With custom signature rendering layout configuration (stamp imprint configuration), an organization administrator can define how the stamp imprint on the signature image looks like (e.g. fonts, elements, layout etc). The new functionality allows to set organization wide background images (e.g. company logos) or define specific fonts for text added to the stamp imprint. While it has no impact on the legal levels of signatures (in EU, defined by eIDAS), a customer specific stamp imprint representation can create higher subjective trust and contract awareness of your customers.

If the feature is activated for your organization you can find the setting in the organization settings. Please see the next figure:

In the section "Custom Signature Rendering Configuration" you can find the following settings:

• Upload your configuration
• Reset the signature rendering to default
• You can download the current configuration
• You can download the default template

If you download the default template (SignatureRenderingLayouts.custom.xml) you will see the following configuration:

//<?xml version="1.0" encoding="utf-8"?>
<SignatureRenderingLayoutConfiguration>
 <Colors>
 </Colors>
 <Fonts>
 </Fonts>
 <Layouts>
 </Layouts>
</SignatureRenderingLayoutConfiguration>

Please note the following before you start to customize: The customized layouts, fonts and colors defined in the configuration file will override possibly existing elements of the default configuration. Also a combination of the two variants is possible. In that case the following hierarchy will be used:

1. Customized configuration from Customization Service
2. Customized local configuration
3. Default configuration

In the next section you can find possible configuration options.

Configuration options

Colors

Supported parameters:

• Parameter "a": Alpha
• Parameter "r": Red
• Parameter "g": Green
• Parameter "b": Blue

Fonts

Supported parameters:

• Parameter "family": Font family
• Parameter "size": Size (pt)
• Parameter "bold"
• Parameter "italic"
• Parameter "underline"
• Parameter "color": The id of the referenced color

Layouts

A layout consists of 1-n layers (e.g. to support background images). There are three different layer types supported:

• Layer
• ExternalImageLayer
• ImageLayer

Supported parameters:

• Parameter "backgroundColor": The id of the referenced color

Layer

A layer consists of 1-n rows. The rows of a layer are printed in the order defined in the configuration.

Supported parameters:

• Parameter "useTotalHeight": If set, the whole image height will be used for the imprint (75 % otherwise)
• Parameter "vAlign": Vertical alignment on signature imprint image
  • top, middle, bottom

Row

A row consists of 1-n cells. Supported parameters:

• Parameter "cellWidthMode"
  • "auto" or not defined: Width will be calculated automatically like in the old rendering
    • Aligned with neighbor rows with the same setting & number of cells
  • "fit-content": Width will be as required for the content (replaces "alignHeadings" from legacy rendering)

Cells

There are several different cell types supported:

• 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)
• Firstname: The first name of the signer as specified in the receiver information
• Lastname: The last name of the signer as specified in the receiver information
• FirstnameLastname: The first name & the last name (separated by a blank) of the signer as specified in the receiver information
• LastnameFirstname: The last name & the first name (separated by a blank) of the signer as specified in the receiver information
• CertificateCommonName: The subject of the signing certificate (e.g. local certificate signing)
• Email: The email address of the signer
• DateTime/DateTimeLocal: The signing date (local timezone)
• DateTimeUtc: The signing date (UTC)
• IpAddress: The ip address of the signer
• PhoneNumber: The phone number of the signer
• TransactionId: The transaction id (e.g. SMS-OTP signing)
• TransactionToken: The transaction token (e.g. SMS-OTP signing)
• Issuer: The issuer of the signing certificate (e.g. local certificate signing)
• PersonalNumber: The personal number of the signer (e.g. BankID)
• Metadata: Custom data
  • 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
• 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

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

Supported parameters:

• Parameter "width"
  • Supported units: %
  • If set, the specified "cellWidthMode" of the row will be overruled
• Parameter "hAlign": Horizontal alignment
  • left, right, center
• Parameter "renderIfEmpty"
  • Cell will be skipped otherwise (like in old rendering)

  • Allows more flexibility (e.g. table layout with two rows and two columns, but only the first row has a heading)

To allow even more flexibility, text cells (Text, TranslatedText, TranslatedTextWithColon) support the following placeholders which refer to the according data cell and will be replaced before rendering.

• ##Signatory##
• ##Firstname##
• ##Lastname##
• ##FirstnameLastname##
• ##LastnameFirstname##
• ##CertificateCommonName##
• ##Email##
• ##IpAddress##
• ##PhoneNumber##
• ##TransactionId##
• ##TransactionToken##
• ##Issuer##
• ##PersonalNumber##

Notes:

• In case a data value is not available (e.g. no phone number set) the placeholder will be simply removed (replaced by an empty string).
• In case an unknown placeholder (e.g. ##Phone##) is configured, this one will not be replaced or removed.
• Data cells which require additional parameters (e.g. DateTime, Metadata) are not supported.

Image Layer

An image layer contains a single image only which can be positioned accordingly and might be used as a background image.

The image will not be scaled up (maximum size is the original image size)

Supported parameters:

• Content: Base64 encoded image
• 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 "with" 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: %

ExternalImageLayer

An external image layer is used to define the layer where the additional (external) image for Click2Sign / Draw2Sign / Type2Sign should be rendered. It must be defined in the layout for these three signature types.

Please also see the next sample for more information about possible configurations:

<?xml version="1.0" encoding="utf-8"?>
<SignatureRenderingLayoutConfiguration>
 <Colors>
  <Color id="black" a="255" r="0" g="0" b="0" />
  <Color id="red" a="255" r="255" g="0" b="0" />
 </Colors>
 <Fonts>
  <Font id="default" family="Arial" size="10pt" bold="0" italic="0" underline="0"
  color="black" />
  <Font id="bold" family="Arial" size="10pt" bold="1" italic="0" underline="0"
  color="black" />
  <Font id="red" family="Arial" size="12pt" bold="1" italic="1" underline="1"
  color="red"/>
 </Fonts>
 <Layouts>
  <Layout id="default">
   <ExternalImageLayer />
    <Layer>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_signatory" font="bold" />
      <Signatory font="default"/>
     </Row>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_email" font="bold" />
      <Email font="default" />
     </Row>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_datetime" font="bold" />
      <DateTimeLocal format="dd-MM-yyyy HH:mm:ss (zzz)" font="default" />
     </Row>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_ipAddress" font="bold" />
      <IpAddress font="default"/>
     </Row>
    </Layer>
 </Layout>
 <Layout id="test" defaultFor="Click2Sign" backgroundColor="white">
   <ExternalImageLayer />
    <Layer useTotalHeight="1" vAlign="bottom">
     <Row cellWidthMode="auto">
      <TranslatedTextWithColon key="lbl_stamp_signatory" font="bold"
      hAlign="right" />
      <Signatory font="default" />
     </Row>
     <Row cellWidthMode="auto">
      <TranslatedTextWithColon key="lbl_stamp_email" font="bold" hAlign="right" />
      <Email font="default" />
     </Row>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_datetime" font="bold"
       hAlign="right" />
      <DateTime format="dd-MM-yyyy HH:mm:ss (zzz)" font="default" />
     </Row>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_ipAddress" font="bold"
      hAlign="right" />
      <IpAddress font="default" renderIfEmpty="0"/>
     </Row>
      <MetadataList xPath="EnvelopeInformation/EnvelopeDocumentInformation">
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_documentName" font="bold"
      hAlign="right" />
      <Metadata xPath="." attribute="name" font="default" />
     </Row>
     <Row>
      <TranslatedTextWithColon key="lbl_stamp_pageNumbers" font="bold"
       hAlign="right" />
      <Metadata xPath="." attribute="numberOfPages" font="default" />
     </Row>
    </MetadataList>
    <Newline/>
     <Row>
      <!--Base64-->
      <Image height="100pt" hAlign="right"></Image>
     </Row>
   </Layer>
   <Layer>
   <Newline/>
    <Row>
     <Text font="red" hAlign="center" width="100">This is layer two on top.</Text>
    </Row>
   </Layer>
  </Layout>
 </Layouts>
</SignatureRenderingLayoutConfiguration>

See also the result of the configuration above: