Skip to main content
Print

Multi-Tag Report Widget

Summary


The multi-tag report widget is used to display count or state information from multiple tags in the form of a table. The tags being analyzed form the rows, and the columns aggregate the data into chunks of time. You can define one or more custom time periods (e.g., specific hours, days, or weeks) to focus the analysis. Additionally, each cell in the table is capable of showing the aggregated data in one or more formats:

  • Number of times a tag transitioned into or out of a state
  • Total time in a state, displayed in Hours:Minutes:Seconds
  • Percentage of time in a state

Examples at a glance


  • A report comparing the percentage of time temperature, humidity, and light are in high and low states. Significant levels are highlighted for scannability.

Common applications


  • Identify which production lines or shifts are operating with maximum uptime.
  • Count how many times machines activate to instantly report hourly/daily/weekly/monthly output.
  • Count how often individual machines enter an error state to identify issues and prioritize maintenance.

Interface breakdown


Hover over a multi-tag report widget, click the Configure Widget button (), and select the stacks and tags you wish to analyze. Then, click ‘Next’ to proceed to the options panel below.

  1. Unit of aggregation: Choose the time span over which your data is grouped. Options include Day, Week, Month, or Shift.
    • Day/Week/Month: Group data into units of the selected calendar period. Use the following UI element, ‘Select configured periods’ to exclude nonworking hours or weekdays if desired.
    • Shift: Group data into custom work periods that you define. This is useful for work schedules that do not align to calendar days. This selection enables you to create multiple configured time periods as needed.
  2. Periods to show: Define the number of horizontal columns to display in the widget. For example, setting the unit of aggregation to ‘Week’ and periods to ‘3’ would show three weeks of aggregated data, one week per column.
  3. Select configured periods: Choose a preset from the dropdown or select ‘Custom’ to configure specific windows of data to include in the visualization. For example, the time period below would include only data from 9:00 AM to 5:00 PM Monday through Friday in your report. Add additional time periods to model more complex schedules.
  4. Timezone: Set the timezone you’d like the widget to apply when processing the timeslots above. ‘Default to current timezone’ will use your computer’s current settings.
  5. Reporting: Select whether you would like to analyze your data based on ‘States’ or ‘Counts’
    • Use States to interpret continuous/analog data. For example, you can track how long a machine is in ‘Active’, ‘Idle’, and ‘Off’ states each day based on its power consumption. Learn how to define states in our Intro to Properties and States Properties articles.
    • Use the checkboxes to show or hide various states. If you have selected a tag with no states configured, use the shortcut () to create at least one States Property for this tag.
    • Use Counts to interpret discrete/digital data. For example, you might count the number of times a button is pressed.
  6. States With Intervals: Turn on ‘With Intervals’ to display the total time or percentage of time that a tag is in each selected state. This can help you answer questions like, ‘How many hours does the drill press stand idle each day?’
  7. States With Transitions: Turn on ‘With Transitions’ to display the number of times that a tag enters each selected state. This can help you answer questions like, ‘How many times does the drill press activate each day?’

Customizing display options


Hover over a widget and click the Display Options button () to define conditions that change the way data is displayed, such as changing colors or showing text based on incoming data. Setting up multiple conditions can create widgets that are very dynamic, elevating critical information as data conditions change. See our tutorial on creating your first dashboard for an interface breakdown.

PropertyDescription
TagSelect the tag or tag state to configure from the list of incoming data. States will be shown in the format ‘StackName:TagName.State’
ConditionDefine the logic conditions under which your chosen settings will take effect relative to the Trigger Value.
Trigger ValueDefine a threshold at which your chosen settings will take effect relative to the Condition setting.
ColorSelect the color of text in a cell.
Display IconNot currently implemented for this widget type.
Display TextNot currently implemented for this widget type.
Background ColorSelect the background color for a cell.

In This Article