Process Inspector actions

Process Inspector provides actions to recover failed process instances.

The following tables contain descriptions of the actions that can be initiated on process instances and activities when using the Process Inspector.

Attention: Only the task owner or a member of the task owner's team can view and modify task data. By default, members of the tw_admins security group can act on the associated process instance. After you define a Portal Admin Team, only members of this team can act on the process instance; members of the tw_admins security group no longer have these privileges.

If the REST API façade returns a timeout exception while waiting for a response from the database, you can configure the web Process Inspector façade to increase the default connection time, which is 240 seconds. See Modifying the stateful session bean cache.

Bulk indicates that the action can be performed in bulk on multiple items at a time.

Table 1. Process instances actions
Action	Bulk	Description
Delete	Yes	Deletes a process instance from the server. This action is available when the process instance status is Completed, Failed, or Suspended. You must configure the ACTION_DELETE_INSTANCE action policy for the user to have authority to perform the action. See Security configuration properties. After a process instance is deleted, the row is gone and can be recovered only by using a backup. There is no way to revive a deleted process instance.
Delete orphaned tokens	Yes	Deletes orphaned tokens from the server, allowing processing to continue. Use this action when activities have been deleted during the migration of inflight process instances from an older snapshot to a newer snapshot, thus causing orphaned tokens. Deleting orphaned tokens does not recover the orphaned tokens, but allows the process to resume so that the remaining process tokens can proceed. An orphaned token is a pointer (token) that is associated with an activity or event that has been removed from a business process definition (BPD). Important: To delete tokens, you must first configure the security policy. For instructions, see "Changing the security policy".
Resume	Yes	Starts a suspended process instance. You must configure the ACTION_RESUME_INSTANCE action policy for the user to have authority to perform the action. See Security configuration properties.
Retry failed steps	Yes	Resumes or restarts a failed process instance. This action is available when a task fails. Use this action on one or more process instances after a system problem is resolved. For example, several process instances failed because the server could not access a database. After the database connection is restored, you can restart the failed process instances using the Retry failed steps action.
Suspend	Yes	Pauses the execution of an active process instance. You must configure the ACTION_SUSPEND_INSTANCE action policy for the user to have authority to perform the action. See Security configuration properties.
Terminate	Yes	Terminates the execution of an active process instance. This action is available when the process instance status is Failed or Suspended. You must configure the ACTION_ABORT_INSTANCE action policy for the user to have authority to perform the action. See Security configuration properties. After a process instance is terminated, you can only delete the process instance and only on Process Center and non-production process servers. There is no way to revive a terminated process instance.

Note about bulk processing

If you initiate a bulk operation that cannot be applied to all process instances within a selection, the operation is applied to as many items as possible. For example, there are 10 process instances in a selection; seven are active and three are completed. When you terminate an action, only the seven active items are terminated (stopped). The three completed items cannot be stopped because they have already completed and are not currently running. A message confirms the number of items that were terminated.

Table 2. Activity actions
Action	Description
Escalate	Opens a window from where you can reassign a task activity and modify the priority level.
Edit data	Opens the data tree in a separate window from where you can edit input variables or run a service or script. This action is currently not supported for Advanced Integration Services.
Fire now	Initiates timers.
Retry failed step	Restarts the activity from the step that failed. Tip: Try changing the input values. Edit and save input variables, then click Retry failed steps.
Skip	Passes data to the next activity, but no actions associated with the skipped activity will run. You cannot go back to a skipped activity and reopen it. You can skip any task if you have administrative authority. You can skip active or failed tasks. You can also skip any task if you are logged in as owner of the task or part of the team that the task was assigned to and have the `ACTION_RETRY_INSTANCE` action policy configured as a configuration object. Limitation: Variables with an Any type cannot be viewed or modified in the web Process Inspector. Skipping a task which uses these variables will cause the values in these variables to be lost. Important: Use this action with caution. Consider the implications for the integrity of the process before you choose to skip an activity. Tip: If you want to skip an activity with predefined output values, edit and save private and output variables, then click Skip.