Contents x
    HTTP Node
        Contents

        HTTP Node

            Article summary

            HTTP Node

            HTTP is a common application protocol used in distributed, collaborative, and hypermedia information systems. The HTTP node enables users to send data to the workflow via POST and GET methods. It can receive data from several IoT cloud services. Some example integrations could be:

            • Microsoft Azure IoT Hub,
            • Actility ThingPark,
            • Digital Matter OEM Server.

            The HTTP node will output data into the rest of the workflow. Each device's payload will be delivered in the order they are received.

            A quick introduction to workflows can be found between 3:30 - 4:24 in the below video 

            Adding a HTTP node to your workflow

            1. First, make sure you’ve selected your desired solution and are now in Rayven Workflow.
            2. Select ‘Inputs’ from the left-hand panel.
            3. Find the HTTP node and drag it onto the canvas.
            4. Double click on the HTTP node to open its configuration window.

            Configuring your HTTP node

            1. Give your node a name. It’s best to choose something simple that clearly explains the node’s purpose. You must pick a name that has three or more characters.
            2. You will see an auto-filled unique URL. This points to the Rayven server and can't be changed. 
              1. An example of this URL format:
              2. When transmitting to this URL you will need to ensure you've changed the [[device_id]] so it is the same at the device ID that appears in the Device Management System. This is so the system can authorize data from the device to be saved in the system. For more information, see Section 3.3: Device Management.
            3. Choose whether to configure a password for extra security. This password must match the password set at your device for authentication to take place. It must be at least 8 characters long and include at least one lower case character, one upper case character, and one special character such as ! or *.
            4. Select the format of the payload data. JSON is the default. If you choose 'JSON Array' you will need to specify the field leading to this under 'Path To Array'. For example, 'parent_field.path'. 


            Adding timestamps

            You can configure the timestamps of your input node so that it records when data is received from a device. To do so, the device will need to have a time zone configured, and you will need to define the following fields on your HTTP input node: 

            1. Date Field Name
              • Enter the name of the date field as it appears in the device payload.
            2. Date Format
              • Specify the format of the data being received, for example, dd/MM/yyyy or hh:mm:ss. 
              • If this is a 24-hour format the hours, this needs to be indicated by entering the hours in capital letters (e.g. HH/mm/ss).
            3. Timezone
              • Select the time zone for the device from a drop down list.



            Activation

            Once the node has been configured, click 'activate' and then 'save'. The node is now ready to receive data. 


            See Also: Section 3.3: Adding devices
            As of Release: 08.12.2021

            What's Next