Deleting on-hold Event Manager tasks
To delete Event Manager tasks that are on hold, you can use the health management capability of the Process Admin Console, or a REST API call via the Swagger interface, or a wsadmin command.
Note: Do not use stored procedures to delete tasks or instances. It might corrupt the data for
on-hold Event Manager tasks.
Important: If you delete a task that belongs to an
active instance, there is the danger that the instance will become
corrupted and require fixing by either skipping or moving the navigation
token. Generally, on-hold Event Manager tasks that triggered UCAs
are safer to delete than other on-hold Event Manager tasks.
Using the Process Admin Console
- Click .
- Select the command Delete Event Manager tasks.
- Either specify to delete all tasks or a list of IDs of tasks to delete.
- Click Submit.
- If there is an error, you will see the error message.
- If there is no error, you see the results of the deletion.
Using a REST API call
Call the
BPM operations REST API DELETE https://host:port/ops/std/bpm/event_manager_tasks
.
Remember: For IBM® BPM on
Cloud,
the operations REST APIs have the following URL,
https://hostname.bpm.ibmcloud.com/bpm/environment/ops/std/bpm/event_manager_tasks
,
where environment has the value dev
for
the development system, test
for the test system,
or run
for the production (runtime) system.The
following examples illustrate how to use the API.
- To delete all on-hold Event Manager tasks:
DELETE https://host:port/ops/std/bpm/event_manager_tasks?all=true
- To delete specific on-hold Event Manager tasks :
DELETE https://host:port/ops/std/bpm/event_manager_tasks?em_task_ids=9,8,7
Important: All
calls to the Business Automation Workflow operations
REST API require that the HTTP header
BPMCSRFToken
is
set with every request. For information about how to obtain a token,
see Preventing cross site request forgery.Tip: For more details about the BPM operations REST APIs and
to try invoking them from a browser, use the Swagger interface. The
Swagger interface is available at the URL
https://server:port/ops/explorer
Where server is
the host name of your BPM server and port is the
port number that is used by the BPM server. For example, https://localhost:9443/ops/explorer
Using a wsadmin command
To delete on-hold Event Manager tasks, see BPMDeleteOnHoldEMTasks command.