PhixFlow Help

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

This page is for application designers who want see how to quickly put together a simple application using Theme 2. For more detailed instructions for creating application see PhixFlow Training - Building Applications.

Before You Start

To follow the steps in the video, you will need some resources. Download media.zip and extract the files.

It also helps to understand the levels of structure in typical GUI screen, as shown in the following picture.

You can download and print this image: PDF Quick Reference Sheet.
The way a GUI screen is made up of levels of content is reflected in the PhixFlow repository. When you are working on a dashboard, right-click on any layout component and click Find in Repository. You can see where the item is within the levels of the dashboard structure.

Part 1: Create a Simple Application 

Error rendering macro 'multimedia' : com.atlassian.renderer.v2.macro.MacroException: Cannot find attachment 'Building an App part 1.mp4'
 

Step 1.  Create an application

  1. In the repository right-click Application and select  Add
  2. Set the Name to Demo Application and save.

Step 2.  Connect to business data

  1. In the repository, right-click Analysis Model and select  Add.  Set the Name to ETL.
  2. In the model window, drag in a  File Collector. Browse to the Businesses Excel spreadsheet (available from media.zip) and upload. PhixFlow automatically creates a stream linked to the file collector. Click the stream icon to open its properties.
  3. In the stream properties, set:
    • Period: Transactional
    • Audit Manual Changes: tick
    • Description to be bigstring.
    • Name to Business Data.
  4. Save the stream properties.
  5. Pin the stream tab so it stays visible.
  6. Run the stream to import the business data
  7. Save the model and check the default stream view contains data.

Step 3.  Create a dashboard. With two areas, one above the other.

  1. In the dashboard properties set
    • Name: Business Data
    • Open Maximised: tick
    • Allow User to Resize: tick
    • Show Windows Button Bar: Tick
  2. Open the Theme 2 - App Builder palette. Drag Form Complete into the empty dashboard on the left. Enter its name.
  3. Drag the palette tab so that it is next to the repository tab. 
  4. In the repository Layouts, you can see the structure of the Business Data Form. 
  5. In the palette, select Tile Blank and Shift+drag it onto Tile Container in the repository. Enter the name Grid.
  6. In the repository, drag Grid to be first in the Tile Container. This automatically moves the tile in the dashboard from the right to the left.
  7. To set the direction of flow within the tile, open the properties for Tile Container and change Direction to Column. In the dashboard, the tiles automatically move so that one is above the other.

Step 4. Add a menu that you can use to open the dashboard.

  1. In the dashboard, click on the header area to open the dashboard properties tab.
  2. Drag the dashboard icon from the top left of the tab onto the menu bar at the top of the PhixFlow screen. 

Step 5.  Display data in a grid.

  1. Switch to the pinned stream properties tab.
  2. Drag the stream icon from the top left of the teb onto the top tile in the dashboard.
  3. PhixFlow prompts you to select how to display the data. Select the grid option.
  4. PhixFlow opens a list of attributes. Select all the attributes and drag them onto the grey header bar in the tile.
  5. PhixFlow display the data from the stream in the grid.

Step 6.  Configure the lower tile.

  1. In the lower tile, right-click Static Text and select Delete.
  2. Click on Dynamic Text to open its properties tab. Change its Name from Header 2 Dynamic to Name. This now matches one of the attributes in the stream. PhixFlow will recognise that it needs to change the header text to match the selected records Name value.
  3. From the palette drag the Field Collection (Fixed Width) component into the tile and enter a name for it.
  4. From the palette drag the Field Collection (Autosize) component into the tile and enter a name for it.
  5. Switch to the pinned stream tab and Shift+drag  the UID to Active attributes onto the left (fixed width) area.
  6. PhixFlow prompts you to confirm that Business Data should be the form's backing stream. Click Yes.
  7. From the stream tab, Shift+Drag Description onto the autosize area.
  8. To delete the UID attribute, in the dashboard lower tile, right-click UID and select Delete. and confirm.

Step 7.  Change the sizing.

  1. Select the tile body, right-click and select Find in Explorer.
  2. Click Tile Body to open its properties.
  3. Clear the Auto Size check box and save the properties.
  4. PhixFlow expands the box so that all attributes are visible without needing to scroll.
  5. In the dashboard, select the tile and open its properties.
  6. Set Position Settings → Height to 390

Step 8. Hide the borders to the Field Collection areas.

  1. In the repository find Column 1
  2. In the CSS Properties, delete the border property.
  3. Repeat for Column 2.

Step 9. Set up a background filter so that the data displayed in the lower tile reflects the selected record in the upper tile.

  1. In the dashboard's upper tile, in the grey header bar, drag UID onto the dashboard background.
  2. PhixFlow opens a filter properties tab showing the condition UID equals BusinessData.UID
  3. Save the  filter.

Step 10.  Set the header for the dashboard and globally replace the icon.

  1. Click Static Text to open its properties. 
  2. In the properties, set Display Text to Business Data Manager
  3. Save the properties.
  4. Right-click Dynamic Text and select Delete.
  5. Click the PhixFlow icon to open its properties.
  6. In Shared Styles, click T2 - Icon Default to open its properties.
  7. In the default icon properties → Basic Settings → Background Image, click  Add to open a new image properties tab.
  8. In the image properties, set the Name to NewLogo
  9. Click Browse and navigate to the files extracted from media.zip. Select MyLogoTeal.png.
  10. Save the image properties.
  11. Save the default icon properties. The shared style will now display the MyLogoTeal.png image wherever Theme 2 specifies the default icon.

Step 11.  Change a single image

  1. In the dashboard lower tile, click the icon in the header to open its properties.
  2. In the properties Style Settings → Background Image, click  Add to open a new image properties tab.
  3. In the image properties, set the Name to BusinessIcon.
  4. Click Browse and navigate to the files extracted from media.zip. Select business48dp.png.
  5. Save the image properties.
  6. Save the default icon properties. The icon in the header changes to the selected one.

Step 12.  Use the dashboard to add new data.

  1. Right-click the dashboard and select Lock Dashboard or switch to  App Mode
  2. In the Dashboard, click the New button to clear all the data fields.
  3. Enter your own data into the fields in the lower tile.
  4. The upper tile now only shows the data you have added.

Step 13.  Fix up the way data is displayed in the view.

  1. Unlock the dashboard (or switch back to   Design Mode).
  2. Right-click the dashboard and click Show View Configuration.
  3. In the stream view properties tab → Advanced → Periods clear the box and save the properties.
  4. In Basic Settings → Default Sort Order click  Add.
  5. In the new sort order properties set Name: By Name and Save
  6. In the sort order properties → Sort Order Attributes click  Show Attributes.
  7. In the popup list of attributes, select Name and drag it into the list.
  8. Save the sort order properties.
  9. Save the stream view properties.
  10. Close the popup list of attributes
  11. In the stream view properties tab:
    •  Advanced → Autosave: tick. PhixFlow automatically saves any changes to the view.
    •  View Attributes, click Name to open its properties tab and in Grid Settings → Read Only: untick and save. This means users can change the Name field for records when using the application in  App Mode.
    • View Attributes, click AnnualTurnOver to open its properties tab and in Basic Settings → Number Format, select Sterling and save.
  12. In the dashboard upper tile, click the Customer Since header. (This is another way to open the properties tab for an attribute.) In Basic Settings → Date Time Format, select  a different format, for example Date(MMM-YYYY). Save the changes.
  13. In the dashboard upper tile, drag column dividers to resize columns.


Part 2: Adding Comments and Maps

Error rendering macro 'multimedia' : com.atlassian.renderer.v2.macro.MacroException: Cannot find attachment 'Building an App Part 2.mp4'


Step 1.  Add placeholders for new content.

  1. From the Theme 2 - App Builder palette, drag into the Tile Container in the repository:
    • Tile Blank and enter the name Comment
    • Tile Map and enter the name Map.
  2. PhixFlow displays the two new tiles in the dashboard. The map tile shows a request rejected message.

Step 2. Set up the Comments area.

  1. In the repository, right-click the Analysis Model ETL and click Display.
  2. In the model window, add a new stream. In the stream properties tab, set Basic Settings:
    • Name: Comments
    • Period: Transactional
    • Audit Manual Changes: tick
    • Save your changes.
  3. In the Attributes section, click  Add to open a new attribute properties tab. Set:
    • Name: Comment
    • Type: Bigstring
    • Save your changes.
  4. In the Attributes section, click  Add to open another new attribute properties tab. Set:
    • Name: BusinessUID
    • Type: Integer
    • Save your changes.
      The Attributes section should now list the attributes you created, Commend and BusinessUID, plus those added automatically when you ticked Audit Manual Changes (UID and the "Update" attributes).
  5. Remember to save the analysis model as well as the changes to properties.
  6. To reopen your dashboard, click on the Business Data menu option on the top  right of the PhixFlow window. (Added in Part 1 step 4.2).
  7. Right-click the dashboard and select Unlock the Layout.
  8. From the palette, Shift+drag CommentsComplete into the top comments area.
  9. Click into the body of the comments section (which is a card) to open its card component properties.
  10. Drag the properties to the same tab column as the palette, so it stays visible.
  11. In the model window, bring the model to the front and click the Comments stream to open its properties.
  12. Drag the stream icon from the properties tab onto the stream name in the card component tab and save the changes.
  13. Minimise the model window so that the workspace shows the dashboard again.
  14. In the dashboard, from the Business Data grid, drag the UID header onto the body of the comments. This sets the background filter for the card.
  15. In the filter properties tab, change the Filter Details to use the BusinessUID instead of UID and save your changes.

Step 3.  Add an editor where users can enter and format comment text.

  1. In the repository, right-click Dashboard and click  Add.
  2. In the new dashboard properties tab, set
    • Name: CommentEditor
    • Allow User to Resize: untick
    • Show Window Button Bar: untick
    • Always On Top: tick
    • Save the changes.
  3. PhixFlow opens the new empty dashboard, which will be the Comments editor.
  4. From the palette, drag Form Popout - Complete into the new dashboard and enter its name; CommentsEditor
  5. Switch to the model and click the Comments stream to open its properties. Pin the tab.
  6. To reopen the dashboard, in the repository → Dashboards , right-click CommentEditor and select Display.
  7. In the Comments dashboard, right-click and select Unlock the Layout
  8. From the pinned Comments tab → Attributes section, drag the Comment attribute into the Comments dashboard.

Step 4. Set the comments editor header

  1. In the Comments dashboard header, click Static Text and enter Comment for.
  2. Click the Dynamic Text to open its properties tab and set Name to BusinessName. This will connect to a context parameter - to be set later.

Step 5.  Link the Comments area to the Comments Editor dashboard.

  1. Ensure the Business Data Manager dashboard is visible and unlocked.
  2. In the repository → Dashboards, drag CommentEditor onto the + button, which is in the top right of the comments box.
  3. To test this works, lock the dashboard and click the + button. PhixFlow opens the Comment editor. Close the Comment Editor again and unlock the layout.
  4. To create context parameters that connect the Comment area to the selected record
    1. drag the UID header from the Business Data grid onto the Comments + button.  PhixFlow automatically opens a context parameter properties tab. Change the name to BusinessUID and save the properties.
    2. drag the Name header from the Business Data grid onto the Comments + button. PhixFlow automatically opens a context parameter properties tab. Change the name  to BusinessUID and save the properties.

      The context parameters must have the same name as the Dynamic Text field on the dashboard in order to link them

  5. To test your changes, lock the dashboard and click the + button. PhixFlow opens the Comment editor. The dynamic text part of the header should now include the business name for the selected record.
  6. To see what context parameters are being used, right-click the Comments Editor dashboard and select Show Context Parameters.

Set up something for the UID


  1.  
    1. drag the UID header from the Business Data grid onto the Comments + button.  PhixFlow automatically opens a context parameter properties tab. Change the name to BusinessUID and save the properties.
    2. drag the Name header from the Business Data grid onto the Comments + button. PhixFlow automatically opens a context parameter properties tab. Change the name  to BusinessUID and save the properties.

The context parameters must have the same name as the Dynamic Text field on the dashboard in order to link them.





  1. Set the Tile Container to row.
  2. Set widths:

Set Business Data grow factor to 8.

Set width of Tile to 100%

Create Comments stream

Add stream to Comments Card

Create a comment editor dashboard

Create an Add action

To open the dashboard

Set the UID

Set the Business UID

Set the Business Name

Create an Update action

To open the dashboard

Set the UID

Set the Business UID

Set the Business Name


  • No labels