If you want to integrate GMG ColorServer into an automated, job-based workflow, we recommend using a job ticket hotfolder. For each job, this hotfolder receives an XML job ticket generated by your workflow software and processes the associated file according to the parameters defined in the ticket.
This approach significantly reduces setup effort. Rather than creating a separate hotfolder for every output condition, you can integrate a single job ticket hotfolder and specify output-dependent settings—such as processing, normalization, and conversion—directly in the job ticket.
Setting Up a Simple Job Ticket Hotfolder
Job ticket-based processing requires two components:
- XML job ticket: A valid XML document that defines the processing parameters in a structure recognized by the hotfolder.
- Job Ticket Hotfolder: Receives XML job tickets and uses the configured XPath references to read the job parameters.
Creating a job ticket
First, create a job ticket manually. This ticket serves as a template for the job tickets that your workflow software will generate automatically later.
<Jobticket>
<Priority>5</Priority>
<Input>
<FilePath>C:\Users\user\colorServer\testjob.pdf</FilePath>
</Input>
<Output>
<Folder>C:\Users\user\colorServer\output</Folder>
</Output>
<Report>
<FilePath>C:\Users\user\colorServer\output\testjob.xml</FilePath>
</Report>
<Processing>
<PDF>Use Flattening</PDF>
<Normalization>ISOcoatedv2-39L</Normalization>
<Conversion>ISOcoatedv2-39L to PSO-Coatedv3-51</Conversion>
</Processing>
</Jobticket>
This XML document contains all job ticket parameters required to process a file:
| Parameter | Description |
| Jobticket/Priority | Processing priority of the job |
| Jobticket/Input/FilePath | Path to the input file |
| Jobticket/Output/Folder | Folder in which ColorServer saves the output file |
| Jobticket/Report/FilePath | Path and file name of the report generated by ColorServer |
| Jobticket/Processing/PDF | Name of the PDF Processing Template |
| Jobticket/Processing/Normalization | Name of the Normalization Template |
| Jobticket/Processing/Conversion | Name of the Conversion Template |
You can choose the structure and names of the XML nodes freely. However, the XPath references configured in the hotfolder must correspond exactly to the XML structure.
Create a matching Job Ticket hotfolder
ColorServer Client and select: Hotfolders > Job Ticket Hotfolder
Configure the host
Configure the input folder
If desired you can add a name filter in the Job Ticket definition section. Only files that match the file name filter will be processed.
In the Job Creation and Color Processing sections, use XPath references to specify where ColorServer can find each parameter in the XML job ticket. For the example above, use the paths listed in Table 1.
Your first job ticket hotfolder is now configured and ready to use. To test it, manually place a job ticket in the hotfolder.
If the job is not processed, check the following:
- The path to the input file is correct and accessible.
- The job ticket is valid XML.
- All XPath references configured in the hotfolder match the XML structure.
- The PDF Processing, Normalization, and Conversion Templates are named correctly and are valid.
Comments
0 comments
Please sign in to leave a comment.