PDF Configuration
The task accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the task, access to these internal properties is provided through the Other property.PDF Configuration Settings
| AlgorithmInfo:
The displayed algorithm info in the signature widget.This setting specifies information about algorithm to be displayed in the signature widget.
This setting is only applicable when AutoText; is False. When AutoText; is True (default) the value is automatically determined based on the information in the certificate. For instance RSA/1024 bits. When AutoText; is False this may be set to a string value in the format "Algorithm/KeySize". | ||||||||||||||||||||||
| AllowComments: Whether the recipient may add comments.This setting specifies whether comments may be added by recipients. If set to True the recipient of the signed PDF may still add comments. The default is False. | ||||||||||||||||||||||
| AllowFillInForms: Whether the recipient may fill in forms.This setting specifies whether forms may be filled in by recipients. If set to True the recipient of the signed PDF may still fill in forms. The default is False. | ||||||||||||||||||||||
| AltCertPassword[index]:
Specifies the password for an alternate Certificate.This setting is used in conjunction with AltCertSource[index], AltCertStore[index], and AltCertType[index]
to load certificates in addition to (or instead of) the *Cert properties of the task.
AltCertPassword[index] specifies the password for the certificate at the given index, and is only required if the certificate is password-protected. | ||||||||||||||||||||||
| AltCertSource[index]:
Specifies the format from which an alternate Certificate should be loaded.This setting is used in conjunction with AltCertType[index], AltCertStore[index], and AltCertPassword[index]
to load certificates in addition to (or instead of) the *Cert properties of the task.
AltCertSource[index] specifies the current format of the certificate at the given index. The possible formats are:
| ||||||||||||||||||||||
| AltCertStore[index]:
Specifies the store from which to load an alternate Certificate.This setting is used in conjunction with AltCertSource[index], AltCertPassword[index], and AltCertType[index]
to load certificates in addition to (or instead of) the *Cert properties of the task.
AltCertStore Notes The AltCertStore[index] setting may be set to the path to a certificate file on disk, or may be a comma separated list of values used to identify the certificate location. The following are the parameters that may be used in the comma separated list:
| ||||||||||||||||||||||
| AltCertType[index]:
Specifies how an alternate Certificate should be used.This setting is used in conjunction with AltCertSource[index], AltCertStore[index], and AltCertPassword[index]
to load certificates in addition to (or instead of) the *Cert properties of the task.
AltCertType[index] identifies the role/function of the certificate at the given index. The possible roles are:
*Note: please see the KnownCert and TrustedCert properties for details on when a certificate should be in the Trusted role versus Known. For example, if two certificates are required to sign a PDF, the first can be specified via SigningCert and the second should be specified under the Other property like this: AltCertSource[0]=2 A third certificate can be specified via AltCert*[1], and so on. It is also acceptable to specify all certificates via the AltCert* configuration options and ignore the *Cert properties (such as SignerCert).
| ||||||||||||||||||||||
AutoFontSize:
Whether to automatically size the font in the signature widget.If set to True (default) the task will automatically size the font within the signature widget.
The following values will be used:
The standard unit is 1/72 of an inch. IN PDF 1.6 the size of this unit may be specified as greater than 1/72 of an inch via the UserUnit entry of the page dictionary. | ||||||||||||||||||||||
| AutoPos:
Whether to automatically position the signature widget.This setting specifies whether the position of the signature widget is automatically determined. If True (default)
the signature widget will be placed in the upper right corner of the page. The default value is True.
If set to False then OffsetX and OffsetY specify the signature widget coordinates. | ||||||||||||||||||||||
| AutoSize:
Whether to automatically size the signature widget.This setting specifies whether the size of the signature widget is automatically determined. If True (default)
the signature widget size is automatically specified. The default value is True.
If set to False then Height and Width specify the size of the signature widget. | ||||||||||||||||||||||
| AutoStretchBackground:
Whether the background of the signature widget is automatically stretched.This setting specifies whether the background of the signature widget is automatically stretched. If True (default)
the background picture used in the signature widget will be automatically stretched to fit the size. The default value is True.
If set to False then StretchX and StretchY specify the dimension to which the image is stretched. | ||||||||||||||||||||||
| AutoText:
Whether to automatically determine the text to be included in the signature widget.This setting specifies whether the text on the signature widget is automatically determined. If set to True (default)
text is determined automatically based on information from the certificate used to sign the document.
If set to False then AlgorithmInfo, SignerInfo, and Header specify the text to be included on the signature widget. | ||||||||||||||||||||||
| BackgroundHeight: The height of the background image.This setting optionally specifies the height of the background image. | ||||||||||||||||||||||
| BackgroundWidth: The width of the background image.This setting optionally specifies the width of the background image. | ||||||||||||||||||||||
| CustomHandlerName: Specifies a custom security handler used for signing and encryption.This setting optionally specifies a custom security handler to be used for signing and encrypting. | ||||||||||||||||||||||
| Detached:
Whether the signature is detached.This setting specifies whether the signature is detached. If True (default) the adbe.pkcs7.detached subfilter will be used when signing the document. The default value is True.
Note: This setting is only applicable when PublicKeySignatureType is set to PKCS7SHA1. | ||||||||||||||||||||||
| EncryptMetadata: Specifies whether the document metadata is encrypted.This setting specifies whether the document metadata is encrypted. The default value is True. | ||||||||||||||||||||||
| FIPSMode: Determines whether to operate in FIPS mode.This setting determines whether to operate in FIPS mode. If set to True the task will operate in FIPS compliant mode. The default value is False. | ||||||||||||||||||||||
| Header: The header displayed on the signature widget.This setting optionally specifies header value that is displayed on the signature widget. | ||||||||||||||||||||||
| Height:
Sets the height of the signature widget.This setting specifies the height of the signature widget. This is only applicable if AutoSize is False.
The default value is 70. | ||||||||||||||||||||||
| IgnoreExistingAppearance: Determines if appearance settings of existing empty signature fields are ignored.This setting specifies whether appearance settings of existing empty signature fields are ignored. The default value is False. | ||||||||||||||||||||||
| IgnoreTimestampFailure: Whether it ignore timestamp failures during signing.This setting determines if failures during the timestamping process are ignored. The default value is False, meaning timestamp failures will cause signing to fail. | ||||||||||||||||||||||
| LiberalMode: Specifies the validation mode of MDP signatures.This setting specifies whether liberal validation is enabled for MDP signatures. The default value is False. | ||||||||||||||||||||||
| Locked:
Whether the signature widget is locked in place.This setting specifies whether the signature widget can be moved on the signed document.
If set to True (default) the widget may not be moved after the document is signed.
Note: Adobe always treats the signature widget as locked in place regardless of this setting. | ||||||||||||||||||||||
| NoRotate: Whether the signature widget rotation is disabled when the document rotates.This setting specifies whether the signature widget is rotated along with the document when the document is rotated (for instance in a browser window). The default value is False, meaning the signature widget may rotate in conjunction with the document. | ||||||||||||||||||||||
| NoView: Whether the signature widget is displayed when the document is viewed.This setting specifies whether the signature widget is displayed when the document is viewed. | ||||||||||||||||||||||
| NoZoom: Whether the signature widget is resized when the document is zoomed.This setting specifies whether the signature widget may change size with the zoom level of the document. The default value is False, meaning it may change size. | ||||||||||||||||||||||
| OffsetX: The offset of the signature widget from the left.This setting specifies the offset of the signature widget from the left page border. This is only applicable when AutoPos is False. | ||||||||||||||||||||||
| OffsetY: The offset of the signature widget from the bottom.This setting specifies the offset of the signature widget from the bottom page border. This is only applicable when AutoPos is False. | ||||||||||||||||||||||
| Print: Whether the signature widget will appear in printed copies.This setting specifies whether the signature widget will appear in printed copies of the document. The default value is True. | ||||||||||||||||||||||
PublicKeySignatureType:
The public key signature type.This setting specifies the public key signature type. This is typically only in legacy cases. Possible values are:
| ||||||||||||||||||||||
| ReadOnly: Whether the signature widget is interactive or read-only.This setting specifies if the signature widget is read-only. If set to True the user may not click on or otherwise interact with the signature widget. The default value is False. | ||||||||||||||||||||||
Rotate:
Specifies the rotation of the signature widget in degrees.This setting specifies the rotation of the signature widget in degrees. Possible values are:
| ||||||||||||||||||||||
| SaveStringsInUnicodeEncoding: Whether strings are saved in Unicode.This setting specifies whether the text values in the signature widget are save in Unicode. The default value is False. | ||||||||||||||||||||||
| SectionTextFontSize:
The font size of the section text.This setting specifies the font size of the section text.
This setting is only applicable if AutoFontSize is False. | ||||||||||||||||||||||
| SectionTitleFontSize:
The font size of the section title.This setting specifies the font size of the section title.
This setting is only applicable if AutoFontSize is False. | ||||||||||||||||||||||
| ShowTimestamp: Whether the timestamp is displayed on the signature widget.This setting specifies whether the timestamp is displayed on the signature widget. The default value is True. | ||||||||||||||||||||||
| SigFieldName: The name of the signature field to sign.This setting optionally specifies the name of the signature field to sign. This is only applicable when SignExistingFields is set to True. | ||||||||||||||||||||||
| SignerInfo: Information to be displayed about the signer.This setting optionally specifies information about the signer that is displayed on the signature widget. This setting is only applicable if AutoText is False. | ||||||||||||||||||||||
| StretchX: Specifies the horizontal stretch of the signature widget background picture.This setting specifies the horizontal stretch of the signature widget background picture. This is only applicable if AutoStretchBackground is False. | ||||||||||||||||||||||
| StretchY: Specifies the vertical stretch of the signature widget background picture.This setting specifies the vertical stretch of the signature widget background picture. This is only applicable if AutoStretchBackground is False. | ||||||||||||||||||||||
| TimestampFontSize:
The font size of the timestamp.This setting specifies the font size of the timestamp.
This setting is only applicable if AutoFontSize is False. | ||||||||||||||||||||||
| TitleFontSize:
The font size of the title.This setting specifies the font size of the title.
This setting is only applicable if AutoFontSize is False. | ||||||||||||||||||||||
| ToggleNoView: Specifies whether the signature is visible on hover.This setting specifies whether the signature widget is visible while hovering over it with a mouse pointer. If set to true the signature widget will only be displayed when hovering over it. The default value is False. | ||||||||||||||||||||||
| UseHexEncoding:
Whether to hex encode strings used in the signature widget.This setting specifies whether strings used in the signature widget are hex encoded. If True
the strings will be written in hex encoding. This setting may be useful if the data to be included in the signature
widget text contains non-ASCII characters.
The default value is False. | ||||||||||||||||||||||
| Width:
Sets the width of the signature widget.This setting specifies the width of the signature widget. This is only applicable if AutoSize is False.
The default value is 70. |