Back Forward Activity form
Completing the Steps tab — Entering transitions
 

About Activity rules

The image/img00033.gif column identifies transitions, optional fields that can end iteration, terminate the activity, or cause control to jump to a later (higher-numbered) labeled step. Use transitions to specify conditions that are evaluated after the method in the step is performed, but before the execution continues with other steps.

Often a transition condition tests whether the method in the current step was successful. See How to test method results using a transition for more on this use of transitions.

When a row is not selected, a checkmarkindicates that this step has a transition defined. When the row is activated, clickto add a transition or theto access the details of the transition.

Use the standard add row (Append Row), append row (), and delete row () buttons with this array. Order is significant.

Field

Description

Enabled?

Select to activate the transition. If this box is not selected:

  • At runtime, all rows of the transition are ignored.
  • When you save the Activity form, a warning message appears. BUG-287
On Exception, Jump to Step Label:

Optional. If you anticipate that this method may cause a Java exception, enter the label of a higher-numbered step to execute next. This can prevent users from seeing any evidence of the exception, such as the red X. B-18852 PRKB-20153

When

Identify a when condition rule that the transition is to evaluate. Alternatively, enter an expression that returns true or false, starting with =.

Click the pencil icon (Pencil) to review or update the when condition rule. Click the magnifying glass icon () to start the Expression Builder.

If True

Select which action the system is to take when the when condition or conditions evaluate to true. Complete both an If True and If False option for each row.

image/img00053.gif
  • Continue Whens — Advance to the next row of the transition.
  • Skip Whens — Skip all the other, later rows of the transition.
  • Jump to Later Step — Jump to a higher numbered step that contains the specified label. Indicate which step to jump to by entering the step's Label name in the True Param field. After the activity jumps to the specified step, it processes that step and later steps in the activity. You cannot use Jump to Later Step to transfer control to a label of a lower-numbered step.
  • Skip Step — End processing of this step, continuing at the next step. If the current step involves an iteration, this choice operates similarly to a break statement in many programming languages. B-11832 C-1821
  • End Activity — End execution of this activity. This is similar to the Exit-Activity method, not the Activity-End method.
True Param

If you selected Jump to Later Step for the If True field, enter the label of a higher-numbered step to jump to.

NoteIf the If True value is Jump to Later Step and the transition is true, but this field is empty, a Java exception occurs. PRKB-20153

If False

Select what action the system is to take if the condition evaluates to false. The choices are the same as those for If True. Complete both an If True and If False option for each row.

False Param

If you selected Jump to Later Step for the If False field, enter the label of a higher-numbered step to jump to.

NoteIf the If False value is Jump to Later Step and the transition is false, but this field is empty, a Java exception occurs. PRKB-20153

Notes

NoteYou can't use an iteration to jump from outside an iteration sequence to any child step within the iteration. You can jump to the parent step — first step (NNN.0) of an iteration sequence. From a child step in an iteration, you can jump to a later step within the iteration or to a later step outside that iteration.

NoteWhen a method in an activity step affects the value of a property referenced in a Declare Expression rule, the declarative rule execution occurs before the system evaluates the transition. For example, if the method updates the value of a Diameter property, and a Declare Expression rule computes a CircleArea property based upon the Diameter value, only the updated CircleArea value is available to the transition. TURBT 1/21/02

NoteWhen a step contains an enabled when-based transition, the Tracer shows a step status of "Good" regardless of the step status that existed before the transition evaluation. This status is consistent with the processing status that will be perceived by the next activity step; it reflects that any error condition that existed is "noted" by the activity. SR-151 B-15297

Up About Activity rules