Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

This page is for application developers who want to provide a toolbar or menu of options for an application.

Overview

For applications that help application users to complete different tasks, you need to provide different options for starting on each task. To do this, create a startup action. This provides a

Overview

Startup actions run when an application is first open. It can be used to open the navigation bar and a landing page. 

If you do not want to create your own navigation menu, the startup actions provide the ability to create a static menu bar for your application, on which you can add menu options.  A startup action provides a topThese contain top-level menu itemitems, which is the container for menu options. The menu options can be:

  • either options that trigger an action
  • or sub-menus that list other menu options. 
When you create an application, PhixFlow automatically creates an empty top-level startup action (
  • menu
option) in the repository. When you add menu
  • options
to this menu and refresh the browser window, PhixFlow displays the menu(s) for the loaded application

For applications that are designed for use on both PCs and mobile devices, consider the usability of your menu on a small screen. A single menu may work in both form-factors. However, it can be helpful to have an alternative menu for mobile display. it is possible to set startup actions independently for either or both. 

Start Landing Page and/or Navigation

  1. In the repository open 
    Insert excerpt
    _startup
    _startup
    .
  2. Click 
    Insert excerpt
    _add
    _add
  3. Enter a Display Name.
  4. Tick one or both of the following as appropriate.
    1. Default Desktop Startup Action
    2. Default Mobile Startup Action
  5. Click 
    Insert excerpt
    _save
    _save
    , this creates the Startup Action.
  6. For Action Method select Actionflow.
    1. Insert excerpt
      _actionflow_list
      _actionflow_list
      : If you have an actionflow which opens the desired screen or screens click the actionflow button to navigate to it.
    2. Insert excerpt
      _add
      _add
      : If you need to create an actionflow click add new:
      1. Click on Connect.
      2. Select on Click.
      3. Click
        Insert excerpt
        _screen_toolbar
        _screen_toolbar
         on the toolbar.
      4. Drag the desired screens and or navigation menus you want to be present when your application opens for a user.
      5. Now drag the connection point to each of your screens as illustrated below:
      6. Image Added
      7. Changes are automatically saved, so close your actionflow.
  7. Click
    Insert excerpt
    _finish
    _finish
    to save your startup action and close it.
  8. Now when you next open the application it will open the selected screens.


Static Menu Creation

Adding Menu Options 
Anchor
add
add

To add menu options, in the repository for your application find the Startup Actions branch. For a new application there is always one menu option, which is added by Phixflow PhixFlow when you create the application.

  1. Double-click the menu item to open its properties.
  2. Optionally, you can change its Name.
  3. In the Menu Items section, click 
    Insert excerpt
    _new
    _new
    nopaneltrue
    .
  4. Select one of:
    • Add a new sub-menu
    • Add a new menu item 
  5. PhixFlow opens a new menu item properties.
    • For a menu item, select an action and specify the order for the menu in the menu bar.
    • For a sub-menu, enter a name, a display name and an order. Then add the Menu Items for the sub-menu.

The structure of the menu items in the repository reflects the menu structure you have created, for example:

  • The top-level menu item is the top of a tree of menus in the repository. The menu items listed in the top-level menu are displayed in the menu bar at the top of the screen. The top-level menu does not have a display name because it acts as a container for the menus, rather than being a menu option itself.

  • Menu options are associated with an action. Actions are often linked to underlying tables. When a user clicks the option, PhixFlow runs the action. For example, if your application has a form to which a user can add data, the menu option "Save Changes" would save the data to the underlying table.

  • A sub-menu contains more menu options or sub-menus, so it is not associated with an action. Sub-menus are displayed with a drop-down arrow to indicate they contain a list of options.

PhixFlow displays menu options and sub-menus on the menu bar. For example the menu structure illustrated above displays the following menu options:

You can create multiple top-level menus, but PhixFlow can display the options contained in only one top-level menu. 

Changing the Default Menu

To specify a default menu for an application, in the repository, right-click on the menu name and select:

  • either Make Default Desktop Menu
  • or Make Default Mobile Menu.

To specify an alternative menu to display instead of the default, provide users with a URL to the application that specifies the alternative menu.

Insert excerpt
_property_tabs
_property_tabs
namebasic-h
nopaneltrue

The options available and their order depend on whether you are configuring a startup action (top-level menu option), a sub-menu or a menu option.

Insert excerpt
_property_toolbar
_property_toolbar
nopaneltrue

Insert excerpt
_property_tabs
_property_tabs
namebasic-h
nopaneltrue

Insert excerpt
_parent
_parent
nopaneltrue

Basic Settings

FieldDescription
Name

Only available for the top-level menu item and sub-menu items.

Enter the repository name for the menu item.

Display Name

You can only enter a display name for sub-menus. Enter the sub-menu name for PhixFlow to display either on the menu bar or in another menu.

For menu options, PhixFlow shows the display name inherited from the action. To change the action's display name, 

  1. Find the action in the repository.
  2. Change the action properties Basic Settings → Display Name.
Order

Enter the order in which the menu will appear, either on the menu bar or in the sub-menu list. PhixFlow reorganises existing entries if you add an order that is already in use. 

The order for menu items is:

  • On the menu bar, left to right, with the last option aligned to the right of the screen.
  • In a sub-menu, top to bottom in the list.
Default ActionOnly available for the top-level menu item. Optionally, select an action that will run when the menu is opened.
ActionOnly available for menu options. Select an action that will run when the user clicks the option in the menu.
Hide the Menu Bar

Only available for the top-level menus.

Insert excerpt
_check_box_untick
_check_box_untick
nopaneltrue
 to display the menu bar at the top of your application; see Design and Application Mode for screenshots showing the default menu bar.

Insert excerpt
_check_box_tick
_check_box_tick
nopaneltrue
 to hide the menu bar. Use this option for a cleaner look to your application if it does not require menu options for the user.

You can have a different setting for default desktop and default mobile menus.

Menu Items

This section is available when Hide the Menu Bar is not ticked. The grid shows the list of menu items, including their:

  • Order
  • List: ticked indicates a sub-menu
  • Name
  • Display Name
  • Description

To add sub-menus and menu items, use the 

Insert excerpt
_new
_new
nopaneltrue
 button in the section toolbar; see Adding Menu Options, above.

Insert excerpt
_description
_description
nopaneltrue

Insert excerpt
_audit
_audit
nopaneltrue

Learn More

For links to all pages in this topic, see Connecting Events to Actions

Insert excerpt
_terms_changing
_terms_changing
nopaneltrue