Assembler

Input DDX Document

A document value that represents the DDX file to be invoked.

If you provide a literal value, the following buttons are available for specifying DDX file contents:

Ellipsis button :

Displays the Select Assets dialog box. (See About Select Asset).

Edit button :

Displays the Assembler DDX Editor dialog box, in which you can type the DDX elements directly, and then click OK. (See Assembler DDX Editor.) The following is an example of the XML header, DDX root, and a result block.

<?xml version="1.0" encoding="UTF-8"?> 
<DDX xmlns="http://ns.adobe.com/DDX/1.0/" > 
 
    <!-- example  of a DDX result block --> 
    <PDF result="out.pdf"> 
        <PDF source="in1.pdf"/> 
        <PDF source="in2.pdf"/> 
    </PDF 
</DDX>

You can also use a template value and type DDX elements directly into the dialog box, which may be useful for testing purposes if you pass DDX elements as process variables.

Input Document Map

(Optional) A map value that represents the documents to be manipulated according to the DDX file. The keys are logical names that are referenced in the DDX file. Each key can reference a document value or a list value that contains document values.

For information about retrieving values from a map or a list, see Accessing data in data collections.

If you provide a literal value, you can add DDX keys and the document values that each key references. For the DDX keys, the following buttons are available for adding and removing keys.

Add A List Entry:

Adds a DDX key to the list.

Delete Selected List Entry:

Removes a DDX key from the list.

For each selected DDX key, the following buttons are available for adding, moving, and removing values that represent a document.

Add A List Entry:

Adds a document entry to the list.

Delete Selected List Entry:

Removes a document entry from the list.

Move Selected List Entry Up One Row:

Moves the selected document entry up in the list. The list order determines the order in which document entries are used.

Move Selected List Entry Down One Row:

Moves the selected document entry down in the list.

Environment

(Optional) An AssemblerOptionSpec value that specifies environmental options to be used during processing of the DDX.

If you specify a literal value, specify the following values.

Job Log Level:

Sets the log level for this operation. The default is INFO. The following values can be used:

• OFF: Turn off logging of messages on the server.

• SEVERE: Log messages only when they indicate a serious failure.

• WARNING: Log messages that indicate potential problems and serious failures.

• INFO: Log messages that are for informational purposes, indicate potential problems, and indicate serious failures.

• CONFIG: Log only static configuration messages.

• FINE: Log tracing information.

• FINER: Log fairly detailed tracing information.

• FINEST: Log highly detailed tracing information.

Note: The use of FINE, FINER, and FINEST will negatively impact performance on the server. Use them for debugging purposes only.

Validate Only:

Sets whether the DDX job is a validation-only test, which means that the Assembler service should validate the DDX but not execute it. A value of True indicates that it is a validation only test. The default is False, which indicates that the Assembler service validate and execute the DDX.

Fail On Error:

Determines whether the DDX job should exit immediately and stop the processing of any other result blocks when an exception or error occurs. A value of False means to keep processing the job regardless of whether an exception or error occurs. Exceptions are accessible as output in the throwables data item from the AssemblerResult value. The error representing the exception can be seen in the log file in the jobLog data item. The default of True means that the DDX job should exit immediately, but if your process catches the exception that is thrown, you can access the exception from the jobLog data item in the AssemblerResult value.

Default Style:

The default font style to be set. The font style is the same format as the font attribute for DDX rich text elements: "<font-style> <font-weight> <font-size>/<line-height> <font-family-specifier>". If no default is specified, "normal normal 12pt 'Minion Pro'" is used.

First Bates Number:

The first numeric value to use for Bates numbering. No default is provided.

Assembler Result

The location to store the returned documents and DDX results. The data type is AssemblerResult.

Input DDX Document

A document value that represents the DDX file to be invoked. Because there is only one document that can be manipulated using this operation, the logical name for the document is inDoc. The PDF source attribute in the DDX file must have the value inDoc. Here is an example:

<PDF source="inDoc"/>

If you provide a literal value, the following buttons are available for specifying DDX file contents:

Ellipsis button :

Displays the Select Asset dialog box. (See About Select Asset).

Edit button :

Displays the Assembler DDX Editor dialog box, in which you can type the DDX elements directly, and then click OK. (See Assembler DDX Editor.) The following is an example of the XML header, DDX root, and a result block.

<?xml version="1.0" encoding="UTF-8"?> 
<DDX xmlns="http://ns.adobe.com/DDX/1.0/" > 
 
    <!-- example  of a DDX result block --> 
    <PDF result="out.pdf"> 
        <PDF source="inDoc"/> 
</DDX>

You can also use a template value and type DDX elements directly into the dialog box, which may be useful for testing purposes if you pass DDX elements as process variables.

Input Document

(Optional) A document value that represents the document to be manipulated according to the DDX file. The default logical name for the document is inDoc.

If you provide a literal value, clicking the ellipsis button displays the Select Asset dialog. (See About Select Asset.)

Environment

(Optional) An AssemblerOptionSpec value that specifies environmental options to be used during processing of the DDX.

If you provide a literal value, specify the following values:

Job Log Level:

Sets the log level for this operation. The default is INFO. The following values can be used:

• OFF: Turn off logging of messages on the server.

• SEVERE: Log messages only when they indicate a serious failure.

• WARNING: Log messages that indicate potential problems and serious failures.

• INFO: Log messages that are for informational purposes, indicate potential problems, and indicate serious failures.

• CONFIG: Log only static configuration messages.

• FINE: Log tracing information.

• FINER: Log fairly detailed tracing information.

• FINEST: Log highly detailed tracing information.

Note: The use of FINE, FINER, and FINEST will negatively impact performance on the server. Use them for debugging purposes only.

Validate Only:

Sets whether the DDX job is a validation-only test, which means that the Assembler service should validate the DDX but not execute it. A value of True indicates that it is a validation only test. The default is False, which indicates that the Assembler service validate and execute the DDX.

Fail On Error:

Determines whether the DDX job should exit immediately and stop the processing of any other result blocks when an exception or error occurs. A value of False means to keep processing the job regardless of whether an exception or error occurs. The default of True means that the DDX job should exit immediately.

Default Style:

The default font style to be set. The font style is the same format as the font attribute for DDX rich text elements: "<font-style> <font-weight> <font-size>/<line-height> <font-family-specifier>". If no default is specified, "normal normal 12pt 'Minion Pro'" is used.

First Bates Number:

The first numeric value to use for Bates numbering.

Output Document

The location to store the returned document. The data type is document.