Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Based on open q where to find examples of e.g. Metadata, which we had just inside the big samples, added code snippets to the different options already.

...

  • Text cells
    • TranslatedText: Translated text for captions (retrieved from WSC's translation file)
      • Additional parameter "key": References the corresponding translation unit in group "SignatureImageRendering"
      • Supports placeholders (see below)
    • TranslatedTextWithColon: Translated text for captions (retrieved from WSC's translation file) followed by a colon
      • Additional parameter "key": References the corresponding translation unit in group "SignatureImageRendering"
      • Supports placeholders (see below)
    • Text: Without translation, printed as-is
      • Supports placeholders (see below)

Data cells

Signatory

...

The name of the signer or the subject of the signing certificate (e.g. local certificate signing)

...

Suggested label translation key: lbl_stamp_signatory

Example:

Code Block
<TranslatedTextWithColon key="lbl_stamp_signatory" font="bold" /> 
<Signatory font="default"/>


Firstname

The first name of the signer as specified in the receiver information

...

Example:

Code Block
<Firstname font="default"/>

Lastname

The last name of the signer as specified in the receiver information

Example:

Code Block
<Lastname font="default"/>

FirstnameLastname

...

The first name & the last name (separated by a blank) of the signer as specified in the receiver information

Example:

Code Block
<FirstnameLastname font="default"/>

LastnameFirstname

...

The last name & the first name (separated by a blank) of the signer as specified in the receiver information

...

Example:

Code Block
<LastnameFirstname font="default"/>

CertificateCommonName

The subject of the signing certificate (e.g. local certificate signing)

...

Example:

Code Block
<CertificateCommonName font="default"/>

Email

The email address of the signer

Example:

Code Block
<Email font="default"/>

DateTime/DateTimeLocal

...

The signing date (local timezone)

Example:

Code Block

...

<DateTime font="default"/>

DateTimeUtc

The signing date (UTC)

Example:

Code Block
<DateTimeUtc font="default"/>

IpAddress

...

The ip address of the signer

Example:

Code Block
<IpAddress font="default"/>

PhoneNumber

...

The phone number of the signer

...

Example:

Code Block
<PhoneNumber font="default"/>

TransactionId

The transaction id (e.g. SMS-OTP signing)

...

Example:

Code Block
<TransactionId font="default"/>

TransactionToken

The transaction token (e.g. SMS-OTP signing)

Example:

Code Block
<TransactionToken font="default"/>

Issuer

...

The issuer of the signing certificate (e.g. local certificate signing)

Example:

Code Block

...

<Issuer font="default"/>

PersonalNumber

The personal number of the signer (e.g. BankID)

Example:

Code Block
<PersonalNumber font="default"/>

Metadata

To add (typically integration specific)

...

  • Uses XPath to select one element from
    • EnvelopeInformation
    • AdditionalClientWorkstepInformation
  • Additional parameter "xPath": To reference the desired node element
  • Additional parameter "attribute" (optional): To reference the desired node's attribute
  • Will print the value of the referenced node or attribute

values contained in the metaDataXml field of the envlope.

  • Uses XPath to select one element from
      • EnvelopeInformation
      • AdditionalClientWorkstepInformation
  • Additional parameter "xPath": To reference the desired node element
  • Additional parameter "attribute" (optional): To reference the desired node's attribute
  • Will print the value of the referenced node or attribute

Example 1:

Assuming the MetaDataXml contains

Code Block
<myMetaData>
  <Name>John Doe</Name>
  <CaseId>1234567</CaseId>
</myMetaData>


Then, the following block will work in the StampImprintConfiguration:

Code Block
<Metadata xPath="./Name" font="default" />

Example 2:

Assuming the MetaDataXml contains

Code Block
<myMetaData name="John Doe">
  <CaseId>1234567</CaseId>
</myMetaData>

Then, 

Code Block
<Metadata xPath="." attribute="name" font="default" />

 Custom

...

  • Can be used to add custom data to the signature image (currently only supported when signing with a Generic Signing Plugin)
  • Additional parameter "key": To reference the desired key/value pair

Example:

Code Block
<Custom key="certholder_confirmed_name" font="default"/>

Additional cells

  • Image
    • Content: Base64 encoded image
    • Additional parameter "height": To enable adjusting the size (in relation to the text size)
      • Supported units: pt
    • Image will not be scaled up (maximum size is the original image size)
  • Newline
  • Metadatalist
    • Uses XPath to select multiple nodes from
      • EnvelopeInformation
      • AdditionalClientWorkstepInformation
    • Iterates over the elements found

...

  • Content: Base64 encoded image (mind that the implementation expects a Base64 data source (e.g. PNG) including Base64 padding)
  • Parameter "hAlign": Horizontal alignment on signature imprint image
    • left, center, right
  • Parameter "height": Used to calculate the size on the signature imprint image

    • Can only be set in case "withwidth" is not defined

    • Supported units: %


  • Parameter "width": Used to calculate the size on the signature imprint image

    • Can only be set in case "height" is not defined

    • Supported units: %

...