Combine Node

This node merges data from multiple sources into a single data stream or structure. It's useful for aggregating data from different devices or sensors before processing or analysis.

Functionality

The combine node takes data from multiple incoming JSON payloads and combines them into one JSON object.

Outputs

The combined JSON will contain all the unique JSON keys that the node has received. The output of the combine node can be configured using various options in the node.


How to Use

Implementation

In the Rayven Workflow Builder:

  • Select Functions.
  • Drag the Combine node to the canvas.
  • Provide an input to the Combine node by connecting it to another node.
  • Double click on the Combine node to open the configuration window.

Configuration

Section: General

This section contains basic configuration elements required for any combine implementation

Field

Requirement

Comments

Node Name

Mandatory

Enter a name for this node.


This provides a handle to which you and others can refer, so it should be simple but meaningful and explain the node’s purpose.

Hold Data From

Optional

This will hold the data received from the Node IDs listed in this field until data from another node will be received. This allows you to hold data in the node. 


Enter comma separated numbers of Node IDs connected to this node whose data you want to use.

Keep Adding Data

Optional

If checked, this option will store the data that was received from each input and will keep adding it to each JSON payload that passes through. 


Note that a new value for the same JSON key will overwrite the previous value held.

Payload Combine Method

Optional

Select from dropdown menu

  • Combine Latest Received - JSON key-value pairs will be combined into a single JSON. The JSON values will always be the latest value for each device.
  • Combine with Same Timestamp - JSON key-value pairs will only be combined into a single JSON where all key-value pairs have the same timestamp.
  • Combine with Latest Timestamp - JSON key-value pairs will only be combined into a single JSON with the latest timestamp.

Action on Error

Mandatory

Select from dropdown menu

  • Continue - Add Error to JSON
  • Continue - Ignore Error
  • Stop - Log Error

Group By

Mandatory

Select from dropdown menu

  • Device
  • Device Label