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 37 Next »

todo-Anthony

  • outstanding comments
  • this still describes the ideal GUI. It needs to be revised to match the final implementation of feature

This page is for application designers who want to create new application project. It explains how to create an application.

Overview

You create a new application project from the PhixFlow Welcome window.

 I would separate the additional tasks. Also do we create application projects or just applications? I used "project" here because we talk about creating applications as being all the stuff you do to create a functional app for users. This particular task is setting up all the config around the application. Options: Setting up an Application or, with your noun-first approach, Application Setup.

From the Welcome window, you can also:

  • switch between card and list views using the buttons on the right: see List Views the details on this list page do not really add any value, can we create an example?
  • select an existing application from the list.

PhixFlow's Welcome Window
PhixFlow's Welcome Window

How to Create a New Application

Click on the Create New button and When you create an application project, PhixFlow guides you through the process in 3 steps. This has now changed to a single step! Please review, most of this is still true with a few minor alterations. Note we have changed the way this works and we now include the creation of user groups and a change to the access permissions. See the creating applications flow in Adobe (Flow 2.5)

Step 1  Name your application

On the left of the Welcome window, click  Create New. PhixFlow prompts you to enter the following information for the application.

  • Name 
  • a development Version number, for example 1.
  • a Description. Consider including the purpose of the application and who is responsible for it.

Click Next.

At this point, PhixFlow creates all the items for your application.

This includes a menu, which you can find in the repository → Menus branch → application_name_Menu. You do not need to use this menu. However, when you add options to it, the menu is displayed on the right of the menu bar at the top of the PhixFlow window; see Menu.

Step 2  Choose an icon

PhixFlow needs an icon to display in the application list. To keep the default application icon, click Next. You can change the icon later; see Application properties.

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.

To change your application icon:

  • either expand the Image list to select an icon that has already been uploaded to PhixFlow
  • or click Add Image upload a new icon.
    In the file window, find and select the image file you want to use as an icon.
    PhixFlow uploads the file and sets it to be your application icon.
    For information about recommended image size, see the Application Icon property.

PhixFlow shows the file name in the Image Name field and displays the icon in Icon Preview.

Click Next

Step 3  Select a theme

PhixFlow comes with several design themes. The theme sets defaults styles for grids in your application. You can adapt and change your theme or it's defaults in the Application properties. For more information about themes and component palettes, see Understanding Palettes and Themes.

Use the arrows to scroll through the different themes until you find the one you like. 

When the theme you like is displayed, click Create.

PhixFlow sets the properties for the themes and styles, then opens the Application Home widow, which is described in Screen Design

More on Themes - We need to rewrite this section.

Themes are now called Templates and they come in the form of a Package that is set to template. See flow: 5.13.2 Marking a Package as a Template 

In PhixFlow, you can bundle items together into a package. Bundle? This makes it easy to share items across different applications.

A theme is a package . It has all the different palettes, components and styles that your application may need. When you select a theme for your application, PhixFlow adds the Theme package to it. You can see the theme package contents in the repository Packages folder

See also

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 ConfigurationFor 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