This page is for application designers who need to create views of data and bind them to components on screens. Todo-Anthony- check this page is correct when the GUI is finalised.

Overview

PhixFlow stores data in tables, formally known as streams. Tables can contain more data than you want to show to a user. For this reason, whenever you show data on a screen, you first compile a view of the data, which only displays the information you specify.A view is made up .

Views Consist of:

1. Attributes
   1. Attributes from the base table
      Specify which attributes to include in your view. You can hide attributes that you want access to but do not necessarily want a user to see, such as the UID of a record.
   2. Attributes from related tables.
      These are the attributes available to the view as the table they originate from shares a relationship with the base table as defined in the ERDs; see 

1. 1. Entity Relationship Diagrams. Views which contain these type of attributes are referred to as a relational view.

2. Records:

   1. For each table, the view includes records specified in the tables default period. This can be all data (usually for transactional data) or only the latest.
3. Sorting and Filtering
   1. You can

1. 1. filter and

1. 1. sort records. See Filtering and Sorting Data.

Components

Data can be displayed in different ways.

1. Insert excerpt
   _grid _grid nopanel true

   : the attributes form the grid columns and data records are displayed in rows. PhixFlow can add scroll bars or paging where grids cannot be accommodated by the screen size.

2. Insert excerpt
   _

1. card _

1. card nopanel true

   : rather than using a form to display data, you can use a card. Any palette item can be added to a card which offered great flexibility.

2. Insert excerpt
   _

1. chart_

1. pie _

1. chart_

1. pie nopanel true

   : attributes are represented in different segments of a pie chart, with values aggregated to represent the segment size. 

2. Insert excerpt
   _

1. chart_bar_

1. horizontal _chart_

1. bar_

1. horizontal nopanel true

   : attributes are represented on the vertical axis, with values aggregated and represented in the bar length.

2. Insert excerpt
   _

1. chart_bar_

1. vertical _chart_

1. bar_

1. vertical nopanel true

   : attributes are represented on the horizonal axis, with values aggregated and represented in the bar height.

2. Insert excerpt
   _chart_line _chart_line nopanel true

   : attributes are represented as points on a horizontal axis, with values aggregated and setting the point position on the vertical axis.

3. Insert excerpt
   _

1. form _

1. form nopanel true

   : attributes are represented by different fields. Usually a form is linked to an action on a grid. For example, the application user selects a line on a grid, and the form displays the data from that record.

Form and card components are special data components, as they can contain other elements, usually fields and labels.

How to Create and Display

Data

For more information on setting up charts and graphs, see Creating Dashboards and Reports.

Step

1: Select a

Table

1. There are several ways to show data on a screen:

   1. From an Entity Relationship Diagram (ERD), select a table and use the Create Screen option; see Creating a Screen from an ERD Table.
   2. Drag a Table from the repository or a tables icon from its properties directly onto a screen.
      1. A list of available tables is available by clicking the Tables button on the toolbar.
      2. This method will typically set the data for the backing form to that of the table.
2. PhixFlow asks you how you want the data to be displayed, select the desired option:
   
3. The view will be data is added to the screen.

Step

2: Select

the Attributes

1. Drag attributes from the Available Attributes window onto the view screen.
2. Start with attributes from the current (base) table.
   1. Optionally, click on related tables to show additional attributes that are available.
3. When you have dragged all the attributes you require, close the window.
4. 
5. These attributes can be changed by selecting the 

   Insert excerpt
   _attributes _attributes nopanel true

    button in the toolbar to add new attributes or right-clicking and selecting

   Insert excerpt
   _attributes_change _attributes_change name nopanel true

    to change existing attributes
   1. See Available Attributes Window for details.

Step

3: Apply

Filtering and

Sorting

Optionally, specify if you want to apply any filters or sort orders to the data

:

1. Select the view component you have added.
   You may need to right-click the view and select Show Stream View Configuration.
   PhixFlow opens the view properties.
   Image Removed
   

   Select an existing Default Sort Order, Default Filter or Background Filter.
   PhixFlow applies filters when the application user sees the view in the application window.

   TipThe application user can remove the default filter

2. On the

   Insert excerpt
   _property_tabs _property_tabs name nopanel true

   , in the Background Filter Rules section filters can be added by filters can be added by pressing 

   Insert excerpt
   _addIcon _addIcon name nopanel true

   1. For Grids, Sort Orders and Default Filters can be added by right-clicking on the grid and selecting 

      Insert excerpt
      _view_show_config _view_show_config name nopanel true

      , then select an existing Sort Order or Filter, or create a new one in the Data Retrieval Options section, see Sort Order and Filter for more detail.

3. 1. Image Added

4. Save all your changes and PhixFlow applies the filters.

   Tip
   Users can remove a Default Filter, where as Background Filters are permanent.

   
   

Reusing Views

Once you have created a view, you can reuse it in multiple locations. In the repository navigate the the table which owns the view, the base table, open the table and in the views section drag the desired view onto your screen. Be aware however that changes made to the view will affect all instances of that view.

Form Field Name

When you drag attributes from the Attribute Selection window or table onto a form, PhixFlow adds a field and label for each attribute. By default, the label is the attribute's name. However, for an attribute from a related streamtable, the Display Name will be shown and not the foreign key value.

For example:

For information about primary and foreign keys and the Display Name option; see Understanding ERDsEntity Relationship Diagrams.