Blockbax Integration
Last updated
Last updated
Blockbax is a platform designed to automate business operations through sensor and machine data without the need for coding.
With a few click you can integrate data captured by BACE IoT Platform into Blockbax and create very powerful dashboards to help make sense of your data.
Creating an inbound Connector in Blockbax Project
Creating an access token in Blockbax project
Creating a webhook in BACE IoT Platform
Creating a new subject type in Blockbax
Creating a subject in Blockbax
In this step you will create an inbound connector to generate a URL endpoint for Webhooks to be sent from BACE IoT Platform.
Login to your Blockbax account. Go to Settings -> Inbound Connectors -> (+) Create Inbound connector.
Provide a name (i.e. BACE Gateway) and under Use template conversion dropdown select BACE IoT Platform: Measurements webhook When finished click Create connector
Inbound connector is created with a unique endpoint that allows sending data into Blockbax platform. The URL in endpoint field will be used during webhook creating in BACE.
For integration into Blockbax, you'll also need an access token to send messages to Blockbax endpoint.
Go to Settings -> Access Token -> (+) Create access token
Give a name to access token (i.e. BACE Integration), and set permission to Measurement writer. Click Create access token
You will need authorization token for HTTP, so keep ApiKey <TOKEN> in the next step for authorization.
In this step, we'll explain how to create a webhook in BACE IoT Platform that will push information to Blockbax inbound connector created in previous step.
Login to BACE Panel and click into one of the project that you want to integrate into Blockbax.
On left navigation click Integrations -> Webhooks
Click Create a Webhook and provide a name to the webhook (i.e. Integration to Blockbax). Make sure to paste URL copied from Blockbax inbound connector into Webhook URL field.
Paste the Access token created in previous step inside Authorization field. Paste ApiKey <Token> in this field. DO NOT include Authorization: text.
When successful you should start seeing Webhook responses inside Blockbax inbound connector
If you are seeing some messages below loging, the messages are pushed into Blockbax as expected and next step is creating a subject type for these messages.
For processing data in Blockbax, you need to map incoming data from BACE IoT platform to a Blockbax subject type first. Subject types are like device templates that helps you connecting similar equipment in bulk easily.
You need to create Metrics for all data points pushed from BACE IoT Platform. For finding out which datatypes are pushed from BACE, in BACE Panel Go to Modbus Devices -> Click one of the Gateways -> Device Info. As you can see from the example below Local port, Serial Baud rate, Module Adress and DO Power on-state are being read by BACE.
Create a new subject type by clicking Subjects -> Types -> (+) Create a new subject type
Provide a name that you can remember. In this example, we are integrating an Ebyte Modbus IO module so we named it with Ebyte IO Module
In next screen click Create Metric to add all metrics into the subject type.
Select ingested, relevant data type and click Create Metric. In this step you can also define additional attributes like unit, upper bound, etc. Refer to Blockbax documentation for each option.
Add all metrics you want to see in Blockbax dashboard
When finished with adding all metrics, you can create a subject using the subject template.
In next step you need to create a new subject using the subject type that was created in the previous step.
Go to Subjects -> Overview -> (+) Create a new subject
Select the subject type you have created in previous screen, and provide a name. External ID should match the source_device
attribute in the BACE Webhook response. This UUID is also available in the BACE Panel URL
Click Create Subject to finalize
You have successfully integrated data from BACE Platform into Blockbax now! You can continue with creating custom dashboards following steps in Blockbax documentation.