Merge widget
- Last UpdatedOct 10, 2025
- 2 minute read
The Merge widget allows you to combine two time-sequential datasets, such as Downtime events, into a single dataset based on a selected direction using the provided Left and Right control buttons.
If you opt to merge to the left, the selected dataset replaces the content of the dataset that comes before it, which makes the two datasets into a single unit. The same behavior applies if you opt to merge the selected dataset with the dataset on the right.
On the widget's initial load, you see the following:
-
Colored bar
This is divided into three section blocks. Each section represents an event or a particular dataset. The one in the middle is the currently selected dataset, and the other two represent the left and right dataset merge options.
-
Duration
This corresponds to the duration of the currently selected dataset. This is updated accordingly based on the new start or end date and time of the merged datasets.
-
Start and End date and time
These are shown at the bottom of each of the sections, where the start date and time of the currently selected dataset correspond to the end date and time of the dataset on the left, and its end date and time correspond to the start date and time of the dataset on the right.
The displayed date and time follow the operating system format or the browser's local time.
Note: The widget ensures that the start date and time of the currently selected event or dataset isn't earlier than the start date and time of the preceding event, and its end date and time isn't later than the start date and time of the event that follows it.
-
Left and Right control buttons
You can use these buttons to select which event you want to merge the currently selected event with.
-
Dataset/event name
The name of the dataset is shown for each section block. The merged datasets take the name of the currently selected dataset, regardless of the merge direction.
For visualization, see Merge widget representation.
Properties
The Merge widget uses the following properties and some of them are defined as a function in a configuration file. For information on how the properties are used, see Merge widget properties usage. The following table describes the supported Merge widget properties:
|
Property |
Supported datatype |
|---|---|
|
Widget Title (widgetTitle) |
String |
|
Data (data) |
Object |
|
Merge Type (mergeType) |
JSON string The returned value is converted to a JSON string. |
|
Persist Selection (persistSelection) |
Boolean |