Overrides files

When you create a workflow, you can set default values for many job properties. However, those default values might not be appropriate for every job. If you want to send different values with a print job, you can use an overrides file.

An overrides file is a text file that contains property and value pairs for job properties; it can be submitted with a print file. When the job is sent to a workflow, the SetJobPropsFromTextFile step can use the information in the overrides file to replace the default values.

The overrides file must meet these criteria:

  • The overrides file must arrive in the hot folder after the print file.
  • You must create a separate overrides file for each print file in the job.
  • The file name must match the pattern specified in the Overrides patterns property. The default pattern matches files that have the extension .oth.
  • Each property and value pair must be on a separate line.
  • For hot folder input devices, each pair must be expressed as: database property name=value, with no spaces before or after the equal sign (=).

    Overrides files that are used with Download input devices follow a different format and requires the AFP Support feature to be installed.

You can use either of these formats for an overrides file:

  • Use the Ricoh ProcessDirector database names for the properties, and list each property and value on a separate line. For example:
    Job.Duplex=Yes
    Job.CustomerName=BankName
    Job.Location=Boulder
  • If the AFP Support feature is installed and the overrides arrive in JCL format from a Download input device, the receive_jcl_jobtype.cfg file is configured to interpret JCL format. The mainframe program creates the overrides file in JCL format.

To submit one or more print files and their accompanying overrides files in the same job, you must use the List batching method and submit a list file with the job. The list file contains the name of each print and overrides file; a print file must be listed before the associated overrides file. The list file might look like this:

input1.pdf
values.oth
input2.pdf
morevalues.oth
input3.pdf
values3.oth
inputfile.pdf
inputfile.oth

Use the Ricoh ProcessDirector database names for the properties, and list each property and value on a separate line. For example:

Job.Duplex=Yes
Job.CustomerName=BankName
 
Copyright © 2006, 2018