How Process Instances Are Migrated

At runtime, when a process instance task that is defined as a migration point executes, Process Manager checks if a migration rule is set (using the qualified task name).

If a migration rule is set, Process Manager:

  1. migrates the process instance to the new version of the process template defined in the migration rule.
  2. issues a BX_INSTANCE_PROCESS_MIGRATED audit event to indicate that the process instance has migrated.
    Note: The managedObjectVersion for this event is the process template version after migration.

    The managedObjectId for this event is the ID of the process instance. This remains the same after migration as it was before, and so it can be used to connect audit events before and after migration.

  3. continues execution of the task using the migrated to version of the process instance.