Relocation of Activities

Stardust provides the option to allow navigation between different interactive steps in a process workflow.

Common Use Cases

Relocation could be useful in the following cases:

Workflow Corrections

In some cases a user selects a wrong option in an activity and as a result the workflow is in the wrong activity. To model correcting transitions for every activity in the model would not be realizable. With the option to jump back to the activity where the wrong option was selected, the workflow can be corrected in a well-arranged way.

Process Upgrades

A new version of the process is mandatory and the user must migrate existing process instances to the new version and continue from the equivalent position. In this case, he could jump back only to the appropriate activities instead of restarting the whole process.

Performing a Relocation

A relocation is executed in two steps:

  1. Finding a valid relocation target starting from a given activity.
  2. Performing the transition to the target found above.

Marking Activities for Relocation

Relocation start points and end points are marked in the model. In the Activity property pages, two check boxes are available to determine:

Refer to section Modifying Activity Properties in chapter Specifying Activities of the Modeling Guide for details on these settings.

Source and Target Activities

Source Activities

Manual activities and application activity instances are supported as source activity types.

The following restrictions apply on activity instances to be used as source activities:

Target Activities

All activity types are supported as target activity types. Note that only users with the administrator role can jump to application activities.

Transition Options

The following transition options can be determined via API:

Note that jumping out of asynchronously started subprocess is not supported.

For details refer to section Transition Options of chapter Relocating Activities in the Programming Guide.

Workflow after transition

After the transition is performed, the workflow must be able to continue in a normal way from the target activity. The workflow continues in the following way:

Example Use Cases

The following examples are use cases for finding targets in workflows with activities marked for source and target relocation.

Linear Flow

This example has several activities in a sequence.

Linear Flow
Figure: Linear flow example

If source activity is 2, the following applies:

Complex Flow

This example complex flow is a combination of OR and AND joins.

Complex Flow
Figure: Complex flow example

Activity 3 is not marked as relocation target, thus it will be skipped by the scanning algorithm.

Possible targets if relocating from 1:

The following forward targets are possible:

The following backwards targets are possible:

Complex Flow 2

This example shows another complex type with AND joins.

Complex Flow 2
Figure: Complex flow example

The following transitions are valid in this flow:

Subprocess Flow

This example uses subprocesses in a three level sharing.

Subprocess Flow
Figure: Subprocess flow example

The workflow could be in the following order:

  1. We forward from 1 to subprocess activity 2.
  2. Now subprocess S1-2 is started from subprocess activity 2 of the main process.
  3. Subprocess S2-2 in the third process is started by subprocess S1-2.

Another option is to start subprocess S2-2 from activity 4 of the main process.

If you want to relocate from activity 1 in the main process to the second activity (subprocess S2-2) of the second subprocess, there are several options:

API provided for Relocation

The WorkflowService provides methods for finding targets and performing the transitions from the specified activity instance to the specified target. Refer to chapter Relocating Activities in the Programming Guide for details.

Data Copy Semantics

All data values get migrated if identical data exist in the new process definition version. Data with the same ID are copied in the following way:

Process History Migration

The process history is migrated as follows:

Restriction

Note that active activity instances are aborted and only one activity can be defined to be the starting activity for the new process instance.