Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
nameapp
nopaneltrue

This page is for PhixFlow application designers who need to create a new application, or change the defaults for an existing application.

Overview

In PhixFlow to design When you create an application GUIin PhixFlow, you add components to select a screen. Components include tables, charts, menus and buttons. By connecting the components to the data in tables (streams), you can create applications. Application users can load an application to interact with the table (stream) data, for example to view and update it.

For how to:

template. This configures default styles and formats for your application. For how to create a new application, see Creating an Application.

  • open an application, and the application Home window, see Designing Applications
  • To access the application properties:

    • either go the the application Home window and use the link in the top right of the window
      Image Removed
    • or open its properties from the repository.

    PhixFlow opens the application properties on the right. You can use the options to set:

    whether you want a menu bar, and which menu options appear there

    When you are working on your application in

    Insert excerpt
    _design_mode
    _design_mode
    nopaneltrue
    , you can:

    This page lists the application properties. To open the application properties tab:

    1. Go to the
      Insert excerpt
      _repository
      _repository
      nopaneltrue
       tab. 
      If the tab is not present, in the PhixFlow toolbar, click the 
      Insert excerpt
      _repository
      _repository
      nopaneltrue
       icon.
    2. In the Applications section, double-click your application's name.
    3. PhixFlow opens the properties tab for the application on the right.

    Use the options to set:

    • icons for the application
    • defaults for:
      • number formats
      • styles for grids
      • components to use for displaying data.
    • menus so that user's can navigate through the application
    • access privileges to specify which users can use the application.
    • the theme that your application uses
    • data formats, if you do not want to use the PhixFlow defaults
    • any packages containing shared resources that your application can use; see Package.
    Panel
    borderColor#7da054
    titleColorwhite
    titleBGColor#7da054
    borderStylesolid
    titleSections on this page

    Table of Contents
    indent12px
    stylenone

    Application Properties

    Loading an Application

    Application users can load an application into 

    Insert excerpt
    _

    standard

    app_

    settings

    mode
    _

    standard

    app_

    settings

    mode
    nopaneltrue

    About

    Field

    Description

    Name

    The name of the application.

    Created by

    The name of the person who created the application

    DescriptionThe description of the application. Consider including the purpose of the application and who is responsible for it.Application Icon

    Select an uploaded image to use in the application menu card for this application. We recommend an image size of approximately:

    • height: up to 100 pixels
    • width: 100 to 150 pixels.

    See Image for how to upload an image to PhixFlow. PhixFlow uploads application icons and logos to its database in images/icons ??dev to confirm

    Navigation

    Menus

    This section lists the menus and the associated actionflows or table-item-actions that have been created for your application.

    A default menu is created automatically with the application.

    You can specify that PhixFlow uses a different menu for desktop and mobile devices. In the grid, right-click a menu to display the context menu and select:

    to interact with data, for example to view and update it.

    You can work on the files in an application's project without loading it. However, if you load an application, the repository is automatically filtered to show just the files available to the application. 

    There are several ways to load an application.

    • From the application menu, click the application card to load it.
      By default, PhixFlow opens with the application menu displayed. To redisplay the menu, in the top left of the PhixFlow window click:
      • either the
        Insert excerpt
        _app_menu
        _
    desktop
      • app_menu
    _desktop
      • nopaneltrue
      • or the 
        Insert excerpt
        _
    menu
      • phixflow_logo_
    mobile
      • name
        _phixflow_
    menu
      • logo_
    mobile
      • name
        nopaneltrue

    PhixFlow will display in the default menu in the menu bar:

    • once options have been added
    • and when Show Default Menu Bar is selected (see below).

    PhixFlow displays the mobile or desktop icon next to the application's name. Using that context menu the user can also load the application with selected menu. All options available in the context menu are:

    Use the buttons below the list to:

    Insert excerpt_add_addnopaneltrue add another menu to the list; see Menu properties Insert excerpt_delete_deletenopaneltrue delete the menu from this application.

    Additional options related to user navigation are:

    Field

    Description

    Show Application in
      • , if it appears.
    • From the repository, right-click on the application name and select 
      Insert excerpt
      _app_load
      _app_load
      nopaneltrue
      .
    • In a browser address bar, enter the application URL; see Starting PhixFlow. When PhixFlow is started in this way, you can still navigate to other applications that you have permission to access.

    Application 

    Insert excerpt
    _property_toolbar
    _property_toolbar
    nopaneltrue

    Insert excerpt
    _property_tabs
    _property_tabs
    namebasic-h
    nopaneltrue

    Basic Settings

    Field


    Description

    Name

    Enter the name of the application.


    Model Validation Status
    Insert excerpt
    _validate
    _validate
    namestatus
    nopaneltrue
    VersionEnter a version number for your application. Use this to track the stages of development or  maintenance for your application. 
    Do not show in the Application Menu

    Select whether or not this application appears in the 

    Insert excerpt
    _app_menu
    _app_menu
    nopaneltrue
    . For example, you may have a test application that should not be visible to other PhixFlow users. Use the repository to open an application that is not present in the Welcome window's application list.

    Show Default Menu Bar

    If you want menu options for the user to navigate your application, select this potion. PhixFlow displays the menu bar at the top of the application screen. Use the Navigation settings to add menu options. See PhixFlow's Interface for screenshots showing the default menu bar.

    Access Permissions

    For details about how to control access to an application, see Common Properties → Access Permissions.

    Style Settings

    Field

    Description

    Theme

    The name of the theme that defines the defaults and styles for this application. The theme provides a set of palettes  and sets some style defaults, such as the styles for grids that you add to screens.

    Select the palette that you want to use when you drag stream attributes onto a layout or area. PhixFlow uses this palette when its container application is running.

    What about this??
    If the container application for is not running, PhixFlow uses:

    • either the default palette set for the area.

    • or the default palette for the destination application when you are dragging stream attributes into a layout for a different (destination) application that is running.

    If you do not set a default palette, PhixFlow uses the system default palette.

    You can change style settings:

    • in the template components in the palette
    • create shared styles
    • set styles on individual components

    Shared Styles and Style Order

    Date 

    Insert excerpt
    _check_box_untick
    _check_box_untick
    nopaneltrue
     to include this application.

    Insert excerpt
    _check_box_tick
    _check_box_tick
    nopaneltrue
     to exclude this application. This is useful for test applications that you do not want anyone else to see.

    Default Date FormatSelect the default format for Date attributes and components.


    Select a format from the drop-down list or click the icons to:

    Insert excerpt
    _

    format_list

    date
    _

    format_list

    date
    nopaneltrue
    : shows the date or date/time formats available for this application in the repository.

    Insert excerpt
    _

    add

    new
    _

    add

    new
    nopaneltrue
    : create a new format.

    Default Date
    Time 
    /Time Format Select the default format for DateTime attributes and components.
    Default Number FormatSelect the default format for numbers.

    UX question - should these be dropdown lists?? Not sure about add here??

    Packages

    This section has a toolbar with standard buttonsThe grid contains a list of packages that contain this application. To add an application to the list:

    Click

    Select a format from the drop-down list or click the icons to:

    Insert excerpt
    _list_number_

    add

    formats
    _

    add

    list_number_formats
    nopaneltrue

     to list all the packages

    : shows the number formats available for this application in the repository.

  • Drag packages into this list. 
  • To remove a package from the list, use the toolbar button  

    Insert excerpt
    _

    delete

    new
    _

    delete

    new
    nopaneltrue
    : create a new format.

    To be confirmed??

    From original doc...

    The styles you select override any styles set in System Configuration. You can override these defaults for individual grids using the style settings in the Stream View properties.

    To specify a style, select it from the drop-down list or click the icons to:

    Insert excerpt_style_list_style_listnopaneltrue: shows the styles available for this application in the repository. Insert excerpt_add_addnopaneltrue: create a new style.

    This may be moving to system??

    Field

    Description

    Default Component Palette

    Select the palette that you want to use when you drag a table, view or attribute onto a screen canvas. 

    PhixFlow uses this palette when its container application is running. If the container application for is not running, PhixFlow uses:

    • either the default palette set for the area.

    • or the default palette for the destination application when you are dragging attributes into a layout for a different (destination) application that is running.

    If you do not set a default palette, PhixFlow uses the system default palette.

    Tip

    Basic palettes are installed with PhixFlow. Additional palettes are available, see Understanding Template Packages and Installing Template Packages.

    Anchor
    images
    images

    Application Icon

    Select an uploaded image to use in the application menu card for this application. We recommend an image size of approximately:

    • height: up to 100 pixels
    • width: 100 to 150 pixels.

    See Adding Images for how to upload an image to PhixFlow. 

    PhixFlow uploads application icons and logos to the images folder in its database. You can see a list of uploaded images in the repository > Images section.

    Application Logo

    Select an uploaded image to provide customised branding for the application. When a user clicks this image, it will open the application menu. We recommend an image size of approximately:

    • height: up to 40 pixels
    • width: up to 300 pixels.

    See Image for how to upload an image to PhixFlow.

    Application Menu and Context Menus

    The Application Menu  Anchorapp_menuapp_menuWhen you run PhixFlow in 

    Style Settings

    When you drag a table or view onto a screen canvas, and select a grid component to display the table data, PhixFlow adds a grid. In this section, set the default appearance of grid views for the application. You can set the following:

    • Default Header Icon Style
    • Default Header Dropdown Pane Style
    • Default Paging Style
    • Grid Header Style
    • Grid Header Button Style
    • Grid Header Dropdown Button Style
    • Grid Row Style
    • Grid Alternate Row Style
    • Grid Row Hover Style - applies when the mouse is over a row in a grid.
    • Grid Column Style
    • Grid Column Header Style
    • Row Selection Style

    To specify a style, select it from the drop-down list or click the icons to:

    • Insert excerpt
      _styles_ccs_list
      _styles_ccs_list
      nopaneltrue
       to show available styles
    • Insert excerpt
      _
    design_mode
    • add
      _
    design_mode
    • add
      nopaneltrue
     without loading an application, you will see the PhixFlow logo and text in the top left of the window. You can click this area to open the  
    •  to create a new style; see Style.

    The styles you select override any styles set in System Configuration. You can override these defaults for individual grids using the style settings in the View properties.

    Default Components

    In this section, select an appropriate component for PhixFlow to add when you drag attributes onto a form or card container. For information about data types, see Understanding Data Types.

    • String
    • Bigstring
    • Long
    • Float
    • Decimal
    • True/False
    • Date
    • DateTime

    Also set the styling for a:

    • Form
    • Card
    • Drop Down
    • Dynamic Text

    And select a default:

    • Table Action - This is the button that PhixFlow adds when you drag a table-action onto a screen canvas.
    • Menu Button

    Menus

    This section has a toolbar with standard buttons. The grid lists the menus that have actionflows or record-actions that can be applied for this application.

    PhixFlow automatically creates a default menu when you create the application project. PhixFlow will display in the default menu in the menu bar:

    • once you have added options to the menu
    • and when Show Default Menu Bar is selected (see below).

    If there are several menus, listed PhixFlow uses the selected (ticked) menu as the menu bar for the application.

    You can specify that PhixFlow uses a different menu for desktop and mobile devices. Right-click on a line in the list to show the popup menu options:

    • Insert excerpt
      _

    app
    • menu_

    menu
    • desktop
      _

    app
    • menu_

    menu
    • desktop
      nopaneltrue
      : use this menu on desktop devices. The

    menu lists the applications available in the current PhixFlow instance.When you run PhixFlow in either 
    • grid shows the desktop icon next to the menu name.

    • Insert excerpt
      _

    app
    • menu_

    mode
    • mobile
      _

    app
    • menu_

    mode
    • mobile
      nopaneltrue

     or 
    • : use this menu on mobile devices. The grid shows the mobile icon next to the menu name.

    • Insert excerpt
      _

    design_mode
    • new
      _

    design_mode
    • new
      nopaneltrue

    , if your PhixFlow URL does not specify an application, the 
    app_menu
    • delete
      _

    app_menu
    • delete
      nopaneltrue

     opens automatically when you log into PhixFlow.  To open the 
    •  delete the menu from this application.

    Insert excerpt
    _

    app_menu

    access
    _

    app_menu

    access
    nopaneltrue

    at any time:either click on the logo/name in the top left of the PhixFlow screen. By default this is the PhixFlow logo and name 

    Advanced

    Field

    Description
    Backslashes must be escaped in expressions

    There is a change in 9.0.0 which affects escaped backslashes in expressions. This option maintains backwards compatibility. By default this will be ticked for applications created before 9.0.0, and unticked for later applications. 

    Packages

    This section has a toolbar with standard buttons. The grid contains a list of packages.

    A package is a bundle of PhixFlow items that are shared between multiple applications. When you export/import an application to another PhixFlow instance, it is important to export/import all packages with the application; see Application Administration.

    One package will include your applications theme settings. To add another package to the application:

    1. Click
      Insert excerpt
      _
    phixflow_logo_name
    1. packages
      _
    phixflow_logo_name
    1. packages
      nopaneltrue
    .or, if your application has been configured to have no menu bar, click the logo in the bottom right of the PhixFlow screen. By default this is the PhixFlow logo 
    1.  to list all the packages in the repository.
    2. Drag packages into this list. 

    To remove a package from the list, use the toolbar button  

    Insert excerpt
    _

    phixflow_logo_only

    delete
    _

    phixflow_logo_only

    delete
    nopaneltrue

    .

    Your administrator can configure the graphic that appears in the menu bar in the application properties → Basic Settings → Application Logo option, below

    .

    The 

    Insert excerpt
    _

    app_menu

    audit
    _

    app_menu

    audit
    nopaneltrue

     lists the available applications as cards, for example:
    Image RemovedThe 

    Tip

    Insert excerpt
    _

    app_menu

    description
    _

    app_menu

    description
    nopaneltrue

     displays the applications:
    • that have been configured to appear on menu
    • and that you have permission to use.

    The repository → Applications branch displays the applications that you have permission to use.

    Application Card Context Menu

    Each application card also has a context menu. To open the application card context menu:

  • either right-click anywhere in the card
  • or hover your mouse pointer over the card, then

    Popup Menu Options

    To access popup menus for an application:

    • Either, in the repository, right-click on an application's name to show the popup menu.
        Image Added
    • Or, in the application menu:
      • click the 
        Insert excerpt
        _more_options
        _more_options
        nopaneltrue
     icon, which is displayed in the top right. Repository Application Context Menu
    Applications also have different context menu available from the repository. To display the repository application context menu,
      • right-click
    the name of an application.

    Image Removed

    Context Menu Options
      • anywhere on the card

    Image Added

    Available in
    context menu
    a popup accessed fromOptionDescription

    application card and
    repository application name


    Image Added Load Application
    Load the selected application so that it is running in 
    Insert excerpt
    _app_mode
    _app_mode
    nopaneltrue
    .
    application cardLoad application in a New TabOpen a new browser tab with the selected application loaded.
    application cardLoad Application in a New WindowOpen a new browser window with the selected application loaded.
    repository application nameImage Added Filter by NameIn the repository
    browser, use the application name to display only the repository tree for
    . filter the list of applications to only show the selected application. The application is not loaded.
    repository application name
    Edit

    Insert excerpt
    _edit
    _edit
    nopaneltrue

    In
    Insert excerpt
    _design_mode
    _design_mode
    nopaneltrue
    , open the
    properties for the selected application
    application properties tab to make changes.
    repository application name
    Insert excerpt
    _delete
    _delete
    nopaneltrue
    Delete the selected application from the repository. This cannot be undone.



    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


    Learn More