Input-XML - 7.Sample

1.) Sample XML with intelligent field:

Download: Placeholder.xml (for eSignatureOffice and webSignatureOffice use)

This means, the signature placement is based on a keyword inside the document. In addition to the keyword, also the size, placement and the offset needs to be set.

The beginning of the offset is on top left: X=0 / 0.

The values itself are in centimetres.

You can find more information here.

For webSignatureOffice use:

Positive numbers for the X offset move the cursor to the right, negative numbers to the left.

Positive numbers for the Y offset move the cursor to the bottom, negative numbers to the top.

This sample is using the keyword "Unterschrift Depotinhaber 1".

XML Sample

<?xml version="1.0" ?>
  <ESign>
    <Signatures>
      <Signature>
        <Placeholder>Unterschrift Depotinhaber 1</Placeholder>
        <Width>4</Width>
        <Height>3</Height>
        <DisplacementTLIndex>7</DisplacementTLIndex>
        <FeldPositionIndex>3</FeldPositionIndex>
    	<Offset_X>0</Offset_X>
        <Offset_Y>-3</Offset_Y>
        <Signed>0</Signed>
        
        <Textblock>
          <X>5</X>
          <Y>5</Y>
          <FontFace>Arial</FontFace>
          <FontSize>12</FontSize>
          <FontStyle>Bold</FontStyle>
          <Interval>110</Interval>

          <TextLine>
            <Text>Uberschrift</Text>
          </TextLine>

        </Textblock>

        <Zoom>Width</Zoom>
        <RectPosX>50</RectPosX>
        <RectPosY>80</RectPosY>

        <BeforeSignConfirmation>
          <Type>Ok</Type>
          <Text>&lt;h1&gt;Confirmation.&lt;/h1&gt;Please confirm.</Text>
        </BeforeSignConfirmation>

        <Stamp>
          <Text>Handwritten signature\r\nDigitally protected</Text>
          <Color>0x00FF0000</Color>
          <Font>Courier New</Font>
          <Size>14</Size>
        </Stamp>

        <Signer>Sales manager</Signer>
        <Reason>I agree with content</Reason>
        <Location>Headquaters</Location>
        <Background>C:\image.bmp</Background>
        <FrameColor>0x00FF00</FrameColor>
        <FrameThickness>2</FrameThickness>
      </Signature>

      <Signature>
        <Placeholder>Unterschrift Depotinhaber 2</Placeholder>
        <Width>4</Width>
        <Height>3</Height>
        <DisplacementTLIndex>7</DisplacementTLIndex>
        <FeldPositionIndex>3</FeldPositionIndex>
        <Signed>0</Signed>
        <Mandatory/>

        <Textblock>
          <X>5</X>
          <Y>13</Y>
          <FontFace>Times New Roman</FontFace>
          <FontSize>10</FontSize>
          <FontStyle>Standard</FontStyle>
          <Interval>120</Interval>

          <TextLine>
            <Text>Text on the second line.</Text>
          </TextLine>

          <TextLine>
            <Text>... and the third line.</Text>
          </TextLine>

        </Textblock>

        <Zoom>75</Zoom>
        <RectPosX>80</RectPosX>
        <RectPosY>80</RectPosY>
      </Signature>
    </Signatures>

    <FillInfo>
      <FillEntry>
        <Name>Field01</Name>
        <Value>Some value</Value>
      </FillEntry>
      <FillEntry>
        <Name>Field02</Name>
        <Value>Another value</Value>
      </FillEntry>
    </FillInfo>

    <FillInfo File="1">
      <FillEntry>
        <Name>Field03</Name>
        <Value>Not used</Value>
      </FillEntry>
    </FillInfo>

    <FillInfo File="2">
      <FillEntry>
        <Name>Field04</Name>
        <Value>Not used either</Value>
      </FillEntry>
    </FillInfo>

    <GUIMode>1</GUIMode>

    <SCSPath>C:\Data\Main.scs</SCSPath>

    <DeviceKind>naturaSignPad</DeviceKind>
    <BlindPadSearch/>

    <PublicKey1Emulation>...[Base64-encoded key or path to key file]...</PublicKey1Emulation>

    <SCS>...[Base64-encoded PDF file content]...</SCS> 
    <CorpCode>...</CorpCode>

    <Overlapped/>

    <AfterSigning>Macro4</AfterSigning>
    <AfterCancel>Nothing</AfterCancel>

    <PDF>JVB...[Base64-encoded PDF file content]...Cg==</PDF>
    <PdfNoBiodata/>

    <DisableHelpButton/>
    <DisableInfoButton/>
    <ShowDialogPrintButton/>
    <ShowFormFillButton/>
    <HideSignControlButtons/>
    <HideLcdSignButton/>

    <DeviceKeys>
      <Hash>6AB..207</Hash>
      <Hash>21F..6A2</Hash>
      <ErrorMessage>Attached device is not supported.</ErrorMessage>
    </DeviceKeys>

    <Macro1Upload>...</Macro1Upload>
    <Zoom>Width</Zoom>
    <ScrollInSignMode>
      <Autoreturn>
        <Delay>2000</Delay>
        <Speed>Instant</Speed>
      </Autoreturn>
    </ScrollInSignMode>
    <HashDialog>
      <Width>400</Width>
      <Height>200</Height>
      <Message>Please pay attention to the dialog on your signature device.\nThe checksum (DOC HASH) of your signed document is:\n\nDOCHASH: %s\n\nPlease compare this value with the value on signature device display and confirm the signature with OK.</Message>
    </HashDialog>
 
    <Found/> 
 
    <Output>
        <Format>Zip</Format>
        <Include></Include>
        <Exclude>Window,Signatures,SCSPath</Exclude>
    </Output>
 
    <DeviceDetails/>
  </ESign>

2.) Sample Signature Block by using Static Fields

Download: Static.xml (for eSignatureOffice use, also limited compatible with webSignatureOffice: some extensions are not working yet)

This sample contains the <static> tag, which uses coordinates to set signature fields. Static field properties must be defined by child tags.

Possible child tags are

<Page>, <X>, <Y> for the placement of the signature field.

<Width> / <Height> are for the size.

The beginning of the offset is on top left: X=0 / 0.

The values itself are in centimetres.

For webSignatureOffice use:

Positive numbers for the X offset move the cursor to the right, negative numbers to the left.

Positive numbers for the Y offset move the cursor to the bottom, negative numbers to the top.

Static Fields

    <Signatures>
      <Static>
        <Page>1</Page>
        <X>3.5</X>
        <Y>21.5</Y>
        <Width>4.2</Width>
        <Height>3</Height>
        <Signed>0</Signed>

        <Textblock>
          <X>5</X>
          <Y>5</Y>
          <FontFace>Arial</FontFace>
          <FontSize>12</FontSize>
          <FontStyle>Bold</FontStyle>
          <Interval>110</Interval>

          <TextLine>
            <Text>Uberschrift</Text>
          </TextLine>

        </Textblock>

        <Zoom>Width</Zoom>
        <RectPosX>50</RectPosX>
        <RectPosY>80</RectPosY>

        <BeforeSignConfirmation>
          <Type>Ok</Type>
          <Text>&lt;h1&gt;Confirmation.&lt;/h1&gt;Please confirm.</Text>
        </BeforeSignConfirmation>

        <Stamp>
          <Text>Handwritten signature\r\nDigitally protected</Text>
          <Color>0x00FF0000</Color>
          <Font>Courier New</Font>
          <Size>14</Size>
        </Stamp>

        <Signer>Sales manager</Signer>
        <Reason>I agree with content</Reason>
        <Location>Headquaters</Location>
        <Background>C:\image.bmp</Background>
        <FrameColor>0x00FF00</FrameColor>
        <FrameThickness>2</FrameThickness>
      </Static>

      <Static>
        <Page>1</Page>   	
        <X>9.7</X>
        <Y>21.5</Y>
        <Width>4.2</Width>
        <Height>3</Height>
        <Signed>0</Signed>
        <Mandatory/>

        <Textblock>
          <X>5</X>
          <Y>13</Y>
          <FontFace>Times New Roman</FontFace>
          <FontSize>10</FontSize>
          <FontStyle>Standard</FontStyle>
          <Interval>120</Interval>

          <TextLine>
            <Text>Text on the second line.</Text>
          </TextLine>

          <TextLine>
            <Text>... and the third line.</Text>
          </TextLine>

        </Textblock>

        <Zoom>75</Zoom>
        <RectPosX>80</RectPosX>
        <RectPosY>80</RectPosY>
      </Static>
    </Signatures>

3.) Sample signature block by using DigSig fields

Download: DigSig.xml (for eSignatureOffice use, also limited compatible with webSignatureOffice: some extensions are not working yet)
This sample contains the <digsig> tag, which declares a signature field for an adobe digsig field inside the PDF document.

https://www.adobe.com/devnet-docs/acrobatetk/tools/DigSig/Acrobat_DigitalSignatures_in_PDF.pdf

Comparing to the other two options, you don´t need to define any placement or size, because the field is already inside the PDF.

DigSig Fields

    <Signatures>
      <DigSig>
        <FieldName>Sigfield1</FieldName>
        <Signed>0</Signed>

        <Textblock>
          <X>5</X>
          <Y>5</Y>
          <FontFace>Arial</FontFace>
          <FontSize>12</FontSize>
          <FontStyle>Bold</FontStyle>
          <Interval>110</Interval>

          <TextLine>
            <Text>Uberschrift</Text>
          </TextLine>

        </Textblock>

        <Zoom>Width</Zoom>
        <RectPosX>50</RectPosX>
        <RectPosY>80</RectPosY>

        <BeforeSignConfirmation>
          <Type>Ok</Type>
          <Text>&lt;h1&gt;Confirmation.&lt;/h1&gt;Please confirm.</Text>
        </BeforeSignConfirmation>

        <Stamp>
          <Text>Handwritten signature\r\nDigitally protected</Text>
          <Color>0x00FF0000</Color>
          <Font>Courier New</Font>
          <Size>14</Size>
        </Stamp>

        <Signer>Sales manager</Signer>
        <Reason>I agree with content</Reason>
        <Location>Headquaters</Location>
        <FrameColor>0x00FF00</FrameColor>
        <FrameThickness>2</FrameThickness>
      </DigSig>

      <DigSig>
        <FieldName>Sigfield2</FieldName>
        <Signed>0</Signed>
        <Mandatory/>

        <Textblock>
          <X>5</X>
          <Y>13</Y>
          <FontFace>Times New Roman</FontFace>
          <FontSize>10</FontSize>
          <FontStyle>Standard</FontStyle>
          <Interval>120</Interval>

          <TextLine>
            <Text>Text on the second line.</Text>
          </TextLine>

          <TextLine>
            <Text>... and the third line.</Text>
          </TextLine>

        </Textblock>

        <Zoom>75</Zoom>
        <RectPosX>80</RectPosX>
        <RectPosY>80</RectPosY>
      </DigSig>
    </Signatures>