Specifications

Certificates other than those associated with the active session cannot
be updated. It is possible however to completely remove any certificate.
Note: After implementation, the scripting API should remove any PDF
objects associated as private data with removed certificates. The scripting
API does not support influencing the order of certificates.
Updating certificates
When obtaining a CP2 dataset for a PDF file that contains a GWG Proof of
Preflight ticket without a corresponding preflight certificate, a new
Proof of Preflight
certificate
preflight certificate is automatically created and stored in the dataset.
Depending on implementation issues, such auto-generated preflight
certificate may be associated with the active session or with a previous
session.
Returns a list of all certificates in the dataset, including any certificates in
the active session, in order of appearance in the dataset. The list may be
empty.
getAllCertificates( )
: CertificateList [R]
Creates a new certificate of the specified vendor-neutral class, associates
it with the current session, adds it to the dataset and returns a reference
to the new certificate.
A certificate class associates additional semantics with a particular type of
certificate. Even if the scripting API does not support access to the class
addNewCertificate(
classID : String ) :
Certificate [W]
properties that may be defined for certain certificate classes, it is important
to specify the appropriate class. For example, a preflight certificate may
cause a GWG Proof of Preflight ticket to be written in the PDF file, while
other certificates do not show this correspondence.
The Certified PDF 2 specification describes two “built-in” classes, as
described in the following table:
DescriptionclassID (CP2:class_id)
A generic certificate, without
additional semantics
"" (the empty string)
A preflight certificate, which may
correspond to a GWG Proof of
Preflight ticket in the PDF file
"Preflight"
In many cases these built-in classes provide sufficient functionality.
Third-party vendors may agree on other values for classID; it is
recommended to register such other values with Enfocus to avoid name
collisions.
After adding a new certificate with this function, and before finishing the
dataset (or exiting the entry point), the script must set the certificate’s
required properties (see "Required and Automatic Properties" section
below) to a non-empty value. Alternatively the script may remove the
certificate. Failing to do either of these is a programming error and has
unpredictable results.
Note: The built-in classID values are easily mapped to one of the built-in
C++ certificate classes. However supporting other classID values requires a
C++ certificate class with dynamic classID (but without support for accessing
497
Enfocus Switch 10