Generator
- Juan Tomás Alonso Nieto (Unlicensed)
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. |
| 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. If true, past periods are discarded. If false, past periods are executed without delay. |
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.
You can try this flow by downloading this JSON file and uploading it to your domain using the Import option.