This topic applies only to the IBM Business Automation Workflow Advanced
configuration.

Releasing a claimed task

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15
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.

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

Procedure

  1. List the claimed tasks owned by a specific person, for example, Smith.
    FilterOptions fo = new FilterOptions();
    fo.setSelectedAttributes("TKIID");
    fo.setQueryCondition("STATE=STATE_CLAIMED AND OWNER='Smith'");
    EntityResultSet result = task.queryEntities("TASK", fo, null, 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.getEntities().size() > 0)
    {
      Entity entity = (Entity) result.getEntities().get(0);
      TKIID tkiid = (TKIID) entity.getAttributeValue("TKIID");
      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.