Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 41 Next »

This page is for application designers who want to create new application project.

Are we calling it application properties or settings? Properties. In this case you are using a pop-up window to set specific properties, but it would be good to keep this consistent. Also, the devs have used lots of different terms in the GUI where clicking an option opens its properties (e.g. Show stream configuration or Show dashboard details). The options should be simplified and made consistent: "Properties" or "Open properties"

We need to add this to the terminology document and also let me know so I can update the flow. We call it settings later on. It was already in.

Sections on this page

Overview

There are several things that happen when you create an application.

  1. PhixFlow creates all the folders in the repository that your project will need.
    This includes a default menu. You can find the menu in the repository → Menus branch → application_name_Menu.
    When you add the first option to the menu, it is automatically displayed on the right of the menu bar at the top of the PhixFlow window; see Menu.
  2. The template that you select is added to your application's Packages folder.
    The template includes the palettes that will give your application a consistent design.
  3. The template sets default properties for your application:
    • formats for dates and numbers
    • the palette and components to use for forms, data fields and cards
    • the styles for data grids
    • the default action - todo-fiona link
    • user groups and access permissions  - todo-fiona check this is happening

You can change all the properties later; see Application properties.

See also

Switch between a  card or  list layout.

Creating a New Application

To create a new application:

  • either in the repository → Applications section, click  Add New

  • or, in the  Application menu; see The Application Menu, below.
    Click the last card, which is the New Application card:

PhixFlow opens the Create Application window. Set the following properties for your application:

  1. Name

  2. Version: a development version number, for example 1.

  3. Description: consider including the purpose of the application and who is responsible for it.

  4. Template: select a template to provide a design theme and to set key properties.

  5. Application Icon: This is the image PhixFlow displays in the card on the application menu. If you do not select an icon, PhixFlow uses a default image.


    • Either use the drop-down to select an icon that has already been loaded into PhixFlow

    • Or click   to find an image on your file system to load.

    Icons for the application menu should be:

    • up to 100 pixels high

    • between 100 to 150 pixels wide

Click Create Application. PhixFlow prompts you to load the application. You can work on an application without loading it.

todo-fiona: check with dev - you have to click load to get the app creation process to complete

Menu

When you create a new application in the repository, PhixFlow automatically creates a menu item for it. You can find the menu in the repository → Menus branch → application_name_Menu. When you add the first option to the menu, it is automatically displayed on the right of the menu bar at the top of the PhixFlow window; see Menu.

Application Menu 

Applications are listed as cards on the application menu.

The  Application menu 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.

 To redisplay the application menu, in the top left of the PhixFlow window click:

  • either the  Application menu
  • or the , if it appears.

Each application card also has a pop-up menu; see Application for details.

PhixFlow's Welcome Window
PhixFlow's Welcome Window


Changing Application Settings

When you create your application project, you are setting up some defaults for the whole application.  We now also take them from a template package. To change or set additional options for your application:

  • either go the the application Home window and use the link in the top right of the window
  • or open the repository and click on the application name.

PhixFlow opens the Application properties.

Your application may also be using defaults set in System Configuration. For example, you can optionally specify the formats for dates and times in your application using the settings:

  • Date
  • Date/Time
  • Number

If you do not specify formats, PhixFlow uses the formats specified in the system configuration.

We need to outline the hierarchy of this logic i.e. system properties are overridden by templates etc.


  • No labels