tWaitForFile Standard properties

Time (in seconds) between iterations

Set the time interval in seconds between each two iterations.

Max. number of iterations (infinite loop if empty)

Set the maximum number of iterations on the specified directory.

Directory to scan

Specify the directory to iterate on.

File mask

Type in the file mask to filter the files to be monitored. To monitor a given file, type in the file name.

Include subdirectories

Select this check box to iterate also on the subdirectories.

Case sensitive

Select this check box to activate case sensitivity.

Include present file

Select this check box to include the file in use.

Trigger action when

Select one of the following trigger conditions:

a file is created: triggers the next component when a file is created.

a file is deleted: triggers the next component when a file is removed.

a file is updated: triggers the next component when a file is modified.

a file is created or updated or deleted: triggers the next component when a file is created, or removed, or modified.

Then

Select what to do with the iteration loop after the next component is triggered:

continue loop: continues iterating until the number of iterations reaches the defined maximum value.

exit loop: stops iterating immediately.

Schema and Edit Schema

A schema is a row description, it defines the number of fields that will be processed and passed on to the next component. The schema of this component is Built-in and cannot be updated.

Wait for file to be released Every (in ms)

Select this check box so that the next component is triggered only after the file operation is completed.

Global Variables

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

CURRENT_ITERATION: the sequence number of the current iteration. This is a Flow variable and it returns an integer.

PRESENT_FILE: the path and name of the present file. This is a Flow variable and it returns a string.

DELETED_FILE: the path and name of the deleted file. This is a Flow variable and it returns a string.

CREATED_FILE: the path and name of the created file. This is a Flow variable and it returns a string.

UPDATED_FILE: the path and name of the updated file. This is a Flow variable and it returns a string.

FILENAME: the name of the file being processed. This is a Flow variable and it returns a string.

NOT_UPDATED_FILE: the path and name of the file that has not been updated. This is a Flow variable and it returns a string.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it.

For more information about variables, see Using contexts and variables.

Usage rule

This component plays the role of triggering the next component based on the defined condition. Therefore this component requires another component to be connected to it via a link.

Connections

Outgoing links (from this component to another):

Row: Main; Iterate.

Trigger: On Subjob Ok; Run if; On Component Ok; On Component Error.

Incoming links (from one component to this one):

Row: Iterate.

Trigger: On Subjob Ok; Run if; On Component Ok; On Component Error; Synchronize; Parallelize.

For further information regarding connections, see Using connections in a Job.