Difference between revisions of "Triggers"
(→SimpleTriggerBuilder) |
|||
| Line 14: | Line 14: | ||
A Trigger that is used to fire a Task at a given moment in time, and optionally repeated at a specified interval. | A Trigger that is used to fire a Task at a given moment in time, and optionally repeated at a specified interval. | ||
| + | |||
| + | The following table shows the SimpleTriggerBuilder element's attributes: | ||
| + | {|class="gvtable" | ||
| + | ! Attribute !! Type !! Description | ||
| + | |- | ||
| + | | type || fixed || This attribute must assume the value '''cron-trigger''' | ||
| + | |- | ||
| + | | class || fixed || This attribute must assume the value '''it.greenvulcano.scheduler.util.quartz.impl.trigger.SimpleTriggerBuilder''' | ||
| + | |- | ||
| + | | name || required || Trigger name | ||
| + | |- | ||
| + | | startTime || optional || Trigger starting time in ISO format: yyyy-MM-dd HH:mm:ss | ||
| + | |- | ||
| + | | endTime || optional || Trigger ending time in ISO format: yyyy-MM-dd HH:mm:ss. | ||
| + | If not defined is the server starting time rounded to the next minute. | ||
| + | |- | ||
| + | | repeatInterval || optional || The period of repetition of the trigger, in ms. | ||
| + | If not defined the task is executed only once. | ||
| + | |- | ||
| + | | repeatCount || optional || The number of repetitions of the trigger. | ||
| + | If not defined the task is executed only once. | ||
| + | If 'period' == -1, the task is repeated endlessly (or to 'endTime'). | ||
| + | |- | ||
| + | | timeZone || optional || Trigger TimeZone. | ||
| + | If not defined is used the TimeZone defined for DateUtils. | ||
| + | |- | ||
| + | | calendarName || optional || Associate the Calendar with the given name with this Trigger. | ||
| + | |} | ||
| + | |||
| + | Might contain the following sub-elements: | ||
| + | * Description | ||
| + | * [[#TgProperties|TgProperties]] | ||
| + | |||
| + | ====TgProperties==== | ||
| + | |||
| + | This element defines additional properties of the Trigger. | ||
| + | |||
| + | Might contain the following sub-elements: | ||
| + | * Description | ||
| + | * [[PropertyDef]] | ||
| + | |||
| + | |||
| + | ===DateIntervalTriggerBuilder=== | ||
| + | |||
| + | This element represents a Trigger that is used to fire a Task based upon repeating calendar time intervals. | ||
| + | |||
| + | |||
| + | The following table shows the DateIntervalTriggerBuilder element's attributes: | ||
| + | {|class="gvtable" | ||
| + | ! Attribute !! Type !! Description | ||
| + | |- | ||
| + | | type || fixed || This attribute must assume the value '''cron-trigger''' | ||
| + | |- | ||
| + | | class || fixed || This attribute must assume the value '''it.greenvulcano.scheduler.util.quartz.impl.trigger.DateIntervalTriggerBuilder''' | ||
| + | |- | ||
| + | | name || required || Trigger name. | ||
| + | |- | ||
| + | | startTime || optional || Trigger starting time in ISO format: yyyy-MM-dd HH:mm:ss | ||
| + | If not defined is the server starting time rounded to the nex minute. | ||
| + | |- | ||
| + | | endTime || optional || Trigger ending time in ISO format: yyyy-MM-dd HH:mm:ss | ||
| + | |- | ||
| + | | repeatIntervalUnit || optional || The period of repetition of the trigger, in time unit. | ||
| + | The attribute admitted values are: | ||
| + | * SECOND | ||
| + | * MINUTE | ||
| + | * HOUR | ||
| + | * DAY | ||
| + | * WEEK | ||
| + | * MONTH | ||
| + | * YEAR | ||
| + | |- | ||
| + | | repeatInterval || optional || The number of repeatIntervalUnit for repetitions of the trigger. | ||
| + | If not defined the default is 1. | ||
| + | |- | ||
| + | | timeZone || optional || Trigger TimeZone. | ||
| + | If not defined is used the TimeZone defined for DateUtils. | ||
| + | |- | ||
| + | | calendarName || optional || Associate the Calendar with the given name with this Trigger. | ||
| + | |} | ||
| + | |||
| + | Might contain the following sub-elements: | ||
| + | * Description | ||
| + | * [[#TgProperties|TgProperties]] | ||
| + | |||
| + | ===CronTriggerBuilder=== | ||
| + | |||
| + | This element represents a Trigger that is used to fire a Task at given moments in time, defined with Unix ''cron-like'' definitions. | ||
| + | |||
| + | The following table shows the CronTriggerBuilder element's attributes: | ||
| + | {|class="gvtable" | ||
| + | ! Attribute !! Type !! Description | ||
| + | |- | ||
| + | | type || fixed || This attribute must assume the value '''cron-trigger''' | ||
| + | |- | ||
| + | | class || fixed || This attribute must assume the value '''it.greenvulcano.scheduler.util.quartz.impl.trigger.CronTriggerBuilder''' | ||
| + | |- | ||
| + | | name || required || Trigger name. | ||
| + | |- | ||
| + | | cronExpression || required || Defines a cron expression. | ||
| + | Reference: [[http://www.quartz-scheduler.org/documentation/quartz-1.x/tutorials/crontrigger]] | ||
| + | |- | ||
| + | | startTime || optional || Trigger starting time in ISO format: yyyy-MM-dd HH:mm:ss | ||
| + | If not defined is the server starting time rounded to the nex minute. | ||
| + | |- | ||
| + | | endTime || optional || Trigger ending time in ISO format: yyyy-MM-dd HH:mm:ss | ||
| + | |- | ||
| + | | timeZone || optional || Trigger TimeZone. | ||
| + | If not defined is used the TimeZone defined for DateUtils. | ||
| + | |- | ||
| + | | calendarName || optional || Associate the Calendar with the given name with this Trigger. | ||
| + | |} | ||
| + | |||
| + | Might contain the following sub-elements: | ||
| + | * Description | ||
| + | * [[#TgProperties|TgProperties]] | ||
Revision as of 10:57, 27 February 2012
Contents
Description
GreenVulcano® ESB uses this element to define a group of Timer Tasks.
VulCon / GV Console Configuration
The Triggers Element is used by: RSHTask, ServiceCallerTask, ShellTask and TestTask.
Might contain the following subelements:
- Description
- SimpleTriggerBuilder or DateIntervalTriggerBuilder or CronTriggerBuilder
SimpleTriggerBuilder
A Trigger that is used to fire a Task at a given moment in time, and optionally repeated at a specified interval.
The following table shows the SimpleTriggerBuilder element's attributes:
| Attribute | Type | Description |
|---|---|---|
| type | fixed | This attribute must assume the value cron-trigger |
| class | fixed | This attribute must assume the value it.greenvulcano.scheduler.util.quartz.impl.trigger.SimpleTriggerBuilder |
| name | required | Trigger name |
| startTime | optional | Trigger starting time in ISO format: yyyy-MM-dd HH:mm:ss |
| endTime | optional | Trigger ending time in ISO format: yyyy-MM-dd HH:mm:ss.
If not defined is the server starting time rounded to the next minute. |
| repeatInterval | optional | The period of repetition of the trigger, in ms.
If not defined the task is executed only once. |
| repeatCount | optional | The number of repetitions of the trigger.
If not defined the task is executed only once. If 'period' == -1, the task is repeated endlessly (or to 'endTime'). |
| timeZone | optional | Trigger TimeZone.
If not defined is used the TimeZone defined for DateUtils. |
| calendarName | optional | Associate the Calendar with the given name with this Trigger. |
Might contain the following sub-elements:
- Description
- TgProperties
TgProperties
This element defines additional properties of the Trigger.
Might contain the following sub-elements:
- Description
- PropertyDef
DateIntervalTriggerBuilder
This element represents a Trigger that is used to fire a Task based upon repeating calendar time intervals.
The following table shows the DateIntervalTriggerBuilder element's attributes:
| Attribute | Type | Description |
|---|---|---|
| type | fixed | This attribute must assume the value cron-trigger |
| class | fixed | This attribute must assume the value it.greenvulcano.scheduler.util.quartz.impl.trigger.DateIntervalTriggerBuilder |
| name | required | Trigger name. |
| startTime | optional | Trigger starting time in ISO format: yyyy-MM-dd HH:mm:ss
If not defined is the server starting time rounded to the nex minute. |
| endTime | optional | Trigger ending time in ISO format: yyyy-MM-dd HH:mm:ss |
| repeatIntervalUnit | optional | The period of repetition of the trigger, in time unit.
The attribute admitted values are:
|
| repeatInterval | optional | The number of repeatIntervalUnit for repetitions of the trigger.
If not defined the default is 1. |
| timeZone | optional | Trigger TimeZone.
If not defined is used the TimeZone defined for DateUtils. |
| calendarName | optional | Associate the Calendar with the given name with this Trigger. |
Might contain the following sub-elements:
- Description
- TgProperties
CronTriggerBuilder
This element represents a Trigger that is used to fire a Task at given moments in time, defined with Unix cron-like definitions.
The following table shows the CronTriggerBuilder element's attributes:
| Attribute | Type | Description |
|---|---|---|
| type | fixed | This attribute must assume the value cron-trigger |
| class | fixed | This attribute must assume the value it.greenvulcano.scheduler.util.quartz.impl.trigger.CronTriggerBuilder |
| name | required | Trigger name. |
| cronExpression | required | Defines a cron expression.
Reference: [[1]] |
| startTime | optional | Trigger starting time in ISO format: yyyy-MM-dd HH:mm:ss
If not defined is the server starting time rounded to the nex minute. |
| endTime | optional | Trigger ending time in ISO format: yyyy-MM-dd HH:mm:ss |
| timeZone | optional | Trigger TimeZone.
If not defined is used the TimeZone defined for DateUtils. |
| calendarName | optional | Associate the Calendar with the given name with this Trigger. |
Might contain the following sub-elements:
- Description
- TgProperties