CIB pdf toolbox 2 technical documentation

4. Usecases

4.2. Loading and Merging PDF-Documents

Inside a JOB you can load PDF-documents in several ways. 

Property

Meaning

Type

InputFilename

Inputfiles as ;-separated list of filenames. If the filename contains a ;, use \ as escape sequence. Before the filename you can specify which pages of the pdf document should be used.

Example:

InputFilename={1-3};filename1;{Odd};filename2;#;12345678#664

The result would be a merged PDF with the pages 1-3 of filename1, all odd pages of filename2 and all pages of filename3, which is located at memory address 12345678 and has a length of 664 bytes..

Syntax:

InputFilename ::= <filenameorpages> [“;“ < filenameorpages >]...

filenameorpages::= [<page description> „;“] (<filename> | <memory blocks> | <memory delimiter>)

page description ::= „{“ <pages> [“,“ <pages>]... „}“

pages::= “All“ |“Even“ | “Odd“ | “First“ | “Last“ | “NoFirst” | “NoLast” | <number> | (<start number> „-„ <end number>)

memory blocks::= < memory block> [<memory delimiter> <memory block>]...

memory block ::= <address> <memory delimiter> <length>

Note:
if InputFilename contains page description for page selection
then all following operations work on the pagecount and page
selection of the resulting document after the merge.

Note:
A special case for filename is “EMPTY:Width,Height”: it means
that empty single-page PDF is generated with the specified
page width and height in mm.

Example:
InputFilename=mydoc.pdf;EMPTY:210,297

In this case, document mydoc.pdf is merged with a singlepage empty PDF.

Set

InputMemoryAddress

Contains pairs of memory addresses and lengths, separated by ; of input document.

Set

InputFilenamePattern

Contains a pattern of input files, e.g. *.pdf. All PDFs with this pattern will be merged together.

Set

WorkSpace

You can set one or several Workspace dictionaries, separated by ; where to search for inputfiles.

Set

MergePdfAConform

A flag indicating, that if several input documents are merged to one, that this merge happens PDF/A specification conform. This means, that if all input documents conform to PDF/A, then the output document conforms also to PDF/A.

Set

OutlinesDeleteExisting

A flag that indicates, that PDF-outlines should be deleted.

Set

PartialDocumentAlignment

Every partial document is expanded to an even pagecount. See
also InsertEmptyPageOmitLast.

Set

InsertEmptyPageOmitLast

This configures the PartialDocumentAlignment behaviour, that for the last document no optional empty page is appebded.

Set

FormfieldNamePrefix

A ;-separated string, by which a prefix for formfields can be defined, which is assigned to each input document in a merge.

Set

GenericFormfieldNamePrefix

A flag, that indicates, that all input documents should get an automatic generated formular field prefix, so that formular fields of the input documents are always unique and are not combined in a pdf merge.

Set

PartialDocumentAlignment

Adds an empty page between merged documents, if the input
documents have an uneven amount of pages.

Set

JoinHistory

Sets a marker inside the PDF, where each document
participated at the join ended.

Set