This case leads you through the process of the API call to prepare an envelope. Generally this call helps you to prepare all steps and the whole configuration for an envelope you want to send later.

Table of Contents

The Story

A car seller is in the final step of selling the car to a customer. He/She creates the contract and adds all the features, that the car will later include, in the document. In order not to overwrite the signature field with text, the seller has created a dynamic field so that the signature field is dynamically placed on the page.

Use Case Description

In a car sales, it is likely that with additional features, which should be installed in the new car, the signature field in the contract is not always on the same position (page 1) but on the second or third. Therefore, it makes sense to place dynamic placeholders. Exactly this case will be described here.

...

Image Removed

Integration

Advanced Document Tags

Advanced document tags are a solution to define interactive form elements in a PDF document by inserting text placeholders. Such advanced document tags are considered in following use cases:

Creating a draft or template from eSignAnyWhere WebUI
Creating a draft or sending an envelope via eSignAnyWhere API by using the prepare-method for document parsing.

Info

title	Alternatives

eSignAnyWhere is offering following alternatives to insert interactive elements:

Prepare a PDF document with Acrobat Form Fields (simple field types such as text input can be defined e.g. with OpenOffice; signature fields can be inserted with Adobe Acrobat Pro.
Form Fields can't be assigned automatically to the proper signer. Less options for configuration.
Use the simpler sig-string notation as plain-text within the PDF document
Sig strings are supported also by other products of Namirial (xyzmo Client, etc). Fields created via sig strings can't be assigned automatically to the proper signer. Less options for configuration. Benefit is the freely

defineable

definable start (and optional end) marker string.
Define the fields entirely in the envelope JSON

or XML

structures when creating a draft or sending an envelope via API

Dimension limitation

Info

Please note that if the height or width of the advanced document tag exceeds the size (width and height) of the document following notification will be displayed:

Image Removed

Dimenstion Limitations Image Added

General Syntax

Info

title	Recommendations for correct parsing

Note that the Advanced Document Tag must be placed in a single-line within your document. No word wrap (also no automatic word wrap) must happen within your document tag. To ensure that parsing the document tag works fine, use a small, but not too small, font. We recommend to use a sans-serif font (e.g. Arial) in the advanced document tag and use a font size of 4pt to avoid issues with unexpected spaces being inserted between characters during parsing.

Info

title	Measurement unit

The measurement unit for e.g. width or height is pixel

The advanced document tag starts with two opening square brackets ("[["), followed by the field definition parameters which are separated by the colon (":"). The advanced document tag ends with two closing square brackets ("]]").

The first field definition parameter is the field name (optionally prefixed by a quantifier ("!" or "*").

The 2nd field definition parameter is the assignment.

Then, attributed element definitions follow.

The first element definition is the field type, attributed in brackets ("(" and ")") with parameters of the field.

Additional element definitions such as labels, default text, font setting, sizing or offset may follow.

Parameters

`!`	required (optional)
`*`	read only (optional)
`fieldname`	String (required)
`:signer1`	Assigned to signer; “signer” or “signer1”, “signer2”, … (required)
`:objecttype`	Type, e.g. signature, combobox, … (mandatory)
`:property`	additional parameters (allow using of some short notation (e.g. l,r,c instead left, right, center, …))

Signature Fields

Note: The following signature types are supported: Click2Sign, Draw2Sign, Type2Sign, RemoteSignature, BiometricSignature, LocalCertificateSignature, DisposableCertificate, OtpSignature (as of October 2019, eSAW 3.6)

...

and additionally SwissComOnDemandCertificate since eSAW 21.

...

27.

Sample for Click2Sign and Draw2Sign

[[!sigField1:signer1:signature(sigType="Click2Sign,Draw2Sign",batch=1):label("some label"):size(width=150,height=60)]]
sigType, batch, label, size are optional.

Sample for Automatic Remote Signature
Note: To use an automatic remote signature you must have the role “Automatic Sealing Sender” enabled, otherwise you are not able to proceed.

[[!sig1:signer1:signature(sigType="AutomaticRemoteSignature"):size(height=50):label("some label")]]

Sample for SwissComOnDemandCertificate Signature

[[!sigField1:signer1:signature(sigType="SwissComOnDemandCertificate"):label("some label"):size(width=150,height=60)]]

Form Fields

Attachments

[[myAttachment:signer:attachment:label("some label"):size(width=10,height=10)]]

label, size are optional.

Textfield

Info

Please note: If a textfield has a default text configured and is set "required" the textfield will be considered as "already filled". This means that it is possible to finish the envelope without explicitely typing data into the textfield.

[[*myText:signer2:text(maxLength=100,password=1,multiline=true):default("default text"):font(name=Arial, color=#FF0000, size=12):alignment(left):size(width=10,height=10)]]

maxLength, password, default, font, alignment (left|right|center), size, multi-line are optional

Code Block

language	java
theme	Eclipse

 "Range": {
                 "From": "-300,00 €",
                 "To": "5.000,00 €"
          },

You can type in any numbers. If you define the same number for “FROM” and “TO” you can only type in the given number. For example if you define 400,00 for “FROM” and “TO” the recipient can only type in this number into the Text Field.

Input Validation Image Modified

The (optional) input validation definition might be helpful to limit the user input to the expected values. Also check the workstep configuration documentation for accepted formats.

Date

Requires a date field for signer1

[[!someDate:signer1:date(format="dd. MMMM yyyy"):range(from="13. März 2018",to="18. December 2019")]]

range is optional and must match with defined format

Email
- optional for email field
- ```
[[someMail:signer:email()]]
```

Number

[[someNumber:signer:number(decimalPlaces=2,decimalSeparator=comma,thousandsSeparator=point,symbol="€",symbolLocation=endWithBlank):range(from="-300,00 €",to="5.000,00 €")]]

range, decimalSeparator, thousandsSeparator, symbol, symbolLocation, are optional
decimalSeparator: comma, point, apostrophe

...

- thousandsSeparator: comma, point, apostrophe, blank

...

- symbolLocation: start, startWithBlank, end, endWithBlank
- range must match with defined format
phone
- ```
[[somePhone:signer:phone(type=international)]]
```
- type: international, internationalLeadingZero, internationalLeadingPlus

time

[[someTime:signer:time(format="HH:mm"):range(from="12:00",to="18:00")]]

range is optional
range must match the defined format

Checkbox

A required checked checkbox is for only one signer.

...

[[*myText:signer2:text(maxLength=100,password=1,multiline=true):default("default text"):font(name=Arial, color=#FF0000, size=12):alignment(left):size(width=10,height=10)

...

]]

...

maxLength, password, default, font, alignment (left|right|center), size, multi-line are optional.

Checkbox

A required checked checkbox is for only one signer.

[[!chk1:signer:checkbox:size(width=10,height=10):checked]]

checked, size is optional.

RadioButton

All items of a group have to have the same name. Group of three RadioButtons for one recipient:

[[testRbnGroup:signer:radio(Red):size(width=10,height=10):checked]]
[[testRbnGroup:signer:radio(Green):size(width=10,height=10)]]
[[testRbnGroup:signer:radio(Blue):size(width=10,height=10)]]

checked, size is optional.

[[myDrop:signer:dropdown(options="Red,Green,Blue",values="R,G,B",editable=1):default("R"):font(name=Arial, color=#FF0000, size=12):alignment(left):size(width=10,height=10)]]

values, editable, default, size, font, alignment (left|right|center) are optional.

List

[[myList:signer:list(options="Red,Green,Blue",values="R,G,B",multiSelect=1):default("R"):font(name=Arial, color=#FF0000, size=12):alignment(left):size(width=10,height=10)]]

values, multiSelect, default, size, font, alignment (left|right|center) are optional.

Offset

You can define a offset by using

:offset(x=-10.5,y=-50.6)

The offset starts at the lower left position, is using points as units and numbers (double) as input. A positive x value moves to right and a positive y value moves up. Note: this is support eSAW version 3.0+.

Variables

Use to reuse some fragments and allow an easier placement of the text markup into floating text.

Definition:

[[#myFontSettings=:font(name=Arial, color=#FF0000, size=12):alignment(left)]]

Usage:

[[myList:signer:list(options="Red,Green,Blue",values="R,G,B",multiSelect=1):default("R")$myFontSettings:size(width=10,height=10)]]

In the next section you can find a input validation example for REST. With this configuration only numbers from -300,00 to 5.000,00 are allowed in the Textfield.

Code Block

language	java
theme	Eclipse

 "Range": {
                 "From": "-300,00 €",
                 "To": "5.000,00 €"
          },

you can type in any numbers. If you define the same number for “FROM” and “TO” you can only type in the given number. For example if you define 400,00 for “FROM” and “TO” the recipient can only type in this number into the Text Field.

The following steps (including the optional use of the advanced document tag) are necessary for the API call:

...

Workflow

The following steps (including the optional use of the advanced document tag) are necessary for the API call:

Prepare a document with advanced document tags
1. First, create or prepare a document with advanced document tags. These tags are placeholders within the document that will be replaced with specific data or values. Make sure to format the tags correctly so that they can be recognized and replaced appropriately.
Upload document
1. Start by uploading the prepared document that contains the advanced document tags using the appropriate API endpoint. Make sure to note the FileId returned from this call as you will need it later.
Prepare file
1. Before sending the document, you need to prepare the file. Please see JSON configuration below. With this configuration it is possible to clear the advanced document tags from the document with this variable set to true: ClearAdvancedDocumentTags
  This will remove any existing advanced document tags from the document.
Define recipient
1. Define the specific recipient for the envelope, as in a standard envelope sending process. Proved recipient details such as name, email, and any other relevant information.
Send envelope
1. Now, with the document prepared and the recipient defined, send the envelope using the send envelope api call. Use the FileId obtained from the initial document upload call to associate the correct document with the envelope.

Please also see the developer mode for this tutorial here: Visit the developer mode.

Prepare a document with advanced document tags

For this case you can use the following document which includes one text field and one checkbox:

Download the

...

document advanced_document.pdf.

Upload the document

Make sure you upload a document which contains advanced document tags to see the differences in preparing the envelope.

Preparing the

...

file

If you are using the Advanced Tags via API you have to call

...

file/prepare to use them.

...

Method	REST endpoint
POST	https://demo.esignanywhere.net/api/v6/file/prepare

For this call you need the File Id which you got from the upload file call

...

and the

...

The next configurations show you sample workstep configuration.

...

following sample configuration:

Code Block

language	java
theme	Eclipse

{
  "

SspFileIds

FileIds": [
    "

##FILE-ID##

string"
  ],
  "

AdHocWorkstepConfiguration

ClearAdvancedDocumentTags":

{ "WorkstepLabel": "string",

true,
  "

SmallTextZoomFactorPercent": 0, "WorkstepTimeToLiveInMinutes": 0, "FinishAction": { "ClientActions": [

SigStringConfigurations": [

RemoveDocumentFromRecentDocumentList

StartPattern":

true,

CallClientActionOnlyAfterSuccessfulSync

string"

: true

ClientName

EndPattern": "string",

CloseApp

ClearSigString": true,

Action

SearchEntireWordOnly":

"string"

true
    }

}

]
}

Sending the envelope

You can now add the configuration you get as response from the prepare call to your send envelope call and send the document to recipients.

Available configurations

Expand

title	All available configurations

Code Block

language	java
theme	Eclipse

{
   ] "UnassignedElements": {
   },     "NoSequenceEnforcedTextBoxes": true[],
        "SigTemplateCheckBoxes": [],
{        "SizeComboBoxes": {[],
        "HeightRadioButtons": 0[],
        "WidthListBoxes": 0
   [],
  },       "AllowedSignatureTypesSignatures": [],
        
      ]
"Attachments": [],
   },     "ParseFormFieldsLinkConfiguration": {

     "MapRequiredFieldsToRequiredTask": true,       "FormsGroupingHyperLinks": "PerPage"[],
      "ReturnSimplifiedConfig": true,       "AddKeepExistingValueFlagDocumentLinks": []
true,       "ParseFormField": true}
    },
    "AdhocPoliciesActivities": {[
       "AllowModificationsAfterSignature": true {
       },     "ViewerPreferencesAction": {
      "ShowPageNavigationBar": true,          "ShowThumbnailsSign": true,{
      "SkipFinishConfirmDialog": true,       "SkipDocumentDialog": true,       "ShowImagesInFullWidthElements": true,{
        "DisableGeolocation": true,       "ShowDocumentDownloadDialogAfterAutomaticFinish": true,       "AttachmentsMaxFileSizeTextBoxes": 0,[
      "SkipPreviewImageOnDisposableCertificate": true,       "LoadCustomJs": true,       "AllowCustomButtons": true,     {
 "GuidingBehavior": "GuideOnlyRequiredTasks",       "FormFieldsGuidingBehavior": "AllowSubmitAlways",       "ShowVersionNumber": true,       "EnableWarningPopupOnLeave": true,       "WarningPopupDisplayAfterElementId": "FillOrSignFieldmyDisabledText",
      "FinishWorkstepOnOpen": true,          "AutoFinishAfterRequiredTasksDone": true,       "GuidingBehaviorOnFinishedTask": "NoMove",       "SkipThankYouDialogRequired": truefalse,
      "NativeAppsUrlScheme": "string",       "DocumentViewingMode": "EndlessPaperAllDocuments",       "ThumbnailMode": "ShowAllPages",         "ShowTopBarValue": true"default text",
      "DisplayRejectButtonInTopBar": true,       "MultipleSignatureTypesAndBatchSigningSettings": {         "IsUseBatchSigningCheckedByDefault": true,         "IsRememberSignatureTypeCheckedByDefaultDocumentNumber": true1,
        "IsRememberBatchSigningDecisionCheckedByDefault": true,         "SkipMultipleSignatureTypesAndBatchSigningDialogIfBatchSigningPossible": true       },       "VisibleAreaOptionsValidation": {
        "AllowedDomain": "string",             "Enabled": true       },       "ShowStartGuidingHintType": "None"
true,       "ShowStatusBar": true,       "ShowZoomButtons": true,       "ShowNoGeolocationWarning": true,       "AutoStartGuiding": true},
       "ShowPageGap": true,         "ShowPageNavigationButtons": true,       "ShowFinishPossibleHint": true,       "SkipRejectConfirmDialogFieldDefinition": true,{
      "BatchSigningType": "Basic",       "BatchSigningDisableNextButtonUntilDialogScrolledToBottom": true     },     "SignatureConfigurations": [       {   "ReadOnly": true,
    "SpcId": "string",         "PdfSignatureProperties": {           "PdfAConformant": true,           "PAdESPart4CompliantMaxLength": true100,
          "IncludeSigningCertificateChain": true,              "SigningCertificateRevocationInformationIncludeMode": "DoNotInclude",           "SignatureTimestampDataIsMultiline": {false,
            "Uri": "string",             "Username": "string",             "PasswordIsPassword": "string"true,
            "SignatureHashAlgorithm": "Sha1",
            "AuthenticationCertifiateDescriptor": {               "IdentifierIsFileSelect": "string"false,
              "Type": "string"             }        "IsScrollAllowed": false,
 },           "EnableEutlVerification": true,           "EnableValidateSigningCertificateName": true,           "SigningCertificateNameRegexIsCombined": "string" false,
               },         "PdfSignatureCryptographicData": {           "SignatureHashAlgorithmTextFormat": "Sha1",{
            "SigningCertificateDescriptor": {             "Identifier": "string",             "TypeTextColor": "Sha1Thumbprint255, 0, 0",
            "Csp": "Default"             }         },         "CertificateFilterFontSizeInPt": {12.0,
          "KeyUsages": [             "string"           ],     "FontName": "Arial",
    "ThumbPrints": [             "string"           ],           "RootThumbPrintsBold": [false,
            "string"
          ]         }       }     ],
    "SigStringParsingConfiguration"Italic": false,
{       "SigStringsForParsings": [         {           "StartPattern": "string",           "EndPatternTextAlign": "stringLeft",
          "ClearSigString": true,           "SearchEntireWordOnly": true         }    },
  ]     },     "GeneralPolicies": {       "AllowSaveDocument": true,       "AllowSaveAuditTrail": true,       "AllowRotatingPagesPosition": true,{
        "AllowAppendFileToWorkstep": true,       "AllowAppendTaskToWorkstep": true,       "AllowEmailDocument": true,       "AllowPrintDocument": true,       "AllowFinishWorkstepPageNumber": true1,
      "AllowRejectWorkstep": true,          "AllowRejectWorkstepDelegation": true,       "AllowUndoLastAction": true,       "AllowColorizePdfForms": true,       "AllowAdhocPdfAttachmentsX": true119.900001525879,
      "AllowAdhocSignatures": true,          "AllowAdhocStampings": true,       "AllowAdhocFreeHandAnnotations": true,       "AllowAdhocTypewriterAnnotations": true,       "AllowAdhocPictureAnnotationsY": true,672.8358984375
      "AllowAdhocPdfPageAppending": true,       "AllowReloadOfFinishedWorkstep": true     },     "FinalizeActions": {       "FinalizeActionList": [  },
            ]     },     "TransactionCodeConfigurations": [
      {         "IdSize": "string",
 {
      "HashAlgorithmIdentifier": "Sha1",         "Texts": [           {             "LanguageWidth": "string"80.0,
            "Value": "string"           }         ]       }"Height": 19.544999999999998
    ]   },   "PrepareSendEnvelopeStepsDescriptor": {     "ClearFieldMarkupString": true   } }

Expand

title	Alternative: SOAP implementation (deprecated)

Code Block

language	xml
theme	Eclipse

  <prepareSendEnvelopeStepsDescriptor>
  <clearFieldMarkupString>1</clearFieldMarkupString>
</prepareSendEnvelopeStepsDescriptor>

For the tag “clearFieldMarkupString” you can choose between the values “true” and “false” in REST and “0” and “1” in SOAP. If you define for example “false” the field markup string will not be cleared. If you choose “true” the field markup string will be cleared.

After successful configuration you get as response a workstep configuration with the form fields at the end. Those form fields will be added to the document. You can find a sample response in the next collapse:

<!--A

label

for

this

workstep-->

<WorkstepLabel>workstepLabel</WorkstepLabel>

<!--Defines

a

image

generation

correction

factor.

If

for

example

this

document

contains

very

small

text,

which

might

not

be

readable

with

the

standard

image

resolution

of

the

client,

this

factor

can

be

used

to

tell

the

client

to

get

a

higher

resolution.-->

<!--Defines

the

time

to

live

of

all

the

documents

created

by

the

workstep.

After

this

time

to

},

live

is

expired,

all

documents

are

deleted.

'0'

sets

the

time

to

live

to

forever.-->

<!--Configure

the

actions

done

by

the

server

and

the

by

the

clients

when

the

workstep

is

finished.-->

<!--Configure

the

action

done

by

the

server

when

the

workstep

is

finished.-->

<ServerAction callSynchronous="0">http://www.google.at</ServerAction>      <ClientAction clientName="WSI" closeApp="0" RemoveDocumentFromRecentDocumentList="0" CallClientActionOnlyAfterSuccessfulSync="1">www.google.at</ClientAction> </FinishAction>    <NoSequenceEnforced>0</NoSequenceEnforced>  <SigTemplate>  <width>50.5</width>  <height>100.5</height> </SigTemplate>      <ParseFormFields mapRequiredFieldsToRequiredTask="0" formsGrouping="PerPage" returnSimplifiedConfig="0" addKeepExistingValueFlag="0">1</ParseFormFields>  <AdhocPolicies>  <AllowModificationsAfterSignature>1</AllowModificationsAfterSignature> </AdhocPolicies>  <signaturePluginConfiguration>  <PdfSignatureProperties_V1>  <PdfAConformant>0</PdfAConformant>  <PAdESPart4Compliant>0</PAdESPart4Compliant>  <IncludeSigningCertificateChain>0</IncludeSigningCertificateChain>  <SigningCertificateRevocationInformationIncludeMode>DoNotInclude</SigningCertificateRevocationInformationIncludeMode> </PdfSignatureProperties_V1>  <PdfSignatureCryptographicData_V1>  <SignatureHashAlgorithm>Sha256</SignatureHashAlgorithm>  <SigningCertificateDescriptor>  <Identifier>14527a6bcfa8b4d7d0183fca6b735b1c246d14ae</Identifier>  <Type>Sha1Thumbprint</Type>  <Csp>Default</Csp> </SigningCertificateDescriptor> </PdfSignatureCryptographicData_V1> </signaturePluginConfiguration>  <SigStringParsingConfiguration>  <SigStringsForParsing>  <StartPattern>`sig</StartPattern>  <EndPattern>`</EndPattern>  <ClearSigString>1</ClearSigString>  <SearchEntireWordOnly>1</SearchEntireWordOnly> </SigStringsForParsing> </SigStringParsingConfiguration>  <GeneralPolicies>  <AllowSaveDocument>1</AllowSaveDocument>  <AllowSaveAuditTrail>0</AllowSaveAuditTrail>  <AllowRotatingPages>1</AllowRotatingPages>  <AllowAppendFileToWorkstep>1</AllowAppendFileToWorkstep>  <AllowAppendTasksToWorkstep>1</AllowAppendTasksToWorkstep>  <AllowEmailDocument>0</AllowEmailDocument>  <AllowPrintDocument>0</AllowPrintDocument>  <AllowFinishWorkstep>1</AllowFinishWorkstep>  <AllowRejectWorkstep>1</AllowRejectWorkstep>  <AllowUndoLastAction>1</AllowUndoLastAction>  <AllowColorizePdfForms>0</AllowColorizePdfForms>  <AllowAdhocPdfAttachments>0</AllowAdhocPdfAttachments>  <AllowAdhocSignatures>1</AllowAdhocSignatures>  <AllowAdhocStampings>1</AllowAdhocStampings>  <AllowAdhocFreeHandAnnotations>1</AllowAdhocFreeHandAnnotations>  <AllowAdhocTypewriterAnnotations>1</AllowAdhocTypewriterAnnotations>  <AllowAdhocPictureAnnotations>0</AllowAdhocPictureAnnotations>  <AllowAdhocPdfPageAppending>0</AllowAdhocPdfPageAppending> </GeneralPolicies> </AdhocWorkstepConfiguration>

Code Block

language	java
theme	Eclipse

Code Block

language	xml
theme	Eclipse

The next lines of code show you how to configure the steps descriptor:

Code Block

language	java
theme	Eclipse

"PrepareSendEnvelopeStepsDescriptor": {
    "ClearFieldMarkupString": true
  }

Expand

title	Alternative: SOAP implementation (deprecated)

<workstepConfiguration

skipThirdPartyChecks=

0

ExportValue"

>

: "G",

<WorkstepLabel>workstepLabel</WorkstepLabel>

<ServerAction callSynchronous="0">http://www.google.at</ServerAction>

"DisplayValue": "Green"

<ClientAction

clientName="WSI"

closeApp="0"

RemoveDocumentFromRecentDocumentList="0"

CallClientActionOnlyAfterSuccessfulSync="1">www.google.at</ClientAction>

</FinishAction>

},

<positionUnits>PdfUnits</positionUnits>

<positionReferenceCorner>Lower_Left</positionReferenceCorner>

</signatureTemplate>

<pdfForms

isEditingAllowed="1"

/>

<SendVisibleArea

allowedDomain="*">0</SendVisibleArea>

</ViewerPreferences>

"ExportValue": "B",

        "DisplayValue": "Blue"

],

       "IsMultiSelect": true,

      "ReadOnly": false,

     "Position": {

        "PageNumber": 1,

</GeneralPolicies>

<WorkstepTasks

SequenceMode="SequenceOnlyRequiredTasks"

/>

  "X": 72.0240020751953,

</AdhocPolicies>

</Policy>

 "Y": 308.938385009766

<PdfSignatureProperties_V1>

<!--Should

the

signatures

be

pdfA

conformant.

Note

this

setting

does

not

convert

a

document

into

pdfA,

it

only

keeps

it

pdfA

conformant

if

it

already

},

is.

Possible

values:

'1'

sign

pdfA

conformant

-

in

this

case

the

file

size

will

be

bigger

than

without

pdfA,

'0'

do

not

sign

pdfA

conformant.-->

    "Size": {

<!--Defines

if

the

signature

should

be

PAdES

part

4

compliant.

Possible

values:

'1'

sign

the

document

PAdES

part

4

compliant,

'0'

sign

the

document

with

standard

pdf

signature.

Default

value:

'0'-->

  "Width": 80.0,

<!--Defines

if

the

certificate

chain

for

the

signing

certificate

should

be

embedded

into

the

signature.

Possible

values:

'1'

include

the

certificate

chain,

'0'

do

not

include

the

certificate

chain.

Default

value:

'0'-->

"Height": 10.0

<!--Defines

if

and

how

the

revocation

information

for

the

signing

certificate

chain

should

be

embedded.

Possible

values:

'DoNotInclude'

no

revocation

information

is

included,

'Include'

the

revocation

information

has

to

be

included,

if

not

possible

the

signature

throws

an

exception,

'TryToInclude'

if

the

revocation

information

can

be

fetched,

it

should

be

included,

if

not

the

signature

is

done

without

revocation

information.

Information

about

the

signatures

where

the

revocation

information

could

not

be

included

is

saved

into

the

WorkstepStatus,

'CheckRevocationIncludeOcsp'

the

revocation

information

has

to

be

included

when

it

is

an

OCSP

},

if

checking

of

the

revocation

(OCSP

or

CRL)

fails

an

exception

is

thrown.

Information

about

the

signatures

where

the

revocation

information

could

not

be

included

is

saved

into

the

WorkstepStatus-->

<SigningCertificateRevocationInformationIncludeMode>DoNotInclude</SigningCertificateRevocationInformationIncludeMode>

</PdfSignatureProperties_V1>

<!--Configurate

the

cryptographic

data-->

<PdfSignatureCryptographicData_V1>

"ElementId": "myVarList",

<!--The

description

of

the

signing

certificate.

More

than

one

SigningCertificateDescriptor can be defined by adding this node more than once. If more SigningCertificateDescriptors are present, these configurations are used as backup if the selected SigningCertificateDescriptor is not working. For example if no revocation information can be retrieved although it should be included into the signature.-->

"DocumentNumber": 1,
                                "Required": false,

<!--The

certificates

identifier-->

     "PreSelectedItems": [

<!--The

certificate

identifier

type.

Possible

values:

'Subject',

'Sha1Thumbprint'-->

<Type>Sha1Thumbprint</Type>

"R"

<Csp>Default</Csp>

],

</SigningCertificateDescriptor>

</PdfSignatureCryptographicData_V1>

</signaturePluginConfiguration>

<TransactionCodeConfiguration

trConfId=

smsAuthTransactionCodeId">

FieldDefinition": {

</TransactionCodeConfiguration>

</TransactionCodeConfigurations>

</workstepConfiguration>

"TextFormat": {

<steps>

<step>

    "TextColor": "255, 0, 0",

<recipientType>Signer</recipientType>

<useDefaultAgreements>false</useDefaultAgreements>

<workstepConfiguration

skipThirdPartyChecks="0">

<WorkstepLabel>workstepLabel</WorkstepLabel>

 "FontSizeInPt": 12.0,

    "FontName": "Miriam",

<ServerAction

callSynchronous="0">http://www.google.at</ServerAction>

<ClientAction

clientName="WSI"

closeApp="0" RemoveDocumentFromRecentDocumentList="0" CallClientActionOnlyAfterSuccessfulSync="1">www.google.at</ClientAction>

             "Bold": false,

</FinishAction>

<SendVisibleArea

allowedDomain="*">0</SendVisibleArea>

          "Italic": false,

</ViewerPreferences>

<Policy

version="1.1.0.0">

          "TextAlign": "Left"

},

"Items": [

  "ExportValue": "R",

              "DisplayValue": "Red"

},

      "ExportValue": "G",

</GeneralPolicies>

     "DisplayValue": "Green"

</AdhocPolicies>

<WorkstepTasks

originalSequenceMode="NoSequenceEnforced"

SequenceMode="NoSequenceEnforced">

},

<Task

id="17006562-45c4-4ab2-83f9-2333bada59c2"

DocRefNumber="1"

enabled="1"

completed="0"

type="FillFormsGroup"

required="1"

displayName=""

/>

</WorkstepTasks>

</Policy>

<!--Configurate

the

signature

properties-->

<PdfSignatureProperties_V1>

<!--Should

the

signatures be pdfA conformant. Note this setting does not convert a document into pdfA, it only keeps it pdfA conformant if it already is. Possible values: '1' sign pdfA conformant - in this case the file size will be bigger than without pdfA, '0' do not sign pdfA conformant.-->

"ExportValue": "B",
                                            "DisplayValue": "Blue"

<!--Defines

if

the

signature

should

be

PAdES

part

4

compliant.

Possible

values:

'1'

sign

the

document

PAdES

part

4

compliant,

'0'

sign

the

document

with

standard

pdf

signature.

Default

value:

'0'-->

<!--Defines

if

the

certificate

chain

for

the

signing

certificate

should

be

embedded

into

the

signature.

Possible

values:

'1'

include

],

the

certificate

chain,

'0'

do

not

include

the

certificate

chain.

Default

value:

'0'-->

<!--Defines

if

and

how

the

revocation

information

for

the

signing

certificate chain should be embedded. Possible values: 'DoNotInclude' no revocation information is included, 'Include' the revocation information has to be included, if not possible the signature throws an exception, 'TryToInclude' if the revocation information can be fetched, it should be included, if not the signature is done without revocation information. Information about the signatures where the revocation information could not be included is saved into the WorkstepStatus, 'CheckRevocationIncludeOcsp' the revocation information has to be included when it is an OCSP, if checking of the revocation (OCSP or CRL) fails an exception is thrown. Information about the signatures where the revocation information could not be included is saved into the WorkstepStatus--> <SigningCertificateRevocationInformationIncludeMode>DoNotInclude</SigningCertificateRevocationInformationIncludeMode> </PdfSignatureProperties_V1>  <PdfSignatureCryptographicData_V1>

"IsMultiSelect": true,
                                    "ReadOnly": false,
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 72.0240020751953,

<!--The

description

of

the

signing

certificate.

More

than

one

SigningCertificateDescriptor

can

be

defined

by

adding

this

node

more

than

once.

If

more

SigningCertificateDescriptors

are present, these configurations are used as backup if the selected SigningCertificateDescriptor is not working. For example if no revocation information can be retrieved although it should be included into the signature.-->

 "Y": 253.978393554688

},

<!--The

certificates

identifier-->

<!--The

certificate

identifier

type.

Possible

values:

'Subject',

'Sha1Thumbprint'-->

  "Size": {

<Type>Sha1Thumbprint</Type>

<!--The

cryptographic

service

provider

to

locate

the

certificate.

Possible

values:

'default'

uses

the

servers

certificate

store,

'custom'

uses

the

custom

signature

action-->

     "Width": 80.0,

<Csp>Default</Csp>

</SigningCertificateDescriptor>

</PdfSignatureCryptographicData_V1>

</signaturePluginConfiguration>

          "Height": 10.0

<TransactionCodeConfiguration

trConfId="smsAuthTransactionCodeId">

</TransactionCodeConfiguration>

</TransactionCodeConfigurations>

<pdfForms

isEditingAllowed="0">

<pdfFormsGroup

id="17006562-45c4-4ab2-83f9-2333bada59c2">

<textBox

id="myText1">

],

             "Signatures": [

"Id": "sigField1",

               "Required": true,

</textBox>

<checkBox

id="chk1">

              "DocumentNumber": 1,

<requiredEvalPolicy>IsChecked</requiredEvalPolicy>

          "DisplayName": "signature label",

       "AllowedSignatureTypes": {

       "ClickToSign": {},

       "SignaturePlugins": []

</checkBox>

</pdfFormsGroup>

},

</pdfForms>

<TypewriterAnnotationTaskInfo

/>

<attachmentFields

/>

 "FieldDefinition": {

           "Position": {

<positionReferenceCorner>Lower_Left</positionReferenceCorner>

<positionUnits>PdfUnits</positionUnits>

</signatureTemplate>

</workstepConfiguration>

"PageNumber": 1,

<eMail>placeholder1@placeholder1.com</eMail>

   "X": 142.100006103516,

<firstName>placeholder1</firstName>

<lastName>placeholder1</lastName>

"Y": 759.248413085938

<disableEmail>false</disableEmail>

},

<skipExternalDataValidation>false</skipExternalDataValidation>

<addAndroidAppLink>false</addAndroidAppLink>

<addIosAppLink>false</addIosAppLink>

"Size": {

<addWindowsAppLink>false</addWindowsAppLink>

            "Width": 150.0,

<authentications

/>

</recipient>

</recipients>

</step>

     "Height": 60.0

</steps>

<document

docRef="1">

<textBox

name="myText1"

readOnly="false"

required="true"

x="72"

y="563.477001953125"

width="200"

height="65.149999999999991" page="1">

},

<fontName>Arial</fontName>

        "TaskConfiguration": {}

<fontStyleBold>false</fontStyleBold>

<fontStyleItalic>false</fontStyleItalic>

},

<textAlign>Center</textAlign>

</fontSettings>

<value>Place

for

signer1</value>

<isMultiLine>false</isMultiLine>

 "Id": "sigField001",

<isPassword>false</isPassword>

<isFileSelect>false</isFileSelect>

         "Required": true,

<isScrollAllowed>false</isScrollAllowed>

<isComb>false</isComb>

                 "DocumentNumber": 1,
                                "DisplayName": "signature label 1",
                                "AllowedSignatureTypes": {
                                    "ClickToSign": {},

</textBox>

{
    "AdHocWorkstepConfigResult": {
        "WorkstepLabel": "string",
        "SmallTextZoomFactorPercent": 0,
        "FinishAction": { "ElementId": "myText",
                                "Required": false,
                                "Value": "default text",
                                "DocumentNumber": 1,
                                "Validation": {
                                    "Type": "None"
                                },
                                "FieldDefinition": {
                                    "ReadOnly": false,
                                    "MaxLength": 100,
                                    "IsMultiline": false,
                                    "IsPassword": false,
                                    "IsFileSelect": false,
                                    "IsScrollAllowed": false,
                                    "IsCombined": false,
                                    "TextFormat": {
                                        "TextColor": "255, 0, 0",
                                        "FontSizeInPt": 12.0,
                                        "FontName": "Arial",
                                        "Bold": false,
                                        "Italic": false,
                                        "TextAlign": "Left"
                                    },
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 72.0240020751953,
                                        "Y": 644.995871582031
                                    },
                                    "Size": {
                                        "Width": 80.0,
                                        "Height": 19.544999999999998
                                    }
                                }
                            },
                            {
                                "ElementId": "someDate",
                                "Required": true,
                                "Value": "",
                                "DocumentNumber": 1,
                                "Validation": {
                                    "Type": "Date",
                                    "DateValidationConfiguration": {
                                        "Format": "dd. MMMM yyyy",
                                        "Range": {
                                            "From": "13. März 2018",
                                            "To": "18. December 2019"
                              "ServerActions": [],         }
   "ClientActions": [                 {               }
     "RemoveDocumentFromRecentDocumentList": true,                     "CallClientActionOnlyAfterSuccessfulSync": true,    },
                "ClientName": "string",               "FieldDefinition": {
    "CloseApp": true,                     "Action": "string"         "ReadOnly": false,
      }             ]         },         "TransactionCodeConfigurationsMaxLength": [0,
            {                 "Id": "string",      "IsMultiline": false,
         "HashAlgorithmIdentifier": "Sha1",                 "Texts": [        "IsPassword": false,
           {                         "LanguageIsFileSelect": "string"false,
                          "Value": "string"         "IsScrollAllowed": false,
          }                 ]         "IsCombined": false,
  },             {                 "Id": "smsAuthTransactionCodeId",   "TextFormat": {
            "HashAlgorithmIdentifier": "Sha256",                 "Texts": [         "TextColor": "Black",
                           ]             }
"FontSizeInPt": 3.0,
       ],         "SignatureConfigurations": [             {                 "SpcId"FontName": "stringArial",
                "PdfSignatureProperties": {                        "PdfAConformantBold": truefalse,
                    "PAdESPart4Compliant": true,                     "IncludeSigningCertificateChainItalic": truefalse,
                    "SigningCertificateRevocationInformationIncludeMode": "DoNotInclude",                     "SignatureTimestampDataTextAlign": {"Left"
                        "Uri": "string",              },
          "Username": "string",                         "PasswordPosition": {
"string",                         "SignatureHashAlgorithm": "Sha1",              "PageNumber": 1,
         "AuthenticationCertifiateDescriptor":  {                             "IdentifierX": "string",97.2239990234375,
                             "Type": "string"          "Y": 606.47327994060493
             }                       },
                    "EnableEutlVerification": true,               "Size": {
    "EnableValidateSigningCertificateName": true,                     "SigningCertificateNameRegex": "string"             "Width": 192.293640136719,
  },                 "PdfSignatureCryptographicData": {                     "SignatureHashAlgorithmHeight": "Sha1", 5.1186008701324415
                          "SigningCertificateDescriptor": {         }
               "Identifier": "string",                }
        "Type": "Sha1Thumbprint",                   },
     "Csp": "Default"                     } {
               },                 "CertificateFilterElementId": { "somePhone",
                                "KeyUsagesRequired": [false,
                        "string"        "Value": "",
           ],                     "ThumbPrintsDocumentNumber": [1,
                            "string"    "Validation": {
               ],                     "RootThumbPrintsType": ["Phone",
                        "string"            "PhoneValidationConfiguration": {
       ]                  }             }  "Type": "International"
     ],         "ViewerPreferences": {             "ShowPageNavigationBar": true,       }
     "ShowThumbnails": true,             "SkipFinishConfirmDialog": true,            },
"SkipDocumentDialog": true,             "ShowImagesInFullWidth": true,             "DisableGeolocation": true,   "FieldDefinition": {
        "ShowDocumentDownloadDialogAfterAutomaticFinish": true,             "AttachmentsMaxFileSize": 0,             "SkipPreviewImageOnDisposableCertificateReadOnly": truefalse,
            "LoadCustomJs": true,             "AllowCustomButtons": true,
            "GuidingBehaviorMaxLength": "GuideOnlyRequiredTasks"0,
 
          "FormFieldsGuidingBehavior": "AllowSubmitAlways",             "ShowVersionNumber": true,             "EnableWarningPopupOnLeaveIsMultiline": truefalse,
            "WarningPopupDisplayAfter": "FillOrSignField",             "FinishWorkstepOnOpen": true,             "AutoFinishAfterRequiredTasksDoneIsPassword": truefalse,
            "GuidingBehaviorOnFinishedTask": "NoMove",               "SkipThankYouDialog": true,        "IsFileSelect": false,
   "NativeAppsUrlScheme": "string",                   "DocumentViewingMode": "EndlessPaperAllDocuments",             "ThumbnailModeIsScrollAllowed": "ShowAllPages"false,
            "ShowTopBar": true,             "DisplayRejectButtonInTopBar": true,             "MultipleSignatureTypesAndBatchSigningSettingsIsCombined": {false,
                  "IsUseBatchSigningCheckedByDefault": true,                 "IsRememberSignatureTypeCheckedByDefaultTextFormat": true, {
                      "IsRememberBatchSigningDecisionCheckedByDefault": true,                 "SkipMultipleSignatureTypesAndBatchSigningDialogIfBatchSigningPossibleTextColor": true"Black",
            },             "VisibleAreaOptions": {                 "AllowedDomainFontSizeInPt": "string",
  3.0,
             "Enabled": true             },             "ShowStartGuidingHintFontName": true"Arial",
            "ShowStatusBar": true,             "ShowZoomButtons": true,             "ShowNoGeolocationWarningBold": truefalse,
            "AutoStartGuiding": true,             "ShowPageNavigationButtons": true,             "ShowFinishPossibleHintItalic": truefalse,
             "SkipRejectConfirmDialog": true,             "BatchSigningType": "Basic",            "TextAlign": "BatchSigningDisableNextButtonUntilDialogScrolledToBottom": trueLeft"
              },         "Policy": {            },
"GeneralPolicies": {                 "AllowSaveDocument": true,                 "AllowSaveAuditTrailPosition": true,{
                      "AllowRotatingPages": true,                 "AllowAppendFileToWorkstepPageNumber": true1,
                 "AllowAppendTaskToWorkstep": true,                       "AllowEmailDocumentX": true,105.379997253418,
                   "AllowPrintDocument": true,                     "AllowFinishWorkstepY": true,543.44325064372993
                 "AllowRejectWorkstep": true,                 "AllowRejectWorkstepDelegation": true},
                  "AllowUndoLastAction": true,                 "AllowColorizePdfFormsSize": true, {
                      "AllowAdhocPdfAttachments": true,                 "AllowAdhocSignaturesWidth": true86.3280029296875,
                  "AllowAdhocStampings": true,                      "AllowAdhocFreeHandAnnotationsHeight": 5.1186008701324415
true,                 "AllowAdhocTypewriterAnnotations": true,                 "AllowAdhocPictureAnnotations": true, }
                       "AllowAdhocPdfPageAppending": true,        }
        "AllowReloadOfFinishedWorkstep": true             },      },
      "WorkstepTasks": {                 "PictureAnnotationMinResolution": 0,   {
             "PictureAnnotationMaxResolution": 0,                   "PictureAnnotationColorDepthElementId": "Color16MsomeTime",
                "SequenceMode": "NoSequenceEnforced",                 "PositionUnitsRequired": "PdfUnits"false,
                "ReferenceCorner": "Lower_Left",               "Value":  "Tasks":,
[]             }         }     },     "StepsDocumentNumber": [1,
        {             "OrderIndex": 1,             "RecipientsValidation": [{
                {                     "EmailType": "placeholder1@placeholder1.comTime",
   
                "FirstName": "placeholder1",                     "LastNameTimeValidationConfiguration": "placeholder1",{
                    "LanguageCode": "en",
                    "DisableEmailFormat": false"HH:mm",
                    "AddAndroidAppLink": false,                     "AddIosAppLinkRange": false,{
                      "AddWindowsAppLink": false,                     "AllowDelegationFrom": true,"12:00",
                      "SkipExternalDataValidation": false,                     "AuthenticationMethodsTo": []"18:00"
                }             ],           }
 "RecipientType": "Signer",             "WorkstepConfiguration": {                 "WorkstepLabel": "string",  }
              "SmallTextZoomFactorPercent": 0,                 "FinishAction": {},
                     "ServerActions": [],          "FieldDefinition": {
         "ClientActions": [                         { "ReadOnly": false,
                          "RemoveDocumentFromRecentDocumentList": true,         "MaxLength": 0,
                  "CallClientActionOnlyAfterSuccessfulSync": true,                 "IsMultiline": false,
          "ClientName": "string",                             "CloseAppIsPassword": truefalse,
                            "Action": "string"        "IsFileSelect": false,
                 }                   "IsScrollAllowed": false,
]                 },                   "TransactionCodeConfigurationsIsCombined": [false,
                           {         "TextFormat": {
              "Id": "string",                         "HashAlgorithmIdentifierTextColor": "Sha1Black",
                        "Texts": [               "FontSizeInPt": 3.0,
            {                                 "LanguageFontName": "stringArial",
                                  "Value      "Bold": "string" false,
                              }          "Italic": false,
             ]                     },      "TextAlign": "Left"
             {                       },
 "Id": "smsAuthTransactionCodeId",                         "HashAlgorithmIdentifier": "Sha256",        "Position": {
               "Texts": [                        "PageNumber": 1,
                           ]             "X": 98.3040008544922,
      }                 ],                 "SignatureConfigurationsY": [522.32325552654288
                      {              },
          "SpcId": "string",                         "PdfSignaturePropertiesSize": {
                            "PdfAConformant": true,           "Width": 135.384201049805,
                "PAdESPart4Compliant": true,                        "Height": 5.1186008701324415
               "IncludeSigningCertificateChain": true,                    }
        "SigningCertificateRevocationInformationIncludeMode": "DoNotInclude",                       }
     "SignatureTimestampData": {                      }
          "Uri": "string",             ],
                   "Username": "string",    "CheckBoxes": [
                           "Password": "string", {
                                "SignatureHashAlgorithmElementId": "Sha1chk1",
                                "AuthenticationCertifiateDescriptorDocumentNumber": {
   1,
                                "IdentifierRequired": "string"true,
                                "IsChecked": false,
  "Type": "string"                             "FieldDefinition": {
  }                             },     "Position": {
                      "EnableEutlVerification": true,                 "PageNumber": 1,
          "EnableValidateSigningCertificateName": true,                             "SigningCertificateNameRegexX": "string"121.699996948242,
                        },                 "Y": 501.918395996094
      "PdfSignatureCryptographicData": {                             "SignatureHashAlgorithm": "Sha1"},
                            "SigningCertificateDescriptor": {       "Size": {
                        "Identifier": "string",               "Width": 10.0,
                "Type": "Sha1Thumbprint",                                 "Csp"Height": "Default"10.0
                            }          },
              },                         "CertificateFilterReadOnly": {false
                            "KeyUsages": [   }
                            }
"string"                             ],
 
                          "ThumbPrintsComboBoxes": [
                            {
   "string"                              ],"ElementId": "myDrop",
                                "RootThumbPrintsDocumentNumber": [1,
                                "stringRequired": false,
                           ]     "Value": "R",
                  }              "FieldDefinition": {
     }                 ],                 "ViewerPreferencesTextFormat": {
 
                  "ShowPageNavigationBar": true,                     "ShowThumbnailsTextColor": true"255, 0, 0",
                  "SkipFinishConfirmDialog": true,                     "SkipDocumentDialogFontSizeInPt": true12.0,
 
                  "ShowImagesInFullWidth": true,                     "DisableGeolocationFontName": true"Arial",
                    "ShowDocumentDownloadDialogAfterAutomaticFinish": true,                     "AttachmentsMaxFileSizeBold": 0false,
                    "SkipPreviewImageOnDisposableCertificate": true,                     "LoadCustomJsItalic": truefalse,
                    "AllowCustomButtons": true,                     "GuidingBehaviorTextAlign": "GuideOnlyRequiredTasks",Center"
                             "FormFieldsGuidingBehavior": "AllowSubmitAlways",      },
              "ShowVersionNumber": true,                     "EnableWarningPopupOnLeaveItems": true,[
                    "WarningPopupDisplayAfter": "FillOrSignField",                    {
"FinishWorkstepOnOpen": true,                     "AutoFinishAfterRequiredTasksDone": true,                     "GuidingBehaviorOnFinishedTaskExportValue": "NoMoveR",
                      "SkipThankYouDialog": true,                     "NativeAppsUrlSchemeDisplayValue": "stringRed",
                     "DocumentViewingMode": "EndlessPaperAllDocuments",                  },
  "ThumbnailMode": "ShowAllPages",                     "ShowTopBar": true,               {
     "DisplayRejectButtonInTopBar": true,                     "MultipleSignatureTypesAndBatchSigningSettings": {                         "IsUseBatchSigningCheckedByDefault"ExportValue": true"G",
                        "IsRememberSignatureTypeCheckedByDefault": true,                    "DisplayValue": "Green"
     "IsRememberBatchSigningDecisionCheckedByDefault": true,                         "SkipMultipleSignatureTypesAndBatchSigningDialogIfBatchSigningPossible": true        },
            },                     "VisibleAreaOptions": {      {
                  "AllowedDomain": "string",                         "EnabledExportValue": "B",
  true                     },                     "ShowStartGuidingHintDisplayValue": true,"Blue"
                    "ShowStatusBar": true,                   }
 "ShowZoomButtons": true,                     "ShowNoGeolocationWarning": true,            ],
        "AutoStartGuiding": true,                     "ShowPageNavigationButtons": true,     "IsEditable": true,
              "ShowFinishPossibleHint": true,                     "SkipRejectConfirmDialogReadOnly": truefalse,
                    "BatchSigningType": "Basic",                "Position": {
     "BatchSigningDisableNextButtonUntilDialogScrolledToBottom": true                 },                 "PolicyPageNumber": {1,
                     "GeneralPolicies": {                         "AllowSaveDocument"X": true72.0240020751953,
                        "AllowSaveAuditTrail": true,                "Y": 360.683402099609
         "AllowRotatingPages": true,                         "AllowAppendFileToWorkstep": true},
                        "AllowAppendTaskToWorkstep": true,           "Size": {
            "AllowEmailDocument": true,                            "AllowPrintDocumentWidth": true80.0,
                         "AllowFinishWorkstep": true,               "Height": 16.67
          "AllowRejectWorkstep": true,                          }
"AllowRejectWorkstepDelegation": true,                         "AllowUndoLastAction": true,     }
                   "AllowColorizePdfForms": true,        }
                "AllowAdhocPdfAttachments": true,       ],
                 "AllowAdhocSignatures": true,      "RadioButtons": [
                 "AllowAdhocStampings": true,          {
              "AllowAdhocFreeHandAnnotations": true,                 "GroupName": "testRbnGroup",
      "AllowAdhocTypewriterAnnotations": true,                         "AllowAdhocPictureAnnotationsDocumentNumber": true1,
                        "AllowAdhocPdfPageAppending": true,       "IsSelectUnison": false,
                "AllowReloadOfFinishedWorkstep": true                     }"Required": false,
                    "WorkstepTasks": {           "SelectedItem": "Red",
            "PictureAnnotationMinResolution": 0,
                        "PictureAnnotationMaxResolutionFieldDefinitions": 0,[
                        "PictureAnnotationColorDepth": "Color16M",           {
             "SequenceMode": "NoSequenceEnforced",                           "PositionUnitsExportValue": "PdfUnitsRed",
                        "ReferenceCorner": "Lower_Left",
                        "Tasks"IsChecked": [true,
                            {            "Position": {
                   "Forms": [                        "PageNumber": 1,
           {                                 "X": 72.0240020751953,
      "Id": "myText1",                                         "PositionPageY": 1,444.918395996094
                                        "DocRefNumber": 1},
                                        "PositionSize": {
                                            "PositionXWidth": 7210.0,
                                            "PositionYHeight": 56310.0
                                        },
                                    },
      "Size":  {                            {
                "Height": 65.15,                        "ExportValue": "Green",
                     "Width": 200.0                  "IsChecked": false,
                     },                   "Position": {
                    "DiscriminatorType": "TextBox"                       "PageNumber": 1,
            },                                "X": 72.0240020751953,
   {                                         "IsRequiredY": true,431.958404541016
                                        "RequiredEvalPolicy": "IsChecked"},
                                        "IdSize": "chk1",{
                                            "PositionPageWidth": 110.0,
                                        "DocRefNumber": 1,   "Height": 10.0
                                    "Position": {   }
                                    },
    "PositionX": 72.0,                               {
             "PositionY": 440.0                          "ExportValue": "Blue",
             },                           "IsChecked": false,
            "Size": {                           "Position": {
                "Height": 25.0,                           "PageNumber": 1,
                "Width": 25.0                           "X": 72.0240020751953,
            },                                "Y": 418.998413085938
       "DiscriminatorType": "CheckBox"                                },
    }                                 ],   "Size": {
                            "IsRequired": true,               "Width": 10.0,
                "Id": "c9919432-ccd0-46a1-a715-9568faa2d57a",                           "Height": 10.0
    "DisplayName": "",                                 "DocRefNumber": 1, }
                               "DiscriminatorType": "FormGroup"    }
                        }        ]
                ]            }
        }                 }
],
           },             "DocumentOptionsListBoxes": [],
                 "UseDefaultAgreements": false         } {
   ],     "AddFormFields": {         "Forms": {             "1ElementId": ["myList",
                {                "DocumentNumber": 1,
   "Value": "Place for signer1",                             "MaxLengthRequired": 100false,
                    "IsMultiline": false,           "PreSelectedItems": [
        "IsPassword": false,                     "IsFileSelect": false,     "R"
               "IsScrollAllowed": false,                ],
    "IsComb": false,                     "TextColor": "255, 0, 0",   "FieldDefinition": {
                "FontSize": 12.0,                     "FontNameTextFormat": "Arial",{
                    "Bold": false,                     "ItalicTextColor": false"255, 0, 0",
                  "TextAlign": "Center",                     "NameFontSizeInPt": "myText1"12.0,
                    "ReadOnly": false,
                    "RequiredFontName": true"Arial",
                    "X": 72.0,                     "YBold": 563.477001953125false,
                    "Width": 200.0,                       "HeightItalic": 65.149999999999991false,

                   "Page": 1,                     "DiscriminatorTypeTextAlign": "AddTextBoxFormFieldDescriptorRight"
                },                 {   },
                 "IsChecked": true,                     "ExportValueItems": "",[
                    "Name": "chk1",                   {
 "ReadOnly": false,                     "Required": true,                     "XExportValue": 72.0,"R",
                     "Y": 439.802001953125,                       "WidthDisplayValue": 25.0,"Red"
                    "Height": 25.0,                   },
 "Page": 1,                     "DiscriminatorType": "AddCheckBoxFormFieldDescriptor"                {
}             ]         }     } }

Expand

title	Alternative: SOAP implementation (deprecated)

Code Block

language	xml
theme	Eclipse

Sending the envelope

You can now add the workstep configuration which you got from the prepare call and send the document to recipients.

           "SignaturePlugins": []
                                },
                                "FieldDefinition": {
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 77.6640014648438,
                                        "Y": 144.890243530273
                                    },
                                    "Size": {
                                        "Width": 150.0,
                                        "Height": 60.0
                                    }
                                },
                                "TaskConfiguration": {}
                            }
                        ],
                        "Attachments": [
                            {
                                "ElementId": "myAttachment",
                                "DocumentNumber": 1,
                                "Required": false,
                                "FileName": "attachment label",
                                "FieldDefinition": {
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 128.059997558594,
                                        "Y": 717.228393554688
                                    },
                                    "Size": {
                                        "Width": 20.0,
                                        "Height": 20.0
                                    }
                                }
                            }
                        ],
                        "LinkConfiguration": {
                            "HyperLinks": [],
                            "DocumentLinks": []
                        }
                    }
                }
            }
        },
        {
            "Action": {
                "Sign": {
                    "Elements": {
                        "TextBoxes": [
                            {
                                "ElementId": "someMail",
                                "Required": false,
                                "Value": "",
                                "DocumentNumber": 1,
                                "Validation": {
                                    "Type": "Email"
                                },
                                "FieldDefinition": {
                                    "ReadOnly": false,
                                    "MaxLength": 0,
                                    "IsMultiline": false,
                                    "IsPassword": false,
                                    "IsFileSelect": false,
                                    "IsScrollAllowed": false,
                                    "IsCombined": false,
                                    "TextFormat": {
                                        "TextColor": "Black",
                                        "FontSizeInPt": 3.0,
                                        "FontName": "Arial",
                                        "Bold": false,
                                        "Italic": false,
                                        "TextAlign": "Left"
                                    },
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 101.300003051758,
                                        "Y": 585.47327994060493
                                    },
                                    "Size": {
                                        "Width": 55.5635986328125,
                                        "Height": 5.1186008701324415
                                    }
                                }
                            },
                            {
                                "ElementId": "someNumber",
                                "Required": false,
                                "Value": "",
                                "DocumentNumber": 1,
                                "Validation": {
                                    "Type": "Number",
                                    "NumberValidationConfiguration": {
                                        "DecimalDigits": 2,
                                        "Symbol": "€",
                                        "SymbolLocation": "EndWithBlank",
                                        "GroupSeparator": "Point",
                                        "DecimalSeparator": "Comma",
                                        "Range": {
                                            "From": "-300,00 €",
                                            "To": "5.000,00 €"
                                        }
                                    }
                                },
                                "FieldDefinition": {
                                    "ReadOnly": false,
                                    "MaxLength": 0,
                                    "IsMultiline": false,
                                    "IsPassword": false,
                                    "IsFileSelect": false,
                                    "IsScrollAllowed": false,
                                    "IsCombined": false,
                                    "TextFormat": {
                                        "TextColor": "Black",
                                        "FontSizeInPt": 3.0,
                                        "FontName": "Arial",
                                        "Bold": false,
                                        "Italic": false,
                                        "TextAlign": "Left"
                                    },
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 112.339996337891,
                                        "Y": 564.4425465235712
                                    },
                                    "Size": {
                                        "Width": 342.618560791016,
                                        "Height": 5.1194073419570909
                                    }
                                }
                            }
                        ],
                        "CheckBoxes": [],
                        "ComboBoxes": [],
                        "RadioButtons": [],
                        "ListBoxes": [],
                        "Signatures": [
                            {
                                "Id": "sigField1000",
                                "Required": true,
                                "DocumentNumber": 1,
                                "DisplayName": "signature label 1000",
                                "AllowedSignatureTypes": {
                                    "ClickToSign": {},
                                    "SignaturePlugins": []
                                },
                                "FieldDefinition": {
                                    "Position": {
                                        "PageNumber": 1,
                                        "X": 303.049987792969,
                                        "Y": 144.890243530273
                                    },
                                    "Size": {
                                        "Width": 150.0,
                                        "Height": 60.0
                                    }
                                },
                                "TaskConfiguration": {}
                            }
                        ],
                        "Attachments": [],
                        "LinkConfiguration": {
                            "HyperLinks": [],
                            "DocumentLinks": []
                        }
                    }
                }
            }
        }
    ]
}

FAQ

The Advanced Document Tag does not fit into a table cell. How can I solve that?

We recommend to use a variable that holds the entire Advanced Document Tag. Variables are not restricted to be just a parameter part of the advanced document tag; they can even store the entire notation.
The variable can be defined outside the table structure. Then, inside the table, just use the variable reference.

I am using Advanced Document Tags for Dropdown Configuration. But my list of allowed values is quite long. Even with small font size, I cannot make it fitting into a single line. How to proceed?

It's allowed to use variables to define a subset of the value list, and then either define another variable that merges the different subsets, or use the list of subsets directly in the Advanced Document Tag.

Example:

Code Block

[[#ListItems01=A,B,C]]
[[#ListValues01=v1,v2,v3]]

[[#ListItems02=D,E,F]]
[[#ListValues02=v4,v5,v6]]

[[myDropDown:signer1:dropdown(options="$ListItems01,$ListItems02",values="$ListValues01,$ListValues02",editable=1):font(name=Arial, color=#FF0000, size=12):alignment(left):size(width=10,height=10)]]

Versions Compared

Old Version 17

New Version Current

Key

The Story

Use Case Description

Integration

Advanced Document Tags

Dimension limitation

General Syntax

Signature Fields

Form Fields

Attachments

Textfield

Input Validation Image Modified

Checkbox

Checkbox

RadioButton

List

Workflow

Prepare a document with advanced document tags

Upload the document

Preparing the

file

Sending the envelope

Available configurations

Sending the envelope

FAQ

The Advanced Document Tag does not fit into a table cell. How can I solve that?

I am using Advanced Document Tags for Dropdown Configuration. But my list of allowed values is quite long. Even with small font size, I cannot make it fitting into a single line. How to proceed?

Page Comparison

Versions Compared

Old Version 17

New Version Current

Key

The Story

Use Case Description

Integration

Advanced Document Tags

Dimension limitation

General Syntax

Signature Fields

Form Fields

Attachments

Textfield

Input Validation Image Modified

Checkbox

Checkbox

RadioButton

DropDown

List

Workflow

Prepare a document with advanced document tags

Upload the document

Preparing the

file

Sending the envelope

Available configurations

Sending the envelope

FAQ

The Advanced Document Tag does not fit into a table cell. How can I solve that?

I am using Advanced Document Tags for Dropdown Configuration. But my list of allowed values is quite long. Even with small font size, I cannot make it fitting into a single line. How to proceed?