Apps & Solutions Tutorials - Developer Documentation
Skip to content

Apps & Solutions Tutorials

Learn more about different Insights Hub Apps and Solutions in the following tutorials:

Visual Flow Creator

Immediately access your data with Visual Flow Creator - Create a flow for visualization

Use the Visual Flow Creator app

  1. Drag and drop an Input node onto the working area

  2. Input nodes can feed data into flows and trigger execution

  3. Double click on the node to edit the content

  4. On the Payload line select the desired style Click on the 3 dots icon to edit the code

  5. Copy and Paste the code from the code block window to the node

  6. Drag and drop an Output node onto the working area Output nodes send the data from the flow to other services or to the debug tab

  7. Connect the nodes to create a flow

  8. Save your creation

  9. Trigger data to the flow with the inject node

  10. Check the debug window to visualize the results

Add an analytics node to the flow

  1. Drag and drop into the flow an analytics node

  2. Choose a parameter for a specific calculation

  3. Save your creation

4.Trigger data to the flow with the inject node

  1. Check the debug tab to visualize the results The messages displayed in the debug window can be filtered using the filter button.

Calculate a KPI on Visual Flow Creator

Create a basic flow

On the Visual Flow Creator app, create a basic flow

  1. Drag and drop on the main page
  2. Input node e.g inject. Input nodes trigger data to the
  3. node e.g read

  4. Output node e.g. debug. Output nodes send the data from the flow to other services or to the debug tag

  5. Double click on the node to edit the content e.g on inject node edit the repeat option e.g on read timeseries node on topic choose an asset, variables and period

  6. Connect the nodes to create a flow

  7. Save your creation

  8. Trigger data to the flow with the inject node

  9. Check the debug tab to visualize the results The messages displayed in the debug window can be filtered using the filter button.

Add a function and filter node with an email sender

Drag and drop between the time series node and the debug node

A function node

  1. Double click on the node to edit properties

  2. Edit the name of the function and on the code window write in Javascript a simple function

  3. On the code block window below copy the entire text The function reads the last value on the string. On this case the Current last value

var newMsg = {payload: msg.payload[msg.payload.length-1].Current}; return newMsg;

A filter node

  1. Double click on the node to edit properties

  2. Edit the name of the filter and on the code window write in Javascript the filter function

  3. On the code block window below copy the entire text On this case all values of the Current bigger then 45[A] will be shown

element.Current >45

A send email node

  1. Double click on the node to edit properties Add Recipients, email Subject and choose the priority

  2. Add a customized message

  3. Save your creation

Trigger data to the flow with the inject node Edit the Repeat inside the inject node to trigger data between an interval or at a specific time

vfc-node

On each node notice that:

  • The orange border indicates that the node is selected

  • The blue circle identifies nodes that have not yet been saved

  • The red triangle indicates missing inputs or errors in the node properties

  • The text below the node shows status and error messages

Insights Hub Business Intelligence

Create a dashboard and publish to your tenant

On the Visual Flow Creator app

  1. Add the dashboard nodes to the flow The dashboard nodes, called widgets, provide a set of nodes for reading, visualizing and analyzing data on a live dashboard

  2. Double click on the Dashboard node to edit properties

  3. Assign each node to a Group in a Tab

  4. Click on the Dashboard Tab to see the tab Layout The Layout defines the tabs with dashboard elements and links.

  5. Create a Tab Edit the name of the tab

  6. On the Tab add one or more Groups Edit Group information This defines on which Tab that group will appear on the dashboard

  7. Re-order the tabs, groups and links Hover the mouse on the tab or group and see a red dashed line around the corresponded node

  8. Click on the open in browser icon for a quick visualization of the dashboards

See also the description of all dashboard nodes available in Visual Flow Creator

Definitions: Group: A group is a container for multiple dashboard elements. You can add or edit a group for each flow and you can develop multiple groups under the tab.

Tabs: Tabs are created under dashboard window. You can add and edit groups and edit the group properties under the tab. You can add or edit multiple groups in the tabs.

Links: You can create links to other web pages in the dashboard panel of the sidebar window.

Dashboard Site: edit the widget formats for more customization.

Dashboard Theme: edit the color of the background and the upper bar of your dashboard, by default they are white and blue respectively, as well as the font of the text.

Access the dashboards via Dashboard Viewer or Fleet Manager

  1. On the Visual Flow Creator app, on the dashboard tab under Layout

  2. Click edit on the Tab to be published

  3. On Access select Show in Dashboard Viewer and update

  4. On tab Theme, change the color of the dashboard

  5. Save the flow

On the Launchpad, on the Dashboard Viewer

  1. Select the desired dashboard

  2. Visualize and interact with the the dashboard

On the Launchpad, on the Fleet Manager app

  1. Filter and select the asset

  2. Click on the Visual Flow Creator Plug in

  3. Visualize and interact with the the dashboard

Insights Hub Business Intelligence (Visual Explorer)

Defining data sources to start Insights Hub Business Intelligence (Visual Explorer) - Create a new Data Source

On the Insights Hub Business Intelligence Data (Visual Explorer Connector) app,

  1. Datasources window, click on New Data Source

  2. Choose the type

  3. Data sources for assets of twin type performance Assets to create a data source for specific assets from a list of assets Asset Types to create a data source for all assets of a certain asset type

  4. Other sources High Resolution Assets or IDL File Subscription for data source over IDL files

  5. Select an asset, then select one or multiple aspects

  6. The information button shows the variables on that aspect. Multiple assets and aspects can be selected. Choose an update mechanism Fixed Range, this mechanism ensures one-time data extraction to Visual Explorer Continuous Update, this mechanism ensures ongoing synchronization

  7. Save data source Edit name and save location, also add tags for organization purposes

Dashboarding with Insights Hub Business Intelligence (Visual Explorer) - Create a Workbook

Use the data source from Insights Hub Business Intelligence Data (Visual Explorer Connector) in Insights Hub Business Intelligence (Visual Explorer). Open the Insights Hub Business Intelligence (Visual Explorer) app in the Insights Hub Launchpad

  1. In the left corner select Explore

  2. Click on the project in which the data source is saved

  3. Click Create to start a new Workbook

  4. Select the Data source and connect

  5. Drag and drop from the measures to a row or column for visualization To the right to add and to the left to delete

  6. Add a Dimension Automatically aggregation of values are shown

  7. Select a value and see edit options

  8. Change the time stamp

  9. Edit the axis name

  10. Add a dimension into the Marks

  11. Customize your graph

  12. Under Marks change Color, Size, Label, Path and more

Create calculation in a new Worksheet

  1. Drag and drop another measure to a row or column

  2. Customize visualization Change color of each Asset

  3. Click Workbook to add a new Worksheet

  4. Select a measure and Create a Calculated Field

  5. Find available functions on the list On this case the IF function A red message appears if there are mistakes in the code of the function

  6. Click Okay to save

  7. Click on the Show Me button on the right upper side The available possibilities for the select values will be shown

  8. Customize visualization

Create Dashboard

  1. Select new Dashboard

  2. Define Dashboard Size

  3. Select show dashboard title

  4. Double click on the box to edit and Apply to visualize

  5. Drag and drop the desired Sheets to visualize on the Dashboard

  6. Customize with the options under Objects Add a Text box and an image

Add more Data Sources

  1. Create a new Worksheet

  2. On Data connect another data source

  3. Search and click Create

  4. Create a graph with the new data source

  5. Add this new worksheet to the Dashboard

Open the Dashboard from the main menu

  1. Search and select the Dashboard

  2. Select Share to share the Dashboard with other tenant users Available download button

  3. Select Edit to go to edit view

Find more on the manual

Last update: September 27, 2023

Except where otherwise noted, content on this site is licensed under the Development License Agreement.