Senseforce 2.0 Manual
  • Welcome to Senseforce 2.0
  • SF MQTT API
  • SF Edge
    • Edge Package Overview
    • Edge Installation
      • Using the SF Edge Service installer in command shell
      • Headless SF Edge Servie execution
    • Edge Configuration
      • Which Plugins to load (appsettings.xml)
      • Edge Data Routing (EventDefinition.xml)
      • OTA configuration (otasettings.xml)
      • Edge Logging
      • Input plugins
        • SQL Plugin
        • SQLite Plugin
        • OPC UA Plugin
          • OPC UA server browser
        • SIEMENS S7/SINUMERIK Plugin
          • Creating connection definition file
        • S7 Plugin
        • REST Plugin
        • TCP Listener Plugin
        • XML File Parsing Plugin
        • Heidenhain Plugin
      • Output Plugins
        • MQTT Plugin
        • SQLite Plugin
    • Edge Compute plugins
      • Creating compute plugins
      • Using compute plugins
  • SF Edge Asset Management
    • Edge version repository
  • SF Platform
    • Navigation
      • Overview Screen
    • Dataset Builder
      • Filters, Aggregations and Groupings
      • Functions of the Formula Editor
      • Additional Settings
      • Special Events
      • FAQ and Troubleshooting
    • Script Editor
      • Details of the Script Editor
      • Installed Packages
      • Working with Timestamps
        • Working with Timestamps in Python
        • Working with Timestamps in R
      • FAQ and Troubleshooting
    • Widgets
      • Text
      • Headline
      • Image
      • Progress Bar & Gauge Chart
      • Table
      • Map
      • Line, Bar, Scatter and Area Chart
      • Pie Chart
      • Gantt Chart
      • Histogram
      • Overview
      • Log
      • Default colors and color conditions
      • FAQ and Troubleshooting
    • Dashboards
      • Dashboard Filters
      • Favorites
      • Data Drilldown & Widget Interaction
      • Editing multiple dashboard widgets
      • Time Zones
      • Synchronized Zooming
      • Sharable Dashboard URL
      • Multi-chart layout options
      • Default sort for table widgets
      • Releases
      • Reporting
      • FAQ and Troubleshooting
      • Applying zoom to global timestamp filter
      • Optimise the layout for different devices
    • Machine Master Data
      • Dimensions
      • Instances
      • Things
      • Use Case
      • FAQ and Troubleshooting
    • Automation
      • Trigger
      • Scheduling overview
      • Actions
      • Test your Automation
      • Zapier integration (necessary internal steps)
      • Zapier integration
      • Subscriptions
      • FAQ and Troubleshooting
    • Event Schema Management
      • Importing a Event Schema
      • FAQ and Troubleshooting
    • Virtual Events
      • Creating a Virtual Event
      • Scheduling Overview
      • Permissions and Data Access
      • FAQ and Troubleshooting
    • Details modal for elements
    • Copy / Duplicate elements
    • Whitelabeling
    • Edge Device Management
    • Element History
    • Public API
      • Get your access token
      • Endpoints
      • Debugging scripts
      • FAQ and Troubleshooting
    • User & Group Management
      • FAQ and Troubleshooting
    • Active Directory & SSO Setup
Powered by GitBook
On this page
  • Overview of the Widget Editor
  • Building a Widget
  • Widget Header Settings
  • Linked Dashboards & External Links

Was this helpful?

  1. SF Platform

Widgets

PreviousFAQ and TroubleshootingNextText

Last updated 2 years ago

Was this helpful?

In the overview screen of the widgets menu, you are able to access and share existing widgets or create new ones. With widgets, you define how your data (from a dataset or script) is displayed. The widgets are then used on a dashboard to view the results. To see on which dashboards a widget is used, click on the on the right side of the overview screen and then on show details.

Overview of the Widget Editor

  1. Select the type of widget you want to create. In "General" you can find text, table, progress bar, map, overview and image widgets and in "Charts" you can find the classics such as line, bar, scatter, and other charts.

  2. Additional settings like copying or duplicating your existing widget (see Copy / Duplicate elements.)

  3. Reset your widget.

  4. If you change something, the save button will be enabled (green) and will save the current settings of your widget.

  5. Define the name of your widget and describe it in detail. The name and description will be shown in the overview screen for the widgets. The description will also be shown in the on a dashboard.

  6. Here you can define various settings for the widget header, described in more detail .

  7. Linked Dashboards & External Links, details on this area in the section below.

Building a Widget

In the following, we will walk through the steps necessary to create a simple line chart. The basic steps are the same for almost all widget types. For more details on a specific widget please go to the respective page.

In the following, you see how a line chart is created which displays the data from a script. 1. Select the widget type 2. Give the widget a name. 3. Write a header for the widget. 4. Go to the "Chart" tab and select "Script" as the data source type. 5. Select the desired script (in our example "Example Script") as input. 6. Select the x-axis values ("timestamp") and then the y-axis data for each series. In the example below, we are creating 2 series using the data of the script output variables "speed1" and "speed2". 7. Save the widget.

Widget Header Settings

In the general tab of your widget editor, you will find a few settings that will change the way the header of your widget looks and behaves.

Show header

This toggle lets you define if you want to display a header on your widget or not. A header is basically like a headline, where you can define in a few words what your widget shows for better understandability.

Widget header

As described in the Show header field, here you can define what your widget header should be. As a default, you get a text box for setting your widget header to any text you want.

But there's also an arrow icon on the right of the text box, which, when clicked, will give you a few advanced options. Here you can, instead of using a static text as the widget header, set a string column from any of your datasets or scripts to appear as your widget header instead.

Note that when using a dataset or a script, the widget will get the value to display from the first row that the dataset or script returns.

Show menu in dashboard

When hovering over your widget in the widget editor, you will notice that a three dotted icon will appear in the top right corner of your widget, this is what we call the menu. Clicking on it reveals a few additional options like "Edit", or options to download a chart as a PNG file.

The show menu in dashboard basically decides if the menu of a widget should be displayed in dashboard view mode or not. That means, if the setting is toggled on, you can add your widget to a dashboard and still see the menu of the widget in dashboard view mode when you hover over it. If this setting is toggled off hover, the menu of the widget will only appear when you are in dashboard edit mode, but not in dashboard view mode.

As this setting only affects how your widget will behave when it is displayed in a dashboard, changing this setting in the widget editor will have no impact on the widget preview.

Linked Dashboards & External Links

After selecting the widget type, you can define a link to a dashboard and/or an external link to a website to the regarding menu points.

The resulting widget could look like this,

The dashboard link will link to the same dashboard no matter where you use your widget. Note that you can also define a dashboard link for your widget in the dashboard edit mode. This link will then be used only on this dashboard.

where is the external link and the dashboard link.

here
Settings for a widgets header
Create a link to a external webpage on your widget.
widget description