Group Configuration Tab

The following table describes the fields in the Configuration tab for groups.

Group Configuration tab

Field

Description

Name

The name to appear as the label for the group in the process definition.

Description

Short description of the group.

Group Action

The type of group. Groups can be of the following types.

2.x Compatibility Mode

This field is only available for loop groups in process definitions that were migrated from ActiveMatrix BusinessWorks 2.x.

Checking this field indicates that you would like activity output in a group to be handled using the ActiveMatrix BusinessWorks 2.x semantics. In 2.x, activity output was not reset at the start of every iteration of a loop. Therefore, activities in a loop could potentially see activity output from previous iterations of the loop.

If you uncheck this field, activity output in loop groups behaves as described in Activity Output and Groups.

Group Action: Iterate

Index Name

The index variable for the loop. This variable will be used to store the current iteration number of the loop. The index starts at one and increments by one with each execution of the loop.

For more information, see Index Variable.

Variable List

A process variable containing the list you wish to use as the source of the iterations. The group iterates once for each item in the list.

Use the button to choose from a list of available process variables for this field. Once a process variable is chosen, the correct XPath expression for that process variable is automatically entered into this field.

Iteration Element

A name to use for the process variable containing the current iteration element of the data supplied in the Variable List field. For more information on this field, see Iteration Element.

Accumulate Output

Specifies that you wish to accumulate the output of each execution of one of the activities in the group into a process variable. For more information, see Accumulate Output.

Output Activity

The activity in a group for which you wish to accumulate output for each execution of the loop. You may select only one activity in the group.

Output Name

The name of the process variable to store the successive output of the selected activity in the Output Activity field.

Group Action: Repeat-Until-True

Index Name

The index variable for the loop. This variable will be used to store the current iteration number of the loop. The index starts at one and increments by one with each execution of the loop.

For more information, see Index Variable.

Conditions

The condition that specifies when the loop should stop. The activities in the group are executed once, then the condition is checked. If the condition evaluates to false, the loop repeats, if the condition evaluates to true, the loop stops. The loop continues to repeat until the condition evaluates to true.

The condition is specified as an XPath expression and the XPath formula builder is available to help to create the condition. For more information, see XPath.

Accumulate Output

Specifies that you wish to accumulate the output of each execution of one of the activities in the group into a process variable. For more information, see Accumulate Output.

Output Activity

The activity in a group for which you wish to accumulate output for each execution of the loop. You may select only one activity in the group.

Output Name

The process variable to store the successive output of the selected activity in the Output Activity field.

Group Action: While True

Index Name

The index variable for the loop. This variable will be used to store the current iteration number of the loop. The index starts at one and increments by one with each execution of the loop. Specifying an index name is optional for While True loops.

For more information, see Index Variable.

Conditions

The loop repeats as long as the condition specified in this field evaluates to true. The condition is evaluated when the group is entered. If the condition evaluates to false, the activities in the group are not executed.

The condition is specified as an XPath expression and the XPath formula builder is available to help to create the condition. For more information, see XPath.

Accumulate Output

Specifies that you wish to accumulate the output of each execution of one of the activities in the group into a process variable. For more information, see Accumulate Output.

Group Action: Repeat-On-Error-Until-True

Index Name

The index variable for the loop. This variable will be used to store the current iteration number of the loop. The index starts at one and increments by one with each execution of the loop.

For more information, see Index Variable.

Conditions

The condition that specifies when the loop should stop. The activities in the group are executed once. If an error occurs during the processing of the activities, and that error does not have an associated error transition, the condition is checked.

If the condition evaluates to false, the loop repeats, if the condition evaluates to true, the loop stops. The loop continues to repeat if unhandled errors are encountered, until the specified condition evaluates to true.

The condition is specified as an XPath expression and the XPath formula builder is available to help to create the condition. For more information, see XPath.

Suspend (If Still Error)

Suspends the process if the error still occurs when the specified condition is true. For more information about this field, see Suspend If Still Error Option.

Group Action: Transaction

Transaction Type

Defines the type of transaction for group.

  • JDBC

  • Java Transaction API (JTA) User Transaction

  • XA Transaction

  • JMS Transaction

Include in Transaction

Specifies if the Receiver is included in the transaction, when JMS Transaction type is selected.

Group Action: Critical Section

Scope

Defines the scope of the critical section group.

  • Single Group — specifies that all process instances in the same process engine for the current process definition will be synchronized on the current group.

  • Multiple Group — specifies that all process instances for the current process definition and any other process definition with a critical section group specifying the same lock resource will be synchronized. If you are synchronizing across multiple process engines, you should select the Multiple Group option. This option requires the Lock resource to be specified in the Lock Object field.

Lock Object

The Lock shared configuration resource that synchronizes critical section groups across process definitions and potentially across process engines.