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

...

For details of the calculate node, see Calculate Action Nodes

Adding Action Nodes

Connection Points

To add action nodes to the actionflow, drag the icons from the toolbar to the canvas. Everything in an actionflow is connection using connection points. They are blue when connected and grey when not connected. Find all the possible connection points below.

Icon

Connection PointRelevant toDescription

Image Added

Interface Driving Connection Point

Input Interface

Output Interface

  • Defines the data attributes the actionflow is expecting as an input. This data is then used in the Actionflow using
    Insert excerpt
    _driving_connection
    _driving_connection
    nopaneltrue
    s
     and remains constant.
  • Defines the data attributes the actionflow is expected to output. This data can then be mapped back onto components on the screen the action is being used.
  • Each instance of the actionflow will map in its own set of data onto the expected data inputs/outputs of the connection point.

Image Added

Interface Request Connection Point

Input Interface

Output Interface

  • Defines the data (and events) the actionflow is expecting as an requested input. This data is then used in the actionflow using
    Insert excerpt
    _request_connection
    _request_connection
    nopaneltrue
    s and remains constant.
  • Each instance of the actionflow will map in its own set of data onto the expected data inputs.
Image Added
Driving Output Connection Point

Input Data Components

Insert excerpt
_action_calculate
_action_calculate
nopaneltrue

Insert excerpt
_action_view_driving
_action_view_driving
nopaneltrue

Insert excerpt
_action_gateway
_action_gateway
nopaneltrue

Insert excerpt
_actionflow
_actionflow
nopaneltrue

  • A data source which drives the actionflow. Data is pushed through the actionflow using 
    Insert excerpt
    _driving_connection
    _driving_connection
    nopaneltrue
    's.
  • Data flows from the
    Insert excerpt
    _driving_output_connection_point
    _driving_output_connection_point
    nopaneltrue
     to the
    Insert excerpt
    _driving_input_connection_point
    _driving_input_connection_point
    nopaneltrue
    .
  • Has attributes which can be mapped to any 
    Insert excerpt
    _driving_input_connection_point
    _driving_input_connection_point
    nopaneltrue
     only.

Image Added

Driving Input Connection Point

Output Data Components

Insert excerpt
_action_calculate
_action_calculate
nopaneltrue

Insert excerpt
_action_view_driving
_action_view_driving
nopaneltrue

Insert excerpt
_action_gateway
_action_gateway
nopaneltrue

Insert excerpt
_action_save
_action_save
nopaneltrue

Insert excerpt
_action_screen
_action_screen
nopaneltrue

Insert excerpt
_action_url
_action_url
nopaneltrue

Insert excerpt
_action_analysis
_action_analysis
nopaneltrue

Insert excerpt
_action_gateway
_action_gateway
nopaneltrue

  • A data receiver. Data is received from 
    Insert excerpt
    _driving_connection
    _driving_connection
    nopaneltrue
    's.
  • Has attributes which can be mapped to any
    Insert excerpt
    _driving_output_connection_point
    _driving_output_connection_point
    nopaneltrue
     only.
Image AddedRequest Output Connection Point

Input Data Components

Insert excerpt
_action_view_request
_action_view_request
nopaneltrue

  • Provides lookup data to the actionflow using 
    Insert excerpt
    _request_connection
    _request_connection
    nopaneltrue
    's.
  • Any node with a 
    Insert excerpt
    _request_input_connection_point
    _request_input_connection_point
    nopaneltrue
     can perform a lookup to a node with a 
    Insert excerpt
    _request_output_connection_point
    _request_output_connection_point
    nopaneltrue
    .
  • Has request attributes and data attributes
    • Request attributes are used in filtering. They are mapped to request attributes on the node performing the lookup. Request attributes are referenced in the nodes filter using
      req.[attributename]
      Data is flowing from the 
      Insert excerpt
      _request_input_connection_point
      _request_input_connection_point
      nopaneltrue
       to the 
      Insert excerpt
      _request_output_connection_point
      _request_output_connection_point
      nopaneltrue
      .
    • Data attributes are mapped to data attributes on the node performing the lookup. These attributes are the actual data that is being returned from the lookup.
      Data is flowing from the 
      Insert excerpt
      _request_output_connection_point
      _request_output_connection_point
      nopaneltrue
       to 
      Insert excerpt
      _request_input_connection_point
      _request_input_connection_point
      nopaneltrue
Image AddedRequest Input Connection Point

Insert excerpt
_action_calculate
_action_calculate
nopaneltrue

Insert excerpt
_action_gateway
_action_gateway
nopaneltrue

  • Performs a lookup to 
    Insert excerpt
    _request_output_connection_point
    _request_output_connection_point
    nopaneltrue
    's.
  • Has request attributes and data attributes
    • Request attributes are used in filtering. They are mapped to request attributes on the node being looked up to. Attributes that need to be sent to the node in order to filter the data must be added as request attributes.
      Data is flowing from the 
      Insert excerpt
      _request_input_connection_point
      _request_input_connection_point
      nopaneltrue
       to the 
      Insert excerpt
      _request_output_connection_point
      _request_output_connection_point
      nopaneltrue
      .
    • Data attributes are mapped to data attributes on the node being looked up to. These attributes are the actual data that is being received from the lookup.
      Data is flowing from the 
      Insert excerpt
      _request_output_connection_point
      _request_output_connection_point
      nopaneltrue
       to 
      Insert excerpt
      _request_input_connection_point
      _request_input_connection_point
      nopaneltrue

Action Nodes

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

Image Added 

Actions can be added to actionflows in 3 ways:

  1. Drag actions from the create section in the toolbar

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

  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.
      Image Added
    • Insert excerpt
      _table_list
      _table_list
      nopaneltrue

      Will ask the user if they would like to create a 
      Insert excerpt
      _action_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 PointsHow to wire this action
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_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_point
nopaneltrue

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

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

Insert excerpt
_driving_input_connection_point
_driving_input_connection_point
nopaneltrue

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 Added 

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
  • Open Mode
  • Role
  • Attributes

Configure the purpose for the screen that will open

  • update: opens form fields with the latest data (tnot clear, refresh)
  • insert: opens the screen with form fields empty clear, not refresh)
  • change: opens form fields with data (not clear, not refresh)

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

Dashboard nodes can have driving connection points to each element on a dashboard.

Insert excerpt
_action_view_driving
_action_view_driving
nopaneltrue


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


Connect a view node to the action node that needs to look-up data via the lookup connection Image Added  icon page. A look-up connection has 2 parameters:

  • 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.

Insert excerpt
_action_calculate
_action_calculate
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.



Insert excerpt
_action_delete
_action_delete
nopaneltrue

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



Insert excerpt
_action_gateway
_action_gateway
nopaneltrue

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



Insert excerpt
_save
_save
nopaneltrue

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



Taptbc

Task tbc

List
Insert excerpt
_actionflow
_actionflow
nopaneltrue
List actionflows available to your application.

Insert excerpt
_screen
_screen
nopaneltrue
List dashboards available to your application.


HTML Comment
hiddentrue

The following icons are for post 9.0 action nodes

IconDescriptionHow to wire this action
Insert excerpt
_action_url
_action_url
nopaneltrue

Add an action to open a specified URL.


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
_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.





Properties

Insert excerpt
_parent
_parent
nopaneltrue

...

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

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

...

Calculate actions process data using expressions; see pages in the topic Expressions and Scripts.

This section has a toolbar with standard buttonsThe grid contains a list of the expressions that the calculate action will perform. To add a new expression:

...