When a potential owner claims a task, this person is responsible
for completing the task. However, sometimes the claimed task must be released
so that another potential owner can claim it.
Why and when to perform this task
Sometimes it is necessary for someone with administrator rights to
release a claimed task. This situation might occur, for example, when a task
must be completed but the owner of the task is absent. The owner of the task
can also release a claimed task.
Steps for this task
- List the claimed tasks owned by a specific person, for example,
Smith.
QueryResultSet result =
task.query("DISTINCT TASK.TKIID",
"TASK.STATE = TASK.STATE.STATE_CLAIMED AND
TASK.OWNER = 'Smith'",
(String)null, (Integer)null, (TimeZone)null);
This action returns a query result set that
lists the tasks claimed by the specified person, Smith.
- Release the claimed task.
if (result.size() > 0)
{
result.first();
TKIID tkiid = (TKIID) result.getOID(1);
task.cancelClaim(tkiid, true);
}
This action returns the task
to the ready state so that it can be claimed by one of the other potential
owners. Any output or fault data that is set by the original owner is kept.