IQFLOW Scheduler¶
IQFLOW allows you to schedule various types of events with flexible schedule configuration.
Scheduler events page displays current configured scheduler events. It allows to add, update or delete scheduler events. The page can be presented in two modes List view or Calendar view. The views can be switched by pressing corresponding icons in the page header.
New scheduler event can be created by clicking on + button in top right corner or by clicking on any cell of Calendar view.
Scheduler Event Dialog¶
Scheduler event edit dialog consist of two forms Configuration and Schedule.
Configuration form allows to set event type and event configuration parameters according to selected event type. Configuration of scheduler event is described in Scheduler Event Types section.
Schedule form allows to setup event schedule configuration.
Schedule form has the following parameters:
- Timezone - timezone in which this scheduler event should be processed.
- Start Date/Time - date/time when this scheduler event should be fired.
- Repeat - if this scheduler event is one time or it should be repeated.
- Repeats - repeat rule, can be either Daily or Weekly.
- Repeat on - applicable for Weekly repeat rule. Specifies weekdays when this scheduler event should be fired.
- Ends on - date until which this scheduler event should be repeated.
Scheduler Event Types¶
In Configuration Event type field can be selected existing event type or specified custom one.
Custom Type:¶
Custom type uses default scheduler event configuration form according to message structure.
- Originator - message originator, can be Single entity (ex. Device, Asset etc.) or Group of entities. If not specified, scheduler event entity itself will be considered as originator.
- Message type - message type according to the Rule Engine message types. Can be existing message type or custom. If not specified, scheduler event type will be considered as message type.
- Message body - message body in JSON representation.
- Metadata - key/value table representing message metadata fields.
Generate Dashboard Report:¶
Allows to schedule dashbaord reports generation in PDF, PNG or JPEG.
Report configuration:
- Base URL - base URL of IQFLOW UI that should be accessible by Report Server.
- Dashboard - dashboard that will be used for report generation.
- Dashboard state parameter value - used to specify target dashboard state for report generation. Can be set automatically by clicking on right most button of the field and invoking Select dashboard state dialog.
- Timezone - timezone in which target dashboard will be presented in report.
- Use dashboard time window - if set, time window configured in the target dashboard will be used during report generation.
- Time window - specific dashboard time window that will be used during report generation.
- Report name pattern - file name pattern of generated report, can contain date-time pattern in form of %d{date-time pattern}.
- Report type - report file type, can be PDF | PNG | JPEG.
- Use current user credentials - if set, credentials of user created this report configuration will be used to open dashboard UI during report generation.
- Customer user credentials - target customer user whose credentials will be used to open dashboard UI during report generation.
- Generate Test Report button is used for testing purposes. It invokes report generation process with provided configuration. Resulting report file will be automatically downloaded if the report generation will be successful.
Send email - if set, email message with report file in attachment will be sent.
Email configuration:
- From - from address
- To - comma separated address list of recipients
- Cc - comma separated address list
- Bcc - comma separated address list
- Subject - mail subject, can contain date-time pattern in form of %d{date-time pattern} according to SimpleDateFormat.
- Body - mail body, can contain date-time pattern in form of %d{date-time pattern} according to SimpleDateFormat.
Update Attributes:¶
Allows to schedule update of attributes for entity or group of entities.
- Target - target entity which attributes should be updated, can be Single entity (ex. Device, Asset etc.) or Group of entities.
- Entity attributes scope - scope of updated attributes. Can be selected if Device entity type is specified in Target. Can be either Server attributes or Shared attributes. For all other entity types Server attributes scope is used.
- Server / Shared attributes - key/value table representing attributes with values to update.
Send RPC Request to Device:¶
Allows to schedule command (RPC call) to device or group of devices.
- Target - target device to which command should be sent, can be Single device or Group of devices.
- Method - RPC call method.
- Params - RPC call params in JSON representation.