Reassign Work Item

API Type

REST

HTTP Method

POST

Description

Reassigns a work item to another participant, and update the user name.

URL Format (On Premises)

https://[domain]:[port]/AgilePointServer/Workflow/ReassignWorkItem

URL Format (AgilePoint for Azure)

https://[domain]:[port]/AgilePointService/Workflow/ReassignWorkItem

Request Parameters

Name	Description
None	Not Applicable

Request Body Properties

Name	Description
ClientData	Definition: Specifies the client data, which identifies a client for AgilePoint Server. Type string Allowed Values: A string that contains the client data. If this value is null, the system will keep existing client data. Otherwise the relevant data is overwritten.
UserName	Definition: The user name for the user. Type string Allowed Values: A valid user name for a registered AgilePoint user.
WorkItemID	Definition: An ID that represents a work item (task). Type string Allowed Values: A valid, unique 32-byte work item (task) ID.

JavaScript Code Example

var JSONObject = {
  "WorkItemID": "9FA1E98B85264545A62384A57D24FFF4",
  "UserName": "DEMO3\\Lilly.Allen",
  "ClientData": ""
};
$.ajax({
  url: "https://mydomain:9011/AgilePointServer/Workflow/ReassignWorkItem",
  data: JSON.stringify(JSONObject)
});

Java Code Example

public String ReassignWorkItem(String WorkItemID, String UserName,
  String ClientData) {

  String URI = "http://mydomain:9011/AgilePointServer/Workflow/ReassignWorkItem";

  HTTPOperations ops = new HTTPOperations(domain, this.userName,
                       password, appID, locale);

  JSONObject postData = new JSONObject();
  try {
    postData.put("WorkItemID", WorkItemID);
    postData.put("UserName", UserName);
    postData.put("ClientData", ClientData);
    return ops.POSTMethod(URI, postData.toString());
  } catch (JSONException e1) {
    e1.printStackTrace();
  }
  return "";
}

C# Code Example

public string ReassignWorkItem(string usernName)
  {
    string URI = "http://mydomain:9011/AgilePointServer/Workflow/ReassignWorkItem";

    string jsonRequestData = "{
      \"WorkItemID\":\"" + "27BDCAFF90954753B0F8FA8F864EA79C" + "\",
      \"UserName\":\"" + userName + "\",
      \"ClientData\":\"" + null + "\"}";

    HTTPOperations ops = new HTTPOperations(domain, this.userName, 
                         password, appID, locale);

    return ops.POSTMethod(URI, jsonRequestData);
  }

Output

WFEvent object that provides the status of the transaction. The possible statuses are:

Sent - Indicates event has been sent to engine for processing.
Failed - Indicates event failed to process.
Processed - Indicates event has been processed successfully.
Canceled - Indicates event was canceled.
Deferred - Indicates event does not need to be sent immediately.

JSON Response Body Example

{
  "ActivityInstID": "A27AD9FE81164DBDB09E9E7CEDCD0930",
  "AutoStart": true,
  "CustomAttributes": null,
  "Diagnostic": true,
  "EndDate": "\/Date(928149600000+0000)\/",
  "Entries": 1,
  "Error": null,
  "EventID": "32535618F3EE4CA1A54A738D9EBB87A6",
  "EventName": "ReassignWorkItem",
  "HighPriority": true,
  "ParamsXml": "<?xml version=\"1.0\" encoding=\"utf-8\"?>
                <WFEvent>
                  <param name=\"ClientData\" value=\"\"\/>
                  <param name=\"owner\" value=\"\"\/>
                  <param name=\"ActivityInstID\" 
                            value=\"A27AD9FE81164DBDB09E9E7CEDCD0930\" \/>
                  <param name=\"UserID\" value=\"demo3\\Lilly.Allen\" \/>
                  <param name=\"HighPriority\" value=\"True\" \/>
                  <param name=\"ProcInstID\" 
                            value=\"B7F0ACFA610349B4BF10A4DAB8E93458\" \/>
                  <param name=\"WorkItemID\" 
                            value=\"9FA1E98B85264545A62384A57D24FFF4\" \/>
                <\/WFEvent>",
  "ParentProcInstID": "",
  "ProcDefID": "",
  "ProcInstID": "B7F0ACFA610349B4BF10A4DAB8E93458",
  "ProcInstName": "",
  "Sender": "demo3\\Brian.Lucas",
  "SentDate": "\/Date(1394152020511+0000)\/",
  "SourceWorkItemID": "",
  "Status": "Sent",	
  "UserID": "demo3\\Lilly.Allen",
  "WorkItemID": "9FA1E98B85264545A62384A57D24FFF4",
  "WorkObjectID": "",
  "WorkObjectInfo": ""
}

Supported Versions

AgilePoint BPMS v5.0 R2 and higher