Skip to content

Panel: Content Viewer Panel

Overview

This highly configurable dashboard panel can display content associated to an asset. It supports several viewing modes detailed below.

Learn about Asset Content

Configuration options

This panel allows viewing content from one or more assets, which is selected in step 2 of the signal configuration.

Configuring the Content Viewer Panel

Option Description
Viewer Type

Choose the type of data and way to display it. Choose from the following, which are documented above.

  • File List
  • Image
  • Table
  • Text
  • Media
  • Line Chart
Content to show
  • Show all content (depends on viewer type for which types will be supported)
  • Show content uploaded in the last defined period (minutes, days, weeks)
  • Chose content to have available (Only these specific content files will be available)
Filter by file extension When enabled, user can choose file extensions to filter what content is available in the panel. Note that the Viewer Type option will also filter by file extension. For example, the Image Viewer will only allow files with image file types.
Allow Downloads When enabled, provides a link for the viewing user to download the file in the dashboard panel. If disabled, no download link is provided and the content is only viewable in the panel.
Load with sidebar If enabled, provides the list of content available as a selectable side bar menu.
Auto Switch when new content is being uploaded When enabled, will automatically update the panel to show the latest content file uploaded that meets the panels file type criteria.
Include URLs Note: File List Viewer Type Only. If enabled, the file list will include any URL links added as content to the Asset.
Include Videos Note: File List Viewer Only. If enabled, will include video links that are added as content to the Asset.

File List Mode

Displays a list of files for downloading / linking - Schematics, manuals, log files, links, etc. Can be filtered by time (last day), type of files, or pick specific content (including links)

The panel in File List view mode

Hint

Viewer options for this panel are limited to 10MB files or smaller. Larger files can be downloaded using the File List or the Viewer option if downloads are enabled in the configuration of the panel.

Image Viewer Mode

Displays an image from a filtered or time-based list of image files. Uses may scroll through the list of images. Can be used for images uploaded by users and also if the connected device creates images based on event data it captures (e.g. high resolution event).

Table Viewer Mode

As a Table viewer for any CSV files

Table viewer mode showing a csv file content as a table.

Line Chart Viewer Mode

As a Chart viewer for CSV files or JSON structured data files. Typically used for applications that require devices to upload high resolution event data or non-standard signal data that isn't necessary to continuously send as a signal.

General usage notes:

  1. The X and Y axis values need to be numeric. If any value of the pair is empty or not a number, the point will be skipped while rendering.
  2. If a series containing more than 1 point has the same X, it will random pick Y value from duplicate points.
  3. The panel can render up to 10 line chart series in a single chart.

This mode supports a few different schema options for CSV and JSON structured data files, as documented below.

Auto schema mode

Supports a CSV formatted file (.csv file extension) with multiple X/Y Pairs, each series has a dedicated X column and a dedicated Y column. Although the 'Automatic' mode will assume each x,y columns are in order (1,y1,x2,y2), turning off the Automatic option allows the user to specify the exact x and y columns for each seriesThe column does not always ordered as x1,y1,x2,y2.

This schema mode differs from 'CSV' in that it uses a specific column for each X axis and Yaxis values of each of the line series instead of only one column for all X axis values.

Example CSV file content for use in \'Auto\' schema line chart mode

exo0,exo1(y2),exo2(x2),exo3,exo4(x3),exo5(x1),exo6(y3),exo7(x4),exo8(y1),exo9(y4)
,212,5,,4,3,216,4,209,207
,212,5,,4,3,216,4,209,207
,212,5,,4,3,216,4,209,207
,212,7,,6,7,216,7,209,207
,212,14,,14,14,215,14,209,207
,212,22,,22,22,215,22,209,207
,211,29,,29,29,215,29,209,207
,211,37,,37,37,215,37,209,207
,211,45,,44,44,215,44,209,207
,211,52,,52,52,215,52,208,207
,211,60,,60,60,214,60,208,206
,211,68,,68,67,214,68,208,206
,211,75,,75,75,214,75,208,206
,210,83,,83,83,214,83,208,206
,210,90,,90,90,214,90,208,206
,210,98,,98,98,214,98,207,206
,210,106,,106,106,213,106,207,206
,210,113,,113,113,213,113,207,206
,210,121,,121,121,213,121,207,206
,210,128,,128,128,213,128,207,206
,210,136,,136,136,213,136,207,205
,210,144,,143,143,213,143,207,205
,210,151,,151,151,212,151,207,205
,209,159,,159,159,212,159,207,205
,209,167,,166,166,212,166,207,205

Options for Auto schema mode

CSV schema mode

Supports a CSV formatted file (.csv file extension) to be displayed as a line chart with 1 or more lines. You specify the column for your X-axis values and then specify one or more columns for the Y-axis values for each series. Note that you can also specify the X and Y axis titles and the series names.

This schema mode differs from 'Auto' in that it uses one column for all of the X axis values of the line series.

Example CSV file content

freq,v1,v2,v3
12.826536,0.697099,0.172224,0.569004
29.418025,0.139836,0.007529,0.850914
54.551056,0.86625,0.071657,0.609019

CSV Schema Configuration

Outcome of Example CSV

JSON Array schema mode

This schema mode supports a JSON array of objects. The objects need to include the keys defined in the panel. If the key is missing, the data point will be skipped while rendering the chart.

Example JSON Array formatted data for the JSON Array schema mode line chart

[
   {
      "freq": 12.826536,
      "v1": 0.697099,
      "v2": 0.172224,
      "v3": 0.569004
   },
   {
      "freq": 54.551056,
      "v3": 0.609019,
      "v1": 0.86625,
      "v2": 0.071657
   },
   {
      "freq": 29.418025,
      "v2": 0.007529,
      "v3": 0.850914,
      "v1": 0.139836
   }
]

JSON Array Schema Mode configuration for the Viewer Line Chart Panel

JSON Array Schema Mode example output for the Viewer Line Chart Panel

JSON Table schema mode

Can be used with files with a JSON object formatted in the same way as the Panel: JSON Table.

Example JSON formatted data for the JSON Array schema mode line chart

{
  "headers": [
    "Stat",
    "Value",
    "Condition",
    "ExtraData"
  ],
  "values": [
    [
      "stat 1",
      23,
      "ok",
      542.32
    ],
    [
      "stat 2",
      103,
      "warning",
      323.99
    ],
    [
      "stat 3",
      0.32,
      "nothing to see here",
      100.81
    ]
  ]
}

JSON Table Schema Mode configuration for the Viewer Line Chart Panel

JSON Table Schema Mode example output for the Viewer Line Chart Panel

Text Viewer Mode

As a text viewer for text / log type files. Typical uses include viewing log files uploaded by devices and notes from users about the asset. Supports .json, .csv, and .txt files.

Example showing a device uploaded .log file

Media Viewer Mode

As a media viewer for viewing YouTube videos. Can be used for such things as instructional videos and youtube live streams of assets.

To add media content, including youtube videos and streams, upload via Asset Content.


Last update: April 7, 2021