Field Object Watcher job keeps track on the actions that should be fired on specific date or time (so-called delayed actions).
Field Object Watcher works on the EventNotification table reading the due dates which are written to it by our system acording to the date filters configured in actions. All the entries earlier or equals to current date on job execution will trigger action.
Example
There is an Order module with the field Deadline of the type date. The Manager needs an action to notify him about the deadline of the item two days before it is due.
The administrator creates an action on item create/update with a filter set for the Deadline field: 2 Days before the Deadline.
The item in the Order module is created or updated with the Deadline date 27/03/2011. Today is the 24th of March, therefore the action will not be fired immediately, instead a record will be added to EventNotification table with a trigger date 25/03/2011 for this action.
If we configure and run Field Object Watcher job on the 25th or 26th of March, it will find the item and will fire the action on create/update.
Parameter | Description |
|---|---|
joblist=fieldObjWatcher | The name of the job that will fire scheduled due actions. |
job.fieldObjWatcher.type= enCode.app.common.scheduler.jobs.FieldObjectWatcherJob | The name of the class that will perform the job. |
job.fieldObjWatcher.param.cutOffDate=01-01-2009 | The parameter instructs the job to only inspect items with a date that is later than the specified date. All the due items before this date will be ignored by the job. Please, note! The job runs only once with this parameter. In order to setup the regular run, use startTimes or interval parameter. |
job.fieldObjWatcher.startimes=11:40,17:50 | Time from 00:00-23:59 when the job starts. Job is performed on daily basis. Comma separated list (spaces not allowed) |