This page is for data modellers who want to display data on a screen in a grid.

Overview

PhixFlow can display any Table data as a grid on GUI screens. This page will show you how to add data as a grid to any screen. It will go through a worked example of creating a grid of employees from various companies.

Creating an Employees Grid

Once you have a screen created it is simple to add any data to it. To add data:

1. Click 

   Insert excerpt
   _table_list _table_list nopanel true

    
2. Drag and drop the desired table onto the screen. In this instance, the Employees table is dragged onto a screen.
3. PhixFlow then asks how to display the data using:
4. Click Grid 
5. The attribute picker should then appear. Drag and drop the attributes to display directly onto the grid.

Relational Attributes

The Employees table has a relationship with a Company table. See the below ERD.

Each employee has a company ID associated to it and is stored in a foreign key attribute, Company. This attribute is linked to the primary key (id_1) of the Companies table. The Companies table also has a display name attribute (CompanyName). This is the attribute that is displayed on the front end when adding a foreign key to any data bound component. For more information on ERD diagrams and relational views, see Entity Relationship Diagrams.

Adding foreign key attributes

When a foreign key, e.g. Company from the primary table Employees, is added to the grid, PhixFlow does the following automatically:

• adds the display name attribute (CompanyName) from the related table (Companies).
  This attribute is marked with  in the grid header,
• hides the foreign key.

Adding relational attributes from a many:1 relationship 

On the above grid the user also wants to display the companies address on the same grid. This data is stored on the Company table and can be accessed using the relationship. To add the company address

1. Right click on the grid and click Show attributes for 'Employees'
2. Click the related table Companies(Company)
3. Drag and drop the attribute Address onto the grid. 
   This attribute is marked with   on the grid header.

Adding relational attributes from a 1:many relationship 

The user creates another screen to display the company data and wants to display the number of employees for that company using their 1:many relationship. Using an attribute from a 1:many relationship causes aggregation of the data. The most simple case is to use the count() attribute.

To add a relational attribute from a 1:many relationship:

1. Right click on the grid and click Show attributes for 'Companies'
2. Click the related table Employees(Company)
3. Drag and drop the attribute Count() onto the grid. 
   This attribute is marked with  on the grid header. It is counting all the records on the Employees table which have that company as its foreign key value.
4. Rename the attribute using the label to Number of Employees in the Grid Settings section on the attribute editor.

todo- redo GIF when Count() is available

Adding any other attribute on the table will also cause aggregation. A default aggregate function is added to the attribute added. If more than one attribute is added the aggregation is combined. The default aggregate function can be changed by

1. Open the attribute editor by clicking on the attribute column header
2. Add an Aggregate function using the drop down under Basic Settings.

For more information on aggregation, see Aggregating Data.

PhixFlow sets the following defaults: 

Making Grids Editable

Marking Columns as Editable

By default all grid attributes are read only. Grids can be made editable by

1. Click on the attribute column header to open its property editor
2. Open Grid Settings

3. Untick Read Only

   Info
   Strings, Bigstrings, Integers, Floats and Decimals allow users to type to change its value Dates and Datetimes have a date picker to change its value Display name attributes will automatically appear as a drop down. Selecting a different value, e.g. Company, will automatically update the ID stored in the foreign key attribute

   
   

Saving data

To save changes to editable attributes

1. Right click on a grid and Show the view configuration
2. Open the Advanced section
3. Tick Auto Save
   This will automatically save any changes made to the grid. An action can be added as a save action below this field if required.

Drop downs

Any attribute can have a drop down added for a user to select a value. See View Attribute. 

Filtering and Sorting - New page

The data in the grid can be automatically sorted by adding a default sort order on the backing view. For more information on sort orders see Sort Order.

The default sort order can be overwritten at any time by a user, by right clicking on a column header and clicking Sort Ascending or Sort Descending. 

Image Removed

The data in displayed on the grid can be filtered in the following ways

a

user

to

Example: A button is clicked to show all employees for company X. This sets a hidden attribute to true. The background filter only applies when this hidden attribute is marked as true.

Filters on Data Views

select

Image Removed

Styles and Formatting - New page

Grids and columns can be styled and formatted on the backing view.

• Grid Header Style
• Grid Header Button Style
• Grid Header Icon Style
• Grid Header Dropdown Button Style
• Grid Header Dropdown Pane Style
• Grid Paging Style
• Grid Row Style
• Grid Column Header Style
• Row Selection Style

a

value

.

See View Attribute

• Setting attribute column widths
• Labelling columns
• Number Formats
• Date/Time Formats
• Hiding columns
• Reordering columns

Adding Actions - New section I believe this can be applied to pie charts etc too

Actions can be added to grids in three locations

.

To add an action as a double-click action

1. Right click on a grid to Show the View Configuration
2. Open the Actions tab
3. On Double Click Action select either Table Action or Actionflow as an action type
4. Select or create the appropriate action. See Configuring Actions.

Image Removed

To add an action to a grid column

1. Click on the grid column header to open the attribute property editor.
2. On Double Click Action select either Table Action or Actionflow as an action type.
3. Select or create the appropriate action. See Configuring Actions.
4. Optionally set the following:

The style applied to the action icon. If no style is set, PhixFlow uses a default cog icon Image Removed.

Image Removed

To add an action to drop target

Image Removed

More Information

For a complete list of view properties and their functions see View.