Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Link text correction

This page covers:

Anchor
viewingUsingDashboards
viewingUsingDashboards
Viewing and using dashboards

...

They also provides the following icons:

Image Removed

Shows a list of any Stream Actions associated with the Stream View. The user may select one of these actions e.g. to update specific data on the grid.

Image Removed

Image Added

Refresh the chart.

Select an existing (or predefined) Filter or create, delete and modify Filters. This causes the chart to refresh and display only those entries which match the selected Filter.

Select an existing (or predefined) multi-column Sort Order or create, delete and modify Sort Orders. Note that data is ordered across all records which are implied by the Filter, not just the current page of data.

Image Removed

Pressing this icon toggles the display of other standard icons and the additional icons below.

Image Removed

Displays summary details of the Stream View.

Image Removed

Displays detail common to Dashboard Elements. This icon is only displayed when a Stream View is added to a Dashboard.

Image Removed

Modifies selected items displayed in the Chart. When this button is pressed, a form containing all fields in the Chart will appear. If a value is entered into any of these fields, the value will be applied to all items displayed.

Image Removed

Exports the data currently being viewed in the grid using a Database Exporter or a File Exporter. The user can select an exporter from the list of Database and File Exporters attached to the underlying stream.

Note that this will export all data, not just the current paged result. However, any filters on the pipe connecting the stream to the Database or File Exporter selected will be applied, so not all records displayed in the Chart may be exported - some may be filtered out in the pipe.

Image Removed

Shows Alarms associated with this Chart.

Image Removed

Shows the configuration of the underlying Stream.

Opens the download data form allowing the user to export just the selected items or all data on the chart as either an Excel file, a CSV (comma separated) file or as an HTML document.

Image Removed
Shows the list of Stream Views

Image Added

Display the number of records in the data, and the number of records currently being displayed.

Anchor
configuringDashboards
configuringDashboards
Configuring dashboards

A dashboard allows a User you to gather into a single view a set of charts.

This grouping of related reports and statistics provides the User users with preconfigured pre-configured overviews of selected areas, making all the data that is required to view and monitor the health of the system both accessible and easy to read.

...

Things added to the dashboard in this way are known as dashboard elements. Dashboard elements are given short names which can then be used in expressions to refer to items selected in those Stream Views.

Dashboards can be created as either 'public' or 'private' - a private dashboard is only visible to the owner. Users may also specify a personal 'default' dashboard which is opened automatically each time PhixFlow is started.

Form: Dashboard Details

All Users Can View Data
FieldDescription
NameThe name of the dashboard.
PublicIf ticked, all users can view and edit the dashboard. If not ticked, only the owner can view or edit the dashboard.If checked, this specifies that all users can view this dashboard by default (provided they have the basic privilege to view dashboards). If this field is not checked, then access to the dashboard is controlled by dropping user groups onto the stream's "User Groups" tab.
Open MaximisedIf ticked, the dashboard opens fills the whole screen when it is opened.
Allow User to ResizeIf ticked, the user can change the size of the dashboard while in app mode. All designers can still change 
Show Toolbar Show the toolbar on the dashboard.
Always On TopAlways keep the dashboard on top.
Keep DataIf ticked, the dashboard data is available and can be referenced even after the dashboard is closed. It can be used if the user wants to store global data available in the system.
PreloadIf ticked, the system will preload the dashboard while loading, so when requested, the dashboard will open much faster.
Dashboard Elements
A list of the dashboard elements on this dashboard on this dashboard.

Access Permissions

All Users Can View DataIf ticked, this specifies that all users can view this dashboard by default (provided they have the basic privilege to view dashboards). If this field is not checked, then access to the dashboard is controlled by dropping user groups in the the user group list.
User Groups
A list of the user groups which can view this dashboard. This tab is only shown if All Users Can View Data is not selected.
Description
DescriptionDescription of the dashboard.

...

The form provides the standard form icons, as well as:

Display the dashboard.

Anchor
dashboardElement
dashboardElement

Configuration

Dashboards open locked by default (elements cannot be moved or edited and buttons carry out updates even in design mode). In design mode, right click on the dashboard area to unlock it. The previous locked status is remembered when switching back to design mode from app mode.

Splitter Bars

The Dashboard area can be divided into multiple, resizing panes by adding vertical or horizontal splitter bars. Right click the pane or any element on the pane to:

  • Add Vertical Bar
  • Add Horizontal Bar

 

Splitter bars can be removed by right clicking on an empty pane and selecting Delete Pane.

Layout Options

Right click any pane or element and select Layout Options to configure the following options:

...

...

Add Element

An element can be added to a dashboard by dragging predefined Stream Views onto the dashboard pane.

...

You can remove an element from the dashboard by selecting Image Removed from the element icon bar. This removes the object from the Dashboard view but will not delete the object from PhixFlow.right clicking on the view and going to Dashboard Options → Remove Element From Dashboard

Link Dashboard Elements

You can link Dashboard views together so that the contents of one view are filtered based on items selected in a "Driver" view.

A grid view (grids only) will be automatically made a "Driver", if any of the filter expressions in any of the dashboard elements reference the view by name. Any views that are drivers can be identified by the existence of the icon Image Removed appearing in the top right of the view. Clicking on this icon will cause any dependent views and charts to refresh themselves.

To make a Dashboard element dependent upon the Driver view, set it up with a Filter which uses at least one condition with an expression containing the drivers view name. i.e ACCTS. When the Filter is evaluated, the view name ACCTS notation will contain the rows selected on the Driver view. An example condition expression is:

Code Block
AccountNum equals ACCTS.AccountNumber

Where AccountNumber is an Attribute on the Driver view.

Dashboard Pane Toolbar

This is found in the top, right-hand corner of the dashboard pane. This provides the following options:

...

Image Removed

...

.

...

...

Image Removed

...

Refresh will update the dashboard in line with changes made elsewhere in PhixFlow.

Anchor
dashboardElement
dashboardElement
Forms: Dashboard Element

...

FieldDescription
NameName of the dashboard element.
Name of targetName of the view underlying this dashboard element.
Data Retrieval Options
Refresh If Not ActiveIf ticked, the dashboard will refresh even if not active (e.g. after the driving selection changes). Otherwise it will refresh as soon as it becomes active.
Use Custom Data RangeTicking the field allows to choose the different data range than is selected on the original view.
Data RangeRange of Stream Sets which will be shown on the chart. The user can choose Latest Stream Set or All Stream Sets.
Use Custom Default Filter

If you tick the checkbox, you can choose a default filter. This will override the default filter set in the original view, if one has been set.

Default FilterThe default filter applies to this dashboard element.Background Filter

The background filter of this dashboard element. This will be applied in addition to the background filter of the original view, if one has been set.

A default filter, if set, or user selected filters are applied on top of this background filter, and the view background filter.
Refresh When Dashboard Refreshes?

Select one of:

  • Always
  • Never
  • Always except on first load
HELPDEVTODO: implications on using context variables vs. database values when populating fields on the view - insert vs. update actions

HELPDEVTODO not yet added

Apply Selections Mode

Auto - Linked Views linked with the Driving View will refresh automatically after selecting a row.
Manual - Linked Views linked with the Driving View will refresh after clicking on a Update the dashboard using the selected rows green button.
Header Options
Display Export ButtonToggle the export button on the view in the dashboard
Display Filter ButtonToggle the filter button on the view in the dashboard
Display Paging ButtonToggle the paging button on the view in the dashboard
Display Refresh ButtonToggle the refresh button on the view in the dashboard
Display Sort Order ButtonToggle the sort order button on the view in the dashboard
Background Filter Rules
Evaluate These Filter Rules as an OrTicking this field means that the background filter rules will be combined as an "or" filter as opposed to an "and" filter
Background Filter RulesA grid of background filter rules which are combined together (usually as an and conjunction) to create the background filter for the dashboard element 
Background Filter Rules have the Following attributes:
Rule Expression The Expression for this Filter rule, if it evaluates to true then the filter associated with this filter rule will be used
FilterThe Filter that will be used should the Rule Expression evaluate to true
OrderThe order in which the filter rules for this dashboard element will be evaluated
Enabled

If not true, this filter will not be used

Stop If TrueIf true and the Rule Expression evaluates to true then any subsequent filter rules will not evaluated
DescriptionA Description of the filter rule

Form Icons

The form provides the standard form icons.

...