sensemetrics Data Import- Importing Connections and Sensors from sensemetrics to iTwin IoT


Overview

The Bentley team has developed a process for importing connections, devices, sensors, historic data, and sensor configurations from sensemetrics into iTwin IoT. All information available within the Connectivity Module will be available on both sensemetrics and iTwin IoT. This workflow allows users to run their existing sensemetrics project simultaneously in iTwin IoT but operate each product separately. Only the sensor data will be synced across platforms. Once the data is imported into iTwin IoT, users can finish setup of iTwin IoT by adding users, setting up graphs, dashboards, alerts, reports, etc. The table below provides a breakdown of This article will guide you in gathering the required information from Sensemetrics and importing the data into the iTwin Iot application. 

Requirements: User conducting data import must have access to API keys within Sensemetrics and must have an Admin role in Bentley IMS that allows you to create new iTwin IoT assets. An overview of IMS roles can be found in the article here.

Note: Users added to a project in Sensemetrics and any profiles created within modules on Sensemetrics will not be transferred. Users will have to be added within iTwin IoT and any module profiles will need to be rebuilt within iTwin IoT.

 

Data Import Functionality
Does Does Not
Imports API, MQTT, FTP connections like Loadsensing CMT, Omnidots, and Geomos, including any sensors, sensor configurations in Sensemetrics, and historic data associated with them. Provide for the import or migration of existing users on the project into iTwin IoT.
Import hardware connections like Threads, Strands, Geonets, and any other logging devices. Sensors, sensor configurations in Sensemetrics, and historic data associated with these devices will also be imported. Transfer or migrate dashboard, graph, alerts, maps, or report module profiles.
Allow users to access the same sensors within both iTwin IoT and Sensemetrics.   
Any configuration change made to a connection, device, or sensor in one platform will have the same effect in the other platform. This includes changing configuration settings, renaming, archiving, and deleting.  

 

Gathering Information from Sensemetrics

The API key for the project being imported is required from Sensemetrics. We will start by retrieving the API key for the project.

  1. Login to Sensemetrics at https://app.sensemetrics.com/.
  2. On the upper-right corner of the Sensemetrics page, click on the Manage Account icon. A selection window will appear.
  3. Click the "Account Settings" option.
  4. In the next screen click the "Projects" button on the left sidebar list.
  5. Click on the name of the project to import from the Projects window that appears.
  6.  The API Key will be available within the Settings page. Highlight and copy or click the copy link button to record the API Key for use in the next steps.

Importing Project to iTwin IoT

The next step will be to create a new import asset in iTwin IoT.

 

  1.  Login to https://itwiniot.bentley.com/. 
  2.  A blue "Register Asset" button will shortly become available in the upper right portion of the Assets landing page. Click on the button to navigate to the Asset Creation page. Note: This button may not immediately become available due to entitlement verification requirements. If this button is greyed out or unavailable, please confirm you have the proper Admin privileges then contact iTwin IoT support via a support case.
  3. You will be directed to the "Register Asset" page. On the upper right portion of the page, you will find the "Import Sensemetrics connections" button. Click this button to go to the Import page.
  4. The Import page will open, which looks like the below image. Begin the process by entering the API key retrieved from Sensemetrics in the previous section into the API key input tab.
  5. The "Fetch Projects" button will change colors from grey to blue. Click the button. 
  6. Click the "Project" dropdown selector to reveal the project. If this is the correct project for Import, click the project name to select it. 
  7.  Once a project is selected, the "Next" button changes colors from grey to blue. Click the button. 8. Use the map navigation tools and the box/polygon tools to draw a box around the project. Once the polygon is drawn, click the blue checkbox button, which will populate the latitude and longitude of the selected polygon. 9. Once the extents and lat/long are configured, click the blue "Next" button at the bottom.

          10. The next page will provide some additional information and notices before you confirm that you would like to complete the Import. Click the blue "Import" button at the bottom if you            would to proceed.

 

This completes the Import process! The next page will allow you to open the recently imported project or restart the process to import additional projects. All connections, devices, and sensors will be available in the iTwin IoT Connectivity page.