Opening the List of Attributes

To open the list of available attributes for a form component:

• either right-click on the form in the dashboard and select 

  Insert excerpt
  _attributes_show _attributes_show nopanel true

• or open the properties tab for a stream or view and expand the Attributes section.

Creating a Form

There are two ways to design a form for a screen.

• From a list of attributes, drag an attribute onto a form component. PhixFlow adds a default labelled field that matches the data type of the attribute; see Showing Data on a Screen.
• Drag field components individually from the palette, as follows:

1. In the dashboard toolbar, click the

   Insert excerpt
   _palette _palette nopanel true

    icon.

2. Expand a palette that has field or labelled field components, such as:

   • Basic Components
   • Labelled Fields
   • Theme 1 - App Builder Base Components
   • Theme 2 - App Builder Base Components

3. Drag components onto a form container.

   Note
   Field or labelled fields must match the data type of the attribute that it will display.

   
   

4. Enter a name so that PhixFlow can save the component to the repository.

Adding a Static Text Label

Enter Your Own Text

Static text components display the text entered in their Display Text property. 

1. From the palette, drag a static text field component onto the dashboard.
2. If this is a label for a data field, optionally group the data field and the static text field together; see Grouping Components.
3. In the properties, in Basic Settings → Display Text, enter the fixed text you want to appear and save your changes.

To change a fixed text label:

1. Click on the label to select it.
   If the label is a composite component, click on the data field, then click again to select its label. 
   

2. PhixFlow displays the static text properties. Edit Basic Settings →  Display Text and save your changes.

Basic Components: individual data field and text components

Labelled fields: a composite component comprising a data field and a static text field

Use the Attribute Name

When designing a dashboard, you may want a field to have a label that indicates the data being displayed. Where the attribute name is a good reflection of it's data, you can use this to add a label. For example, an attribute called Name has company name data:

To create a label from an attribute:

1. Open the list of available attributes.

2. Drag an attribute onto a form container on the dashboard.

3. PhixFlow adds a labelled field to the form.

A labelled field is a composite component that includes:

• a static text field, with properties → Basic Settings:
  • Name is Label
  • Display Text is the name of the attribute.
• a data field that displays data from the attribute.

For information about composite components, see Grouping Components.

The default component to use when you drag attributes onto a dashboard are set in the Application properties or in System Configuration.

Adding a Dynamic Text Label

1. The default component to use when you drag attributes onto a dashboard are set in the Application properties or in System Configuration.

For information on how to add more fields to a labelled field, see Adding to a Labelled Field, below.

Adding a Dynamic Text Label

You can create a label or heading that changes depending on the user-selected record, using a dynamic text component. This is useful to add headings to a form or card that change depending on the selected record. This is illustrated for a form heading on the right.

To bind the component to the attribute, give the dynamic text component the same name as the attribute.
 todo-Fiona any attribute or just primary keys?
todo-Fiona anything else

This is useful to add headings to a form or card. 

todo-Fiona - Name fields are often the display name for the primary key 

For a Grid

1. Create a dashboard with a grid and form, both bound to the same stream or view. 
2. Add a dynamic text component to the form.
3. Bind the component to an attribute.

For a Card

1. Drag a stream onto a dashboard. In the pop-up window, select the card component.

2. Optionally select related attributes.

3. In the card header, add a dynamic text component.
4. Bind the component to an attribute.

To bind the dynamic text component to an attribute, do one of  the following:

•  In the dynamic text properties, give it the same name as the attribute you want to show. 
•  on the dashboard, drag an attribute from the grid header onto the dynamic text component
• open the list of available attributes and drag one onto the dynamic text component.

Panel
borderColor #00374F titleColor white titleBGColor #00374F borderStyle solid title Illustration of Dynamic Text
A dashboard has a form container that includes a dynamic text field component that looks like this: Image Removed Dynamic text field showing heading that displays the business name The dynamic text field displays the attribute Name from the selected record in a grid.  . Image Added Dashboard with grid (top) and form (below)  In the dashboard below, the first record, for the business Avaveo, is selected.Image Removed      Dashboard with grid (top) and form (below)  The heading is a dynamic text component. It is set to display the attribute Name from the selected record in a grid. Both the data grid and the form are bound to a stream called Business, which includes the attribute called Name.      Image Modified Stream that is bound to the grid and the form In the dynamic text field properties, the Name property is set to Name. PhixFlow recognises that Name is an attribute. This creates a link between the dynamic text field and the attribute.

ddd

Image Removed