Creating an Application

Overview

Applications contain everything necessary for it to function, from its data and access permissions, to links with associated packages. Each application has a unique URL and associated styling.

Open an Application

To open an existing application

  1. Double-click on the application's name from the application list that opens with PhixFlow.
    1. If the application list is not displayed, in the top left of the PhixFlow, click .

Access an application using its URL

Every application has a URL which allows you to access it directly. 

  1. To obtain the URL for the application, the most reliable method is to open the application and copy the value from the address bar:
    1. For example: https://bigcorp.com/phixflow/?application=Data%20Analysis
 More Detail

The URL is made up of: Server Address + Application Name + Menu Name

For example: 

Server addresshttps://bigcorp.com/phixflow/start?

Application NameData Analysis. Spaces must be replaced by %20 in a URL.

Menu Name: navigation

Result:

https://bigcorp.com/phixflow/?application=Data%20Analysis&menu=navigation

Creating a New Application

  1. Click  Add New from the PhixFlow Landing Screen.
    • If this is not open, click the  Application menu.

2. PhixFlow opens the Create Application wizard.

3. Set the following properties for your application:

    • Name: enter a name.

    • Version (Optional): enter a version number if applicable.

    • Description (Optional): we recommend entering a useful description of the application, potentially the data owner and app creators.

    • Template: Template Packages define the styling, default settings and templates used to create your application. We recommend selecting a PhixFlow template, such as Serene Grey, as this comes complete with everything you need to start creating your application. 

    • Application Icon (Optional): select an image to be used as the icon for your application on the selection screen.

      Icons for the application menu should be:

      • up to 100 pixels high
      • between 100 to 150 pixels wide

4. Click Create Application.

Templates Packages

Template Packages contain predefined options to specify a palette and other default properties; these include styling, default settings and templates used to create the content of your application. A Template package is selected when an application is created. See Understanding Template Packages.

 Packages

In PhixFlow you can share the same resources, such as data connectors and styles, with multiple applications by adding them to a package and then adding the package to different applications. A package can contain anything in an application.

To associate a package to an application:

  1. Open the Application's  Properties
    1. Click the Home button from the header menu and then click the properties button.
  2. Scroll down to the  Packages section in the properties.
  3. Click the  Packages button to open the available packages list.
    1. Tip: If the available packages list opens over the top of the application properties, drag the tab header to the left so that both open tabs can be seen next to each other.
  4. Drag the required package into the packages area for your application and   Apply your changes.

Application Properties

To access the application properties, click the  Properties button on the application home page. 

The default properties used by your application are based on the template package you selected when you created it. You can see the default properties or set them in the Application PropertiesThese include:

  1. Grid Styling for headers, fonts and row sizes applied to grids by default.
    1. Set in the  Styles tab.
  2. Default Components, such as the Form Fields template used when creating input forms.
    1. Set in the  Styles tab.
  3. Formats for numbers and dates, including the number of decimal places.
    1. Set in the  Properties tab.
  4. The Application Icon used in the application list to identify your application.
    1. Set in the  Properties tab.

If a default style or number/date format is not set in the application properties, PhixFlow uses defaults set in System Configuration. If the latter is not set, PhixFlow will prompt you to set them.

For more detail on this topic see Editing Application Properties.

Startup Actions

Startup actions are Actionflows which run when your application initially opens. They can be used to open the default navigation menu and a specific screen, such as a landing page. See Designing Screens and Startup Actions.

Server Properties

The instance of PhixFlow can be labelled and a colour set. This is useful when you have multiple environments such as Development, UAT and Production.

  • Server Properties
    • From the header menu, click  Administration → System → Configuration.
    • Click on the  Properties tab.
  • Set the Label
    • Set a value in PhixFlow Instance. This will appear in the banner at the top of PhixFlow. For Example, Testing.
  • Banner Colour
    • Choose a colour by clicking the coloured box next to this field. You can pick a specific using the colour picker and set this as the banner colour.

Security

There are two elements of security:

  • Controlling who can access an application.
  • Controlling their privileges within an application.

To find out more on this topic see, 21. Security and Access.

What's Next?

The PhixFlow Fundamentals course provides a practical guide to using PhixFlow, including setting up the application properties. 

Already started PhixFlow Fundamentals?

Return to Application Fundamentals

Further Reading