PDF Digital Signature Properties

You set the properties to enable a digital signature for PDF reports and to define the placement of the signature in the output PDF report.

At the instance level or at the report level, you can set the properties to enable a digital signature for PDF reports. You must first register at least one digital signature, so you can select the one to you use in your instance or reports. To implement the digital signature for a report based on a PDF layout template or an RTF layout template, set the Enable Digital Signature property on the report to "true."

You also must set the appropriate properties to place the digital signature in the desired location on your output report. Your choices for placement of the digital signature depend on the template type. The choices are as follows:

  • (PDF only) Place the digital signature in a specific field by setting the Existing signature field name property.

  • (RTF and PDF) Place the digital signature in a general location of the page (top left, top center, or top right) by setting the Signature field location property.

  • (RTF and PDF) Place the digital signature in a specific location designated by x and y coordinates by setting the Signature field x coordinate and Signature field y coordinate properties.

    If you choose this option, you can also set Signature field width and Signature field height to define the size of the field in your document.

Property Name Description Default Configuration Name

Enable Digital Signature

Set this to "true" to enable a digital signature for PDF reports.

false

signature-enable

Digital signature name

Select a registered digital signature file.

N/A signature-name

Existing signature field name

This property applies to PDF layout templates only. If the report is based on a PDF template, then you can enter a field from the PDF template in which to place the digital signature.

N/A signature-field-name

Signature field location

This property can apply to RTF or PDF layout templates. This property provides a list that contains the following values: Top Left, Top Center, Top Right. Choose one of these general locations and Publisher inserts the digital signature to the output document, sized and positioned appropriately. If you choose to set this property, do not enter X and Y coordinates or width and height properties.

N/A signature-field-location

Signature field X coordinate

This property can apply to RTF or PDF layout templates. Using the left edge of the document as the zero point of the X axis, enter the position in points that you want the digital signature to be placed from the left. For example, if you want the digital signature to be placed horizontally in the middle of an 8.5 inch by 11 inch document (that is, 612 points in width and 792 points in height), enter 306.

0 signature-field-pos-x

Signature field Y coordinate

This property can apply to RTF or PDF layout templates. Using the bottom edge of the document as the zero point of the Y axis, enter the position in points that you want the digital signature to be placed from the bottom. For example, if you want the digital signature to be placed vertically in the middle of an 8.5 inch by 11 inch document (that is, 612 points in width and 792 points in height), enter 396.

0 signature-field-pos-y

Signature field width

Enter in points (72 points equal one inch) the desired width of the inserted digital signature field. This applies only if you're also setting the Signature field x coordinate and Signature field Y coordinate properties.

0 signature-field-width

Signature field height

Enter in points (72 points equal one inch) the desired height of the inserted digital signature field. This applies only if you're also setting the Signature field x coordinate and Signature field Y coordinate properties.

0 signature-field-height