Please also see the next figure for an overview of the envelope structure:

Image RemovedImage Added

For a basic guide of REST and the different API calls please also have a look at our Postman tutorial.

...

The result of the API call is the FileId which will be needed for the sending call.

Configuration

The configuration is the core of the envelope. Within the configuration you can define following settings:

Envelope configuration
- Name
- Meta data
- Document time stamp etc.
Unassigned elements
- Textboxes
- Radio buttons
- signatures etc.
Activities
- Action
  - Sign
    - Recipient configuration
      - Authentication configuration
  - View
    - Recipient configuration
      - Authentication configuration
  - Sign automatic etc.
  - SignAsP7M
- Visibility options
Email configuration
Reminder configuration
Expiration configuration
Callback configuration
Agreement configuration

Starting configuration

...

Info

Please note that with api v6 the general policies are set as default:

Code Block

language	java
theme	Eclipse

"Documents": [{

"FileId": "c5a229ae-1234-1234-b6e8-d4eb9fd7bcf5"

AllowAdhocFreeHandAnnotations = false,

"DocumentNumber": 1

        AllowAdhocPdfAttachments =

}

false,

],

"Name":

"Test",

"Activities":

[{

      AllowAdhocPdfPageAppending = false,

"Action":

{

               AllowAdhocPictureAnnotations

"Sign": {

= false,

"RecipientConfiguration": {

AllowAdhocSignatures = false,
                    AllowAdhocStampings = false,

"ContactInformation":

{

                 AllowAdhocTypewriterAnnotations = false,

"Email":

"janedoe@sample.com",

          AllowEmailDocument = true,

"GivenName":

"Jane",

   AllowPrintDocument = true,
                    AllowRejectWorkstep

"Surname": "Doe"

= true,
                    AllowSaveAuditTrail = true,

"LanguageCode":

"EN"

            AllowSaveDocument = true,

}

          AllowUndoLastAction = false,

},

            AllowRotatingPages = false,

"Elements":

{

             AllowAppendFileToWorkstep

"Signatures": [{

= false,
                    AllowAppendTasksToWorkstep = false,

"TaskConfiguration":

{

         AllowColorizePdfForms = false,
                    AllowReloadOfFinishedWorkstep

"OrderDefinition": {

= true,
                    AllowDownloadOfSignedP7MFiles = true

"OrderIndex": 0

};
            }

Via UI it is possible to change the following policies (settings can be found in organization settings → Policy for the document viewer for recipients):

Code Block

language	xml
theme	Eclipse

<GeneralPolicies>
  <AllowSaveDocument>1</AllowSaveDocument>
  <AllowSaveAuditTrail>1</AllowSaveAuditTrail>
  <AllowUndoLastAction>1</AllowUndoLastAction>
  <AllowAdhocPdfAttachments>0</AllowAdhocPdfAttachments>
</GeneralPolicies>

The configuration is the core of the envelope. Within the configuration you can define following settings:

Envelope configuration
- Name
- Meta data
- Document time stamp etc.
Unassigned elements
- Textboxes
- Radio buttons
- signatures etc.
Activities
- Action
  - Sign
    - Recipient configuration
      - Authentication configuration
  - View
    - Recipient configuration
      - Authentication configuration
  - Sign automatic etc.
  - SignAsP7M
- Visibility options
Email configuration
Reminder configuration
Expiration configuration
Callback configuration
Agreement configuration

Starting configuration

Lets start with a nearly empty configuration first. Then fill it step by step with the settings above. In the next collapse you can find the sample configuration which includes one action (ClickToSign):

Code Block

language	java
theme	Eclipse

{
    "Documents": [{
               }
                                },
      "FileId": "c5a229ae-1234-1234-b6e8-d4eb9fd7bcf5",
            "DocumentNumber": 1
        }
    ],
    "IdName": "sample sig clicktosignTest",
    "Activities": [{
            "Action": {
                "RequiredSign": true,{
                    "RecipientConfiguration": {
              "DocumentNumber          "ContactInformation": 1,{
                                "DisplayNameEmail": "Sign herejanedoe@sample.com",
                            "GivenName": "Jane",
    "AllowedSignatureTypes": {
                        "Surname": "Doe",
                "ClickToSign": {
           "LanguageCode": "EN"
                        }
                    },
             },
       "Elements": {
                        "FieldDefinitionSignatures": [{
                                    "PositionTaskConfiguration": {
                                        "PageNumberOrderDefinition": 1,{
                                        "XOrderIndex": 100,0
                                    }
    "Y": 200
                            },
                       },
         "ElementId": "sample sig clicktosign",
                        "Size": {
       "Required": true,
                                "WidthDocumentNumber": 1001,
                                "DisplayName": "Sign here",
             "Height                   "AllowedSignatureTypes": 70{
                                    }
"ClickToSign": {
                                    }
                                },
                          ]
      "FieldDefinition": {
                },
                    "SigningGroupPosition": "firstSigner"
{
                     }
            }
        }
    ]
}

The next screenshot shows the document after sending the configuration:

Image Removed

With this configuration we can now add the settings which are mentioned above. First, lets start with the envelope configuration.

Envelope configuration

You can place the general policies directly below the following row:

Code Block

language	java
theme	Eclipse

  "Name": "string",
  "MetaData": "string",
  "AddDocumentTimestamp": true,
  "ShareWithTeam": true,
  "LockFormFieldsOnFinish": true,

Unassigned elements

This section contains all elements which were not assigned to a specific recipient. This results for example from adding so called sig-string to the document. For example, the SIGNificant Server Platform, analyzes PDF documents and searches for so-called 'sig-strings'. When found, a signature field is inserted exactly on this position of the document.

Such elements could be:

PDF form fields
- Textboxes, Checkboxes, Comoboxes, Radio buttons, Listboxes
Signatures
Predefined field elements

Attachments

Code Block

language	java
theme	Eclipse
title	Attachments

"Attachments": [
      {
"PageNumber": 1,
                                        "X": 100,
                                        "Y": 200
                          "ElementId": "string",
        "DocumentNumber": 0},
        "Required": true,
        "FileName": "string",
        "DisplayIconType": "Paperclip",
          "FieldDefinitionSize": {
          "Position": {
                 "PageNumber": 0,
            "XWidth": 0100,
                   "Y": 0
          },
          "SizeHeight": {70
            "Width": 0,
            "Height": 0
          }
        },
         "TaskConfiguration": {
          "OrderDefinition": {
   }
         "OrderIndex": 0
          }
        }
      }
    ],

Link configuration

Code Block

language	java
theme	Eclipse
title	Link configuration

"LinkConfiguration": {
      "HyperLinks": [
        {]
          "ElementId": "string",
          "Uri": "string" },
          "DocumentNumber": 0,
          "FieldDefinitionSigningGroup": {"firstSigner"
            "Position": {    }
              "PageNumber": 0,}
        }
    ]
}

The next screenshot shows the document after sending the configuration:

Sent Envelope Image Added

With this configuration we can now add the settings which are mentioned above. First, lets start with the envelope configuration.

Envelope configuration

You can place the general policies directly below the following row:

Code Block

language	java
theme	Eclipse

  "XName": 0"string",
              "Y"MetaData": 0"string",
  "AddDocumentTimestamp": true,
  "ShareWithTeam": true,
  "LockFormFieldsOnFinish": true,

Unassigned elements

This section contains all elements which were not assigned to a specific recipient. This results for example from adding so called sig-string to the document. For example, the SIGNificant Server Platform, analyzes PDF documents and searches for so-called 'sig-strings'. When found, a signature field is inserted exactly on this position of the document.

Such elements could be:

PDF form fields
- Textboxes, Checkboxes, Comoboxes, Radio buttons, Listboxes
Signatures
Predefined field elements

Attachments

Code Block

language	java
theme	Eclipse
title	Attachments

"Attachments": [
          },
            "Size": {
              "Width": 0,
          {
        "HeightElementId": 0"string",
        "DocumentNumber": 0,
   }
     "Required": true,
    }
    "FileName": "string",
   }
      ]"DisplayIconType": "Paperclip",
        "DocumentLinksFieldDefinition": [{
          "Position": {
            "ElementIdPageNumber": "string"0,
            "DocumentNumberX": 0,
            "LinkAnchorY": {0
            "ElementId": "string"},
            "DocumentNumberSize": 0,{
            "LinkDefinitionWidth": {0,
              "PositionHeight": {0
          }
       "PageNumber": 0},
        "TaskConfiguration": {
          "XOrderDefinition": 0,{
                "YOrderIndex": 0
          }
    },
    }
      }
    ],

Link configuration

Code Block

language	java
theme	Eclipse
title	Link configuration

"LinkConfiguration"Size": {
                "WidthHyperLinks": 0,[
        {
          "HeightElementId": 0"string",
              }"Uri": "string",
            }
          }"DocumentNumber": 0,
          "FieldDefinition": {
            "Position": {
              "PageNumber": 0,
              "X": 0,
              "Y": 0
            },
            "Size": {
              "Width": 0,
              "Height": 0
            }
          }
        }
      ],
      },

Reading confirmationImage Removed

With the reading task a recipient must confirm reading the document to have the evidence that he/she was reading it.

Generally there are 3 basic ways concerning the range of the reading task:

Reading task for an area
Reading task for one page
Reading task for the document

Area read confirmation

Code Block

language	java
theme	Eclipse
title	Area read confirmation

"AreaReadConfirmations"DocumentLinks": [
        {
          "ElementId": "string",
          "RequiredDocumentNumber": true0,
          "DocumentNumberLinkAnchor": 0,
{
            "DisplayNameElementId": "string",
            "DefinitionDocumentNumber": {0,
            "PositionLinkDefinition": {
              "PageNumberPosition": 0,{
                "XPageNumber": 0,
                "YX": 0,
          },
          "SizeY": {0
            "Width": 0  },
              "HeightSize": 0{
          }
       "Width": }0,
        "TaskConfiguration": {
          "OrderDefinitionHeight": {0
            "OrderIndex": 0  }
            }
          },
      }
    ],

Page read confirmation

Code Block

language	java
theme	Eclipse
title	Page read confirmation

"PageReadConfirmations"FieldDefinition": [{
      {
        "ElementIdPosition": "string",
{
              "RequiredPageNumber": true0,
              "DocumentNumberX": 0,
        "DisplayName      "Y": "string",
0
           "PageNumber": 0},
            "TaskConfigurationSize": {
              "OrderDefinitionWidth": {0,
              "OrderIndexHeight": 0
            }
          }
        }
      ]
    },

...

Reading confirmationImage Added

With the reading task a recipient must confirm reading the document to have the evidence that he/she was reading it.

Generally there are 3 basic ways concerning the range of the reading task:

Reading task for an area
Reading task for one page
Reading task for the document

Area read confirmation

Code Block

language	java
theme	Eclipse
title	Document Area read confirmation

 "DocumentConfirmationReadConfirmationAreaReadConfirmations": [
      {
        "ElementId": "string",
        "Required": true,
        "DocumentNumber": 0,
        "DisplayName": "string",
        "TaskConfigurationDefinition": {
          "OrderDefinitionPosition": {
            "OrderIndexPageNumber": 0,
            }
 "X": 0,
            "Y": }0
        }

Activities

This is the main part of the envelope configuration. The section activities can include one to many actions.

Action

Please note that additionally to the elements below you can add a visibility option to either show all documents to the recipient or just selected once:

Code Block

language	java
theme	Eclipse
title	Visibility option

 "VisibilityOptions": [
  },
          "Size": {
            "Width": 0,
            "Height": 0
          }
        },
        "TaskConfiguration": {
          "DocumentNumberOrderDefinition": 0,{
            "IsHiddenOrderIndex": true0
          }
      ]

Those actions include the recipients of the envelope as well as the tasks for those recipients (signing, viewing etc.)

One action can either include one of the following tasks:

Automatic signing
Signing
Document viewing
P7M signing

Lets have a detailed look into the signing task.

The signing task includes the following information:

Recipient configuration
- Contact information
Personal message (optional)
Authentication
- Access code
- SMS OTP
- Swedish bankId
- OAuth
- SAML
Elements
- same elements available as documented in the section "unassigned elements"
Policy configuration
Signature data configuration
Batch configuration

Recipient configuration

  }
      }
    ],

Page read confirmation

Code Block

language	java
theme	Eclipse
title	Recipient configurationPage read confirmation

"RecipientConfigurationPageReadConfirmations": {
       [
     "ContactInformation": {
              "EmailElementId": "string",
          "Required": true,
        "GivenNameDocumentNumber": "string"0,
        "DisplayName": "string",
        "SurnamePageNumber": "string"0,
        "TaskConfiguration": {
          "PhoneNumberOrderDefinition": "string",{
              "LanguageCodeOrderIndex": "AF"0
          }
  },

Personal message

Code Block

language	java
theme	Eclipse
title	Personal message

 "PersonalMessage": "string",

Authentication

Code Block

language	java
theme	Eclipse
title	Authentication

 "AuthenticationConfiguration": {

Within this section you can place the different authentication methods:

...

      }
      }
    ],

Document read confirmation

Code Block

language	java
theme	Eclipse
title	Access codeDocument read confirmation

 "AccessCodeDocumentConfirmationReadConfirmation": {
      "ElementId": "string",
         "Code"Required": true,
      "DisplayName": "string",
      "TaskConfiguration": {
       },

SMS-OTP

Code Block

language	java
theme	Eclipse
title	SMS-OTP

 "SmsOneTimePasswordOrderDefinition": {
          "OrderIndex": 0
     "PhoneNumber": "string"
  }
      }
      },

...

Activities

This is the main part of the envelope configuration. The section activities can include one to many actions.

Action

Please note that additionally to the elements below you can add a visibility option to either show all documents to the recipient or just selected once:

Code Block

language	java
theme	Eclipse
title	Swedish Bank IdVisibility option

 "SwedishBankIdVisibilityOptions": {[
        {
          "PersonalNumberDocumentNumber": "string"0,
                "AllowAnyPersonalNumberIsHidden": true
        }
      },

OAuth2

Those actions include the recipients of the envelope as well as the tasks for those recipients (signing, viewing etc.)

One action can either include one of the following tasks:

Automatic signing
Document viewing
P7M signing
Signing

Automatic signing

Please see the following sample for an automatic signing action:

Code Block

language

Code Block

language	java
theme	Eclipse
title	OAuth2

  "OAuthAuthentications{
	"Documents": [
                {
                  "ProviderName": "string",
                  "Validations": [
                    {
                      "FieldReferenceId": "string",
                      "ExpectedValue": "string"
                    }
                  ]
                }
              ],

SAML

Code Block

language	java
theme	Eclipse
title	SAML

 "SamlAuthentications": [
                {
                  "ProviderName": "string",
                  "Validations": [
                    {
                      "FieldReferenceId": "string",
                      "ExpectedValue": "string"
                    }
                  ]
                }
              ]

Additionally to the those configuration referring the recipient also following settings are available. This setting include to disable the email and allowing the recipient to access the envelope again after it has been completed and closed. Furthermore, it is possible to include app links in the email and allowing delegation:

Code Block

language	java
theme	Eclipse
title	Additional recipient configuration

"DisableEmail": true,
            "AllowAccessAfterFinish": true,
            "IncludedEmailAppLinks": {
              "Android": true,
              "iOS": true,
              "Windows": true
            },
            "AllowDelegation": true

Elements

In this section you can add elements for the recipient which (if they are set required) must be finished in order to finish the envelope.

PDF Forms

Textbox

		{
			"FileId": "1234ddc4-1234-1234-1234-3af31c131234",
			"DocumentNumber": 1
		}
	],
	"Name": "Test.pdf",
	"AddDocumentTimestamp": false,
	"ShareWithTeam": true,
	"LockFormFieldsOnFinish": false,
	"Activities": [
		{
			"Action": {
				"SignAutomatic": {
					"ProfileId": "12347562-1234-1234-1234-5a43184d1234",
					"RenderingLanguageCode": "EN",
					"VisibleSignatures": [
						{
							"DocumentNumber": 1,
							"UseExternalTimestampServer": false,
							"FieldDefinition": {
								"Position": {
									"PageNumber": 1,
									"X": 68.0,
									"Y": 631.8
								},
								"Size": {
									"Width": 190.0,
									"Height": 80.0
								}
							}
						}
					]
				}
			},
			"VisibilityOptions": [
				{
					"DocumentNumber": 1,
					"IsHidden": false
				}
			]
		}
	],
	"EmailConfiguration": {
		"Subject": "Please sign the enclosed envelope",
		"Message": "Dear #RecipientFirstName# #RecipientLastName#

#PersonalMessage#

Please sign the envelope #EnvelopeName#

Envelope will expire at #ExpirationDate#"
	},
	"ReminderConfiguration": {
		"Enabled": true,
		"FirstReminderInDays": 5,
		"ReminderResendIntervalInDays": 3,
		"BeforeExpirationInDays": 3
	},
	"ExpirationConfiguration": {
		"ExpirationInSecondsAfterSending": 2419200
	}
}

Document viewing

Please see the following sample for a document viewing action:

Code Block

language	java
theme	Eclipse

{
	"Documents": [
		{
			"FileId": "264addc4-1234-1234-1234-3af31c13b3c2",
			"DocumentNumber": 1
		}
	],
	"Name": "Test.pdf",
	"AddDocumentTimestamp": false,
	"ShareWithTeam": true,
	"LockFormFieldsOnFinish": false,
	"Activities": [
		{
			"Action": {
				"View": {
					"RecipientConfiguration": {
						"ContactInformation": {
							"Email": "john.doe@sample.com",
							"GivenName": "John",
							"Surname": "Doe",
							"LanguageCode": "EN"
						},
						"SendEmails": true,
						"AllowAccessAfterFinish": true
					},
					"ViewingGroup": "1"
				}
			},
			"VisibilityOptions": [
				{
					"DocumentNumber": 1,
					"IsHidden": false
				}
			]
		},
		{
			"Action": {
				"SendCopy": {
					"RecipientConfiguration": {
						"ContactInformation": {
							"Email": "jane.doe@sample.com",
							"GivenName": "Jane",
							"Surname": "Doe",
							"LanguageCode": "EN"
						}
					},
					"CopyingGroup": "2"
				}
			},
			"VisibilityOptions": [
				{
					"DocumentNumber": 1,
					"IsHidden": false
				}
			]
		}
	],
	"EmailConfiguration": {
		"Subject": "Please sign the enclosed envelope",
		"Message": "Dear #RecipientFirstName# #RecipientLastName#

#PersonalMessage#

Please sign the envelope #EnvelopeName#

Envelope will expire at #ExpirationDate#"
	},
	"ReminderConfiguration": {
		"Enabled": true,
		"FirstReminderInDays": 5,
		"ReminderResendIntervalInDays": 3,
		"BeforeExpirationInDays": 3
	},
	"ExpirationConfiguration": {
		"ExpirationInSecondsAfterSending": 2419200
	}
}

P7M signing

Please see the following sample for a P7M signing action (for more information please also see Using P7M (PKCS7) signature type):

Code Block

language	java
theme	Eclipse

{
    "Documents": [
        {

Code Block

language	java
theme	Eclipse
title	Textbox

 "TextBoxes": [
              {
                "ElementId": "string",
                "Required": true,
                "Value": "string",
                "DocumentNumber": 0,
                "Validation": {
                  "Type": "None",
                  "DateValidationConfiguration": {
                    "Format": "string",
                    "Range": {
                      "From": "string",
                      "To": "string"
                    }
                  },
                  "NumberValidationConfiguration": {
                    "DecimalDigits": 0,
                    "Symbol": "string",
                    "SymbolLocation": "Start",
                    "GroupSeparator": "Comma",
                    "DecimalSeparator": "Comma",
                    "Range": {
                      "From": "string",
                      "To": "string"
                    }
                  }"FileId": "a33f6f7d-1234-1234-1234-42cfbc3cad08",
                  "PhoneValidationConfiguration"DocumentNumber": {1
        }
    ],
    "Name": "test",
    "TypeActivities": "International"[
        {
          },
    "Action": {
                "TimeValidationConfigurationSignAsP7M": {
                    "FormatRecipientConfiguration": "string",
{
                        "RangeContactInformation": {
                      "From      "Email": "stringjohn.doe@sample.com",
                            "ToGivenName": "stringJohn",
                    }
        "Surname": "Doe",
         }
                },
     "LanguageCode": "EN"
          "FieldDefinition": {
             },
     "ReadOnly": true,
                  "MaxLengthSendEmails": 0,true
                   "IsMultiline": true},
                    "IsPasswordSignatureMethods": true,{
                  "IsFileSelect      "LocalCertificate": truefalse,
                        "IsScrollAllowedDisposableCertificate": true,{
                  "IsCombined": true,
         "DocumentIssuingCountry": "AT",
        "TextFormat": {
                    "TextColorIdentificationIssuingCountry": "stringAT",
                            "FontSizeInPtIdentificationType": 0"DrivingLicense",
                            "FontNamePhoneNumber": "string+##PhoneNumber##",
                    "Bold": true,
        "DocumentType": "DriverLicense",
             "Italic": true,
                    "TextAlignDocumentIssuedBy": "Left##Issuer##",
                  },
          "DocumentIssuedOn": "2023-02-15",
       "Position": {
                    "PageNumberDocumentExpiryDate": 0"2023-02-28",
                            "XSerialNumber": 0"##SerialNumber##",
                    "Y": 0
       "DocumentNumber": "123"
          },
                  "Size": {}
                    "Width": 0},
                    "HeightSignAsP7MGroup": 0"1"
                  }
                },
                "TaskConfiguration": {}
                  "GroupedOrderDefinition": {
 ]
}

Signing

Lets have a detailed look into the signing task.

The signing task includes the following information:

Recipient configuration
- Contact information
Personal message (optional)
Authentication
- Access code
- SMS OTP
- Swedish bankId
- OAuth
- SAML
Elements
- same elements available as documented in the section "unassigned elements"
Signature data configuration
Batch configuration

Recipient configuration

Code Block

language	java
theme	Eclipse
title	Recipient configuration

"RecipientConfiguration": {
            "ContactInformation": {
      "GroupId        "Email": "string",
                    "OrderIndexGivenName": 0"string",
                  }"Surname": "string",
              "PhoneNumber": "string",
 }
              }"LanguageCode": "AF"
            ]},

...

Personal message

Code Block

language	java
theme	Eclipse
title	CheckboxPersonal message

 "CheckBoxesPersonalMessage": [
             "string",

Authentication

Code Block

language	java
theme	Eclipse
title	Authentication

 "AuthenticationConfiguration": {

Within this section you can place the different authentication methods:

Access code

Code Block

language	java
theme	Eclipse
title	Access code

 "AccessCode": {
                "ElementIdCode": "string",
              },

SMS-OTP

Code Block

language	java
theme	Eclipse
title	SMS-OTP

 "SmsOneTimePassword  "RequiredEvalPolicy": "None",{
                "DocumentNumberPhoneNumber": 0,"string"
              },

Swedish Bank Id

Code Block

language	java
theme	Eclipse
title	Swedish Bank Id

 "SwedishBankId  "Required": true,{
                "IsCheckedPersonalNumber": true"string",
                "FieldDefinitionAllowAnyPersonalNumber": {true
              },

OAuth2

Code Block

language	java
theme	Eclipse
title	OAuth2

  "OAuthAuthentications": [
    "ExportValue": "string",
                  "Position": {
                    "PageNumberProviderName": 0"string",
                    "XValidations": 0,[
                    "Y": 0
{
                       }"FieldReferenceId": "string",
                      "SizeExpectedValue": {"string"
                    "Width": 0,}
                    "Height": 0]
                  },
              ],

SAML

Code Block

language	java
theme	Eclipse
title	SAML

 "SamlAuthentications    "ReadOnly": true[
                },{
                  "TaskConfigurationProviderName": {"string",
                  "GroupedOrderDefinitionValidations": {[
                    "GroupId": "string",
{
                      "OrderIndexFieldReferenceId": 0"string",
                  }
    "ExpectedValue": "string"
           }
         }
      }
            ],

Combobox

Code Block

language	java
theme	Eclipse
title	Combobox

 "ComboBoxes": [

                {}
                "ElementId": "string"]

Additionally to the those configuration referring the recipient also following settings are available. This setting include to disable the email and allowing the recipient to access the envelope again after it has been completed and closed. Furthermore, it is possible to include app links in the email and allowing delegation:

Code Block

language	java
theme	Eclipse
title	Additional recipient configuration

"DisableEmail": true,
                "DocumentNumberAllowAccessAfterFinish": 0true,
                "RequiredIncludedEmailAppLinks": true,{
                "ValueAndroid": "string"true,
                "FieldDefinitioniOS": {true,
                  "TextFormatWindows": {true
            },
            "AllowDelegation": true

Elements

In this section you can add elements for the recipient which (if they are set required) must be finished in order to finish the envelope.

PDF Forms

Textbox

Code Block

language	java
theme	Eclipse
title	Textbox

 "TextBoxes": [
        TextColor": "string",
      {
                "FontSizeInPtElementId": 0"string",
                "Required": true,
   "FontName             "Value": "string",
                    "BoldDocumentNumber": true0,
                    "ItalicValidation": true,{
                    "TextAlignType": "LeftNone",
                   },
"DateValidationConfiguration": {
                    "ItemsFormat": ["string",
                    "Range": {
                      "ExportValueFrom": "string",
                      "DisplayValueTo": "string"
                    }
                  ]},
                  "IsEditableNumberValidationConfiguration": true,{
                    "ReadOnlyDecimalDigits": true0,
                    "PositionSymbol": {"string",
                    "PageNumberSymbolLocation": 0"Start",
                    "XGroupSeparator": 0"Comma",
                    "YDecimalSeparator": 0
            "Comma",
      },
                  "SizeRange": {
                      "WidthFrom": 0"string",
                      "HeightTo": 0"string"
                    }
                  },
                  "TaskConfigurationPhoneValidationConfiguration": {
                    "GroupedOrderDefinitionType": {"International"
                    "GroupId": "string"},
                    "OrderIndexTimeValidationConfiguration": 0{
                  }  "Format": "string",
                }
    "Range": {
         }
            ],

Radio button

Code Block

language	java
theme	Eclipse
title	Radio button

 "RadioButtonsFrom": ["string",
               {
       "To": "string"
        "GroupName": "string",
           }
     "DocumentNumber": 0,
                "IsSelectUnison": true,}
                "ToggleToOff": true},
                "RequiredFieldDefinition": true,{
                  "SelectedItemReadOnly": "string"true,
                  "FieldDefinitionsMaxLength": [0,
                  {
  "IsMultiline": true,
                  "ExportValueIsPassword": "string"true,
                    "IsCheckedIsFileSelect": true,
                    "CheckBoxAppearanceIsScrollAllowed": true,
                    "ReadOnlyIsCombined": true,
                    "PositionTextFormat": {
                      "PageNumberTextColor": 0"string",
                      "XFontSizeInPt": 0,
                      "YFontName": 0"string",
                    "Bold": }true,
                    "SizeItalic": {true,
                      "WidthTextAlign": 0,"Left"
                      "Height": 0},
                    }"Position": {
                  }
  "PageNumber": 0,
             ],
       "X": 0,
        "GroupTaskConfiguration            "Y": {0
                  "GroupedOrderDefinition": {
  },
                  "GroupIdSize": "string",{
                    "OrderIndexWidth": 0,
                    }"Height": 0
                  }
                },
              ],

Listbox

Code Block

language	java
theme	Eclipse
title	Listbox

  "ListBoxesTaskConfiguration": [{
                  "GroupedOrderDefinition": {
                    "ElementIdGroupId": "string",
                    "DocumentNumberOrderIndex": 0,
                "Required": true,  }
                "PreSelectedItems": [}
                  "string"
  }
              ],

Checkbox

Code Block

language	java
theme	Eclipse
title	Checkbox

"CheckBoxes": [
                "FieldDefinition": {
                  "TextFormatElementId": {"string",
                    "TextColorRequiredEvalPolicy": "stringNone",
                    "FontSizeInPtDocumentNumber": 0,
                    "FontNameRequired": "string"true,
                    "BoldIsChecked": true,
                    "ItalicFieldDefinition": true,{
                    "TextAlignExportValue": "Leftstring",
                  }, "Position": {
                    "ItemsPageNumber": [0,
                    {
   "X": 0,
                    "ExportValueY": "string",0
                  },
    "DisplayValue": "string"
             "Size": {
      }
              "Width": 0,
   ],
                  "IsMultiSelectHeight": true,0
                  "ReadOnly": true},
                  "PositionReadOnly": {true
                    "PageNumber": 0},
                    "XTaskConfiguration": 0,{
                    "YGroupedOrderDefinition": 0{
                  },
                  "Size": {"GroupId": "string",
                    "WidthOrderIndex": 0,
                    "Height": 0
  }
                }
                },
            ],

Combobox

Code Block

language	java
theme	Eclipse
title	Combobox

 "ComboBoxes    "TaskConfiguration": {[
                  "GroupedOrderDefinition": {
                    "GroupIdElementId": "string",
                    "OrderIndexDocumentNumber": 0,
                "Required": true,
 }
                }"Value": "string",
              }
  "FieldDefinition": {
         ],

Signatures

Code Block

language	java
theme	Eclipse
title	Signature information

"Signatures": [
        "TextFormat": {
     {
                "IdTextColor": "string",
                    "RequiredFontSizeInPt": true0,
                    "DocumentNumberFontName": 0"string",
                    "DisplayNameBold": "string"true,
                    "FieldDescriptionItalic": "string"true,
 				"AllowedSignatureTypes": {

Before you add the signatures please add the following in the section "Signatures" . [ in order to set the order of the recipients (required) and to set the timestamp (optional):

Code Block

language	java
theme	Eclipse
title	TaskConfiguration

"TaskConfiguration": {
                  "StampImprintDateConfigurationTextAlign": {"Left"
                    "UseLocalTimezone": true},
                    "DateTimeFormatItems": "string"[
                   }, {
                      "UseExternalTimestampServerExportValue": true"string",
                      "BatchIdDisplayValue": "string",
                  "OrderDefinition": {  }
                  ],
  "OrderIndex": 0
               "IsEditable": true,
  }
                }

In the "AllowedSignatureTypes" you can place the following available signature types:

"FieldDefinition": {

"ReadOnly": true,
                  "Position": {
                    "PageNumber": 0,
                    "X": 0,
                    "Y": 0
                  },
                  "Size": {
                    "Width": 0,
                    "Height": 0
                  }
                },

Info

Code Block

language	java
theme	Eclipse
title	ClickToSign

Please note: The following configurations for the signature types do not include the field definition. Please add the following code to the choosen signature type in order to place the signature field on the document.

Code Block

language	java
title	Field definition

ClickToSign

"ClickToSign": {
                    "UseExternalSignatureImageTaskConfiguration": "Optional",{
                    "PreferredGroupedOrderDefinition": true,{
                    "StampImprintConfigurationGroupId": {"string",
                      "DisplayExtraInformationOrderIndex": true,0
                      "DisplayEmail": true,}
                }
      "DisplayTransactionId": true,
       }
               "DisplayTransactionToken],

Radio button

Code Block

language	java
theme	Eclipse
title	Radio button

 "RadioButtons": true,[
                      "DisplayPhoneNumber": true,
      {
                "UseCustomStampImprintGroupName": true"string",
                      "DisplayIp"DocumentNumber": true0,
                      "DisplayName"IsSelectUnison": true,
                      "DisplaySignatureDateRequired": true,
                      "FontNameSelectedItem": "string",
                      "FontSizeInPtFieldDefinitions": 0[
                  {
  }
                  },

DrawToSign

Code Block

language	java
theme	Eclipse
title	DrawToSign

 "DrawToSign"ExportValue": {"string",
                    "UseExternalSignatureImageIsChecked": "Optional"true,
                    "PreferredCheckBoxAppearance": true,
                    "StampImprintConfigurationReadOnly": {true,
                      "DisplayExtraInformationPosition": true,{
                      "DisplayEmailPageNumber": true0,
                      "DisplayTransactionIdX": true0,
                      "DisplayTransactionTokenY": true,0
                    },
  "DisplayPhoneNumber": true,
                        "UseCustomStampImprint"Size": true,{
                      "DisplayIpWidth": true0,
                      "DisplayNameHeight": true,0
                    }
    "DisplaySignatureDate": true,
             }
         "FontName": "string",
      ],
                "FontSizeInPtGroupTaskConfiguration": 0{
                  "GroupedOrderDefinition": {
 }
                  },

TypeToSign

Code Block

language	java
theme	Eclipse
title	TypeToSign

 "TypeToSignGroupId": {"string",
                    "UseExternalSignatureImageOrderIndex": "Optional",0
                    "Preferred": true,}
                }
    "StampImprintConfiguration": {
         }
            ],

Listbox

Code Block

language	java
theme	Eclipse
title	Listbox

 "DisplayExtraInformationListBoxes": true,[
              {
          "DisplayEmail": true,
     "ElementId": "string",
                "DisplayTransactionIdDocumentNumber": true0,
                      "DisplayTransactionTokenRequired": true,
                      "DisplayPhoneNumber"PreSelectedItems": true,[
                      "UseCustomStampImprintstring": true,
                      "DisplayIp": true],
                      "DisplayNameFieldDefinition": true,{
                      "DisplaySignatureDateTextFormat": true,{
                      "FontNameTextColor": "string",
                      "FontSizeInPt": 0,
                     }"FontName": "string",
                  },

LocalCertificate

Code Block

language	java
theme	Eclipse
title	LocalCertificate

  "LocalCertificateBold": {true,
                    "EnforcePreferredHashAlgorithmItalic": true,
                    "PreferredHashAlgorithmTextAlign": "Sha256Left",
                    "UseExternalSignatureImage": "Optional"},
                    "PreferredItems": true,[
                    "StampImprintConfiguration": {
                      "DisplayExtraInformationExportValue": true"string",
                      "DisplayEmailDisplayValue": true,"string"
                    }
  "DisplayTransactionId": true,
                ],
        "DisplayTransactionToken          "IsMultiSelect": true,
                      "DisplayPhoneNumberReadOnly": true,
                      "UseCustomStampImprintPosition": true,{
                      "DisplayIpPageNumber": true0,
                      "DisplayNameX": true0,
                      "DisplaySignatureDateY": true,0
                  },
    "FontName              "Size": "string",
  {
                    "FontSizeInPtWidth": 0,
                    "Height": }0
                  },

DisposableCertificate

Code Block

language	java
theme	Eclipse
title	DisposableCertificate

"DisposableCertificate": {

                },
                "IsLongLivedTaskConfiguration": false,{
                    "ValidityInSecondsGroupedOrderDefinition": 0,{
                    "UseExternalSignatureImageGroupId": "Optionalstring",
                    "PreferredOrderIndex": true,0
                    "StampImprintConfiguration": {}
                }
      "DisplayExtraInformation": true,
       }
               "DisplayEmail],

Signatures

Code Block

language	java
theme	Eclipse
title	Signature information

"Signatures": true,[
              {
          "DisplayTransactionId": true,
     "ElementId": "string",
                "DisplayTransactionTokenRequired": true,
                      "DisplayPhoneNumber"DocumentNumber": true0,
                      "UseCustomStampImprint"DisplayName": true"string",
                      "DisplayIpFieldDescription": true"string",
 				"AllowedSignatureTypes": {

Before you add the signatures please add the following in the section "Signatures" . [ in order to set the order of the recipients (required) and to set the timestamp (optional):

Code Block

language	java
theme	Eclipse
title	TaskConfiguration

"TaskConfiguration": {
                    "DisplayNameStampImprintDateConfiguration": true,{
                      "DisplaySignatureDateUseLocalTimezone": true,
                    "DateTimeFormat": "string"
                  },
                 "FontName "UseExternalTimestampServer": true,
                  "BatchId": "string",
                  "OrderDefinition": {
     "FontSizeInPt               "OrderIndex": 0
                    }
                  },

DisposableCertificate (Long-Lived)

Beside the disposable certificate, the solution can use a specific procedure called "Long-Lived Disposable" for scenarios where the signature becomes a valid qualified signature after signing. This can be useful where the identification is confirmed/approved after signing of the document.

Info
Please note the following: It is not allowed to download the document or the audit trail for a long-lived disposable. Therefore, the policies must be set correctly (<AllowSaveDocument>0</AllowSaveDocument> and <AllowSaveAuditTrail>0</AllowSaveAuditTrail>)

General description

The Long-Lived Disposable Certificate (LLD) is a special variant of a Disposable certificate.

The main difference to the disposable certificate is, that it is not being activated immediately, but after the signatures have been applied. LLD are always active, no need to activate them.

...

In the "AllowedSignatureTypes" you can place the following available signature types:

theme

Info

Please note: The following configurations for the signature types do not include the field definition. Please add the following code to the choosen signature type in order to place the signature field on the document.

Code Block

language	java

title

Eclipse

title

DisposableCertificate (Long-Lived)

Field definition

"FieldDefinition": {
                  "Position": {
                    "PageNumber": 0,
                    "X": 0,
                    "Y": 0
                  },
                  "Size": {
                    "Width": 0,
                    "Height": 0
                  }
                },

ClickToSign

Code Block

language	java
theme	Eclipse
title	ClickToSign

"ClickToSign": {
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

DrawToSign

Code Block

language	java
theme	Eclipse
title	DrawToSign

 "DrawToSign": {
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

TypeToSign

Code Block

language	java
theme	Eclipse
title	TypeToSign

 "TypeToSign": {
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

LocalCertificate

Code Block

language	java
theme	Eclipse
title	LocalCertificate

 "LocalCertificate": {
                    "EnforcePreferredHashAlgorithm": true,
                    "PreferredHashAlgorithm": "Sha256",
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

DisposableCertificate

Code Block

language	java
theme	Eclipse
title	DisposableCertificate

"DisposableCertificate": {
                    "IsLongLived": false,
                    "ValidityInSeconds": 0,
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

DisposableCertificate (Long-Lived)

Beside the disposable certificate, the solution can use a specific procedure called "Long-Lived Disposable" for scenarios where the signature becomes a valid qualified signature after signing. This can be useful where the identification is confirmed/approved after signing of the document.

Info
Please note the following: It is not allowed to download the document or the audit trail for a long-lived disposable. Therefore, the policies must be set correctly (<AllowSaveDocument>0</AllowSaveDocument> and <AllowSaveAuditTrail>0</AllowSaveAuditTrail>)

General description

The Long-Lived Disposable Certificate (LLD) is a special variant of a Disposable certificate.

The main difference to the disposable certificate is, that it is not being activated immediately, but after the signatures have been applied. LLD are always active, no need to activate them.

Please see the following sample configuration for LLD:

Code Block

language	java
theme	Eclipse
title	DisposableCertificate (Long-Lived)

"DisposableCertificate": {
                    "IsLongLived": true,
                    "ValidityInSeconds": 0,
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string","DisposableCertificate": {
                      "IsLongLivedFontSizeInPt": true,
  0
                    }
                  "ValidityInSeconds},

SwissComOnDemand

Code Block

language	java
theme	Eclipse
title	SwissComOnDemand

"SwissComOnDemand": 0,{
                    "UseExternalSignatureImageValidityInSeconds": "Optional"0,
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

...

ATrustCertificate

Code Block

language	java
theme	Eclipse
title	SwissComOnDemand	ATrustCertificate

 "ATrustCertificate": {
                    "TemplateId": "string",
                    "Preferred": true,
                    "StampImprintConfiguration"SwissComOnDemand": {
                      "ValidityInSecondsDisplayExtraInformation": 0true,
                      "PreferredDisplayEmail": true,
                      "StampImprintConfigurationDisplayTransactionId": {true,
                      "DisplayExtraInformationDisplayTransactionToken": true,
                      "DisplayEmailDisplayPhoneNumber": true,
                      "DisplayTransactionIdUseCustomStampImprint": true,
                      "DisplayTransactionTokenDisplayIp": true,
                      "DisplayPhoneNumberDisplayName": true,
                      "UseCustomStampImprintDisplaySignatureDate": true,
                      "DisplayIpFontName": true"string",
                      "DisplayNameFontSizeInPt": true,0
                      "DisplaySignatureDate": true, }
                  },

Biometric

Please note the following available values for the "SignaturePositioning":

Value	Description
intersects with field	The signing must intersect with the field but the signer is allowed to leave the boundaries of the signature field
within field	The signature must be completely within the boundaries of the signature field
on page	The signature can start anywhere on the page, even without intersecting with the signature field

Code Block

language	java
theme	Eclipse
title	Biometric

"Biometric": {
                      "FontNameBiometricVerification": "string"true,
                      "FontSizeInPtAllowBiometricStoringOnly": 0
                    }
true,
                    },

ATrustCertificate

Code Block

language	java
theme	Eclipse
title	ATrustCertificate

 "ATrustCertificate"StoreSignedResponseWithoutBioData": {true,
                    "TemplateIdAllowSkipBiometricVerification": "string"true,
                    "PreferredBiometricServerUserId": true"string",
                    "StampImprintConfigurationSignaturePositioning": {
                      "DisplayExtraInformation": true"WithinField",
                      "DisplayEmailPreferred": true,
                      "DisplayTransactionIdStampImprintConfiguration": true,{
                      "DisplayTransactionTokenDisplayExtraInformation": true,
                      "DisplayPhoneNumberDisplayEmail": true,
                      "UseCustomStampImprintDisplayTransactionId": true,
                      "DisplayIpDisplayTransactionToken": true,
                      "DisplayNameDisplayPhoneNumber": true,
                      "DisplaySignatureDateUseCustomStampImprint": true,
                      "FontNameDisplayIp": "string"true,
                      "FontSizeInPt": 0
               DisplayName": true,
     }
                  },

Biometric

Please note the following available values for the "SignaturePositioning":

...

Code Block

language	java
theme	Eclipse
title	Biometric

"Biometric": {
"DisplaySignatureDate": true,
                      "BiometricVerificationFontName": true"string",
                      "AllowBiometricStoringOnlyFontSizeInPt": true,0
                    "StoreSignedResponseWithoutBioData": true,}
                  },

RemoteCertificate

Code Block

language	java
theme	Eclipse
title	RemoteCertificate

"RemoteCertificate  "AllowSkipBiometricVerification": true,{
                    "BiometricServerUserIdValidityInSeconds": "string"0,
                    "SignaturePositioningUseExternalSignatureImage": "WithinFieldOptional",
                    "Preferred": true,
                    "StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "DisplayPhoneNumber": true,
                      "UseCustomStampImprint": true,
                      "DisplayIp": true,
                      "DisplayName": true,
                      "DisplaySignatureDate": true,
                      "FontName": "string",
                      "FontSizeInPt": 0
                    }
                  },

...

OneTimePassword

Code Block

language	java
theme	Eclipse
title	RemoteCertificateOneTimePassword

"RemoteCertificateOneTimePassword": {
                    "ValidityInSeconds": 0,
                    "UseExternalSignatureImage": "Optional",
                    "Preferred": true,
                    "Preferred"StampImprintConfiguration": {
                      "DisplayExtraInformation": true,
                      "DisplayEmail": true,
                      "DisplayTransactionId": true,
                      "DisplayTransactionToken": true,
                      "StampImprintConfigurationDisplayPhoneNumber": {true,
                      "DisplayExtraInformationUseCustomStampImprint": true,
                      "DisplayEmailDisplayIp": true,
                      "DisplayTransactionIdDisplayName": true,
                      "DisplayTransactionTokenDisplaySignatureDate": true,
                      "DisplayPhoneNumberFontName": true"string",
                      "UseCustomStampImprintFontSizeInPt": true,0
                      "DisplayIp": true,}
                      "DisplayName},

SwedishBankId

Code Block

language	java
theme	Eclipse
title	SwedishBankId

 "SwedishBankId": true,{
                      "DisplaySignatureDatePreferred": true,
                      "FontNameStampImprintConfiguration": "string",{
                      "FontSizeInPtDisplayExtraInformation": 0true,
                    }  "DisplayEmail": true,
                  },

OneTimePassword

Code Block

language	java
theme	Eclipse
title	OneTimePassword

"OneTimePassword    "DisplayTransactionId": {true,
                      "ValidityInSecondsDisplayTransactionToken": 0true,
                      "UseExternalSignatureImageDisplayPhoneNumber": "Optional"true,
                      "PreferredUseCustomStampImprint": true,
                      "StampImprintConfigurationDisplayIp": {true,
                      "DisplayExtraInformationDisplayName": true,
                      "DisplayEmailDisplaySignatureDate": true,
                      "DisplayTransactionIdFontName": true"string",
                      "DisplayTransactionTokenFontSizeInPt": true,0
                      "DisplayPhoneNumber": true, }
                  },

SignaturePlugins

Code Block

language	java
theme	Eclipse
title	SignaturePlugins

"SignaturePlugins    "UseCustomStampImprint": true,[
                      "DisplayIp": true,{
                      "DisplayNamePluginId": true"string",
                      "DisplaySignatureDatePreferred": true,
                      "FontNameStampImprintConfiguration": "string",{
                        "FontSizeInPtDisplayExtraInformation": 0
true,
                         }"DisplayEmail": true,
                  },

SwedishBankId

Code Block

language	java
theme	Eclipse
title	SwedishBankId

 "SwedishBankId      "DisplayTransactionId": {true,
                        "PreferredDisplayTransactionToken": true,
                        "StampImprintConfigurationDisplayPhoneNumber": {true,
                        "DisplayExtraInformationUseCustomStampImprint": true,
                        "DisplayEmailDisplayIp": true,
                        "DisplayTransactionIdDisplayName": true,
                        "DisplayTransactionTokenDisplaySignatureDate": true,
                        "DisplayPhoneNumberFontName": true"string",
                        "UseCustomStampImprintFontSizeInPt": true,
0
                      }
    "DisplayIp": true,
               }
       "DisplayName": true,
          ]

Predefined Field Elements

You can also add predefined elements to the document. Please see the following configurations:

Textfields

Code Block

language	java
theme	Eclipse
title	Textfields

"TextFields": [
           "DisplaySignatureDate": true,
    {
                  "FontNameElementId": "string",
                      "FontSizeInPtDocumentNumber": 0,
                    }"Value": "string",
                  },

SignaturePlugins

Code Block

language	java
theme	Eclipse
title	SignaturePlugins

"SignaturePlugins"FieldDefinition": [{
                    "TextFormat": {
                      "PluginIdTextColor": "string",
                      "PreferredFontSizeInPt": true0,
                      "StampImprintConfigurationFontName": {
  "string",
                      "DisplayExtraInformationBold": true,
                        "DisplayEmailItalic": true,
                        "DisplayTransactionIdTextAlign": true,
"Left"
                    },
                    "DisplayTransactionTokenPosition": true,{
                        "DisplayPhoneNumberPageNumber": true0,
                        "UseCustomStampImprintX": true0,
                        "DisplayIpY": true,0
                        "DisplayName": true},
                        "DisplaySignatureDateSize": true,{
                        "FontNameWidth": "string"0,
                        "FontSizeInPtHeight": 0
                    }
   }
               }
            }
    }
              ],

Predefined Field Elements

You can also add predefined elements to the document. Please see the following configurations:

Textfields

EmailFields

Code Block

language	java
theme	Eclipse
title	TextfieldsEmailFields

 "TextFieldsEmailFields": [
                {
                  "ElementId": "string",
                  "DocumentNumber": 0,
                  "Value": "string",
                  "FieldDefinition": {
                    "TextFormat": {
                      "TextColor": "string",
                      "FontSizeInPt": 0,
                      "FontName": "string",
                      "Bold": true,
                      "Italic": true,
                      "TextAlign": "Left"
                    },
                    "Position": {
                      "PageNumber": 0,
                      "X": 0,
                      "Y": 0
                    },
                    "Size": {
                      "Width": 0,
                      "Height": 0
                    }
                  }
                }
              ],

...

InitialsFields

Code Block

language	java
theme	Eclipse
title	EmailFieldsInitialsFields

 "EmailFieldsInitialsFields": [
                {
                   { "ElementId": "string",
                  "ElementIdDocumentNumber": "string"0,
                  "DocumentNumberIncludeMiddleNameInitials": 0true,
                  "FieldDefinition": {
                    "TextFormat": {
                      "TextColor": "string",
                      "FontSizeInPt": 0,
                      "FontName": "string",
                      "Bold": true,
                      "Italic": true,
                      "TextAlign": "Left"
                    },
                    "Position": {
                      "PageNumber": 0,
                      "X": 0,
                      "Y": 0
                    },
                    "Size": {
                      "Width": 0,
                      "Height": 0
                    }
                  }
                }
              ],

...

GivenNameFields

Code Block

language	java
theme	Eclipse
title	InitialsFieldsGivenNameFields

 "InitialsFieldsGivenNameFields": [
                {
                  "ElementId": "string",
                  "DocumentNumber": 0,
                  "IncludeMiddleNameInitials": true,
                  "FieldDefinition": {
                    "TextFormat": {
                      "TextColor": "string",
                      "FontSizeInPt": 0,
                      "FontName": "string",
                      "Bold": true,
                      "Italic": true,
                      "TextAlign": "Left"
                    },
                    "Position": {
                      "PageNumber": 0,
                      "X": 0,
                      "Y": 0
                    },
                    "Size": {
                      "Width": 0,
                      "Height": 0
                    }
                  }
                }
              ],

...

SurnameFields

Code Block

language	java
theme	Eclipse
title	GivenNameFieldsSurnameFields

 "GivenNameFieldsSurnameFields": [
                {
                  "ElementId": "string",
                  "DocumentNumber": 0,
                  "FieldDefinition": {
                    "TextFormat": {
                      "TextColor": "string",
                      "FontSizeInPt": 0,
                      "FontName": "string",
                      "Bold": true,
                      "Italic": true,
                      "TextAlign": "Left"
                    },
                    "Position": {
                      "PageNumber": 0,
                      "X": 0,
                      "Y": 0
                    },
                    "Size": {
                      "Width": 0,
                      "Height": 0
                    }
                  }
                }
              ],

...

FullNameFields

Code Block

language	java
theme	Eclipse
title	SurnameFieldsFullNameFields

"SurnameFieldsFullNameFields": [
                {
                  "ElementId": "string",
                  "DocumentNumber": 0,
                  "FieldDefinition": {
                    "TextFormat": {
                      "TextColor": "string",
                      "FontSizeInPt": 0,
                      "FontName": "string",
                      "Bold": true,
                      "Italic": true,
                      "TextAlign": "Left"
                    },
                    "Position": {
                      "PageNumber": 0,
                      "X": 0,
                      "Y": 0
                    },
                    "Size": {
                      "Width": 0,
                      "Height": 0
                    }
                  }
                }
              ],

FullNameFields

Code Block

language	java
theme	Eclipse
title	FullNameFields

"FullNameFields": [0
                {
    }
              "ElementId": "string",
   }
               "DocumentNumber": 0, }
              ],

DataFields

Code Block

language	java
theme	Eclipse
title	DataFields

 "DateFields    "FieldDefinition": {[
                    "TextFormat": {
                      "TextColorElementId": "string",
                      "FontSizeInPtDocumentNumber": 0,
                      "FontNameDateFormat": "string",
                      "BoldFieldDefinition": true,{
                      "ItalicTextFormat": true,{
                      "TextAlignTextColor": "Leftstring",
                     } "FontSizeInPt": 0,
                      "PositionFontName": {"string",
                      "PageNumberBold": 0true,
                      "XItalic": 0true,
                      "YTextAlign": 0"Left"
                    },
                    "SizePosition": {
                      "WidthPageNumber": 0,
                      "Height": 0
                    }
  "X": 0,
               }
       "Y": 0
        }
              ],

DataFields

Code Block

language	java
theme	Eclipse
title	DataFields

 "DateFields": [
},
                    "Size": {
                      "ElementIdWidth": "string"0,
                      "DocumentNumberHeight": 0,
                  "DateFormat": "string",  }
                  "FieldDefinition": {}
                }
    "TextFormat": {
         ]
            },

FinishActionConfiguration

Code Block

language	java
theme	Eclipse
title	Finish action configuration

"FinishActionConfiguration "TextColor": "string",
{
            "SignAnyWhereViewer": {
              "FontSizeInPtRedirectUri": 0,"string"
            },
            "FontNameSignificantClientSignatureCaptureForIos": "string",
        {
              "BoldRemoveDocumentFromRecentDocumentList": true,
                      "Italic"CallClientActionOnlyAfterSuccessfulSync": true,
                      "TextAlignCloseApp": "Left"true,
              "RedirectUri": "string"
     },
        },
            "PositionSignificantClientSignatureCaptureForAndroid": {
                      "PageNumber"RemoveDocumentFromRecentDocumentList": 0true,
                      "X"CallClientActionOnlyAfterSuccessfulSync": 0true,
                      "YCloseApp": 0true,
              "RedirectUri": "string"
     },
       },
             "SizeSignificantClientSignatureCaptureForWindows": {
              "RemoveDocumentFromRecentDocumentList": true,
       "Width": 0,
      "CallClientActionOnlyAfterSuccessfulSync": true,
               "HeightCloseApp": 0true,
              "RedirectUri": "string"
       }
     },
            "KioskSdk": }{
                }"RedirectUri": "string"
              ]}
            },

Additional envelope information

...

Code Block

language	java
theme	Eclipse
title	Callback configuration

 "CallbackConfiguration": {
    "CallbackUrl": "string",
    "StatusUpdateCallbackUrl": "string",
    "StepActionCallbackConfigurationActivityActionCallbackConfiguration": {
      "Url": "string",
      "ActionCallbackSelection": {
        "ConfirmTransactionCode": true,
        "DefaultEventType": true,
        "AgreementAccepted": true,
        "AgreementRejected": true,
        "RequestPrepareAuthenticationInformationSuccess": true,
        "PrepareAuthenticationSuccess": true,
        "AuthenticationFailed": true,
        "AuthenticationRejected": true,
        "AuthenticationSuccess": true,
        "ReAuthenticationFailed": true,
        "AuditTrailRequested": true,
        "AuditTrailXmlRequested": true,
        "CalledPage": true,
        "WhoIsInformation": true,
        "DocumentDownloaded": true,
        "FlattenedDocumentDownloaded": true,
        "AddedAnnotation": true,
        "AddedAttachment": true,
        "AppendedDocument": true,
        "FormsFilled": true,
        "ConfirmReading": true,
        "PageViewChanged": true,
        "SendTransactionCode": true,
        "PrepareSignWorkstepDocument": true,
        "SignWorkstepDocument": true,
        "UndoAction": true,
        "WorkstepCreated": true,
        "WorkstepFinished": true,
        "WorkstepRejected": true,
        "DisablePolicyAndValidityChecks": true,
        "EnablePolicyAndValidityChecks": true,
        "AppendFileToWorkstep": true,
        "AppendTasksToWorkstep": true,
        "SetOptionalDocumentState": true,
        "PreparePayloadForBatch": true
      }
    }
  },

...

Page tree

Page History

Versions Compared

Old Version 25

New Version Current

Key

Image RemovedImage Added

Configuration

Starting configuration

Starting configuration

Envelope configuration

Unassigned elements

Attachments

Link configuration

Envelope configuration

Unassigned elements

Attachments

Link configuration

Reading confirmationImage Removed

Area read confirmation

Page read confirmation

Reading confirmationImage Added

Area read confirmation

Activities

Action

Recipient configuration

Page read confirmation

Personal message

Authentication

Document read confirmation

SMS-OTP

Activities

Action

OAuth2

Automatic signing

SAML

Elements

PDF Forms

Textbox

Document viewing

P7M signing

Signing

Recipient configuration

Personal message

Authentication

Access code

SMS-OTP

Swedish Bank Id

OAuth2

SAML

Combobox

Elements

PDF Forms

Textbox

Radio button

Listbox

Checkbox

Combobox

Signatures

ClickToSign

Radio button

DrawToSign

TypeToSign

Listbox

LocalCertificate

DisposableCertificate

Signatures

DisposableCertificate (Long-Lived)

ClickToSign

DrawToSign

TypeToSign

LocalCertificate

DisposableCertificate

DisposableCertificate (Long-Lived)

SwissComOnDemand

ATrustCertificate

Biometric

ATrustCertificate

Biometric

RemoteCertificate