There are three primary types of timer event nodes:
-
Timer Start Event (interrupting/non-interrupting): This node initiates a process instance at a scheduled time, either interrupting or non-interrupting ongoing processes. It allows you to set a specific date, duration, or cycle for the process to start. You can configure it to trigger a process instance just once or repeatedly.
-
Timer Intermediate Event: This node introduces time-based triggers within a process. It’s used to pause the process execution until a specified time duration or date is reached. Once triggered, the process continues its execution.
-
Timer Boundary Event (interrupting/non-interrupting): Attached to a task or subprocess, this node monitors the passage of time while the task is being executed. When the predefined time condition is met, the boundary event triggers an associated action, interrupting or non-interrupting the ongoing task or subprocess.
Timers
Timers introduce the ability to trigger events at specific time intervals. They can be configured in three different ways: as a date, a duration, or a cycle. These configurations can use static values or dynamic/computed values.
-
Date: Events triggered on a specific date and time.
- Format: ISO 8601 (e.g.,
2019-10-01T12:00:00Z or 2019-10-02T08:09:40+02:00)
-
Time Duration: Events triggered after a specified duration.
- Format: ISO 8601 duration expression (
P(n)Y(n)M(n)DT(n)H(n)M(n)S)
- P: Duration designator
- Y: Years
- M: Months
- D: Days
- T: Time designator
- H: Hours
- M: Minutes
- S: Seconds
Examples:
PT15S - 15 seconds
PT1H30M - 1 hour and 30 minutes
P14D - 14 days
P3Y6M4DT12H30M5S - 3 years, 6 months, 4 days, 12 hours, 30 minutes, and 5 seconds
- Time Cycle (available for Timer Start Event): Events triggered at repeating intervals.
- Option 1: ISO 8601 repeating intervals format (
R)
- Examples:
R5/2023-08-29T15:30:00Z/PT2H: Every 2 hours seconds, up to five times, starting with 29 August, 15:30 UTC time
R/P1D: Every day, infinitely
- Option 2: Using cron expressions
- Example:
0 0 9-17 * * MON-FRI: Every hour on the hour from 9 a.m. to 5 p.m. UTC, Monday to Friday
Important: Only Spring cron expressions are permissible for configuration. Refer to the official documentation for detailed information on configuring Spring Cron expressions.
Scheduled timer events are clearly indicated within the process definition list, as illustrated in the following example:
To manage timers efficiently, you have the option to activate or suspend them through the convenient quick actions menu located in the process page header:
More information about timer expressions you can find in the below section:
Timer expressions
Configuration
For each node type, the following timer types can be configured:
| Node Type | Date | Duration | Cycle |
|---|
| Timer Start Event | Yes | No | Yes |
| Timer Intermediate Event | Yes | Yes | No |
| Timer Boundary Event | Yes | Yes | No |
A process definition version should have a single Timer Start Event.
For comprehensive details on each timer event node in this section, please refer to the corresponding documentation: