IBM Business Process Manager, Version 8.5.5
GET /rest/bpm/wle/v1/social/task/{taskId}/experts[?parts={string}]
Name | Value Type | Description |
---|---|---|
parts | string | A string indicating which parts, that is if the GroupDetail, of the response data should be returned. Valid values are "all" (the default), or "none".
|
None
The default content type is application/json.
{ "description": "User", "type": "object", "properties": { "completed": {"type": "integer", "description": "The calculated number of times this task has been completed by this user." }, "avgHours": {"type": "double", "description": "The calculated average hours to complete this task for this user." }, "userID": {"type": "integer", "description": "The user ID of the user that is described by this object." }, "userName": {"type": "string", "description": "The user name of the user that is described by this object.", }, "fullName": {"type": "string", "description": "The full name of the user that is described by this object.", }, "isDisabled": {"type": "boolean", "description": "States whether this user is disabled. This field is set to false and cannot be changed." }, "primaryGroup": {"type": "string", "description": "The primary group associated with this user." }, "emailAddress": {"type": "string", "description": "The email address associated with this user." }, "userPreferences": [ { "key" : { "type": "string", "description": "The key associated with the user preference." }, "value" : { "type": "string", "description": "They value associated with the user preference." } } ], "memberships": {"type": "[string]", "description": "List of groups in which the user is a member." }, "workload": {"type": "integer", "description": "The workload assocaited with this user." } } }
{ "status": "200", "data": { "systemIdentifiedUsers": [{ "completed": 2, "avgHours": 0, "userID": 0, "userName": "tw_admin", "fullName": "Internal TW Admin user", "isDisabled": false, "primaryGroup": null, "emailAddress": null, "userPreferences": null, "tasksCollaboration": null, "memberships": null, "workload": 0 }], "expertParticipantGroupUsers": [{ "avgHours": 0, "userID": 1, "userName": "tw_admin", "fullName": "Internal TW Admin user", "isDisabled": false, "primaryGroup": null, "emailAddress": null, "userPreferences": { "Locale": "en" }, "tasksCollaboration": null, "memberships": null }], "expertParticipantGroupDetails": { "groupID": 1303, "groupName": "Expert Participant Group 1 v1_T_b653ff89-3206-4f8d-add5-e38c3fc82c7e.c736b70f-b151-4099-a921-a033a2a017b3", "displayName": "Expert Participant Group 1 v1", "description": "Expert Participant Group 1 v1", "members": null } } }
<?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="http://rest.bpm.ibm.com/v1/data/usergroup" elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://rest.bpm.ibm.com/v1/data/usergroup" xmlns:data="http://rest.bpm.ibm.com/v1/data/root" xmlns:cmn="http://rest.bpm.ibm.com/v1/data/common"> <import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root" /> <import schemaLocation="Common.xsd" namespace="http://rest.bpm.ibm.com/v1/data/common" /> <!-- This type represents a user that has been defined to the IBM BPM installation. --> <complexType name="User"> <complexContent> <extension base="data:Data"> <sequence> <!-- The numeric ID of the user --> <element name="userID" type="long" /> <!-- The alphanumeric user name associated with the user --> <element name="userName" type="string" /> <!-- The user's full name --> <element name="fullName" type="string" minOccurs="0" /> <!-- This field indicates whether or not this user is disabled. This field is set to false and cannot be changed. --> <element name="isDisabled" type="boolean" /> <!-- The timestamp when the user last logged in, This field cannot be changed. --> <element name="lastLoginDate" type="dateTime" /> <!-- not used --> <element name="primaryGroup" type="string" minOccurs="0" /> <!-- not used --> <element name="emailAddress" type="string" minOccurs="0" /> <!-- A list of user preferences (extended attributes) associated with this user --> <element name="userPreferences" type="cmn:Map" minOccurs="0" /> <!-- A list of Tasks (taskIds) that the user is collaborating on --> <element name="tasksCollaboration" type="string" minOccurs="0" maxOccurs="unbounded" /> <!-- A list of groups to which this user belongs --> <element name="memberships" type="string" maxOccurs="unbounded" minOccurs="0" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a user with a workload defined to the IBM BPM installation. --> <complexType name="TeamMember"> <complexContent> <extension base="tns:User"> <sequence> <!-- The numeric ID of the user --> <element name="workload" type="integer" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a user with a workload defined to the IBM BPM installation. --> <complexType name="Expert"> <complexContent> <extension base="tns:TeamMember"> <sequence> <!-- TODO what is this --> <element name="completed" type="integer" /> <!-- TODO what is this --> <element name="avgHours" type="double" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents an array of Experts --> <complexType name="Experts"> <complexContent> <extension base="data:Data"> <sequence> <!-- MAY CONTAIN --> <element name="Experts" type="tns:Expert" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a list of expert users with a workload defined to the IBM BPM installation. --> <complexType name="ExpertList"> <complexContent> <extension base="data:Data"> <sequence> <!--group of users the system identifies as experts on a task --> <element name="systemIdentifiedUsers" type="tns:Expert" maxOccurs="unbounded" minOccurs="0" /> <!--group of users included in the the task expert participant group --> <element name="expertParticipantGroupUsers" type="tns:Expert" maxOccurs="unbounded" minOccurs="0" /> <!--task expert participant group --> <element name="expertParticipantGroupDetails" type="tns:Group" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a user that has been defined to the IBM BPM installation. --> <complexType name="UserPreferences"> <complexContent> <extension base="data:Data"> <sequence> <!-- The user's display name --> <element name="displayName" type="string" /> <!-- The user's "Primary Role Description --> <element name="primaryRoleDescription" type="string" /> <!-- The user's Task Email Address --> <element name="taskEmailAddress" type="string" /> <!-- The user's Phone Number --> <element name="phoneNumber" type="string" /> <!-- The user's Street Address --> <element name="streetAddress" type="string" /> <!-- The user's City --> <element name="city" type="string" /> <!-- The user's State --> <element name="state" type="string" /> <!-- The user's Country --> <element name="country" type="string" /> <!-- The user's Postal Code--> <element name="postalCode" type="string" /> <!-- The user's Image --> <element name="image" type="string" /> <!-- The user's Toolbar Collapsed setting --> <element name="toolbarCollapsed" type="boolean" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a group that has been defined to the IBM BPM installation. --> <complexType name="Group"> <complexContent> <extension base="data:Data"> <sequence> <!-- The numeric ID of the group --> <element name="groupID" type="long" /> <!-- The alphanumeric name of the group --> <element name="groupName" type="string" /> <!-- The display name associated with the group --> <element name="displayName" type="string" /> <!-- The description associated with the group --> <element name="description" type="string" /> <!-- The list of users that are members of this group --> <element name="members" type="string" maxOccurs="unbounded" minOccurs="0" /> <!-- The alphanumeric name of the manager group --> <element name="managerGroupName" type="string" minOccurs="0" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a list of zero or more users that have been defined to the IBM BPM installation. --> <complexType name="UserList"> <complexContent> <extension base="data:Data"> <sequence> <element name="users" type="tns:User" maxOccurs="unbounded" minOccurs="0" /> </sequence> </extension> </complexContent> </complexType> <!-- This type represents a list of zero or more user groups that have been defined to the IBM BPM installation. --> <complexType name="GroupList"> <complexContent> <extension base="data:Data"> <sequence> <element name="groups" type="tns:Group" maxOccurs="unbounded" minOccurs="0" /> </sequence> </extension> </complexContent> </complexType> <element name="User" type="tns:User" /> <element name="TeamMember" type="tns:TeamMember" /> <element name="Expert" type="tns:Expert" /> <element name="Experts" type="tns:Experts" /> <element name="UserPreferences" type="tns:UserPreferences" /> <element name="Group" type="tns:Group" /> <element name="UserList" type="tns:UserList" /> <element name="GroupList" type="tns:GroupList" /> </schema>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <bpm:ResponseData xmlns:bpm='http://rest.bpm.ibm.com/v1/data'> <status>200</status> <data xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ug='http://rest.bpm.ibm.com/v1/data/usergroup' xsi:type="ug:ExpertList"> <systemIdentifiedUsers> <userID>0</userID> <userName>tw_admin</userName> <fullName>Internal TW Admin user</fullName> <isDisabled>false</isDisabled> <workload>0</workload> <completed>2</completed> <avgHours>0.0</avgHours> </systemIdentifiedUsers> <expertParticipantGroupUsers> <userID>1</userID> <userName>tw_admin</userName> <fullName>Internal TW Admin user</fullName> <isDisabled>false</isDisabled> <userPreferences> <item key="Locale"> <value xmlns:ns8="http://www.w3.org/2001/XMLSchema" xsi:type="ns8:string">en</value> </item> </userPreferences> <avgHours>0.0</avgHours> </expertParticipantGroupUsers> <expertParticipantGroupDetails> <groupID>1303</groupID> <groupName>Expert Participant Group 1 v1_T_b653ff89-3206-4f8d-add5-e38c3fc82c7e.c736b70f-b151-4099-a921-a033a2a017b3</groupName> <displayName>Expert Participant Group 1 v1</displayName> <description>Expert Participant Group 1 v1</description> </expertParticipantGroupDetails> </data> </bpm:ResponseData>
The default content type is application/json.
{ "description": "WLE Error Response", "type": "object", "properties": { "status": {"type": "string", "description": "The status of the previous API call." }, "exceptionType": {"type": "string", "description": "The classname associated with the exception." }, "errorNumber": {"type": "string", "description": "Message ID of the exception." }, "errorMessage": {"type": "string", "description": "Message text of the exception." }, "errorMessageParameters": {"type": ["string"], "optional": true, "description":"Message text parameters of the exception." }, "programmersDetails": {"type": "object", "optional": true, "description":"Additional exception details, for example, a stack trace." } } }
<?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="http://rest.bpm.ibm.com/v1/data/exception" elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://rest.bpm.ibm.com/v1/data/exception" xmlns:dat="http://rest.bpm.ibm.com/v1/data/root"> <import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root" /> <!-- This type represents an error response. --> <element name="RestRuntimeException"> <complexType> <sequence> <element name="status" type="string"/> <element name="Data" type="tns:ExceptionData"> </element> </sequence> </complexType> </element> <!-- This type contains detailed error information associated with an exception. --> <complexType name="ExceptionData"> <sequence> <element name="status" type="string"/> <!-- This specifies the java class name of the exception --> <element name="exceptionType" type="string"/> <!-- The message ID of the error message --> <element name="errorNumber" type="string" minOccurs="0"/> <!-- The complete error message --> <element name="errorMessage" type="string"/> <!-- The list of strings inserted into the error message --> <element name="errorMessageParameters" type="string" minOccurs="0" maxOccurs="unbounded"/> <!-- The stacktrace associated with the exception. Note that this will be omitted unless the "server-stacktrace-enabled" property is enabled in the server's 100Custom.xml file. --> <element name="programmersDetails" type="string"></element> <!-- Prior responses. Set if a bulk command was used --> <element name="responses" type="dat:BulkCommandResponses" minOccurs="0"></element> </sequence> </complexType> </schema>
Code | Description |
---|---|
200 OK | Success completion. |
400 Bad Request | The parameters are not valid or they are missing. |
401 Unauthorized | The caller is not authorized for this request. |
406 Not Acceptable | The requested content type or content encoding is not supported. |
500 Internal Server Error | A severe problem has occurred, programmer's details are provided. |
8.0.0
Parent Topic: Task Experts Resource