User Guide

ManualsBrandsMacromedia ManualsOtherLIVE CYCLE 7.2

101

102

103

104

105

106

107

108

109

110

Adobe LiveCycle Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder

Installing and Configuring LiveCycle for JBoss Configuring an Assembler QPAC in a workflow process 107

Note: For information about selecting options on the Configuration tab, see the next section, Error

logging and fail modes in the Assembler QPAC workflows.

Error logging and fail modes in the Assembler QPAC workflows

When you set up a workflow using the Assembler QPAC, you can select the error logging level and the fail

mode that LiveCycle Workflow uses when exceptions occur.

You can set the error logging level to Off (no logging), Normal (brief messages), or Debug (detailed

descriptions of errors). You can associate a process variable (for example,

<joblog>) of type Document to

the Output Log Document field in order to store the log messages.

You can set the fail mode to Stall Process or Terminate Process to direct the Assembler QPAC to stall or

terminate a process when an exception occurs in LiveCycle Assembler.

When a job fails with Stall Process selected, the workflow process stalls, but is not terminated. If logging is

set to Normal or Debug, information about the exception appears on the LiveCycle Workflow Stalled

Action page in Administrator. Component administrators should search for the process and terminate it,

and then return to Administrator and delete the stalled action if desired. The logged messages are

displayed on the stalled action page, but not on the process page.

When a job fails with Terminate Process selected, the workflow process terminates when an exception is

thrown. If logging is set to Normal or Debug, information about the exception is written to the log file for

the component for which the exception was thrown. For Watched Folder, the log file is the activity.log file

that is placed in the /failure subdirectory of the configured watched folder.

If you are configuring an Assembler QPAC for use with Watched Folder, you should set the fail mode to

Terminate Process. Watched Folder users may not have access to Administrator, so if processes stall but are

not terminated, users do not receive messages about the exception until the process is terminated. Setting

the fail mode to Terminate Process ensures that error messages are logged to the activity.log file, which is

available in the [watchedfolder]/failure directory (when the logging level is set to Normal or Debug).

For information on setting error logging and fail modes, see Using LiveCycle Assembler QPACs.

Using Watched Folder with a

static DDX file

Use the Browse button to locate the

DDX file: Browse to the DDX file that

you want to use.

Input Document Map Variable:

Select the

<inputdocmap> variable.

Output Document Map: Click

the ellipsis button and select the

<outputmap> variable.

Using QPAC only (with a

static DDX file)

Input Document Map: Do not select