...
This job will watch the folder c:/temp on a MS Microsoft Windows ® operating system. The regular expression (regex) is used to define which file(s) JobScheduler has to watch. In this example the regex means that every event involving the files file1.xml and/or file2.xml will fire the execution of the embedded script (which in this case will echo values for JobScheduler-Environment Variables to stdout).
Every change of files in the folder c:/temp which is matched by the filter ^file1\.xml$ starts a task for the job.
The SCHEDULER_TASK_TRIGGER_FILES environment variable contains the names of all the filtered files in the c:/temp folder at the time where when the task is started. These files was started. This list doesn't just contain the name of the file that triggered the embedded script.
The file names are held in the form of a semicolon separated list. This list doesn't just contain the file which was changed.
Note that this behaviour could be critical when two files (e.g. file1.xml and file2.xml) are changed at the same time.
Two tasks will then be started for the job.
In the first task the environment variable SCHEDULER_TASK_TRIGGER_FILES has will have the value c:/temp/file1.xml;c:/temp/file2.xml.
In the second task the environment variable SCHEDULER_TASK_TRIGGER_FILES will have a value that depends on what the first task has done with the files.
If, for example, the first task deletes the files in c:/temp then SCHEDULER_TASK_TRIGGER_FILES will be empty for the second task.
For further information on how to use file events with a job chain we recommend to read the Directory Monitoring with File Orders.
See also:
- Environment variable (JS Reference handbook)
- Directory Monitoring (JS Reference handbook)