PDF Digital Signature Properties

There are specific properties that should only be set at the report level to enable digital signature for a report and to define the placement of the signature in the output PDF document.

For more information on how to enable digital signature for your output PDF documents, see Implementing a Digital Signature.

Note that to implement digital signature for a report based on a PDF layout template or an RTF layout template, you must set the property Enable Digital Signature to "True" for the report.

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

Enable Digital Signature

Default: false

Description: Set this to "true" to enable digital signature for the report.

Internal Name: signature-enable

Existing signature field name

Default: N/A

Description: 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.

For more information about defining a field for the signature in a PDF template, see Adding or Designating a Field for a Digital Signature in Report Designer's Guide for Oracle Business Intelligence Publisher.

Internal Name: signature-field-name

Signature field location

Default: N/A

Description: 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 BI 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.

Internal Name: signature-field-location

Signature field X coordinate

Default: 0

Description: 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.

Internal Name: signature-field-pos-x

Signature field Y coordinate

Default: 0

Description: 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.

Internal Name: signature-field-pos-y

Signature field width

Default: 0

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

Internal Name: signature-field-width

Signature field height

Default: 0

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

Internal Name: signature-field-height