The Dashboard is the first page displayed when Flowlink Cipher is launched. This page displays a collection of gadgets that provide a quick overview of incoming data and site statuses. Information about dashboards and their gadgets is provided below. Click the headings to expand each section.
Dashboards
Users can create multiple dashboards to help organize gadgets. This allows all related gadgets to be kept in a single dashboard separated from unrelated gadgets, keeping the dashboard uncluttered and allowing larger real estate for each gadget. This also provides users with a one-step option of viewing all information pertaining to a specific area or subject.
Dashboards can be created as shared or private. A private dashboard is available only to the user that created the dashboard. A shared dashboard is accessible to other users for the purpose of copying the dashboard to their user accounts. This allows a user, such as an administrator, to create dashboards and populate them with gadgets relevant to a specific task or user. The dashboards can then be copied by other users, eliminating the need for those users to setup gadgets. Once copied, the new dashboard can be modified by the user if needed. New dashboards are created as Private by default, but can be set to Shared using the Dashboard Configuration dialog box.
Copies of shared dashboards do not receive updates if changes are made to the original dashboard after it has been copied. Once a user copies a dashboard, the copied version is equivalent to a new dashboard created by that user and has no connection to the original dashboard, similar to copying a file from one location to another. |
The default dashboard is named Home and is displayed as a button at the top of the Dashboard screen. Each time a dashboard is created or copied by a user, it is added as another button at the top of the screen in alphabetical order. These buttons are used to select the dashboard to display. The button of the active dashboard will be displayed with bold text to indicate which dashboard is in use.
The plus button beside the dashboard buttons displays a tools panel with controls for adding gadgets and working with dashboards. The dashboard functions are explained below; refer to the Gadgets section for information on gadgets.
New Dashboard
The New Dashboard tool in the tools panel is used to create a new dashboard. When selected, it launches the Create New Dashboard dialog box.
1. Enter a name for the new dashboard.
2. Click Save.
A new button is added at the top of the Dashboard page with the dashboard name specified.
3. Click the newly added button to display the new dashboard.
Dashboard Configuration
The Dashboard Configuration tool in the tools panel launches the Dashboard Configuration dialog box.
This dialog box is used to edit or delete existing dashboards, and to add new or shared dashboards for the current user. The options are divided between dashboards created by the current user and shared dashboards created by other users.
• Under Your Dashboards, the Dashboard Title field provides a drop-down list of all dashboards created or copied by the current user. When a dashboard is selected in this list, the name, creation date and state (Private or Shared) of the dashboard is displayed.
• Under Shared Dashboards is a drop-down list of all shared dashboards available to the user. These can be copied to the user’s account and used as their own dashboard. Selecting a dashboard in the drop-down list displays the gadgets that have been set up for that dashboard, the user that created the dashboard and the creation date for the dashboard.
The table below describes the various functions available in the Dashboard Configuration dialog box. Expand each section by clicking each task in the table.
I want to... |
Create a New Dashboard New dashboards can be created from within the Dashboard Configuration dialog box. 1. Click the plus button 2. Select Dashboard Configuration. 3. Expand Your Dashboards, if it’s not already open. 4. Click the Add New button beside the drop-down list of dashboards. The Create New Dashboard dialog box is displayed.
5. Enter a Dashboard Name. 6. Click Save. A new dashboard button is added to the Dashboard page and is available in the drop-down list of dashboards under Your Dashboards. |
Rename a Dashboard The name of a dashboard should be related to the content in the dashboard to easily identify its purpose and the information it provides. If the purpose or content of a dashboard changes, or is unknown at the time of creation, it may be necessary to rename the dashboard. To rename a dashboard: 1. Click the plus button 2. Select Dashboard Configuration. 3. Expand Your Dashboards, if it’s not already open. 4. Select the relevant dashboard in the Dashboard Title drop-down list. 5. Click the Rename Dashboard button A Rename Dashboard dialog box will be displayed.
6. Type a new name in the field. 7. Click Save. |
Share a Dashboard The state of a dashboard determines whether it is shared or private. • A shared dashboard can be copied by other users. • A private dashboard is accessible only to the user that created it. New dashboards are created as Private by default. The current state is displayed beside the check box in the Dashboard Configuration dialog box. 1. Click the plus button 2. Select Dashboard Configuration. 3. Expand Your Dashboards, if it’s not already open. 4. Select the relevant dashboard in the Dashboard Title drop-down list. 5. Click the Shared check box to enable the option.
A message is displayed stating that the access to the dashboard has been changed and the dashboard is added to the drop-down list under Shared Dashboards. |
Delete a Dashboard A dashboard that is no longer needed can be deleted from Cipher. Once deleted, it cannot be retrieved. 1. Click the plus button 2. Select Dashboard Configuration. 3. Expand Your Dashboards, if it’s not already open. 4. Select the relevant dashboard in the Dashboard Title drop-down list. 5. Click the Delete button A message is displayed confirming the deletion of the dashboard. 6. Click Yes to perform the deletion. The dashboard button is removed from the Dashboard screen and the name is removed from the drop-down list of dashboards in the Dashboard Configuration dialog box. |
Copy a Shared Dashboard Shared dashboards can be copied to a user’s dashboard page, creating a new dashboard for that user, but with gadgets already populated. 1. Click the plus button 2. Select Dashboard Configuration. 3. Expand Shared Dashboards. 4. Expand the drop-down list of shared dashboards. 5. Select the relevant dashboard in the list. Details for the selected dashboard are displayed.
6. Click Copy to your dashboards. A dialog box is displayed providing the option to rename the dashboard.
7. [Optional] Change the dashboard name if needed. 8. Click Save. The new dashboard is added as a button on the Dashboard page and to the list of dashboards under Your Dashboards in the Dashboard Configuration dialog box. |
Gadgets
A Note type gadget is added to the dashboard the first time that a user connects to Flowlink Cipher. This gadget is populated with a welcome message containing information to help a new user get started. All other gadgets are manually added to the dashboard by the user.
The types of gadgets available include:
Gadget Type | Icon | Description |
|---|---|---|
Graphing |
| This gadget is used to show a live preview of an existing graph. Each time new data is available for the graph, the gadget will automatically be updated with the latest data.
Hovering the mouse cursor over the graph will cause tooltips to be displayed for the data in the graph. The tooltip contains the name of each dataset in the graph, the color associated with each dataset and the value with units at the location of the cursor. If a data point in the graph was ingested with an error code assigned to it from the device, the code will also be included in the tooltip. See Error Codes for Data Points for a table of possible error codes. This tooltip will update as the cursor moves from one dataset to the next in the graph. The wheel button on the mouse can be used to zoom in and out of the graph and the left mouse button can be used to drag the graph to the left and right to pan the visible data range. Note: Panning and zooming the data in the display is temporary, if a different page in the system is viewed, the display in the graph gadget will reset to the time range defined in the graph configuration when the user returns to the Dashboard page. The Options button • Go to Graph: Go to the details page of the graph being displayed in the gadget. • Delete Gadget: Delete the gadget from the dashboard. This does not affect the data source associated with the gadget, it only removes the gadget. |
Note |
| This gadget is used to display textual notes that have been manually entered by the user. |
Site |
| This gadget is used to display information about a specific site, including a graph of the most recent level, velocity and flow rate data and a timestamp of the last time data was ingested from the site.
The gadget is populated by selected a site from the Select Site field. Clicking in this field display a list of all sites available to the user. If the user has been assigned to a tenant, only sites in that tenant will be available. The list of sites can be filtered by entering text in the Search field at the top of the list. Only sites that match the text specified will be included in the list. A drop-down list beside the Search field can be used to filter the list even further by specifying the property in which to search for the matching text. When an option is selected, only sites with text in the selected property (tenant, tag, etc.) will be available.
When a site contains multiple datasets for the level, velocity and flow rate data types, the graph will default to the first dataset in the datasets list on the Devices tab of the site information page for the selected site. See Devices Tab for more information on the dataset order for site devices. The drop-down arrows adjacent to the L, V, F labels in the graph can be used to select a different dataset. Clicking one of these arrows displays a list of the datasets in the site of the selected data type. Select a dataset in the list to change the graph displayed. Each time new data is available for the graph being displayed, the gadget will automatically be updated with the latest data. The graph data will be displayed according to the settings in the Preferences tab of the user profile page and the gadget Options explained below. If these settings have not been defined, the following colors will be used by default: • Level - Blue • Velocity - Green • Flow Rate - Red Hovering the cursor over the gadget will cause tooltips to be displayed for the data and the axis values. The data tooltip contains the name of each dataset in the graph, the color associated with each dataset and the value with units at the location of the cursor. If a data point in the graph was ingested with an error code assigned to it from the device, the code will also be included in the tooltip. See Error Codes for Data Points for a table of possible error codes. The X axis tooltips display the timestamp of the cursors current location for each dataset. The Y axis tooltip changes to show the level, velocity or flow rate value at the current location of the cursor. This tooltip will update as the cursor moves from one dataset to the next in the graph. Site gadgets will display with a colored border indicating the status of the site. This allows a quick visual check of the status of each site in the dashboard.
The possible colors include: • Yellow: The Data Last Received option for the site is enabled and the length of time since the site last received data is greater than the threshold. • Red: An alarm has been triggered by the site and at least one Data type event has a status of Active or Acknowledged. The color is removed when all Data type events for the site have a status of Resolved. The Options button • Change Period: The time period for which data will be included in the graph displays. The available times are the last 24 hours, 48 hours, 72 hours or 1 week. The graph will be displayed for the selected period of time, regardless of whether or not there is data available for the entire time period. If the time period extends beyond the data in the dataset, the right side of the graph will be empty. For example, if the Change Period is set to 72 hours, but there is only 60 hours worth of data, the data lines in the graph will stop at 60 hours and the last 12 hours of the graph will be empty. • Go to Site: Go to the details page of the site being displayed in the gadget. • Graph from Site: Go to the Configure Graph page with the site and datasets from the site gadget selected for a new graph. The datasets, and the order in which they are displayed in the site gadget, will be repeated in the new graph. • Delete Gadget: Delete the gadget from the dashboard. This does not affect the data source associated with the gadget, it only removes the gadget. At the bottom of the site gadget the following information and controls are provided: • Elapsed time since last data received. If the site is receiving data, a clock symbol precedes the timestamp. If the site is no longer receiving data, a triangular symbol, with the tooltip Site is not receiving data, precedes the timestamp. • The last received value from voltage type datasets named Input Voltage in the site. • An alarm icon with a count if alarms have been triggered at the site. Clicking this icon displays a menu with options to Go to Alarms screen or to Acknowledge All Alarms. On the Alarms page you can view the details of the alarm(s). Once all alarms have been acknowledged, the icon will be removed from the gadget. Alarms can be acknowledged through a site gadget on the dashboard or from a site card on the Map page. See Dashboards and Map for more information. These items will automatically be updated with new values each time new data is available for the site. |
Battery |
| This gadget is used to view the last received battery voltage at a site(s). This is useful in monitoring for sites with low battery voltage. The gadget can report voltages for a single site, a user-specified selection of sites, all sites in a specific tenant or all sites assigned a specific tag. If a tenant, tag or selection of sites is selected, the gadget is populated with a list of sites in the tenant or selection, or with the specified tag. The list can be sorted by either the site names or the voltage values by clicking on the column headings. An arrow will be displayed beside the column heading indicating which value the list is being sorted by and the direction. The values in the list will be updated automatically each time new data is available for the selected site(s).
If the user is assigned to a tenant, only sites belonging to that tenant will be visible in the gadget. Clicking a site name in the list will go to the site information page for that site. The Options button • Delete Gadget: Delete the gadget from the dashboard. This does not affect the data source associated with the gadget, it only removes the gadget. |
Alarm |
| This gadget is used to display a list of all active alarms for a site(s). Alarms can be reported for a single site, a user-specified selection of sites, all sites in a specific tenant or all sites assigned a specific tag. If a tenant, tag or selection of sites is selected, the gadget is populated with a list of the sites in the tenant or selection, or with the specific tag, that have active or acknowledged alarms. This allows monitoring the health of multiple sites in a single function. Sites included in the search criteria that do not have alarms will not be displayed in the gadget. The list will be updated automatically each time a new alarm is triggered for a selected site or new information is available for an alarm in the list (alarm status, last data push, etc.). Alarm gadgets will display with a red border if the list contains a Data alarm.
The list of alarms includes the following information for each site in the list: • alarm status • site name • number of active alarms • number of acknowledged alarms • date of the last data ingestion The list can be sorted by any of these values by clicking on the column headings. An arrow will be displayed beside the column heading indicating which value the list is being sorted by and the direction. The list also provides a button Clicking a site name in the list will go to the site information page for that site. From there, the Events tab can be used to view the details of each alarm for the site. Icons beside each site in the list indicate the current status of the alarms for that site, either: • • These icons can be used to change the status of the alarms for a site. Clicking an Active icon will transition all alarms for that site to acknowledged. Clicking an Acknowledged icon will transition all acknowledged alarms for that site to resolved and that site will be removed from the list. The Options button • Acknowledge All Alarms: Acknowledge all alarms in all sites currently displayed in the gadget. Entries will also be added to the site logs for each site that is updated. • Resolve All Alarms: Resolve all alarms in all sites currently displayed in the gadget. Entries will also be added to the site logs for each site that is updated. • Delete Gadget: Delete the gadget from the dashboard. This does not affect the data source associated with the gadget, it only removes the gadget. |
Silent Site |
| This gadget is used to display a list of sites with active alarms for missed data ingestions based on the threshold setting for Data Last Received on each site's information screen. The gadget can report alarms for a single site, a user-specified selection of sites, all sites in a specific tenant or all sites assigned a specific tag. If a tenant, tag or selection of sites is selected, the gadget is populated with a list of the sites in the tenant or selection, or with the specific tag, that have active or acknowledged silent site alarms. This allows monitoring the health of multiple sites in a single function. Sites included in the search criteria that do not have alarms will not be displayed in the gadget. The list will be updated automatically each time a new alarm is triggered for a selected site or new information is available for an alarm in the list (alarm status, last data push, etc.). Silent Site gadgets will display with a colored border when there are active or acknowledged alarms for the selected site(s).
The list includes the following information for each site in the list: • alarm status • site name • number of active alarms • number of acknowledged alarms • date of the last data ingestion • battery voltage The list can be sorted by any of these values by clicking on the column headings. An arrow will be displayed beside the column heading indicating which value the list is being sorted by and the direction. The list also provides a button Clicking a site name in the list will go to the site information page for that site. From there, the Events tab can be used to view the details of each alarm for the site. Icons beside each site in the list indicate the current status of the alarms for that site, either: • • These icons can be used to change the status of the alarms for a site. Clicking an Active icon will transition all alarms for that site to acknowledged. Clicking an Acknowledged icon will transition all acknowledged alarms for that site to resolved and that site will be removed from the list. The Options button • Acknowledge All Alarms: Acknowledge all alarms in all sites currently displayed in the gadget. Entries will also be added to the site logs for each site that is updated. • Resolve All Alarms: Resolve all alarms in all sites currently displayed in the gadget. Entries will also be added to the site logs for each site that is updated. • Delete Gadget: Delete the gadget from the dashboard. This does not affect the data source associated with the gadget, it only removes the gadget. |
Gadgets are displayed on the dashboard in a grid format, with each gadget occupying one or more cells in the grid. As gadgets are added, they are automatically snapped to the next available cell in the grid, going from left to right, top to bottom. Each gadget can be resized and/or repositioned as needed.
The table below describes the various functions available for gadgets. Expand each section by clicking each task in the table.
I want to... |
|---|
Add a Gadget To add a gadget to a dashboard: 1. Click the plus button
2. Click the type of gadget you want to add. 3. For an alarm, battery or silent site gadget, you must select how many sites will be displayed in the gadget and how those sites will be selected. Click either: • Site to display only a single site • Tenant to display all sites in a specific tenant • Tag to display all sites assigned a specific tag A new gadget will be added to the dashboard. By default, the gadget will be added as a single cell in the next available grid cell.
For all gadgets other than a note you must select the data you want displayed. 4. Click the drop-down list at the top of the gadget and select the data source to be displayed. The gadget is populated with data from the selected data source. For a note type gadget, you must enter the text you want to display in the note. To do this, the gadget must be in edit mode. 5. Click the Edit button A text editing toolbar and a text entry field will be added to the gadget.
6. Enter the desired text in the field. 7. Click the Save button The note is now displayed in the gadget on the dashboard. |
Edit a Gadget Existing gadgets can be edited if needed. This includes changing the data source for a graph or site gadget, or editing the text in a note gadget. To edit a graph or site gadget: 1. Select a new data source from the drop-down list at the top of the gadget. 2. Click the Options button 3. Select the relevant setting from the options list. To edit a note gadget: 1. Click the Edit button 2. Make any necessary changes. 3. Click the Save button |
Resize/Reposition a Gadget 1. To resize a gadget, click the bottom-right corner of the gadget and drag the border until the gadget reaches the appropriate size then release the mouse button. 2. To reposition a gadget, click the gadget-type icon in the top-left corner of the gadget and drag it to the desired location then release the mouse button. Dragging a gadget to the edge of the page on the right side of the window will automatically expand the dashboard to add more columns to the grid. When the mouse button is released to drop the gadget, all gadgets will automatically be reduced in size to accommodate the additional columns in the dashboard. The layout of the dashboard will be remembered each time a user logs into the system with the same user account. |
beside the dashboard buttons to open the tools panel.
in the 
.
in the top-right corner of a graph gadget provides the following options:
in the top-right corner of a site gadget provides the following options:
in the top-right corner of a site gadget provides the following option:
to add a new site gadget to the dashboard for the selected site. 
Active: This is displayed if the site has any active alarms. 
Acknowledged: This is displayed if all alarms for the site have been acknowledged.
in the top-right corner of a site gadget provides the following options:
in the top-right corner of a site gadget provides the following options:
in the bottom-left corner of the note gadget. 
to save the text and exit edit mode.