Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview 

This Tutorial will introduce the concept of TagProvider, which allows tagless connections with external and dynamic data sources. 

In this application, we will connect to an MQTT broker and a generic display that will show information about the selected element. This solution won't create any local tags; everything will be executed with dynamic connections.

On this page:

Table of Contents
maxLevel2
stylenone


Requirements

This tutorial assumes that the basic Solution Configuration tutorial has already been executed. 

Therefore, the detailed description of some operations, like creating new solutions, won't be included in this tutorial.


Configuration Outline

  1. Create a New Solution.
  2. Start The Broker and the MQTT Simulator, at Data Explorer.
  3. At AssetsTree, create a MQTT TagProvider.
  4. Add the MQTT data to to an AssetNode.

Basic Outline:

  1. Pick a template with the header/menu already there for a better look quickly.
  2. Start MQTT Simulator
  3. Connect to MQTT Simulator
  4. Map tags from "Hello Factory!" automatically for a dynamic reference
  5. Create a screen with:
    1. Asset TreeAssetTree
    2. Trend Chart
    3. Some Smart Symbols with #'s and visuals to see quantity and state

Bonus - Advanced Steps:

  1. Add a space for Smart Symbols (Depending on what's found in the asset tree)
  2. Add code to auto-create Smart Symbol layout
  3. Enjoy a Smart Display!
    1. DataGrid
    2. UI Controls

Configuration Steps

Create a new Solution

At the Solutions Manager tool, create a new solution, using HeaderLayout.

Using the Data Explorer MQTT Tools

Go to Data Explorer / MQTT Tools. Start the MQTT and the MQTT Simulator.

Image Added

Once you've done so, click Connect to see and browse the generated data.

Image Added 


TagProvider connection with MQTT Broker

  1. Go to Unified Namespace > Asset Tree
  2. Create a new TagProvider. Either  by the Toolbar Icon, or via menu File-New-TagProvider. Keep the provider MQTT and all default settings.
  3. Right click at the RootTags Folder. At the context menu, execute New AssetFolder.
  4. Right click at the folder just created and execute 'Insert Asset from TagProvider'. Select GroupID as the initial node to insert.

At this point, you already have the data from the broker integrated with your AssetTree.


Display With AssetTree and UI Controls

  1. Go to Draw and select the MainPage.
  2. Insert a TAssetsTree component (Located under the Modules section of the list of components). No configuration required, the default settings are what we need.
  3. Add a TextBox (icon) using the vertical toolbar. Add the value Client.SelectedAsset to the LinkedValue property, and the Label text to AssetPath.
  4. Add a TextBox (icon) using the vertical toolbar. Add the value Asset(Client.SelectedAsset) to the linked value to AssetValue, and modify the Label text to Value.
  5. Add a DataGrid and configure the DataSource to  Client.SelectedAsset.
  6. Add a TrendChat, and map the first pen, using Client.SelectAsset for the TagName.

Running the Solution

Go to Runtime / Startup and press the START button, or use the top menu to execution, by going to Action / Startup.

The RichClient will execute and will show the AssetTree. As you navigate on the tree, some fields will have a new value, the ones mapped to Client.SelectedAsset.


In this section:

Page Tree
root@parent
spacesV10

Data Explorer Tools

The DataExplorer tools allow you to easily perform data mining and monitoring from various data sources, including MQTT Brokers, OPC-UA, PLCs and SQL databases. Here, let's see how you can connect to our MQTT Simulator to browse its data.

Go to Data Explorer → MQTT Tools to start. You can connect to your own broker, if you wish, but our system has a native SpartkplugB MQTT Built-In Broker that you can use.

Out platform also offers a MQTT Publisher Simulator, that has customizable data being published. Simply click both of the green "start" buttons to start the Broker and Simulator.

Image Removed

Once you've done so, click Connect to see and browse the generated data.

Image Removed