Specifying Timestamps For Signing - Adobe 22002486 User Manual

Acrobat 9 Family of Products
Security Feature User Guide
Table 9 Reason field behavior
# of Reasons UI Pref
0 (empty array) on
0 (empty array) off
0 (empty array) on
1 or more off or on
1 off
2 or more on
2 or more off
Example 5.4
// Obtain the signature field object:
var f = this.getField("mySigFieldName");
f.signatureSetSeedValue(
{ reasons: ["This is a reason", "This is a better reason"],
flags: 8
} )

5.6 Specifying Timestamps for Signing

Timestamps originating from a timestamp authority's timestamp server are often associated with
signatures. If it is critical in your workflow to acquire a secure timestamp with a digital signature, it can be
controlled at the document level instead of relying on the signer's Acrobat configuration. Adding a seed
value to the signature field with the timestamp server authority settings overrides the corresponding
application level settings, if any. Use the
specify a timestamp server.
Table 10 Seed values: timeStampspec properties
Property Type
url
flags
To specify a timestamp server:
1. Create a signature field with an intuitive name and tooltip.
Flag Reason Behavior
Required Reason field does not appear in UI.
Optional Reason field does not appear in UI.
Optional Display the default list.
Required Display the custom reasons in a read-only field.
Optional Reason field does not appear in UI.
Optional Display the custom drop-down list and let the user enter a custom reason.
Optional Reason field does not appear in UI.
Seed value: Custom signing reason
Figure 59 Seed value: Reason not allowed error
Description
string URL of the timeStamp server providing a RFC 3161-compliant timeStamp.
number A flag controlling whether the time stamp is required (1) or not required (0). The default is 0.
specifier object's
timeStampspec
Controlling Signing with Seed Values
Specifying Timestamps for Signing
and properties to
url flags
76