File Trigger

The file trigger is used to start a workflow whenever a file shows up in a directory. One common use of the file trigger is to initiate a workflow whenever a file is FTP'ed or copied into a folder.

The Directory

The directory field is set to the directory you want to watch. This field holds a URL-like value that represents a directory on an asset managed by Situate. Use the arrow at the end of the directory field to use the file browser.

Matching

If "Match All" is selected, the workflow will be triggered for each file placed in the directory, regardless of it's name.

If "Match Regular Expression" is chosen, only files matching the regular expression in the regular expression field will cause the trigger to fire.

Minimum Size

The minimum size field allows you to establish a minimum size of the file before the trigger will fire. This helps prevent premature triggers should a transfer stall or perhaps a program writes a little in the file, then waits some time before writing the rest.

Stable Time

The number of seconds the file must remain unchanged before the trigger fires. This prevents the trigger from firing until the file is completely written.

Injected Variables

When a file trigger fires, it sets the following variables...

fileName -- The simple name of the file (without the path) fullFileName -- The full URL-like name of the file

These variables may be used to pass which specific file has been created into the workflow.

The Variables Tab

Like all triggers, the file trigger can inject one or more variables. This covered in "Triggers and Data Injection".