Invoke Flow Service (Magic xpi 3.x)
The Invoke Flow service invokes a flow using the Flow ID. The flow is executed on the relevant Magic xpi Server and based on the first flow component’s invocation properties.
To add the Invoke Flow service to a flow:
-
Find the services icons in the Components pane at the left of the screen. You can display only the services by selecting Services from the drop-down list at the top of the Components pane.
-
Drag the Invoke Flow service to your flow.
-
In the Invoke Flow Service dialog box, enter the information as described in the table below:
|
|
|
|
Name
|
Type a name that describes the service in the flow.
|
|
Description
|
Type a description of the service in your flow (optional).
|
|
Processing mode
|
Select whether the step should be executed linear or parallel or in Stand Alone mode. This is only available if the Invoke Flow service is not the first step in the flow.
|
|
Wait for completion
|
Select whether the step should be run in Wait for Completion mode. The options are Yes or No.
|
Note:
|
Wait for completion is only available when:
|
|
|
|
Call logic flow
|
You can use this option if you want to call generic logic after the execution of a specific step. Once this step has been executed, the flow logic that you defined in the flow properties is called before the Server continues to the following steps.
The options are Yes or No (default).
|
|
Invoke by expression
|
This field enables you to invoke a flow dynamically according to expressions that are evaluated at runtime. Select one of the following from the drop-down list:
|
Note:
|
To invoke a flow dynamically, you need to supply both the business process ID and the flow ID. You can use the GetBPID and GetFlowID functions to locate the business process ID and the flow ID.
|
|
Since version: V3.2
|
|
BP ID
|
This expression represents the BP ID that contains the flow that you want to invoke.
Click  to open the Expression Editor. You can use the Expression Editor to enter the required information.
|
Note:
|
This field is only available when you set the Invoke by expression field (above) to Yes.
|
|
Since version: V3.2
|
|
Flow ID
|
The flow to be invoked. This field can be used in two different ways.
-
If you set the Invoke by expression field (above) to No, click  to open the Flow List. Select the flow to be invoked and then click Select. The selected flow is displayed next to the button.
-
If you set the Invoke by expression field (above) to Yes, click to open the Expression Editor. You can use the Expression Editor to enter an expression that represents the flow ID that you want to invoke.
|
|
Arguments
|
Click to open the Invoke Arguments dialog box. Here you can define the following parameters:
-
Destination Variable: Click to select a target flow variable.
-
In/Out: Select In, Out or In/Out.
-
Source Variable: Click to select a source variable. This is available only when you select Out or In/Out.
-
Source Variable EXP: Enter a value using the Expression Editor. This is available only when you select In.
|
|
Save point
|
Select Yes to indicate that the step is a Save Point in your flow. This is available only if the flow's Recovery Policy is set to Save Point.
|
-
Click OK to close the Invoke Flow dialog box. The Invoke Flow service is displayed in the flow.
|
Note:
|
You can move directly to the flow that you that you want to invoke, as defined in the Invoke Flow service. To do this, right-click on the Invoke Flow service icon in the flow, and select Move To from the context menu. The Magic xpi Studio will then display the invoked flow.
At the same time, the Move Back button is enabled in the Magic xpi Studio toolbar. To return to the invoking flow, click Move Back on the toolbar.
|
|
