Ancillary Outputs are post-processing steps applied to assembled documents after the document is rendered. They are applied on a request to generate documents (and apply to all documents generated as part of the request) or as part of a DocumentSet object to apply the instructions to each specific document generated as part of the request.
PostProcess is invoked to apply watermarks and barcodes, merge, and encrypt by placing the resulting DocSet into a PostProcess request and adding the AncillaryOutputOption elements with Watermark, Barcode, and SetEncryption nodes.
The AncillaryOutputOption is submitted in the Generate, SelectAndGenerate, SelectGenerateAndSave, and AssembleDocumentSet operations to apply to all documents generated. It is submitted as part of the DocumentSet in the Generate, GenerateAndSave, and AssembleDocuments operations to apply on a document-by-document basis. To apply multiple post-processing events to a document or document set, you must submit a unique AncillaryOutputOption object on the request (so that a single request might contain multiple AncillaryOutputOption objects. In addition to submitting post-processing instructions on a request that also generates documents (described above), you can use the PostProcess operation to submit a document (using DocumentSet or DocSet) that has already been assembled.
This is a visual representation of the AncillaryOutputOption.
- Barcode: Applies a barcode to the returned documents. If used, you must also submit a Barcode object on the request. See Barcodes.
- CertificationSeal: Applies a seal to the PDF document (using Adobe PDF features) that will notify the recipient of the document if a seal has been applied and if the seal was broken prior to the recipient opening the file. A broken seal might indicate modifications were made to the document after the seal was applied. This is sometimes referred to as a tamper seal.
- Encryption: Defines the PDF file encryption information and document rights management options. If used, you must also submit a SetEncryption object on the request. See Encryption and SetEncryption.
- Watermark: Applies a watermark to the returned documents. The watermark is applied independent of the Adobe PDF Watermark functionality; it is applied using iText programmable PDF software to apply an image (watermark image) to the PDF. If used, you must also submit a Watermark object on the request. See Watermarks and Watermark.
- PdfMerge: Sets the output as a single PDF comprising a merged grouping of individual documents in a packet and removes all individual documents (only returns the single merged PDF).
- MergedCopyPDF: Sets the output as a single PDF comprising a merged grouping of individual documents in a packet and also returns all individual documents.
- Zip: Creates an archive (ZIP file) containing all returned documents. This can be used with the PdfMerge and MergedCopyPDF options and on document returned.
- SignaturePointSet: Provides a means to replace signature fields (signature and dates) with a point set (X, Y coordinates) and removed the signature fields so that only a line exists in the document. This is used most often with a customer employs another post-processing event to a PDF that requires X and Y coordinates for all signatures in a document. If this is not submitted, the standard eSignature or signature processing as defined in the transaction date is used. See Signature Points or SignaturePointSet.
