Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

This page is for application designers who want to create actionflows to add functionality to an application screen. For actionflow concepts, see Understanding Actionflows.

On a screen, any component that has an 

Insert excerpt
_actionflow
_actionflow
nopaneltrue
 tab can be configured to trigger an actionflow to run. 

To create an actionflow:

  1. On a screen, click a component to display its properties. Components that can have actionflows are:
    • buttons
    • grid views
    • card/containers
    • areas
    • form fields.
  2. There are 3 ways to add actionflows. In the component properties →
    Insert excerpt
    _actionflow
    _actionflow
    nopaneltrue
     Settings:
    • Adding via an event handler
      • click 
        Insert excerpt
        _add
        _add
        nopaneltrue
      • Event Type select an event type
      • Action Method select Actionflow
      • Insert excerpt
        _save
        _save
        nopaneltrue
      • Actionflow, click 
        Insert excerpt
        _add
        _add
        nopaneltrue

    • Adding via an action directly
      • Action Method select Actionflow
      • Actionflow, click 
        Insert excerpt
        _add
        _add
        nopaneltrue
        .
    • Quick add for buttons
      • Right click on a button and select Add actionflow
        Adding an actionflow by right-click on a button
  3. PhixFlow opens the actionflow canvas.
  4. Drag actions from the toolbar onto the central canvas 
  5. Wire the actionflow and connect
    • instance inputs
    • action nodes
    • instance outputs (optional)

For more detail on actionflow nodes and wiring, see Using Actionflow Nodes and Wiring Actionflows.



HTML Comment
hiddentrue

Options to create an actionflow not available in 9.0

To create an actionflow:

  • with a button as the input connection, in a screen, right-click on any button (anything else?) on a dashboard screen and select Add Actionflow.
  • initially unconnected to a component, in the repository browser expand Actionflows and click 
    Insert excerpt
    _add
    _add
    nopaneltrue
    . You can wire the action to a button (or something else) - add relevant link.
HTML Comment
hiddentrue

Wiring Actions

Wire each node from the output to the input connection points

Mapping Connection Points

Input Connection (available data or user action) map onto the Connection Point in order to pass data to the Actionflow.

  • Drag the Input Connection's "Output Connector" Image Removed onto the required Connection Point.
  • The mapping window opens.
  • Drag the attributes from the Input Connection (Left) onto the Connection Point (Right)Ensure the type of data is the same i.e. we cannot map a text field onto a date field as they are not compatible
    • .
  • Create Target Attributes (Optional): drag an attribute on the left to the white space on the right, this will automatically create an attribute of the same name and type.
  • Confirm the mapping. Now the "Output Connector" will be blue to indicate it has been mapped Image Removed.
  • Repeat these steps for any additional mappings required.
  • Image Removed

    Building an Actionflow Not sure if we just add the mapping into here?

    Data flows through the Actionflow sequentially one stream-item at a time. When a lookup is performed the entire data set is read and processed. 

    1. Connect Inputs to Input Connection Points
      1. Create new Input Connection Points
        1. Click 
          Insert excerpt
          _add
          _add
          nopaneltrue
        2. Provide a name for the connection point.
        3. Select driving or lookup. 
        4. Click Create Connection Point
        5. Select input
        6. Click Connect Input.
        7. Map attributes - see Mapping section below.
      2. Connect inputs to existing Input Connection Points


        1. Click Connect
        2. Select input
        3. Click Connect Input.
        4. Map attributes - see Mapping section below.
    2. Add Action Nodes
      1. Click and hold on the desired Action Node, now drag this onto the canvas area.

      2. Click and hold on the Input Connection, when release a set of action nodes is displayed, select the desired option.
        1. This process also works from existing Action Nodes.

    3.  Connecting
      1. From
        Insert excerpt
        _driving_interface_connection_point
        _driving_interface_connection_point
        nopaneltrue
        : Click and hold on the input Connection, move the mouse over the desired node and select the 
        Insert excerpt
        _driving_input_connection_point
        _driving_input_connection_point
        nopaneltrue
        .

        1. You will only be prompted to select an input connection if there is more than one input connection point e.g. a dashboard or the connection point is already connected.
      2. Action Nodes: Hover the mouse over the action node and select the correct 
        Insert excerpt
        _driving_output_connection_point
        _driving_output_connection_point
        nopaneltrue
         . Move the mouse over the desired action node and select the
        Insert excerpt
        _driving_input_connection_point
        _driving_input_connection_point
        nopaneltrue
        .
    4. Mapping, once a connection is made a mapping screen will open automatically. As described above click and drag the attributes on the left to create a mapping:
      1. On to an attribute on the right.
      2. Into the blank space to create an attribute and mapping automatically. 
    5. Configuring the nodes as described in the nodes section above.
    6. Repeat the above steps to create you desired configuration.

    Running an Actionflow

    Actionflows run from being:

    1. attached to an event such as a Button, a Double Click event on a grid item or any event attached to an item.  link to events
    2. ran directly from the repository - cannot do this yet.
    3. ran as an Action Task on a Task plan




    What's next?

    Wiring Inputs Into an Actionflow

    Using Actionflow Nodes

    Wiring Actionflows.

    Insert excerpt
    _terms_changing
    _terms_changing
    nopaneltrue