Trigger patterns

Specifies one or more pattern-matching strings that RICOH ProcessDirector uses to identify trigger files. A trigger file indicates that the associated input file has been completely transmitted. The trigger file and the input file have the same name, but they have different extensions. For example, using the default trigger pattern matching string for input devices, an input file named STMT406.pdf would have an associated trigger file named STMT406.trg. The value uses regular expression syntax and characters in the value are case-sensitive. Separate multiple patterns by commas; do not type a space between them.

The default trigger pattern-matching string for Hot folder input devices and Download input devices is .*\.trg$. This default can be changed for Hot folder input devices, but not for Download input devices. In this string:

  • Period (.) matches a single occurrence of any character (letter or number).
  • Asterisk (*) matches zero or more of the preceding characters, up to the maximum file name length.
  • Backslash (\) is the escape character that means the next character is interpreted literally.
  • .trg are the actual characters that must match.
  • Dollar sign ($) means that a match of .trg signifies the END of the expression.

The default for LPD input devices is .*\trg$. This default string cannot be changed. In this string:

  • Period ( . ) matches a single occurrence of any character.
  • Asterisk ( * ) matches zero or more occurrences of the preceding expression.
  • Backslash (\) indicates that the following period is a literal period, not a placeholder.
  • .trg are actual characters that must match.
  • Dollar sign ($) signifies that a match of .trg signifies the END of the expression.
Database name
InputDevice.FileTriggerPatterns

Usage notes:

  • To use trigger files, set the Completion method property for the input device to Trigger.
  • If the Completion method property for the input device is Trigger, RICOH ProcessDirector checks for trigger files first. It ignores trigger patterns for any of the other completion methods. It then checks for other pattern types in this order: overrides patterns, list patterns, data patterns.
  • The input file must have an extension. If it does not, it is not matched to a trigger file, even if one exists.
  • The trigger file does not need to have any content. For example, to create a trigger file that indicates that transmission of the input file is complete, access the Linux command line from outside of the RICOH ProcessDirector interface. Then, change to the directory that contains the input file and issue this command: touch filename.trg
  • An overrides file can also be used as a trigger file by specifying the same pattern value for both the Trigger patterns and Overrides patterns properties. In this case, the file is first used as a trigger to indicate that the job has been received and then as an overrides file to update property values.

Parent topic: Field help