Macromedia live cycle 7.2 Manual

Page of 123
Adobe LiveCycle
Invoking LiveCycle Assembler Using LiveCycle Workflow and Watched Folder
Installing and Configuring LiveCycle for JBoss
 Preparing PDF and DDX files     112
Preparing PDF and DDX files
The PDF files included in the input directory or defined by the Assembler QPAC must correspond to the file 
pattern value defined for the 
source
 element in the DDX file. 
When using Watched Folder with LiveCycle Assembler, you must specify the Input Document Map 
variable (as described in 
). You must 
use the 
sourceMatch
 attribute for the source element to define the file pattern. For information on 
setting the regular expression pattern for the 
sourceMatch
 attribute, see the Document Description XML 
Reference.
For example, in the DDX file, the PDF source can be specified in the following ways:
Pattern matching for specific file names: 
<PDF source="mysource" sourceMatch="appendix[\d]+[.]pdf" select="1-last"/>
Pattern matching with wildcard value: 
<PDF source="mysource" sourceMatch=".+[.]pdf" select="1-last"/>
In the examples above, pattern-matching matches any input PDF files that begin with the characters 
appendix
 followed by a digit, and then followed with the file name extension .pdf. The wildcard value 
matches at least one input PDF file with any characters that include digits and end with .pdf.
For more information on setting the source element in the DDX file, see “Specifying multiple input 
streams” in the Developing Applications for LiveCycle Assembler guide and the Document Description XML 
Reference
.
Submitting the LiveCycle Assembler job for processing
You can submit a LiveCycle Assembler job to Watched Folder programmatically using a batch file that 
transfers the package containing the required files to the configured watched folder. (Instructions for 
creating a batch file or script to complete this action is beyond the scope of this guide.) You can also 
submit a job manually by dragging or copying the package of files to Watched Folder. 
If you have created a LiveCycle Assembler workflow in LiveCycle Workflow Designer that does not use 
Watched Folder, you can submit the job for processing using a client application that you create using the 
LiveCycle Workflow Java API. For information on developing custom client applications for 
LiveCycle Workflow, see the Developing Custom Applications for LiveCycle Workflow guide, available with 
the LiveCycle Workflow SDK.
You can also submit jobs for processing using a variety of other mechanisms available with 
LiveCycle Workflow, such as web services, email, and messaging queues, as well by using online forms. For 
more information, see the Developing Custom Applications for LiveCycle Workflow and Developing Custom 
QPACs
 guides.
Note:
When NFS sharing is set up for Watched Folder, temporary files and directories related to Watched 
Folder jobs are placed in the Global storage directory, but are not automatically deleted when the 
job processing is complete. To prevent performance issues, you should regularly remove files with 
name Session
[NNNN]
, where NNNN is the workflow process ID from the Global storage directory.
The default location of the Global storage directory is {TempDir]/AdobeDocumentStorage/global. If 
[TempDir] is not specified by the user in Configuration Manager, the default location is 
java.io.tmpdir.