Actions in the Process Inspector
You can use actions in the Process Inspector to administer process instances and their components.
Actions are available on several levels in the Process Inspector. When you select a process instance, the details panel includes the actions that you can perform on that instance. Similarly, if you select an activity or a task, the details panel includes the actions that you can perform on that activity or task.
Process instance actions
| Action | Description |
|---|---|
| Delete | Deletes a completed, failed, or suspended process
instance on a non-production server. The delete action is not available
on production servers. 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. Tip: If this action
is not available, check that the ACTION_DELETE_INSTANCE action
policy includes your user ID or group. For information, see Configuration properties for Process Portal action policies
|
| Delete orphaned tokens | Deletes orphaned tokens from the process instance
to allow processing to continue. Orphan tokens occur when an instance
migrates from one snapshot to another and there is an activity in
the old snapshot that contains a token but the activity does not exist
in the new snapshot. 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).
Tip: If the
option to delete orphaned tokens is not available but orphaned tokens
exist, check whether the security policy has been configured to support
moving or deleting tokens. For information, see Changing the security policy to handle orphaned tokens to hand orphaned tokens.
|
| Edit data | Expands the Data section so that you can review the instance data. |
| Modify due date | Changes the due date to the day and time that you specify. |
| Refresh | Reloads the process data. |
| Resume | Starts a suspended process instance. Tip: If this action is not available, check that the ACTION_RESUME_INSTANCE action
policy includes your user ID or group. For information, see Configuration properties for Process Portal action policies
|
| Retry failed steps | Resumes or restarts a failed process instance. Use this action on one or more process instances after a system problem is resolved. For example, if a process instance fails because the server could not access the database and the connection has been restored, you can restart the failed process instance using the Retry failed steps action. |
| Suspend | Pauses the execution of an active process instance. Tip: If this action is not available, check that the ACTION_SUSPEND_INSTANCE action
policy includes your user ID or group. For information, see Configuration properties for Process Portal action policies
|
| Terminate | Terminates the execution of failed or suspended
process instance. Before you terminate a process instance, check if the instance has dependent relationships. If the instance depends on other instances, terminating the instance also terminates the instances that it depends on. You can wait for all of the instances to complete before you terminate the dependent instance. Or, if you want to keep these dependency instances, you can remove the relationship before you terminate the instance. If you still want the relationship to be visible, you can add an independent relationship before you remove the dependent relationship. To terminate instances in a dependent relationship, you must have the authorization to terminate all the dependent instances. For example, instance A depends on instance B and instance B depends on instance C. Terminating instance A terminates instance B and instance C. Terminating instance B terminates instance C. If you have the authorization to terminate instance A and instance B but not instance C, you must either remove the relationship between instance B and C or get a user with the appropriate access to terminate instance C, before you can terminate instance A. 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.Tip: If
this action is not available, check that the ACTION_ABORT_INSTANCE action
policy includes your user ID or group. For information, see Configuration properties for Process Portal action policies
|
Activity actions
The following table lists the actions and describes the transition that happens for the activity when you click the action. Some of the actions are not available for ad hoc activities. The list of actions that you see depends on the state of the process instance and whether the action policy contains your user ID or group. For information about the states, see Runtime states for activities in process applications
| Action | Description |
|---|---|
| Disable | Moves READY and WAITING activities to DISABLED state. |
| Start | Moves READY and WAITING activities to WORKING state. If the action is repeatable, the process instance gains an copy of this activity and the copy is optional. For WAITING activities, clicking Start overrides the wait condition on the activity. |
| Enable | Moves the DISABLED activity
according to whether it is automatic or manual and whether its preconditions
are fulfilled or not:
|
Task actions
The following table lists the actions that you can take on a task. The availability of some of the actions depends on the status of the task and its parent instance.
| Action | Description |
|---|---|
| Assign to user or Reassign to user | Assigns the task to a specified user. |
| Return to team | Removes the assignment to the user from the task and returns the task back to the team. |
| Edit data | Expands the Data section so that you can review the task data. |
| Modify due date | Changes the due date to the day and time that you specify. |
| Modify priority | Changes the priority to the level that you specify. |
| Skip | Skips the task to send the process instance to the next step in its flow. You cannot undo the skip action. |
Timer actions
The only available action is Fire now. This action overrides the timer and sends the flow along the path that exits the timer. For example, a review activity has an attached timer (a boundary event) that leads to an escalation path.
Message event actions
There no available actions for message events. The presence of a message event indicates that the instance is waiting for a message to arrive.
Relationship actions
The following table lists the actions that you can take on a process instance relationship. To see these actions, click a relationship in the instance relationships list.
| Action | Description |
|---|---|
| Edit description | Opens a window from where you can edit the description of the relationship. |
| Remove | Removes the relationship between the two instances. The instances themselves are not affected. |