How to get All Task of a user to design your custom UWL using BPM API as a rest full service.

[former_member182534]

This guide provides instructions on how to get All Task of a user to design your custom UWL using BPM API as a Restful Service.

Applies to:

This Document Holds good for all CE 7.3 SP05 onwards. This service can be called from UI5 Screen as an Ajax call.

Please note that from 7.31 SP12 onward you can also use the standard BPM OData service to get All Task of a user to design custom UWL as mentioned by christian.loos.

Special Thanks to christian.loos.

Step 4 : Create Business Objects as shown below:

public class TaskHeader {

  private String priority;

  private String status;

  private String taskType;

  private String id;

  private String name;

  public String getPriority() {

  return priority;

  }

  public void setPriority(String priority) {

  this.priority = priority;

  }

  public String getStatus() {

  return status;

  }

  public void setStatus(String status) {

  this.status = status;

  }

  public String getTaskType() {

  return taskType;

  }

  public void setTaskType(String taskType) {

  this.taskType = taskType;

  }

  public String getId() {

  return id;

  }

  public void setId(String id) {

  this.id = id;

  }

  public String getName() {

  return name;

  }

  public void setName(String name) {

  this.name = name;

  }

}

import java.util.ArrayList;

import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement

public class TaskHeaders {

  protected ArrayList<TaskHeader> taskHeaders;

  public ArrayList<TaskHeader> getTaskHeaders() {

  return taskHeaders;

  }

  public void setTaskHeaders(ArrayList<TaskHeader> taskHeaders) {

  this.taskHeaders = taskHeaders;

  }

}

Step 5 : Create a restful service class file and write a code as shown below or if you are continuing from the document then just copy past the methods only.

import java.io.StringReader;

import java.net.URI;

import java.text.DateFormat;

import java.text.ParseException;

import java.text.SimpleDateFormat;

import java.util.ArrayList;

import java.util.Date;

import java.util.HashSet;

import java.util.Iterator;

import java.util.Set;

import javax.ws.rs.Consumes;

import javax.ws.rs.GET;

import javax.ws.rs.POST;

import javax.ws.rs.Path;

import javax.ws.rs.PathParam;

import javax.ws.rs.Produces;

import javax.ws.rs.core.MediaType;

import javax.xml.parsers.DocumentBuilder;

import javax.xml.parsers.DocumentBuilderFactory;

import org.w3c.dom.Document;

import org.w3c.dom.Element;

import org.w3c.dom.Node;

import org.xml.sax.InputSource;

import bo.Material;

import bo.MaterialCreation;

import bo.TaskHeader;

import bo.TaskHeaders;

import com.sap.bpm.api.BPMFactory;

import com.sap.bpm.exception.api.BPMException;

import com.sap.bpm.pm.api.ProcessDefinition;

import com.sap.bpm.pm.api.ProcessDefinitionManager;

import com.sap.bpm.pm.api.ProcessStartEvent;

import com.sap.bpm.pm.api.ProcessStartManager;

import com.sap.bpm.tm.api.Status;

import com.sap.bpm.tm.api.TaskAbstract;

import com.sap.bpm.tm.api.TaskDetail;

import com.sap.bpm.tm.api.TaskInstanceManager;

import com.sap.tc.logging.Location;

import commonj.sdo.DataObject;

import commonj.sdo.helper.XMLHelper;

@Path("/MaterialCreationService")

@Produces({MediaType.APPLICATION_XML})

public class MaterialCreationToRestService {

  private static final Location location = Location.getLocation(MaterialCreationToRestService.class);

  private final String PRE_TASK_URI = "bpm://bpm.sap.com/task-instance/";

  @Path("/getAllTasks")

  @GET

  @Consumes({MediaType.APPLICATION_JSON})

  @Produces({MediaType.APPLICATION_JSON})

  public TaskHeaders getAllTasks() throws Exception

    {

    System.err.println("ArticleMaintenanceService -> getAllTasks");

    TaskHeaders taskHeaderDetails = new TaskHeaders();

    TaskHeader bpmTaskDetail;

    TaskAbstract myTask;

  URI taskInstanceId;

  TaskDetail taskDetails;

  try

    {

    //Retrieve the TaskInstanceManager

    TaskInstanceManager taskInstanceManager = BPMFactory.getTaskInstanceManager();

    //Build the set of statuses to query

    HashSet<Status> statuses = new HashSet<Status>();

    statuses.add(Status.READY);

    statuses.add(Status.RESERVED);

    statuses.add(Status.IN_PROGRESS);

    //Query those statuses

    Set<TaskAbstract> myTasks = taskInstanceManager.getMyTaskAbstracts(statuses);

    System.err.println("size(myTasks) : "+myTasks.size());

        ArrayList<TaskHeader> bpmTaskDetails = new ArrayList<TaskHeader>();

    //Use the ID of a task instance to generate the URL of the task execution UI

    for (Iterator iterator = myTasks.iterator(); iterator.hasNext();)

    {

    myTask = (TaskAbstract) iterator.next();

    taskInstanceId = myTask.getId();

    taskDetails = taskInstanceManager.getTaskDetail(taskInstanceId);

    bpmTaskDetail = new TaskHeader();

    bpmTaskDetail.setId(taskInstanceId.toString());

    bpmTaskDetail.setName(taskDetails.getName());

    bpmTaskDetail.setPriority(taskDetails.getPriority().toString());

    bpmTaskDetail.setStatus(taskDetails.getStatus().toString());

    bpmTaskDetail.setTaskType(taskDetails.getTaskType());

    // Add Detail to the List

    bpmTaskDetails.add(bpmTaskDetail);

    }

    taskHeaderDetails.setTaskHeaders(bpmTaskDetails);

    }

  catch (BPMException e)

  {

  System.err.println("BPMException : "+e.getMessage());

  throw e;

  }

  return taskHeaderDetails;

    }

}

Step 6 & Step 7 is same as mentioned in the document. If you are continuing then you can ignore these steps.

Creating Deploy-able Object & Accessing the methods exposed.

Refer the document to "Creating Deploy-able Object" & "Accessing the methods exposed" as it is the same.

Testing your REST services

You can test the created REST services using the POSTMAN for Chrome or Advanced REST client for Chrome.