Process Migration Functions

Functions are provided to control process migration.

These ProcessManagementService functions are:

  • listMigrationRules - List the process instance migration rules that are set for one or more process templates.
  • isSetMigrationRule - Test whether any migration rules are set for a particular qualified task name.
  • getMigrationPoints - List the permissible process instance migration points for one or more process templates.
  • setMigrationRules - Set one or more process instance migration rules.
  • unsetMigrationRules - Unset one or more previously set process instance migration rules.
  • clearMigrationRules - Clear all process instance migration rules for one or more process templates.

Authorization of Process Migration Functions

A resource can only perform process migration if they have the necessary privileges to execute the handleProcessMigration system action. (The system-wide default value for this system action is Denied.)

Process Manager validates the calling resource’s privileges whenever a process migration service function is called. If the calling resource does not have the necessary authorization to execute the handleProcessMigration system action, the call will fail with an appropriate error.

Note: You can use the SecurityService functions (for example, IsActionAuthorized) to test whether a resource has the necessary authorization before calling a process migration service function.