Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Please see the following figure for more information.

FigureDescription

Designer Page OverviewImage RemovedDesigner Page OverviewImage Added

  1. Standard menu bar
    1. on the very left side, by default collapsed.
      Menu items have been explained in the first chapters of the Application Reference - WebUI.
  2. The Recipients List
  3. Form Field Elements
  4. Predefined (static value) Fields
  5. The main editor
  6. The page preview section (on the right side)
  7. Wizard Navigation Bar (bottom)

Properties Panel
to configure element properties; visible only when an element is selected and in property-editor mode.

...

There is a couple of properties which can be defined on any interactive element that can be placed on a document:

General PropertiesImage RemovedGeneral PropertiesImage Added

The assignment of an element to a recipient defines which recipient is allowed to, or must, fill an element as part of fulfilling the (signing) activity. An element can be assigned to one (or no) recipient. Only recipients of type "signer" (with or without having signature fields) are eligible in the recipients selection (with an exception - "Automatic Signing Activities" can be selected on signature fields, see below). If a field is not assigned to any recipient, only the default value will be shown to all signers (and other recipients), but nobody will be able to interact with the element or change its value. When changing the recipient using the drop down list, both the color indicator of the properties panel and the color of the element in the main panel will automatically change to the color indicator of the recipient (also visible e.g. in the recipients panel).

...

General

Advanced

  • Required
  • Read-only
    • when this property is checked the user cannot edit the value.
  • Id
    • a (technical) field identifier which is typically used when the form values should be processed automatically after signing. Its use typically depends on integration scenarios.
      The control supports copying the value directly to the browser session storage, by pressing the "copy" icon (Copy IconImage RemovedCopy IconImage Added).

    • Info

      Please note that if the Id is copied to another field it will be a "clone" of the original one. Additionally the following message will appear after assigning the Id to another field:
      Another Element with this Id has been found, all settings of it will be copied. Later changes will be applied to all elements with this Id. Do you wish to proceed?


  • New value
    • the initial value of the textfield element can be defined. This value will be shown to the recipients already before editing the value.
  • Font family
    • The font family defines which font should be used for rendering the text in the web browser, and also be used for filling form elements in the PDF. Keep in mind when working with languages that require usage of Unicode characters, that the font installed on the server must also support the entire (used) unicode charset - otherwise the entire text or some characters will be represented using replacement characters.
  • Font size, text color, text alignment
  • Multi-line
  • Password
    • the field behaves as a password field, which implies that the value entered by the recipient (or prefilled) is not readable but showing masked password input instead
  • Character limit (0= no limit)
    • Define a maximum text input length

...

  • None
  • Date
    • Format
    • Minimum value
    • Maximum value
  • Email
  • Number
    • Decimal Places
    • Symbol
    • Symbol location
    • Group Separator
    • Decimal Separator
    • Minimum value
    • Maximum value
  • Phone
    • Phone type
      • international
      • international leading zeros
      • international leading plus
  • Time
    • Format
    • Minimum value
    • Maximum value

Textfield SettingsImage RemovedTextfield SettingsImage Added

Please see the following sample for date validation:

Input validationResult

Input ValidationImage RemovedInput ValidationImage AddedInput Validation ResultImage Removed

Input Validation ResultImage Added

Signature

For information about how to sign the different signature types please have a look at the Signer Guide.

...

If the sender allows just one signature type, the signature type will be automatically selected when a recipient later-on clicks on the signature field. When allowing multiple signature types, the sender is allowing the recipient to select one of the allowed signature types. The sender can in addition define, by marking the "star" icon (Star IconImage RemovedStar IconImage Added), a preferred signature type which is then automatically preselected for the recipient.

...

  • Signature fields can be assigned also to "Automatic Signing Activities", making the automatic signatures visible on the document
  • Required
  • Custom Signature Image (feature flag necessary: "ExternalSignatureImage"
    • This allows signers to upload their picture (custom signature picture) and add it as additional graphics to the stamp imprint. Furthermore the signer can store the signature image which a gallery for later usage.
    • By enabling the "Custom Signature Image" checkbox, the sender can allow (or enforce) that the signer is uploading an additional image to be shown in the signature field. Such custom signature images can be used to ask for placing a company stamp picture, or to insert Hanko stamps. See Story: Using external signature images for additional use case details. Note that the global setting here sets and overrules the signature-type specific settings, as this property can also be defined on a per-signature-type level in the Advanced tab.
  • Batch Signature
    • With the "Batch Signature" checkbox enabled, it makes the signature field a member of a batch of several signature fields. Signatures being member of a batch can be signed all at once if the signer prefers, but allow the signer also to sign them one by one. When the batch signing option is enabled, the sender can distinguish between different batch signing behavior:

      • Simple Batch
        where the signer just knows how many signature fields are signed as part of the batch
      • Signature List (unselected)
        where a list of all signature fields (document name and page number, or signature field label) are displayed in a list of checkboxes; the user needs to select those which should be signed as part of the batch (opt-in)
      • Signature List (preselected)
        where a list of all signature fields (document name and page number, or signature field label) are displayed in a list of checkboxes; the user can deselect those which she/he doesn't want to sign as part of the batch (opt-out)
      • Signature List (selected, required mandatory)
        Like "preselected", but without an option to uncheck the "mandatory signature fields)
      • Signature List (unselected, required mandatory)
        Like "unselected", but mandators signature fields still preselected and without an option to uncheck the mandatory signature fields
    • The signature field, in the designer page's main editor, is represented by a different icon when the signature field is member of a batch:

      Signature Field in standard representationSignature Field allowing batch signing

      Signature Field Standard RepresentationImage RemovedSignature Field Standard RepresentationImage AddedSignature Field Batch SigningImage Removed

      Signature Field Batch SigningImage Added


Following options available for all signature types

...

  • DisposableCertificate
  • SwissComOnDemand
  • RemoteCertificate
  • OneTimePassword

Signature Settings OverviewImage RemovedSignature Settings OverviewImage Added

ClickToSign

Info

Please note: The additional setting for using qualified timestamp server is not available for this signature type.

There is no additional configuration (setting) needed for this signature type.

...

Info

Following feature flag is necessary: SwissComOnDemandCertificate

Before starting the envelope please see the following configurations which are needed in order to send a SwissCom On Demand Certificate.

FigureConfiguration

SwissCom Certificate SettingImage RemovedSwissCom Certificate SettingImage Added

  • Authentication certificate
  • Customer key
  • Name pattern



Info
titleName pattern

Please see the following sample name pattern (can differ in other use cases):

Please also note that the name patterns are case sensitive!

cn=TEST ##ReceiverFirstName## ##ReceiverLastName##\n##ReceiverLastName##, givenname=##ReceiverFirstName##, surname\nsurname=##ReceiverLastName##, c=##country##, emailaddress\nemailaddress=##ReceiverEmail##

If an evidenceId is needed add it to the pattern like it is shown in the next sample and enable the checkbox "Determine and set Swisscom On-Demand Certificate 'Evidence ID' automatically:

cn=TEST ##ReceiverFirstName## ##ReceiverLastName##\n##ReceiverLastName##, givenname=##ReceiverFirstName##, surname\nsurname=##ReceiverLastName##, c=##country##, emailaddress\nemailaddress=##ReceiverEmail##, serialNumber=##EvidenceId##

After setting the organization configuration you can start with the envelope. Please do not forget to add the following data which is necessary to use the SwissCom On Demand Certificate:

FigureConfiguration

SwissCom Certificate RecipientImage RemovedSwissCom Certificate RecipientImage Added

  • Mobile phone
  • Country of residence
  • Organization (optional)


...

Another option allows the sender to define that only the validation response (which includes the validation score obtained from biometric server) should be stored in the signed PDF, instead of storing the entire biometric data. In this case, the document itself does not store the data required for a forensic examination of the handwritten signature, but legal considerations may result in preferring that option, in some countries.

Biometric Signature SettingImage RemovedBiometric Signature SettingImage Added

Info

Following feature flag is necessary: BiometricSignature

For the biometric signature you can additionally configure following setting:

Biometric Signature Advanced SettingImage RemovedBiometric Signature Advanced SettingImage Added

  • positioning
    • intersects with field
    • withinField
    • onPage

...

Info

Please see the following configuration available for local certificate signature:

Figure

Configuration

Local Certificate SettingImage RemovedLocal Certificate SettingImage Added

  1. With the local certificate setting you can

    1. validate the recipient and certificate holder name

    2. enable signing certificate filter on intended use

    3. and enable the certificate root CA verification with EUTL.


...

If the user has a long lived certificate you can use the Digital Remote Signature option. You can configure the User Id and the Device Id. If not configured the signer must provide those information:

Digital Remote Signature RecipientImage RemovedDigital Remote Signature RecipientImage Added

Disposable Certificate

...

After the configuration in the organization settings you also have to fill in the disposable data for the recipient. Please see the next figure:

FigureConfiguration

Disposable Certificate RecipientImage RemovedDisposable Certificate RecipientImage Added

  • Document type
    • Identity card
    • Driver license
    • Passport
  • Document number
  • Document issued on
  • Document issued by
  • Document expiry date
  • Identification Issuing Country
  • Identification type
    • Tax Code
    • National unique number
    • Passport
    • Identity card
    • Driving license
  • Identification Number
  • Mobile phone
  • Country of residence

...

Following configuration (optional) can be set before sending the envelope with a SMS-OTP signature: You can either set the phone number for the signer or not. To set the phone number just add in the following space on the create envelope page. If you do not set the phone number, the signer has to fill in his/her phone number:

SMS OTP RecipientImage RemovedSMS OTP RecipientImage Added

Automatic Remote Signature

...

User must have enabled the option “Allow automatic eSealing” to use the automatic remote signatures / eSealing within a workflow.


Automatic Remote Signature ProfilesImage AddedAutomatic Remote Signature ProfilesImage Removed

  1. Enable automatic eSealing for the user

...

In the eSAW UI you can add an automatic signer / eSealing via button in the recipient list “Add Automatic”. Then the profile must be selected for the automatic signature / eSealing. Attention: the power user must have the right “Allow automatic eSealing” enabled (see “Settings” > “Users”).

Add Automatic Remote SignatureImage RemovedAdd Automatic Remote SignatureImage Added

  1. Add automatic

Generic Signing Plugin

...

  • Select in Unison
    • When multiple radio buttons of a group have the same export value and one of this duplicate export value is selected, all radio buttons of the group with the same export value get selected

Radio Button SettingImage RemovedRadio Button SettingImage Added

Checkbox

General
  • Required
  • Read-only
    • when this property is checked the user cannot edit the value.
  • Id
    • a (technical) field identifier which is typically used when the form values should be processed automatically after signing. Its use typically depends on integration scenarios.
      The control supports copying the value directly to the Windows clipboard, by pressing the "copy" icon.
  • Export value
    • An "export value", which is the meaning assigned to the checkbox when it is checked. Using this field might be indicated when form values should be processed automatically after signing. Its use typically depends on integration scenarios.
  • Deselected
    • The initial value of the checkbox element; while the label automatically changes between "Deselected" and "Selected" in the current implementation to reflect its current state.

...

  • Attachment icon
    • Paperclip
    • Graph
    • Pushpin
    • Tag
  • Either enable or disable to set a custom file name and if enabled enter a file name

Attachment SettingImage RemovedAttachment SettingImage Added

Read Confirmation

...

Please also see the next figure for reading confirmation just for a specific area:

Read ConfirmImage RemovedRead ConfirmImage Added

FigureDescription

Read Confirm SettingImage RemovedRead Confirm SettingImage Added

  1. Reading confirmation for the page
  2. Reading confirmation for the document

If the field is selected as required the recipient must then confirm that he/she has read the selected area.

Read Confirm AreaImage RemovedRead Confirm AreaImage Added

Please note the following general settings which are available to configure a link:

...

With the link form field it is possible to add hyperlinks to the document. This allows the recipient to just click on the link to navigate to linked pages.

Link ConfigurationImage RemovedLink ConfigurationImage Added

Predefined (static value) Fields

...

  • EmailFields
  • InitialsFields
  • GivenNameFields
  • SurnameFields
  • FullNameFields
  • DateFields
  • Static Text

Email SettingsImage RemovedEmail SettingsImage Added

The value of a predefined field will be inserted automatically at the time when the recipient, to whom a predefined field was assigned, is opening the activity. On predefined fields, only the recipient can be selected. Different to other form elements, it is not possible to set a predefined field "mandatory" as the value anyhow is filled automatically. Following predefined fields can be used:

...

  • TextBoxes
  • CheckBoxes
  • ComboBoxes
  • RadioButtons
  • ListBoxes
  • Signatures
  • Attachments
  • AreaReadConfirmations
  • PageReadConfirmations
  • Guiding OrderImage RemovedGuiding OrderImage Added

Main Editor

What-you-see-is-what-you-get (WYSIWYG) editor to place form elements, re-arrange and resize them. Elements can be added on the document by dragging them from the Elements Toolbox and placing it directly at the target location. After adding the element to the document, when moving the mouse over the element on the document, an in-place action menu up shows up:

In Place ActionImage RemovedIn Place ActionImage Added

The in-place action menu provides following actions:

...

Re-arranging elements on the page can again be done by Drag&Drop. While re-arranging elements, rulers which are automatically appearing during the re-arranging help to align controls precisely:
Arranging ElementImage RemovedArranging ElementImage Added

Elements can be resized with a Drag&Drop interaction on the lower-right corner (where it is indicated using the resize-corner icon). Note that elements that had been embedded as AcroForm Elements on the PDF cannot be resized.

...

On devices without touch capabilities, the user can open the properties panel by selecting (clicking) an element in the Main Editor area. On tablet PCs (or in general on devices with touch input), the user must click on the cogwheel icon on an element's adhoc menu to open the properties panel. The color of the property panel is indicating to which recipient an element is assigned. The recipient colors used in the recipients list, and also used for the elements in the main editor, are reflected in the colors of the properties panel. When the properties panel is open, the user can change settings, but needs to confirm or cancel the properties panel using one of the two buttons at the bottom of the properties panel, before other UI changes (e.g. arranging of elements) can be done in the UI:
Properties PanelImage Removed
Properties PanelImage Added