Set XDP Content source properties

Use Document Builder to apply properties to XDP Content source files. For example, these properties select the XDP documents to use and the order in which they are considered. Before you begin these instructions, open a DDX file that uses an XDP Content icon.

  1. From the canvas panel, select an XDP Content icon.

  2. From the XDP Content panel, supply values where needed. (See XDP Content attributes you can set from the XDP Content panel.)

  3. Save your work and click Validate to validate the DDX file. (See Validating the DDX Document.)

  4. Click Preview to view an example of the resultant document. (See Previewing the Result from a DDX Document.)

XDP Content attributes you can set from the XDP Content panel

Source:
Name of a single input data stream, an ordered list of data streams, or an external data URL. Each stream or URL must resolve to a document. If the document is not XDP, the Assembler service tries to convert the document to XDP.

This source is required:
Select this check box to terminate XDP assembly if this source does not specify a valid XDP document.

Insertion Point:
Name of the insertion point in the XDP source file where the fragment is inserted.

Doc match regex:
Selects source names and their associated data streams from the inputs map. Depending on the Match Mode: property, the matched documents are either included in or excluded from the assembled document. If more than one name matches, the names are sorted, as specified in the Sort Locale: and Sort Order: properties. The Assembler service supports the Java regular expressions. (See the Java tutorial Lesson: Regular Expressions.)
Instead of specifying this parameter, you can specify the Source: parameter. If you also specify the Source: parameter, the document is included only if it matches the regular expression regarding the match mode sense.

Sort Locale:
Locale to use for sorting the names matched by the Match Mode: property. The value of this attribute must be a valid two-character ISO language code (see ISO 639). If you omit this parameter, the Assembler service determines the locale from the DDX TargetLocale element. Document Builder does not provide an interface for setting the TargetLocale element. However, you can use the Source mode to specify this element by directly editing the DDX document.

Sort Order:
If the regular expression specified in the Doc match reg expression: parameter matches multiple documents, this attribute specifies the order in which those documents are sorted. This attribute is not used if the source attribute is specified and it matches an entry in the inputs map. Select Ascending to sort the matched documents in the A-Z ascending order. Select Descending to sort the matched documents in the Z-A descending order.

Match Mode:
Specifies whether the match results are included in or excluded from the document assembly. Select Include to include the matched data streams. Select Exclude to exclude the matched data streams. This parameter applies only when you also provide the Doc match reg expression: parameter.

Include subfolders:
If true, all files in the folder and subfolders are included. The result is a list of documents for the PDF source element that maintains the original folder structure. If false, only the files in the specified folder are included. This parameter is used when the Doc match reg expression: parameter specifies subfolders.

Include all docs:
Select this field to include files in the folder and subfolders. The result is a list of documents for the PDF source element that maintains the original folder structure. Deselect this field to include only the files in the specified folder. This parameter is used when the Doc match reg expression: parameter specifies folders.

Just include these docs:
Range of documents to include from the ordered list specified in the Source: parameter or obtained by applying the Doc match reg expression: property. Leave this field blank if all documents are included. Here are examples of document ranges:

  • 1,3,5 Includes the first, third, and fifth documents from the ordered list of documents.

  • 1-5,8-10 Includes the first through fifth and eighth through tenth documents from the ordered list of documents.

  • 8-last Includes the eighth through last documents from the ordered list of documents.

This parameter is used when the Doc match reg expression: parameter specifies folders and subfolders. This parameter corresponds to the DDX property identified as the XDP source element’s select attribute. See “Page and document ranges” in the Assembler Service and DDX Reference.

Fragment:
A string that identifies the fragment to name to insert. To insert the entire form at the insertion point, leave this field blank. Use this property only if your source XDP documents contain forms designed to work with form fragments.

Retain Insertion Points:
Specify the insertion points to retain. Select All to retain all of the insertion points. Select None to remove all of the insertion points. To retain specific named insertion points, select List and then provide the names of each insertion point to retain. Use this property only if your source XDP documents contain forms designed to work with form fragments.

Remove Insertion Points:
Specify the insertion points to remove. Select All to remove all of the insertion points. Select None to retain all of the insertion points. To remove specific named insertion points, select List and then provide the names of each insertion point to retain. Use this property only if your source XDP documents contain forms designed to work with form fragments.

For more information, see Assembler Service and DDX Reference.