Acrobat 9 Family of Products
Controlling Signing with Seed Values
Security Feature User Guide
Specifying Timestamps for Signing 76
Example 5.4
Seed value: Custom signing reason
// Obtain the signature field object:
var f = this.getField("mySigFieldName");
f.signatureSetSeedValue(
{ reasons: ["This is a reason", "This is a better reason"],
flags: 8
} )
Figure 59 Seed value: Reason not allowed error
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
timeStampspec
specifier object’s
url
and
flags
properties to
specify a timestamp server.
Table 10 Seed values: timeStampspec properties
Property Type
Description
url
string
URL of the timeStamp server providing a RFC 3161-compliant timeStamp.
flags
number
A flag controlling whether the time stamp is required (1) or not required (0). The default is 0.
To specify a timestamp server:
1. Create a signature field with an intuitive name and tooltip.
0 (empty array)
on
Required
Reason field does not appear in UI.
0 (empty array)
off
Optional
Reason field does not appear in UI.
0 (empty array)
on
Optional
Display the default list.
1 or more
off or on
Required
Display the custom reasons in a read-only field.
1
off
Optional
Reason field does not appear in UI.
2 or more
on
Optional
Display the custom drop-down list and let the user enter a custom reason.
2 or more
off
Optional
Reason field does not appear in UI.
Table 9 Reason field behavior
# of Reasons
UI Pref
Flag
Reason Behavior