Versions Compared

Key

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

Insert excerpt
_Banners
_Banners
nameactionflow
nopaneltrue

Overview

To reuse An action(s), within an Actionflow, the action nodes within it can be extracted.

In order to make actions re-usable (this will be important when we have API actions for example) we will need to wrap them in an action flow and then re-use the flow. To make this easier we need a wizard to take an action (or group of actions) on a model and quickly convert them to a nested action flow.

Image Removed

This wizard would have to:       

  •  automatically create the action flow 

  • move all the actions into the action flow (preferably laid out as they are in the original model)

  • create all of the necessary input and output connection points and connection point attributes on the action flow to correspond to the connection points on the actions within it

  • Wire up the action flow connection points to the internal actions and map the attributes

  • Connect anything that was on the original diagram that connected to a moved action to the appropriate connection point of the action flow that has replaced it.

Added the ability to extract actions to a new actionflow in the actionflow node context menu. This will create a new actionflow and transfer all selected nodes into that actionflow. All extracted nodes must be connected and not include any start phase nodes. If a start loop is extracted its corresponding end loop must be extracted too and vice-versa.

logic that ensures that we have a valid subset of actions e.g. it can’t include a start loop node without the end loop node.

  • Can’t include phases

  • You must selected all nodes between any two connected nodes

  • You can’t select a start envelope without the end envelope

  • Passthrough attributes need mapping at the interface of the new nested action

  • You cannot extract subsets from different loops

New Actionflow Setup

After the Actionflow has been extracted, the newly created Actionflow retains the original action nodes but contains the input of the original actionflow.

Image Removed

Original Actionflow Setup

The action nodes on the original actionflow are replaced with an embedded actionflow node. See Actionflow Node Properties.

Image Removedre-used by extracting them to a new Actionflow. The actions in the original Actionflow are then converted to an embedded Actionflow node.

The newly created Actionflow automatically contains:

  • the input and output connection points
  • all transferred action nodes 
  • the original attributes, which are mapped to match the original Actionflow setup
  • input, output and lookup connectors for each connection in the new Actionflow which is connecting to an action node outside of the new Actionflow


Extracting to a New Actionflow

  1. Select the action nodes requiring extraction and right-click to choose
    Insert excerpt
    _extract_actionflow
    _extract_actionflow
    nopaneltrue
    Image Added
    1. A new Actionflow is automatically created
      Image Added
    2. On the original Actionflow, the action nodes are replaced with an embedded Actionflow node - see Actionflow Node Properties
      Image Added


Note

Important Considerations:

  • All action nodes requiring extraction must be connected
  • If a
    Insert excerpt
    _action_loop_start
    _action_loop_start
    nopaneltrue
     or
    Insert excerpt
    _action_loop_end
    _action_loop_end
    nopaneltrue
     is extracted, its corresponding end/start loop must be extracted too
  • Insert excerpt
    _action_phase
    _action_phase
    namestart
    nopaneltrue
     actions cannot be included in the extraction

  • Any passthrough attributes must be mapped into the original Actionflow