IBM BPM, V8.0.1, All platforms > Programming IBM BPM > Developing client applications for BPEL processes and tasks > Developing EJB client applications > Developing applications for human tasks

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.

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.

Developing applications for human tasks