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

What is an Embedded Actionflow?

An action node or group of action nodes can be nested within an  Actionflow node that can be reused without reusing the entire Actionflow. For example, a Calculate Action that normalises an area code can be extracted from its original Actionflow and reused (embedded) within many other Actionflows using its  Actionflow node.                         

For reusing entire Actionflows, see 1.17 Instances and Reusability. For extracting or moving an action(s) to another Actionflow, see 2.06 Extracting and Moving Actions.

Embedding Actionflows

An action(s) can be embedded after using the  Extract to new Actionflow option,  see 2.06 Extracting and Moving Actions, or by opening the list of Actionflows in the  Repository and dragging one onto the canvas.

  1. Click the  Actionflow option in the toolbar
  2. Drag and drop an  Actionflow from the Repository onto the canvas
  3. An embedded  Actionflow node is created
    1. If any changes are required to the functionality within the embedded Actionflow, right-click on the embedded node and choose  Display

Embedding Compatibility

  • Actionflows containing  Phases,  Start Phase actions, and confirmation screens cannot be embedded
  • When editing an Actionflow that has been embedded,  Phases cannot be created
  • An Actionflow in an application cannot be embedded in a package

Worked Example

Here's a worked example using the Shop Data (available from the Learning Centre).

In this example, we are using:  

  • A Staff Form screen containing blank input fields, set up to create a new staff member  - this screen was created using the Edit Form template

If you are completing this chapter as part of the Actionflow course and using a training instance, the data and screens have already been pre-loaded into the Actionflow Intermediate Application. For this example, we'll be working on the Save button on the Staff Form screen.

GIF/SCREENSHOT OF FINISHED RESULT

Prerequisites 

For this example, we'll embed an extracted Actionflow. If you have not completed 2.06 Extracting and Moving Actions, expand the section below and follow the steps to create an extracted Actionflow.

.

 Create an Extracted Actionflow

Error rendering macro 'excerpt-include' : No link could be created for '2.06 Extracting and Moving Actions'.

.

Embed Proper Case Actionflow

In this example, we'll embed an extracted action node that converts a First Name string to proper case. We'll embed this within the Save action on the Staff Form.

Embed Extracted Action in Actionflow

  1. Open the Actionflow on the Save button on the Staff Form
  2. Click  Actionflow in the toolbar and drag the Proper Case Actionflow from the  Repository onto the canvas
  3. Click and drag  Actionflow node onto the connector between the  input and  Save action and drop it when the  icon appears
  4. Choose the out_ProperCase connection point from the Select Connection Point pop up
  5. Click on the connector between the Proper Case  Actionflownode and  Save action
  6. Map across the ProperCase attribute from the embedded  Actionflow node to the first_name attribute on the  Save action 

1.02 Actionflow Principles

  • No labels