This command deletes a specified work item. Optionally, you can force
deletion of corrupted work items.
CAUTION You
should only delete a work item when doing so is absolutely necessary.
Never delete a work item under the following circumstances.
The work item is currently locked by a user-defined application (including
step processors or work performers).
The only exception to this rule is if, while manually
recovering a work item that is locked by a failed work performer or
step processor, you have determined that deleting the work item is
the best course of action.
The work item is locked by Visual WorkFlo/Conductor, Process Administrator,
or vwtool.
In Visual WorkFlo/Composer-based workflows, the work item is a child
work item created via a StaticSplit system instruction, and the work
item has not yet reached the Rendezvous or Release system instruction
in its workflow.
In Process Designer-based
workflows, the work item is a child work item created via an AND-Split
system instruction, and the work item has not yet reached the Collector
step in its workflow.
In Visual WorkFlo/Composer-based workflows, the work item is a parent
work item (that is, it contains a StaticSplit system instruction) that
is pending a Rendezvous with one or more of its child work items.
In Process Designer-based
workflows, the work item is a parent work item (that is, it contains
an AND-Split system instruction) that is pending an AND-Join with one
or more of its child work items. A work item in this state lists "Rendezvous"
as its current instruction.
The work item is the waited-for work item that satisfies a WaitForCondition
system function or Visual WorkFlo/WaitForEvent system instruction.
Force deletion of work item. The force delete option causes the
Process Engine
to bypass inspection of the work item before deleting it.
Enter "y" to force deletion of the work item or "n"
to delete the work item only if no errors occur.
Use the force delete option when the work item is corrupted, or
when directed by your FileNet support representative. Actions that
indicate corruption are:
using wobquery to display this work item results in an error.
using deletewob, without the forcedelete parameter, to delete
this work item results in an error.
TIP In
vwtool, you can enter parameters on the command line (following the command
name) or let vwtool prompt you for the information by entering just the
command name. Generally, we recommend prompt mode for all but the simplest
commands. Entering the parameters on the command line is intended primarily
for script-driven input.