Versions Compared

Key

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

This page is for application designers who want to define a process using a workflow diagram, and then connect elements of the diagram to PhixFlow dashboards and actions in an application. This page describes properties

Overview

An actionflow diagram is made up of a This page is for application designers who want to define a process using a workflow diagram, and then connect elements of the diagram to PhixFlow dashboards and actions in an application. This page describes properties

Overview

An actionflow diagram is made up of a series of nodes. Each node represents a specific action. By configuring different actions and wiring them together you can create complex functionality. This section describes the properties of the different action nodes. This page has the properties for introduces the following nodes and how to connect them:

...

Child pages (Children Display)

...

  • Request Query Lookup
  • Driving Query Lookup

For details of the calculate node, see Calculate Action Nodes

Adding Action Nodes

Connection Points

Adding Action Nodes

Connection Points

Everything in an actionflow is connected using connection points. They are blue when connected and grey when not connected. Find all the possible connection points below.

...

The toolbar includes the following actions action nodes that you can drag onto the actionflow canvas.

 

Actions can be added to actionflows in 3 ways:

...

Add a node for a data view. The actionflow uses views to grab additional data to use when processing stream-items.

...

  1. Drag actions from the create section in the toolbar


  2. From existing action nodes
    Users can create new actions from connections from existing actions.


  3. Dragging the following items from the repository using
    • Insert excerpt
      _screen_list
      _screen_list
      nopaneltrue

      Will create an 
      Insert excerpt
      _action_screen
      _action_screen
      nopaneltrue
       node.

    • Insert excerpt
      _table_list
      _table_list
      nopaneltrue

      Will ask the user if they would like to create a nopanel
      Insert excerpt
      _action_save_action_savetrue
       node, 
      Insert excerpt
      _action_view_driving_action_view_driving
      nopaneltrue
       node or  Insert excerpt_action_view_request_action_view_requestnopaneltrue node.
      Image Removed
      Insert excerpt_actionflow_list_actionflow_listnopaneltrueWill create an  Insert excerpt_actionflow_actionflownopaneltrue node. Doesn't do this yet

...

Add another complete actionflow as a node within this actionflow.  This is useful to reuse existing actionflows, or to refactor a complex workflow by moving part of the logic to its own node.

...

The input and output connection points of the actionflow node must be wired into the rest of the actionflow.

Need to test to add detail

...

Add an action to open a specified dashboard (screen). Only use this action as the final node in an actionflow or branch of it. 

...

Open screen nodes can be created with or without a screen attached. This is useful if the screen has not been created yet. Open screen nodes which do not have a screen attached appear with a warning symbol to remind users that this still needs to be configured.

Image Removed 

Each open screen node has 1 primary input connection point by default called 'in'. Connecting to this connection point simply opens the screen and cannot pass any data to it. Do we still need this?

Once a screen has been attached to the open dashboard node an input connection point for each form on the screen is created. Each input connection point automatically has any data fields on the form (dynamic text or form fields) added as attributes. These attributes can be mapped to and supplied with data.

Each input connection point has the following properties:

  • Type
    This is always driving
  • Open Mode
    update: opens form fields with the latest data (not clear, refresh)
    insert: opens the screen with form fields empty (clear, not refresh)
    change: opens form fields with data (not clear, not refresh)
  • Role
    Primary: Simply opens the dashboard regardless of data
    Component: Opens the dashboard and can provide forms with data
  • Attributes
    A list of attributes available on the input connection point. These directly link to the fields available on the form. Only component connection points have attributes.

To set the actionflow to close the active dashboard on completion, on the top right of the canvas, tick Close Parent Dashboard.
Image Removed

    • _save
      _action_save
      nopaneltrue
       node, 
      Insert excerpt
      _action_view_driving
      _action_view_driving
      nopaneltrue
       node or 
      Insert excerpt
      _action_view_request
      _action_view_request
      nopaneltrue
       node.


      Image Added

    • Insert excerpt
      _actionflow_list
      _actionflow_list
      nopaneltrue

      Will create an 
      Insert excerpt
      _actionflow
      _actionflow
      nopaneltrue
       node. Doesn't do this yet



...

IconDescriptionConnection Points
Create

Insert excerpt
_actionflow
_actionflow
nopaneltrue

Add another complete actionflow as a node within this actionflow.  This is useful to reuse existing actionflows, or to refactor a complex workflow by moving part of the logic to its own node.

Insert excerpt
_driving_

output

input_connection_point
_driving_

output

input_connection_point
nopaneltrue

Connect a view node to the action node that needs to look-up data via the 

Insert excerpt
_

request

driving_

input

output_connection_point
_

request

driving_

input

output_connection_point
nopanel

true. A look-up connection has 2 parameters:
  • data attribute: the attribute in the view from which you want to look-up data. For example, the view may have the attribute staff_number that you require.
  • request attribute: the data returned by the look-up. This maps to an input on the destination point.

    true

    Insert excerpt
    _request_input_connection_point
    _request_input_connection_point
    nopaneltrue

    Insert excerpt
    _
    action_view_request
    screen
    _
    action_view_request
    screen
    nopaneltrue

    Add an action to open a

    node for a data view. The actionflow uses views to look-up to additional data to use when processing stream-items.

    specified dashboard (screen). Only use this action as the final node in an actionflow or branch of it. 

    Insert excerpt
    _
    request
    driving_
    output
    input_connection_point
    _
    request
    driving_
    output
    input_connection_point
    nopaneltrue
    Insert excerpt
    _action_view_
    calculate
    driving
    _action_view_
    calculate
    driving
    nopaneltrue


    Add

    an action to manipulate the data that is passed to the calculate action. In the calculate action, write an expression using one or more of the 115+ functions available in PhixFlow

    a node for a data view. The actionflow uses views to grab additional data to use when processing stream-items.

    Insert excerpt
    _driving_input_connection_point
    _driving_input_connection_point
    nopaneltrue

    Insert excerpt
    _driving_output_connection_point
    _driving_output_connection_point
    nopaneltrue


    Insert excerpt
    _
    request_input_connection_point_request_input_connection_pointnopaneltrue Insert excerpt
    action_view_request
    _action_
    delete_action_delete
    view_request
    nopaneltrue
    Add
    an action to deletes the specified stream-items passed to the node
    a node for a data view. The actionflow uses views to look-up to additional data to use when processing stream-items.
    Insert excerpt
    _
    driving
    request_
    input
    output_connection_point
    _
    driving
    request_
    input
    output_connection_point
    nopaneltrue

    Insert excerpt
    _action_

    gateway

    calculate
    _action_

    gateway

    calculate
    nopaneltrue

    Add

    a node to specify decision logic. Gateways control the route that stream-items take as they flow through the actionflow

    an action to manipulate the data that is passed to the calculate action. In the calculate action, write an expression using one or more of the 115+ functions available in PhixFlow.

    Insert excerpt
    _driving_input_connection_point
    _driving_input_connection_point
    nopaneltrue

    Insert excerpt
    _driving_output_connection_point
    _driving_output_connection

    _pointnopaneltrue

    _point
    nopaneltrue

    Insert excerpt
    _request_input_connection_point
    _request_input_connection_point
    nopaneltrue

    Insert excerpt
    _action_delete
    _action_delete
    nopaneltrue

    Add an action to deletes the specified stream-items passed to the node.

    Insert excerpt
    _
    request
    driving_input_connection_point
    _
    request
    driving_input_connection_point
    nopaneltrue
    Insert excerpt
    _
    save
    action_gateway
    _action_
    save
    gateway
    nopaneltrue

    Add a node to

    saves the specified stream-items to their stream

    specify decision logic. Gateways control the route that stream-items take as they flow through the actionflow.

    Insert excerpt

    _driving_input_connection_point

    _driving_input_connection_point

    nopaneltrueexcerpt-include

    _

    action

    driving_

    url

    input_

    action

    connection_

    url

    point
    nopaneltrue

    Add an action to open a specified URL.

    Insert excerpt
    _driving_

    input

    output_connection_point
    _driving_

    input

    output_connection_point
    nopaneltrue

    Taptbc

    Insert excerpt
    _

    driving

    request_input_connection_point
    _

    driving

    request_input_connection_point
    nopaneltrue

    Insert excerpt
    _save
    _save
    nopaneltrue

    Add a node to saves the specified stream-items to their stream.

    Insert excerpt
    _driving_
    output
    input_connection_point
    _driving_
    output
    input_connection_point
    nopaneltrue
    Task tbc
    Insert excerpt
    _
    driving_input_connection_point
    action_url
    _
    driving_input_connection_point
    action_url
    nopaneltrue
    Add an action to open a specified URL.
    Insert excerpt
    _driving_
    output
    input_connection_point
    _driving_
    output
    input_connection_point
    nopaneltrueList Insert excerpt_actionflow_actionflow
    nopaneltrue
    List actionflows available to your application.
    Insert excerpt
    _action_
    screen
    analysis
    _action_
    screen
    analysis
    nopaneltrue
    List dashboards available to your application
    Add tables to run analysis.

    Insert excerpt
    _driving_input_

    table

    connection_

    list

    point
    _driving_

    table

    input_connection_

    list

    point
    nopaneltrue

    List tables available to your application.

    ...

    hiddentrue

    The following icons are for post 9.0 action nodes

    Insert excerpt
    _driving_output_connection_point
    _driving_output_connection_point
    nopaneltrue

    Taptbc

    Insert excerpt
    _

    ...

    driving_input_connection_point
    _driving_input_connection_point
    nopaneltrue

    Insert excerpt
    _driving_output_

    ...

    connection_

    ...

    point
    _driving_

    ...

    output_connection_

    ...

    point
    nopaneltrue

    ...

    For more detail of each actionflow node, see below.

    HTML Comment
    hiddentrue

    The following icons are for post 9.0 action nodes

    writewrite a node to write data what does this do.
    IconDescriptionHow to wire this action

    Insert excerpt
    _action_

    file
    _action_

    file
    nopaneltrue

    Add

    ...

    an action to use a file in a specified location in the PhixFlow database. check restrictions on location


    Insert excerpt
    _

    ...

    Basic Settings

    Todo-Fiona - How do you specify the different types of gateway

    ...

    action_email
    _action_email
    nopaneltrue
    Add a node to generate an email.
    Insert excerpt
    _

    ...

    action_

    ...

    write
    _

    ...

    action_

    ...

    write
    nopaneltrue

    ...

    Add a node to write data what does this do.



    HTML Comment
    hiddentrue

    Properties

    Insert excerpt
    _

    ...

    parent
    _

    ...

    parent
    nopaneltrue

    Basic Settings

    Todo-

    ...

    Available for save actions. Select the specific change to make to the stream-items:

    ...

    Fiona - How do you specify the different types of gateway

    FieldDescription
    NameEnter the name for the action node.
    Show in the Explorer

    An application can have many actionflows, and an individual actionflow can have many actions. This can lead to many items being listed in the repository. Use this option to omit the action from the repository.

    Insert excerpt
    _check_box_tick
    _check_box_tick
    nopaneltrue
     to display this action node in the repository.

    Insert excerpt
    _check_

    ...

    box_

    ...

    untick
    _check_

    ...

    box_

    ...

    untick
    nopaneltrue

    ...

    Available for gateway actions. 

    ...

     to omit this action node from the repository.

    Stream Item Action

    Todo-Fiona- find out if this can be renamed to something else unless it really relates to existing stream item actions.

    Available for save actions. Select the specific change to make to the stream-items:

    • Either: Todo-Fiona
    • Insert: create a new stream-item in the stream.
    • Update: change part of the stream-item in the stream.
    • Delete: delete the stream-item from the stream. Todo-Fiona- check about delete node, Adam think sit may be going away.

    Insert excerpt
    _

    ...

    terms_

    ...

    changing
    _

    ...

    terms_

    ...

    changing
    nopaneltrue

    ...

    Input Connection Points

    This section has a toolbar with standard buttonsThe grid contains a list of the wires that pass data into the action. 

    To edit an existing connection, double-click its name in the list.

    To add a new 

    ...

    Stream NameSelect the stream Todo-Fiona why isn't this identified by the parent of the attribute/stream-item?
    Exclusive

    Available for gateway actions. 

    Insert excerpt
    _check_box_

    ...

    tick
    _check_

    ...

    box_tick
    nopaneltrue

    ...

     Todo-Fiona

    ...

    ...

    Insert excerpt
    _check_

    ...

    box_

    ...

    untick
    _check_

    ...

    box_

    ...

    untick
    nopaneltrue

    Calculate Action Expressions

    ...

     Todo-Fiona


    Input Connection Points

    This section has a toolbar with standard buttonsThe grid contains a list of the

    ...

    wires that pass data into the

    ...

    action. 

    To edit an existing connection, double-click its name in the list.

    To add a new 

    create a new attribute: click 

    Insert excerpt
    _add
    _add
    nopaneltrue
     and set its properties. Todo-Fiona- why would this be useful

    Drag add an existing attribute to this list Todo-Fiona- is this possible??

    To remove attributes, select one and click 

    Insert excerpt
    _delete_

    ...

    item
    _delete_

    ...

    To remove attributes, select one and click Image Removed Permanently Delete. Todo-Fiona- check icon and label.

    item
    nopaneltrue

    ...


    Output Connection Points

    Todo-Fiona

    Insert excerpt
    _access
    _access
    nopaneltrue

    Access Permissions section is available for gateway actions.

    Insert excerpt
    _description
    _description
    nopaneltrue

    Insert excerpt
    _audit
    _audit
    nopaneltrue


    Pop-up Toolbar

    Todo-Fiona

    • Under what circumstances does the pop-up toolbar appear
    • screenshot
    OptionDescription







    Pop-up Menu

    OptionDescription
    Permanantly Delete with a Cross not a bin
    Show Action Instance Details → Show properties



    What's next?

    Child pages (Children Display)
    styleh3