Scheduler
uniflow.plugin.scheduler •
Category: Timer / Logic •
Version: v1.0.8
Scheduler Plugin Reference Manual
1. Overview
Plugin Name: Scheduler
Type: Automation / System
Identifier: uniflow.plugin.scheduler
Description
Provides automated date-, time-, interval-, and Cron-based trigger evaluation for Uniflow industrial rule execution. Evaluates configured schedules across system or IANA timezones and emits multi-format timestamp data (ISO 8601 string, Unix Time in seconds, Unix Time in milliseconds, booleans, and custom values) into the Uniflow telemetry catalog to fire rules on exact schedules.
2. Configuration Parameters
The following configuration fields are available in the User Interface for this plugin:
| Configuration Setting | Description |
|---|---|
| Source Name | Friendly display name of the Scheduler source instance (e.g., Shift Event Scheduler). |
| Time Zone | Target timezone used for schedule evaluation (Local, UTC, or system/IANA timezone ID e.g., UTC, Eastern Standard Time, Europe/London). |
| Check Tick (sec) | Evaluation check tick frequency in seconds (default 1 second, minimum 1). |
| Enabled | Boolean flag (True/False) specifying if the scheduler engine is active. |
3. Scheduled Points & Trigger Configuration
Each configured Scheduler source manages a collection of scheduled points. Points can be added, edited, or removed using the dedicated Schedule Point Editor Dialog.
| Point Parameter | Description |
|---|---|
| Trigger Name | Friendly display name of the scheduled trigger point (e.g., Morning Shift Start, Daily Report Generation). |
| Schedule Type | Schedule timing strategy: DailyTime, OneTime, Cron, or Interval. |
| Time of Day (HH:mm:ss) | Time of day target for DailyTime and OneTime schedules (formatted as HH:mm:ss, e.g., 08:30:00). |
| Target Date | Specific calendar date target for OneTime schedules. |
| Active Days of Week | Day-of-week active flags (Mon, Tue, Wed, Thu, Fri, Sat, Sun) for DailyTime schedules. |
| Cron Expression | Standard 5-field Cron expression (e.g., 0 8 * * 1-5 for Mon-Fri at 8:00 AM) with live preview validation. |
| Interval Seconds | Recurrence period in seconds for Interval schedules (e.g., 60 for every minute). |
| Output Payload Format | Payload format emitted upon trigger: DateTime, UnixTimeSeconds, UnixTimeMilliseconds, Bool, CustomString, Int32. |
| Custom String Value | Text payload value emitted when PayloadType is CustomString. |
| Custom Int Value | Integer payload value emitted when PayloadType is Int32. |
| Enabled | Boolean flag indicating whether the individual point trigger is enabled. |
| Auto-disable (OneTime) | Automatically disables the trigger point after firing once (OneTime schedules). |
4. Key Features & Dialogs
Timezone-Aware Schedule Evaluation
Local, UTC, and all operating system / IANA timezones).Flexible Trigger Strategies
HH:mm:ss timestamp.minute hour day-of-month month day-of-week) using the Cronos engine, with real-time expression validation and next-occurrence preview in the UI.Multi-Port Output Data Stream
When a schedule fires, the source adapter populates all available output representation ports on the Rule Integration node:
"2026-08-01T08:30:00.0000000+00:00"1785573000)1785573000000)5. Exposed Routes & Data Types
The following routes are available in the Uniflow catalog for this plugin:
| Display Name | Route ID | Kind | Category | Access | Data Type |
|---|---|---|---|---|---|
| point.Name | point.Id (GUID) | Value | Scheduler | ReadWrite | String / Int32 / Double / Bool |
6. Usage Examples
Scenario A: Triggering Daily Shift Reports at 08:30 AM (Mon-Fri)
1. In the Scheduler Source Editor, create a new source named Shift Scheduler with Time Zone = Local.
2. Click Add Schedule and configure:
Morning Shift StartDailyTime08:30:00Mon, Tue, Wed, Thu, Fri (Uncheck Sat, Sun)DateTime3. In the Rule Editor, place a Source Input graph node select Shift Scheduler -> Morning Shift Start.
4. Connect the ISO 8601 (String) output port or Unix Time (s) output port to downstream notification nodes (e.g., Email, MQTT, Database logger).
Scenario B: Periodic Clean-up Task Using Cron
1. In the Scheduler Source Editor, click Add Schedule.
2. Configure:
Hourly Backup TriggerCron0 * * * * (Fires at minute 0 of every hour)UnixTimeSeconds3. In the Rule Editor, link the trigger port to execute database export or file cleanup rules.
Scenario C: One-Time Maintenance Event
1. Configure:
Scheduled Maintenance RebootOneTime2026-12-3123:00:00True)2. Upon reaching the target date and time, the scheduler fires the rule and automatically disables the point.