Branching to another activity

Use the Branch instruction to cause the current activity to find another specified activity and branch to it without a return. When the system executes a Branch step, control transfers to another activity found through rule resolution. Execution of the original activity pauses.

When the branched activity ends, processing of the current activity ends also; no steps after the Branch step are executed.

You can pass parameters to the target activity, or you can share the current activity parameter page with the target activity.

Do not include any steps after a Branch instruction, unless the branch occurs only part of the time (because of a transition) or the later steps can be reached through a label and Jump.

Parameters

The Branch instruction requires the name of the target activity branched to, and parameters for that activity.

Parameter Description

Parameter	Description
activity	In the Method field, type the word `Branch`, a space, and the activity name to branch to. SmartPrompt is available. If the second activity is not in the same class as this activity, and not in the same class as the page identified in the Step Page field, identify the Applies To key part of the second activity also, using the format: `Branch Data-Admin-Operator-ID.Analyze`
Pass current parameter page?	Select if you want the current activity's parameter page to be passed to (shared with) the branch activity, which can alter its contents in any way. Clear this check box to use the array that appears below the check box to pass parameters to the branch activity, on its own parameter page. If you select this box, make sure that input parameter values needed by the branch activity are present on the parameter page before the Branch instruction.
Value	Complete values for parameters of the branch activity, if you did not check the Pass current parameter page? box. Enter literal or property reference values for each parameter that you want to have a value. The system creates a parameter page for the branch activity that is unrelated to the calling activity's parameter page.

activity

In the Method field, type the word Branch, a space, and the activity name to branch to. SmartPrompt is available.

If the second activity is not in the same class as this activity, and not in the same class as the page identified in the Step Page field, identify the Applies To key part of the second activity also, using the format:

Branch Data-Admin-Operator-ID.Analyze

Pass current parameter page?

Select if you want the current activity's parameter page to be passed to (shared with) the branch activity, which can alter its contents in any way.

Clear this check box to use the array that appears below the check box to pass parameters to the branch activity, on its own parameter page.

If you select this box, make sure that input parameter values needed by the branch activity are present on the parameter page before the Branch instruction.

Value

Complete values for parameters of the branch activity, if you did not check the Pass current parameter page? box. Enter literal or property reference values for each parameter that you want to have a value.

The system creates a parameter page for the branch activity that is unrelated to the calling activity's parameter page.

Results

At runtime, the system uses rule resolution to locate the activity identified in the branch. It transfers control to the activity and passes the parameters supplied. The step page of this step becomes the primary page of the target activity. Processing of the original activity pauses.

When the branched-to activity ends, processing of the original activity also ends. If the original activity was started by another activity using a CALL instruction, processing resumes with that activity.

Checking the method status

This method updates the pxMethodStatus property only if it fails. See How to test method results using a transition.