Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page is provides the reference information for dashboard properties.

Overview

Create application screens by starting with a dashboard; see Creating or Opening a Screen.

PhixFlow opens existing screens locked, to prevent accidental editing. To edit a screen,  Insert excerpt_layout

This page is provides the reference information for dashboard properties.

Overview

Create application screens by starting with a dashboard; see Creating or Opening a Screen.

PhixFlow opens existing screens locked, to prevent accidental editing. To edit a screen, 

Insert excerpt
_layout_unlock
_layout_unlock
nopaneltrue
 it:

  • either using the toolbar 
  • or right-click anywhere in the screen to display the pop-up menu.

This page explains the dashboard properties. For information on how to divide a dashboard into different panes, and how to add components to it, see Drag-and-Drop Techniques.

See Also

Properties

Insert excerpt
_property_toolbar
_property_toolbar
nopaneltrue
 The toolbar includes the button to 
Insert excerpt
_dashboard_display
_dashboard_display
nopaneltrue
.

Insert excerpt
_parent
_parent
nopaneltrue

Live Search
spaceKey@self
additionalnone
placeholderSearch all help pages
typepage

Panel
borderColor#00374F
titleColorwhite
titleBGColor#00374F
borderStylesolid
titleSections on this page

Table of Contents
maxLevel3
indent12px
stylenone


Basic Settings

 is the default. The screen does not need to be cached.

Caching relates to the screen itself. Any data backing the screen will be reload each time the screen is opened.

FieldDescription
NameThe name of the screendashboard.
Open Maximised

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to open the screen the dashboard maximised.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to open the screen dashboard as a pop-up window.

Allow User to Resize

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to enable the application user, when running in 
Insert excerpt
_app_mode
_app_mode
nopaneltrue
, to resize the

screen

dashboard.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to keep the

screen

dashboard size fixed when running in in 

Insert excerpt
_app_mode
_app_mode
nopaneltrue
.

This option does not affect resizing the

screen

dashboard in 

Insert excerpt
_design_mode
_design_mode
nopaneltrue
.

Show Toolbar
Insert excerpt
_design_mode
_design_mode
nopaneltrue
 always has a toolbar with the screen dashboard name on the left and toolbar icons on the right. 

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to also display the toolbar in 
Insert excerpt
_app_mode
_app_mode
nopaneltrue
. The screen dashboard name is displayed. Toolbar icons are not displayed.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 is the default as the toolbar is usually not required in 
Insert excerpt
_app_mode
_app_mode
nopaneltrue
.

Show Window Button Bar

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to display a Windows-style bar at the top of the screendashboard. This has a maximise/restore button and a close button.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to have no Windows-style bar at the top of the screendashboard.

Always On Top

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to keep the

screen

dashboard on top of other

screens

dashboards. This is useful for a pop-up window that you want a user to complete before returning to another

screen

dashboard.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to allow other

screens

dashboards to be displayed in front. 

Keep Data

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to allow screen allow dashboard data to be referenced even after the screen dashboard is closed. This is useful if an application user needs access to global data available in the system.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 is the default. The screen data dashboard data is not required once the screen dashboard is closed.

Preload

ScreensDashboards, especially complex screensdashboards, can take some time to open, which can feel slow to the application user. Use this option when you need a screen dashboard to open quickly. Preloading screens adds to the time it takes PhixFlow to initially start up.  For this reason we recommend you only preload screens dashboards that an application user will always want to open.

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to preload the screen the dashboard when PhixFlow first starts.  When the user then opens the screendashboard, it displays immediately. The data itself may still take time to load.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 is the default. The screen dashboard does not need to be preloaded.

Preloading relates to the screen dashboard itself. Any data backing the screen dashboard is only loaded when the screen dashboard opens, and this may also take time to load.

Cache Locally

Width

For screens

If an application user is likely to require the same screen dashboard in different stages of a task. Use this option so that, when the user closes and reopens the screendashboard, it loads immediately. 

Insert excerpt
_check_box_tick
_check_box_ticktick
nopaneltrue
 to cache the dashboard on the application user's client computer when the dashboard first opens.

Insert excerpt
_check_box_untick
_check_box_tickuntick
nopaneltrue
 to cache the screen on the application user's client computer when the screen first opens.
Insert excerpt
_check_box_untick_check_box_untick
nopaneltrue
Position

For screens that are not set to Open maximised.

By default, pop-up screens are opened floating centrally. If you want a screen to open with a fixed position, select one of the drop-down options:

  • Pinned to top
  • Pinned to bottom
  • Pinned to left
  • Pinned to right
  • Floating (default)

 is the default. The dashboard does not need to be cached.

Caching relates to the dashboard itself. Any data backing the dashboard will be reload each time the dashboard is opened.

Position

By default, new dashboards are set to Floating. If you want a dashboard to open with a fixed position, select one of the Pinned drop-down options:

  • Pinned to top
  • Pinned to bottom
  • Pinned to left
  • Pinned to right

Use the Pinned options to create a permanently visible dashboard. This is useful for a navigation area or toolbar that you want to be visible for all other dashboards. Floating dashboards do not overlap with pinned dashboards. When the user maximises a Floating dashboard, it expands only to the remaining space. 

Width

For dashboards that are not set to Open maximised, specify a screen dashboard width in pixels, for example 500px for a small confirmation window. The default size for a pop-up screen dashboard approximately 800px.
Height

For screens dashboards that are not set to Open maximised, specify a screen dashboard height in pixels, for example 150px for a small confirmation window. The default size of a pop-up screen dashboard is approximately 500px. 

Top

Available when Position is Floating.

For screens dashboards that are not set to Open maximised, set an offset value in pixels to position the screen dashboard where it is required. For example, to display a screen dashboard as a pop-up window towards the top left of the screen, set:

  • Top: 60px
  • Left: 60px
Left
Right
Bottom

Dashboard Elements

This section lists has a toolbar with standard buttonsThe grid contains a list of the Dashboard Elements on this screendashboard.

PhixFlow creates To add dashboard elements when you , on the dashboard, use the pop-up menu Add Area... options to divide up the screen. In PhixFlow version 8.3 and earlier, dashboard elements enabled dashboard. When you add a component to a part of the dashboard, PhixFlow automatically creates a container dashboard element for it. This means different parts of the screen to dashboard can be bound to different sources of data, either a stream (table) or viewdata views.

Where dashboard elements are bound to data, you can link them, so that the data in one dashboard element drives the data in another; see Linked and Driving Views.and Driving Views or Forms.

To delete a dashboard element, on the dashboard right-click components on part of the dashboard and select Delete. When the dashboard element is empty, right-click it and select 

Insert excerpt
_delete_item
_delete_item
nopaneltrue
 Element

Menu Items

This section has a toolbar with standard buttons and:

  •  Image Modified Show stream-actions
  • Insert excerpt
    _filter
    _filter
    nopaneltrue

The grid contains a list of menu items. To add a menu item to the list, click 

Insert excerpt
_add
_add
nopaneltrue

  1. click 
    Insert excerpt
    _add
    _add
    nopaneltrue
  2. Select 
    • either Add a new sub-menu
    • or Add a new menu item; see Menu
  3. PhixFlow opens a new properties tab for a menu item or sub-menu; see Menu for details.

To remove a menu, use the toolbar button 

Insert excerpt
_delete
_delete
nopaneltrue
.

Mappings

This section has a toolbar with standard buttons

Components on the screendashboard, such as buttons or data-components, can have actions or stream-item actions. Stream-item actions can take data from attributes in different streams (tables) or views. Where the attributes have different names, you must map the attribute, so that the stream-item action recognises the data. This grid contains a list of mappings for the components on this screen. To configure a mapping, in the screen, right-click a component and select  Insert excerpt_mapping_mappingnopaneltrueso that the stream-item action recognises the data. This grid contains a list of mappings for the components on this dashboard. 

To configure a mapping, in the dashboard, right-click a component and select 

Insert excerpt
_mapping
_mapping
nopaneltrue
.

Unreachable Actions

This section has a toolbar with standard buttons. The grid displays a list of actionflows that are linked to components on the dashboard, but do not exist yet.


Tip

Actionflows are a new way to configure actions, introduced in PhixFlow version 9.0.0; see Understanding Actionflows.

Actions

This section has a toolbar with standard buttons. The grid displays a list of actions and  actions and stream-item-actions that are linked to the dashboard.


Tip

Actions and stream-item-actions

that are linked to the screen.

were the way to configure dashboard functionality before PhixFlow version 9.0.0; see Using Stream Actions and Stream Item Actions


Insert excerpt
_access
_access
nopaneltrue

Insert excerpt
_description
_description
nopaneltrue

Insert excerpt
_audit
_audit
nopaneltrue

Menus and Toolbars

Screen Toolbar

There is a toolbar above the screen canvas. This provides the following options:

List options

Insert excerpt
_tables
_tables
nopaneltrue

Open the repository showing the list of available tables for your application.

Insert excerpt
_screen_toolbar
_screen_toolbar
nopaneltrue
Open the repository showing the list of available screens dashboards for your application.
Insert excerpt
_actionflow
_actionflow
nopaneltrue
Open the repository showing the list of available actionflows for your application.
Insert excerpt
_palette
_palette
nopaneltrue
Open the list of palettes.
Insert excerpt
_styles
_styles
nopaneltrue
Open the repository showing the list of available styles for your application.
Canvas options
Insert excerpt
_help
_help
nopaneltrue
Open the help topic with details about working with screensdashboards.
Insert excerpt
_property_settings
_property_settings
nopaneltrue
Open the properties tab for the screendashboard.

Insert excerpt
_layout_unlock
_layout_unlock
nopaneltrue

or 

Insert excerpt
_layout_lock
_layout_lock
nopaneltrue

Unlock a screen dashboard to edit its layout.

Lock a screen to dashboard to prevent accidental edits and to display the data content.

Insert excerpt
_refresh
_refresh
nopaneltrue

Update the screen dashboard to reflect changes made elsewhere in PhixFlow, such as the screen dashboard properties, layer orders or shared styles.

Screen Pop-up Menu

Right-click on a screen to display its pop-up menu. The options available depend on where you click. If there are many options, some are moved onto the sub-menu

Insert excerpt
_screen
_screen
nopaneltrue
 Options.

Menu optionDescription
Insert excerpt
_layout_unlock
_layout_unlock
nopaneltrue
Unlock a screen dashboard to edit its layout.
Insert excerpt
_layout_lock
_layout_lock
nopaneltrue
Lock a screen to a  dashboard to prevent accidental edits and to display the data content.
Insert excerpt
_context_parameters
_context_parameters
nopaneltrue
For dashboards created in PhixFlow versions 8.3 and earlier, open a window listing the context parameters in alphabetical order.
Insert excerpt
_element_show
_element_show
nopaneltrue
For dashboards created in PhixFlow versions 8.3 and earlier, open the properties for the dashboard element.
Insert excerpt
_area_above
_area_above
nopaneltrue

Use these options to divide a screen dashboard into multiple, resizable panes. Select the option to add a pane relative to the currently selected pane.

To remove a pane, use the pop-up menu options 

Insert excerpt
_delete
_delete
nopaneltrue
 Pane.

Insert excerpt
_area_right
_area_right
nopaneltrue
Insert excerpt
_area_below
_area_below
nopaneltrue
Insert excerpt
_area_left
_area_left
nopaneltrue
Insert excerpt
_area_lock_width
_area_lock_width
nopaneltrue
Fix the height or width of the selected pane. You will no longer be able to resize a pane by dragging its dividing line.
Insert excerpt
_area_lock_height
_area_lock_height
nopaneltrue
Insert excerpt
_delete
_delete
nopaneltrue

When a specific component is selected, delete the component.

Other delete options that may be available relate to specific types of component in the selected pane.

Insert excerpt
_delete_item
_delete_item
nopaneltrue
 

Delete options depend on the selected item. Examples are:

  • Insert excerpt
    _delete_item
    _delete_item
    nopaneltrue
     selected objects
  • Insert excerpt
    _delete_item
    _delete_item
    nopaneltrue
     pane
  • Insert excerpt
    _delete_item
    _delete_item
    nopaneltrue
     form 
Insert excerpt
_element_delete
_element_delete
nopaneltrue
Delete a dashboard element.
Insert excerpt
_form_new
_form_new
nopaneltrue
Create a new form in the current area.
Insert excerpt
_pin_unpin
_pin_unpin
nopaneltrue

Pin a component to fix its position; see Pinning and Unpinning.

Insert excerpt
_palette
_palette
nopaneltrue

Open the palette to drag in components.
Insert excerpt
_autosize
_autosize
nopaneltrue

Toggle whether or not the currently selected component is automatically auto sized when an application window is resized by the user.

Note

Using this option, or manually resizing a component may change the state of the Layout → Style Settings → Auto Size property.


Insert excerpt
_arrange_components
_arrange_components
nopaneltrue

Options to arrange the selected components within a pane:

Insert excerpt
_align_left
_align_left
nopaneltrue

Insert excerpt
_align_right
_align_right
nopaneltrue

Insert excerpt
_align_top
_align_top
nopaneltrue

Insert excerpt
_align_bottom
_align_bottom
nopaneltrue

Insert excerpt
_distribute_horizontal
_distribute_horizontal
nopaneltrue

Insert excerpt
_distribute_vertical
_distribute_vertical
nopaneltrue


Insert excerpt
_repository_find
_repository_find
nopaneltrue

Open the repository with to see the selected component in the list. This can be useful if you want to move a component.
Insert excerpt
_screen_properties
_screen_properties
nopaneltrue
Open the properties tab for the screendashboard.
Insert excerpt
_record_show
_record_show
nopaneltrue

Display information about the stream and its stream-items.

Insert excerpt
_termterms_tableschanging
_termterms_tableschanging
nopaneltrue

Insert excerpt
_mapping
_mapping
nopaneltrue
Opens a new mapping element properties tab where you can map attributes with different names to components.
Insert excerpt
_children
_children
nopaneltrue
For the selected parent container, select all the child components.
Insert excerpt
_table_properties
_table_properties
nopaneltrue

or Show the Stream Configuration
Open the properties for the stream (table).

Insert excerpt
_attributes_show
_attributes_show
nopaneltrue
...

Show the list of attributes that are bound to the component. The attributes can be from a stream or view. This is shown in the option:

  • Insert excerpt
    _attributes_show
    _attributes_show
    nopaneltrue
     
    for stream
    (table)<name>
  • Insert excerpt
    _attributes_show
    _attributes_show
    nopaneltrue
     
    for view <name>


HTML Comment

Unreachable Actions

A workflow can have placeholder actionflows linked to a dashboard. If the actionflow has not been wired then it is listed here.

Open on Startup

You may have a screen that acts as your application's welcome window. Use this option to open a screen whenever the application starts.

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to open the screen when the application starts.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 is the default. The screen is opened by a user action within the application.