Generator
Description
This unit is a Source unit type.
The Generator unit generates events autonomously based on event frequency, quantity, and content settings configured in the properties.
When the unit receives events, it applies the conditions set in the properties.
Events are output through the out port with the desired period/frequency until the configured number of total events is reached. Optional fields containing the event order number and period start date will be added to the event.
Configuration
After dragging this unit into the Flow canvas, double-click it to access its configuration options. The following table describes the configuration options of this unit:
Tab | Field | Description |
---|---|---|
General | Name | Enter a name for the unit. It must start with a letter, and cannot contain spaces. Only letters, numbers, and underscores are allowed. |
Description | Enter a description detailing the scope of the unit. | |
Total events | The total number of events to be emitted. Use -1 to allow an unlimited amount of events. | |
Counter field name | Enter the name of an input event field containing an event order number, starting at zero, to be added to the output event (optional). | |
Table field name | Enter the name of an input event field containing the period start date to be added to the output event (optional). | |
Period | Millis | The number of milliseconds between actions. The action depends on the value entered in the 'exact' field of the unit. Enter 0 to set to 'as soon as possible', rendering the 'exact' field value obsolete. |
Exact | If true, the 'millis' value is interpreted as how often to carry out a given process, even if the previous process in the flow has not finished. | |
Aligned | When set to 'on', the period will not start counting from the moment of the alert creation but from a fixed division that takes 0 as the starting point. Only valid for exact periods. For example, when aligned is on, imagine your 'millis' value is 120000 (2 minutes) and the alert was created at 00:03, the first event will be generated at 00:04 and every two minutes thereafter. However, if it is not aligned, the first event will be generated at 00:03, the next at 00:05 and so on. | |
Drop past periods | Which action to take when transformation takes longer than the configured period. |
Input ports
This unit does not have any input ports.
Output ports
Port | Description |
---|---|
out | Outputs the indicated number of events at the given frequency, with optional fields containing the event order number and period start date. |
Example
Imagine you wish to generate an unlimited number of events and send them via email.
You can use the Generator unit to emit the desired number of events from across Devo. To do it, we add a Generator unit to fire out events. Finally, we link it to the in input port of an Email sink unit to send it to the required recipients.
In the Generator unit properties, set the total number of events to -1 in order for unlimited events.
In the Email Sink unit properties, specify the email to send the events to.
Download this example
You can try this flow by downloading the following JSON file and uploading it to your domain using the Import option: