Preprocess Substitution Rule

Preprocess rules execute first and identify candidates for a Global Substitution job.

One or more preprocess rules may be used to identify candidate objects to include in a Global Substitution job, including structured documents, files, and folders. Preprocess rules execute before other rule types and make their results available to the other rules.

The Find column allows you to specify a preprocess rule. See Custom Rule Find Scriptletsfor a list of available rules.

The Promotion column allows you to optionally change selected objects or objects generated from a previous (or current) preprocess command before further processing. The options are:

Option	Description
None	Objects are not promoted.
To Folder Item	Objects that are already folder items (such as structured documents, files, folders) are unaltered. Elements within structured documents and file versions are converted to the folder item in which they reside.
To Versioned Object	Objects that are already versioned (such as structured document elements, file versions) are unaltered. Structured documents convert to their root element and files are converted to their latest file version.

Important: If you use preprocess scriptlets, such as getFolderItems, and then specify element type rules, you must specify To Versioned Object. This allows subsequent rules to be supplied with the required type of object.