Releasing a claimed task

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

  1. 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.

  2. 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.

Related concepts
Queries on business-process and task-related objects

Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)