Xentara v1.2
User Manual
|
A JSON object describing an execution track has the following syntax:
id | A string value containing the ID of the group. The ID is used to construct the group’s primary key. |
uuid | A string value containing the unique UUID of the group. |
threadCount | An integer value describing the size of the thread pool used for this track. This value must be greater than 0. Usually, the thread count should not be greater than the number of cores available on the target machine. If you specify 1 as the thread count, all tasks in the track will run sequentially. |
events | A JSON array containing all of the track’s events. |
timers | A JSON array containing all of the track’s timers. |
A JSON object describing an event within an execution track has the following syntax:
The array can contain as many events as desired. If no events are desired, the array can be empty, or the entire events member can be omitted.
source | A string value describing the event that should trigger the pipeline. The string value must contain the primary key of the event. |
pipeline | A JSON object describing the pipeline to execute. |
The array member describing the timers within an execution track has the following syntax:
The array can contain as many timers as desired. If no timers are desired, the array can be empty, or the entire timers member can be omitted.
period | A string value containing the period of the timer. The string must be a number followed by one of the units "ns", "ms", "µs", "s", "m", or "h", for nanoseconds, microseconds, milliseconds, second, minutes, or hours respectively. For microseconds, you can write "us" instead of "µs". The period can contain fractions. The string "0.5ms" is a valid period. |
offset | A string value containing the offset of the timer. The timer will be offset by the specified time interval compared to a timer with offset 0. A positive offset will make the timer fire later, a negative offset will make the timer fire earlier. The offset must must be string value containing either "0" for no offset, or a number followed by one of the units "ns", "ms", "µs", "s", "m", or "h", for nanoseconds, microseconds, milliseconds, second, minutes, or hours respectively. For microseconds, you can write "us" instead of "µs". The offset can be negative, and contain fractions. The string "-0.5µs" is a valid offset. |
sequence | An optional integer value containing the sequence number of the timer. The sequence number is used to fine-tune the in which concurrent timers are executed. If you do not specify a sequence number, a sequence number of 0 will be used. |
pipeline | A JSON object containing the pipeline to execute when the timer fires. |
The object member describing the pipeline of an event or timer has the following syntax:
checkPoints | A JSON array containing the check points of the pipeline. Since the check points do not have any properties of their own, each check point is represented by an empty JSON object ({} ). The array can contain as many check points as desired, but there must be at least two. |
segments | A JSON array containing the segments of the pipeline. |
A JSON object describing describing a pipeline segment of an execution pipeline has the following syntax:
The array can contain as many segments as desired, but there must be at least one.
start | An integer value containing the index of the starting check point of the segment. The index is 0-based, so that the first check point has index 0, and the last checkpoint has index (number of checkpoints) - 1. If the pipeline has four check points, for example, then indices must be between 0 and 3. |
end | An integer value containing the index of the ending check point of the segment. The index must be higher than the start index. |
tasks | A JSON array containing the tasks to be executed. The array can contain as many tasks as desired, but there must be at least one. |
function | A string value describing the actual Xentara element task to be executed for each task entry. The string value must contain the primary key of the task. |
Here is an example of a complete track: