Logic & Automation (ETL)
      Back to home
      1. Home
      2. 5: Workflow Toolkit
      3. Logic & Automation (ETL)

      Multifunctional Device Labels Node

      A node that combines device identification with multifunctional processing capabilities. It might allow for data to be tagged, categorized, or processed differently based on the device it originated from, using labels or identifiers.

      Inputs

      The Multifunctional Device Label node has a mandatory input.

      Input

      Requirement

      Comments

      Input Field Name

      Mandatory

      Enter the JSON key of the value that needs to be aggregated to a device label.

      Functionality

      The Multifunctional Device Label can perform calculation on the input field at the device label value. Eg. Sum all devices that share the same Site label value.

      Outputs

      A new JSON key is created to hold the output of the calculated value based on the configuration set in the node.


      How to Use

      Implementation

      In the Rayven Workflow Builder:

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

      Configuration

      Section: General

      This section contains basic configuration elements required for any Multifunctional Device Label 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.

      Input Field Name

      Mandatory

      Enter the JSON key of the value that needs to be aggregated to a device label.

      Calculation

      Mandatory

      Select the calculation function from the dropdown menu

      • Sum
      • Average
      • Min
      • Max
      • Count
      • Last Count

      Function Time Range

      Mandatory

      Select the function range from the drop down list:

      • Up to timestamp
      • Up to end of interval unit

      Interval

      Mandatory

      Enter an integer for the time interval.

      Interval Unit

      Mandatory

      Select the time unit to be used for the calculation interval from the dropdown menu

      • Seconds
      • Minutes
      • Hours
      • Days
      • Weeks (Start on Sunday)
      • Weeks (Start on Monday)
      • Months
      • Years (Start from January)
      • Years (Start from July)

      Time Zone

      Mandatory

      Select the timezone to be used for the calculation interval. 


      If “Device Time Zone” is selected, the node will automatically calculate the data according to the device time zone which is configured at Device Filter.


      If Custom Time Zone is used, please select the Time Zone in the next dropdown menu.

      Time Zone

      Mandatory 


      (Only if Time Zone Source is set to Custom)

      Select the Time Zone to ensure that the aggregation is done for the right interval in the time zone selected.

      Output Field Name

      Mandatory

      Enter the JSON key to hold the calculation output. If the key exists in the input, the value will be overwritten by the calculation output. Otherwise, the JSON key will be created to hold the calculation output.

      Device Label 1

      Mandatory

      Select from the Device Label created in the Devices Table. This selection will limit the calculation to only take the value of devices that share the same Device Label values.


      Users can add more than 1 device label.

      Decimal Precision

      Optional

      Optional parameter. Set the decimal precision of the output value.