Showing results for 
Search instead for 
Did you mean: 
Showing results for 
Search instead for 
Did you mean: 

Community Tip - New to the community? Learn how to post a question and get help from PTC and industry experts! X

Build an Equipment Dashboard Guide Part 1

0% helpful (0/1)

Build an Equipment Dashboard Guide Part 1




This project will introduce you to the principles of ThingWorx Foundation by creating an eqipment dashboard. Following the steps in this guide, you will create the building blocks of your first IoT application, including Things and Streams. We introduce the basics for creating an IoT application.

NOTE: This guide's content aligns with ThingWorx 9.3The estimated time to complete ALL 2 parts of this guide is 30 minutes. 


Step 1: Learning Path Overview


This guide explains the steps to create an Industrial Eqipment Dashboard, and is part of the Connect and Monitor Industrial Plant Equipment Learning Path. You can use this guide independently from the full Learning Path. If you want to learn the basics of creating an eqipment dashboard with ThingWorx, this guide will be useful to you.When used as part of the Industrial Plant Learning Path, you should already have ThingWorx Kepware Server installed, and it should be sending data to ThingWorx Foundation. You also need to have previously created the Thing Shape and Thing Template used for this dashboard. We hope you enjoy this Learning Path.


Step 2: Create Thing


Thing is used to digitally represent a specific component of your application in ThingWorx. In Java programming terms, a Thing is similar to an instance of a class. In this step, you will create a Thing that represents an individual Pump using the Thing Template we created in the previous guide.

Using a Thing Template allows you to increase development velocity by creating multiple Things without re-entering the same information each time.

  1. In ThingWorx Foundation, navigate to Browse > Modeling > Things.

    Step 2 Create Thing Step 1.png

  2. Click + New.

    Step 2 Create Thing Step 2.png

  3. In the Name field, type MyPump.

NOTE: This name, with matching capitalization, is required for the data display created in a later step.

      4. If Project is not already set, click the + in the Project text box and select the PTCDefaultProject.

      5. In the Base Thing Template field, search for and select the previously-created PumpTemplate.

      6. At the top, click Save.

      Step 2 Create Thing Step 6.png


Manage Property Bindings

  1. At the top, click Properties and Alerts.

    Step 2 Manage Property Images Step 1.png

  2. At the top, click Manage Bindings.

    Step 2 Manage Property Images Step 2.png

  3. In the top-left Local > Search Things field, search for and select IndConn_Tag1.

    Step 2 Manage Property Images Step 3.png

  4. Drag-and-drop Simulation_Examples_Functions_Random3's + symbol onto the watts Property on the right.

    Step 2 Manage Property Images Step 4.png

  5. At the bottom-right of the pop-up, click Done.
    • Note how the Tag from ThingWorx Kepware Server is now bound to the the watts Property.
  6. Click Save.
  7. Click Refresh repeatedly to confirm the watts Property value is changing.IoTProductMgmt_7-1658973567620.png



Step 3: Store Data in Value Stream


Now that you have created the MyPump Thing to model your application in ThingWorx, you need a storage Entity to record changing Property values. This step shows how to save time-series data in a Value Stream already created in a previous guide. To learn more, refer to the Methods for Data Storage guide.

  1. Navigate to Browse > Modeling > Thing Templates.

    Step 3 Step 1.png

  2. Click the previously-created PumpTemplate Thing Template to open it.

    Step 3 Step 2.png

  3. Confirm you are on the General Information tab.
    • If necessary, click Edit to allow changes.
  4. In the Value Stream field, search for and select IndConn_ValueStream.

    Step 3 Step 4.png

  5. Click Save.

    Step 3 Step 5.png


Step 4: Create Application UI


ThingWorx Foundation is used to create customized web applications that can display and interact with data from multiple sources. These web applications are called Mashups and are created using the Mashup Builder. The Mashup Builder is where you create your web application by dragging and dropping Widgets such as Grids, Charts, Maps, and Buttons onto a Canvas. All of the user interface elements in your application are Widgets.

We will build a web application with three Widgets:

  • Image showing a picture of the pump
  • Value Display showing the pump serial number
  • Line Chart showing the value of watts Property trend over time.


Create New Mashup


  1. Navigate to Browse > Visualization > Mashups.


  2. Click + New.


  3. Keep the defaults and click OK.


  4. In the Name field, type pump-dashboard.
  5. If Project is not already set, click the + in the Project text box and select the PTCDefaultProject.
  6. Click Save.


  7. At the top, click Design.


Define Mashup Areas


  1. At the top-left, ensure the Layout tab is selected.
  2. Click Add Bottom to split your UI into two halves.


  3. Click the newly-created bottom-half to select it.
  4. Click Add Left.


  5. Click the bottom-left container to select it.
  6. In the top-left Layout section, scroll down and select Fixed Size.


  7. Type 200 in the Width text box that appeared, then press your keyboard’s Tab key to record your entry.


Add Widgets


  1. In the top-left, click the Widgets tab.


  2. In the Filter field, type image.


  3. Drag-and-drop an Image Widget onto the lower-left area of the central Canvas.
    • This Widget will show an image of the pump in use.

4. In a similar manner to what was just done with the Image Widget, drag-and-drop a Value Display Widget onto the top area.

5. Likewise, drag-and-drop a Line Chart Widget onto the lower-right area.


6. Click Save.


       Click here to view Part 2 of this guide. 

Version history
Last update:
‎Dec 01, 2022 04:46 PM
Updated by:
Labels (2)