Creating custom steps (transforms)
To create a transform, an InfoPrint Manager system administrator must use this procedure:
- Connect to the InfoPrint Manager server using the InfoPrint Manager Web Administration Interface.
- In the left-hand Objects panel, click the Servers tab.
- Click , the Menu icon, and select Custom Steps (Transforms)....
- Click the New button in the upper right corner.
- In the Create New Custom Step (Transform) dialog, fill in these values:
- Type a meaningful name for the transform.
InfoPrint Manager references the transform name in transform sequences that are associated with actual destinations.
- If not filled in, either type or select the InfoPrint Manager server in which you want to create the transform.
Transforms can only be associated with actual destinations in the same server. If the InfoPrint Manager Web Administration Interface is only monitoring one server, this field contains that server name.
- Output File Format
- Select a format for the output file produced from this transform.
- Type a description of this transform that will appear whenever you show this transform through the InfoPrint Manager Web Administration Interface.
- Transform Options
- Type the command-line transform and its options, including any InfoPrint Manager substitution variables.
- Final Step
- Specify if the transform step is the last one.
- Force Sequence Stop Return Code
- Specify a return code that indicates the transform step was successful, but the transform step is not returning data for further processing by InfoPrint Manager.
- Document Formats Allowed
- Add a format for the input file or files that are being transformed.
Note: You can specify either one or multiple document formats. The format of the input file determines whether this transform is called for a job sent to this actual destination.
- Use Server Locale
- Specify whether to use the locale language of the server (On - default) or English (Off) for input and output of information defined in the %% substitution variables in the Transform Options field.
The transform examples that follow demonstrate common uses of transform objects, using
the substitution values shown in the
Transform substitution variables table. Some of these examples presume that an application programmer has created a program with
the name specified at the start of the Transform Options field.
- If you are specifying any substitutions for which the passed values might contain a blank space, such as
job name, be sure to put quotes around the substitution so it is passed correctly. Note that this only applies to single
%substitution variables. Do not put quotes around any
- The examples that follow presume that the PATH environment variable has been set to the appropriate path so you do not have to specify the fully qualified path name in the Transform Options field.
Transform substitution variables
|Transform options substitution variables||Meaning|
|%i||The name of the input file to transform.|
|%o||The name of the file in which to store the output of the transform.
Note: If this is a non-terminating transform, data must be stored in the file named by %o.
|%e||The name of the file in which to store any transform information or error messages.
If anything is written to this file, it is logged in the InfoPrint Manager server log.
|%u||The name of the file for updating the pages-completed and job-page-count job attributes.
Note: This file should only be accessed through the transform_update utility.
|%j||The name of the original print file, minus the path (from the document-file-name attribute).
Note: This should only be used to construct another name, such as a temporary file.
|%n|| The name of the original print file, minus the path and minus the extension (from
the document-file-name attribute).