IBM Business Process Manager, Version 8.5.5

REST interface for BPD-related resources - Task Activity Stream Resource - GET Method

Retrieves an activity stream for the a process instance, as looked up by the given task ID.

Sample method invocation

GET /rest/bpm/wle/v1/social/task/{taskId}/stream[?page={integer}][&pageSize={integer}][&since={string}][&sort={string}]

Parameters

Optional parameters
NameValue TypeDescription
page integer
The page of items to return. The default is no paging. Pages start at 1. Using 0 disables paging.
pageSize integer
The number of items to return on a page. The default is 10.
since string
A filter for returning items only available since this date/time. The format is in the form of "2010-10-10T00:00:00"
sort string
The sort order.
ValueDescription
asc
Sort the list in ascending order.
desc
Sort the list in descending order

Request content

None

Response content

An Activity Stream, as described by the specifications available at http://activitystrea.ms

The default content type is application/json.

MIME type: application/json

+ View example content
{
    items:[
        {
            actor:{
                displayName:"Internal TW Admin user",
                id:"tw_admin",
                objectType:"PERSON"
            },
            content:"help me",
            object:{
                displayName:"Comment for Employee Requisition for (3) (3)",
                id:"2078.91",
                objectType:"ibm.bpm.comment"
            },
            published:"2012-01-09T16:19:05.537-05:00",
            verb:"POST"
        },
        {
            actor:{
                displayName:"System",
                id:"ibm.bpm.system",
                image:{
                    height:30,
                    width:30,
                    url:"/ProcessPortal/com/ibm/bpm/social/img/System_avatar4_30x30.png"
                },
                objectType:"SERVICE"
            },
            content:"This instance is now completed.",
            object:{
                displayName:"Employee Requisition for (3)",
                id:"2072.3",
                objectType:"ibm.bpm.instance"
            },
            published:"2012-01-09T09:58:01.520-05:00",
            verb:"POST"
        },
        {
            actor:{
                displayName:"Internal TW Admin user",
                id:"tw_admin",
                objectType:"PERSON"
            },
            content:"Internal TW Admin user completed the task titled Task: Submit requisition and associated with the Submit job requisition activity.",
            object:{
                displayName:"Task: Submit requisition",
                id:"2078.3",
                objectType:"ibm.bpm.task"
            },
            published:"2012-01-09T09:58:00.748-05:00",
            verb:"POST",
            replies:{
                items:[
                    {
                        author:{
                            displayName:"Internal TW Admin user",
                            id:"tw_admin",
                            image:{
                                height:32,
                                width:32
                            },
                            objectType:"PERSON"
                        },
                        content:"tagging Internal TW Admin user user",
                        objectType:"COMMENT",
                        published:"2012-01-09T16:18:44.743-05:00"
                    }
                ]
            }
        },
        {
            actor:{
                displayName:"System",
                id:"ibm.bpm.system",
                image:{
                    height:30,
                    width:30,
                    url:"/ProcessPortal/com/ibm/bpm/social/img/System_avatar4_30x30.png"
                },
                objectType:"SERVICE"
            },
            content:"A new task titled Task: Submit requisition has been created for Internal TW Admin user. It is for the Submit job requisition activity.",
            object:{
                displayName:"Task: Submit requisition",
                id:"2078.3",
                objectType:"ibm.bpm.task"
            },
            published:"2012-01-09T09:57:53.783-05:00",
            verb:"POST"
        },
        {
            actor:{
                displayName:"System",
                id:"ibm.bpm.system",
                image:{
                    height:30,
                    width:30,
                    url:"/ProcessPortal/com/ibm/bpm/social/img/System_avatar4_30x30.png"
                },
                objectType:"SERVICE"
            },
            content:"This instance was created and named Employee Requisition for (3). It is being orchestrated by the HR Open New Position process definition.",
            object:{
                displayName:"Employee Requisition for (3)",
                id:"2072.3",
                objectType:"ibm.bpm.instance"
            },
            published:"2012-01-09T09:57:52.900-05:00",
            verb:"POST"
        }
    ],
    totalItems:5,
    more:false
}

MIME type: application/xml


+ View schema
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://rest.bpm.ibm.com/v1/data/social"
        elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:tns="http://rest.bpm.ibm.com/v1/data/social"
        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"/>

 
    
    <!--  Start of Social  -->
    
   <simpleType name="StreamObjectType">
      <restriction base="string">
         <enumeration value="activity"/>
         <enumeration value="article"/>
         <enumeration value="badge"/>
         <enumeration value="bookmark"/>
         <enumeration value="collection"/>
         <enumeration value="comment"/>
         <enumeration value="event"/>
         <enumeration value="file"/>
         <enumeration value="group"/>
         <enumeration value="image"/>         
         <enumeration value="note"/>
         <enumeration value="person"/>
         <enumeration value="place"/>
         <enumeration value="product"/>
         <enumeration value="question"/>
         <enumeration value="review"/>
         <enumeration value="service"/>
         <enumeration value="video"/>
      </restriction>
   </simpleType>
   
   
   <simpleType name="StreamVerb">
      <restriction base="string">
         <enumeration value="post"/>
         <enumeration value="add"/>
         <enumeration value="cancel"/>
         <enumeration value="checkin"/>
         <enumeration value="delete"/>
         <enumeration value="favorite"/>
         <enumeration value="follow"/>
         <enumeration value="give"/>
         <enumeration value="ignore"/>
         <enumeration value="invite"/>         
         <enumeration value="join"/>
         <enumeration value="leave"/>
         <enumeration value="like"/>
         <enumeration value="make-friend"/>
         <enumeration value="play"/>
         <enumeration value="receive"/>
         <enumeration value="remove"/>
         <enumeration value="remove-friend"/> 
         <enumeration value="request-friend"/>  
         <enumeration value="rsvp-maybe"/>  
         <enumeration value="rsvp-no"/>  
         <enumeration value="rsvp-yes"/>  
         <enumeration value="save"/>  
         <enumeration value="share"/>  
         <enumeration value="stop-following"/>  
         <enumeration value="tag"/>  
         <enumeration value="unfavorite"/>  
         <enumeration value="unlike"/>  
         <enumeration value="unsave"/>  
         <enumeration value="update"/>                                                                                                                                              
      </restriction>
   </simpleType> 
   
    <complexType name="PostedContent">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="message" type="string"/>
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>
    
    <complexType name="PostedResult">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="posted" type="boolean"/>
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>    

    <complexType name="FollowedResult">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="followed" type="boolean"/>
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>   

    <complexType name="HelpRequest">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="instanceId" type="integer"/>
		    	<!-- MUST CONTAIN  -->
		    	<element name="sendTo" type="string"/>
		    	<!-- MUST CONTAIN  -->
		    	<element name="description" type="string"/>
		    </sequence>		    		    
	    </extension>
	</complexContent>
    </complexType> 
    
    <complexType name="HelpResult">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="valid" type="boolean"/>
		    	<!-- MUST CONTAIN  -->
		    	<element name="method" type="string"/>
		    </sequence>		    		    
	    </extension>
	</complexContent>
    </complexType>

    <complexType name="ToolbarCollapsed">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="collapsed" type="boolean"/>
		    	<!-- MUST CONTAIN  -->
		    	<element name="method" type="string"/>
		    </sequence>		    		    
	    </extension>
	</complexContent>
    </complexType>
    
    <complexType name="RequestValid">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
		    	<!-- MUST CONTAIN  -->
		    	<element name="valid" type="boolean"/>
		    	<!-- MUST CONTAIN  -->
		    	<element name="method" type="string"/>
		    </sequence>		    		    
	    </extension>
	</complexContent>
    </complexType>                
   
    <complexType name="StreamMediaLink">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
	    		<!-- MAY CONTAIN  -->
		    	<element name="duration" type="integer"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="height" type="integer"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="width" type="integer"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="url" type="string"/>
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>
    

    <complexType name="StreamObject">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
	    		<!-- MAY CONTAIN  -->
		    	<element name="attachments" type="tns:StreamObject"  minOccurs="1" maxOccurs="unbounded"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="author" type="tns:StreamObject"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="content" type="string"/>
		    	<!-- MAY/SHOULD CONTAIN  -->
		    	<element name="displayName" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="fileName" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="downstreamDuplicates" type="string"  minOccurs="1" maxOccurs="unbounded"/>
		    	<!-- SHOULD CONTAIN  -->
		    	<element name="id" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="parent" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="image" type="tns:StreamMediaLink"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="objectType" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="published" type="date"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="summary" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="updated" type="date"/>		    			    	
		    	<!-- MAY CONTAIN  -->
		    	<element name="upstreamDuplicates" type="string"  minOccurs="1" maxOccurs="unbounded"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="url" type="string"/>		    	   			    			    			    			    			    			    			    			    	
		    	<!-- MAY CONTAIN  -->
		    	<element name="processName" type="string"/>		    	   			    			    			    			    			    			    			    			    	
		    	<!-- MAY CONTAIN  -->
		    	<element name="processId" type="string"/>	
		    	<!-- MAY CONTAIN  -->
		    	<element name="taskName" type="string"/>	
		    	<!-- MAY CONTAIN  -->
		    	<element name="taskId" type="string"/>	
		    	<!-- MAY CONTAIN  -->
		    	<element name="taskText" type="string"/>	
		    </sequence>
	    </extension>
	</complexContent>
    </complexType> 
    
    
    <complexType name="StreamActivity">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
	    		<!-- MUST CONTAIN  -->
		    	<element name="actor" type="tns:StreamObject"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="content" type="string"/>
	    		<!-- MAY CONTAIN  -->
		    	<element name="generator" type="tns:StreamObject"/>
	    		<!-- MAY CONTAIN  -->
		    	<element name="icon" type="tns:StreamMediaLink"/>	
		    	<!-- SHOULD CONTAIN  -->
		    	<element name="id" type="string"/>		    	
	    		<!-- SHOULD CONTAIN  -->
		    	<element name="object" type="tns:StreamObject"/>		    	
		    	<!-- MUST CONTAIN  -->
		    	<element name="published" type="date"/>		    	
	    		<!-- MAY CONTAIN  -->
		    	<element name="provider" type="tns:StreamObject"/>			    	
	    		<!-- MAY CONTAIN  -->
		    	<element name="target" type="tns:StreamObject"/>		    	
		    	<!-- MAY CONTAIN  -->
		    	<element name="title" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="updated" type="date"/>		    			    	
		    	<!-- MAY CONTAIN  -->
		    	<element name="url" type="string"/>
		    	<!-- SHOULD CONTAIN  -->
		    	<element name="verb" type="string"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="replies" type="tns:StreamObjectCollection"/>		    	
	    		<!-- MAY CONTAIN  -->
		    	<element name="ibmbpmext" type="tns:StreamObject"/>		    			    	
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>

    <complexType name="StreamObjectCollection">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
	    		<!-- MAY CONTAIN  -->
		    	<element name="items" type="tns:StreamObject"  minOccurs="0" maxOccurs="unbounded"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="totalItems" type="integer"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="url" type="string"/>		    			    			    			    			    			    			    			    	
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>
    
    <complexType name="StreamActivityCollection">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
	    		<!-- MAY CONTAIN  -->
		    	<element name="items" type="tns:StreamActivity"  minOccurs="0" maxOccurs="unbounded"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="totalItems" type="integer"/>
		    	<!-- MAY CONTAIN  -->
		    	<element name="url" type="string"/>		    			    			    			    			    			    			    			    	
		    	<!-- MAY CONTAIN  -->
		    	<element name="more" type="boolean"/>		    			    			    			    			    			    			    			    	
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>	
    
    
   	<element name="PostedContent" type="tns:PostedContent" />
   	<element name="HelpRequest" type="tns:HelpRequest" />    	
   	<element name="PostedResult" type="tns:PostedResult" />
   	<element name="FollowedResult" type="tns:FollowedResult" />
   	<element name="HelpResult" type="tns:HelpResult" />
   	<element name="ToolbarCollapsed" type="tns:ToolbarCollapsed" />
   	<element name="RequestValid" type="tns:RequestValid" />
   	<element name="StreamMediaLink" type="tns:StreamMediaLink" />    	    	    	    	
   	<element name="StreamObject" type="tns:StreamObject" />
   	<element name="StreamActivity" type="tns:StreamActivity" />
   	<element name="StreamObjectCollection" type="tns:StreamObjectCollection" />
	<element name="StreamActivityCollection" type="tns:StreamActivityCollection" />
    	    	    	    	    	

</schema>
+ View example content
<soc:StreamActivityCollection>
	<items>
		<actor>
			<displayName>Internal TW Admin user</displayName>
			<id>tw_admin</id>
			<objectType>PERSON</objectType>
		</actor>
		<content>help me</content>
		<object>
			<displayName>Comment for Employee Requisition for (3) (3)
			</displayName>
			<id>2078.91</id>
			<objectType>ibm.bpm.comment</objectType>
		</object>
		<published>2012-01-09-05:00</published>
		<verb>POST</verb>
	</items>
	<items>
		<actor>
			<displayName>System</displayName>
			<id>ibm.bpm.system</id>
			<image>
				<height>30</height>
				<width>30</width>
				<url>/ProcessPortal/com/ibm/bpm/social/img/System_avatar4_30x30.png
				</url>
			</image>
			<objectType>SERVICE</objectType>
		</actor>
		<content>This instance is now completed.</content>
		<object>
			<displayName>Employee Requisition for (3)</displayName>
			<id>2072.3</id>
			<objectType>ibm.bpm.instance</objectType>
		</object>
		<published>2012-01-09-05:00</published>
		<verb>POST</verb>
	</items>
	<items>
		<actor>
			<displayName>Internal TW Admin user</displayName>
			<id>tw_admin</id>
			<objectType>PERSON</objectType>
		</actor>
		<content>
			<span class=proper-noun>Internal TW Admin user</span>
			completed the task titled
			<span class=proper-noun>Task: Submit requisition</span>
			and associated with the
			<span class=proper-noun>Submit job requisition</span>
			activity.
		</content>
		<object>
			<displayName>Task: Submit requisition</displayName>
			<id>2078.3</id>
			<objectType>ibm.bpm.task</objectType>
		</object>
		<published>2012-01-09-05:00</published>
		<verb>POST</verb>
		<replies>
			<items>
				<author>
					<displayName>Internal TW Admin user</displayName>
					<id>tw_admin</id>
					<image>
						<height>32</height>
						<width>32</width>
					</image>
					<objectType>PERSON</objectType>
				</author>
				<content>
					tagging
					<span class="bpm-user-tag">Internal TW Admin user</span>
					user
				</content>
				<objectType>COMMENT</objectType>
				<published>2012-01-09-05:00</published>
			</items>
		</replies>
	</items>
	<items>
		<actor>
			<displayName>System</displayName>
			<id>ibm.bpm.system</id>
			<image>
				<height>30</height>
				<width>30</width>
				<url>/ProcessPortal/com/ibm/bpm/social/img/System_avatar4_30x30.png
				</url>
			</image>
			<objectType>SERVICE</objectType>
		</actor>
		<content>
			A new task titled
			<span class=proper-noun>Task: Submit requisition</span>
			has been created for
			<span class=proper-noun>Internal TW Admin user</span>
			. It is for the
			<span class=proper-noun>Submit job requisition</span>
			activity.
		</content>
		<object>
			<displayName>Task: Submit requisition</displayName>
			<id>2078.3</id>
			<objectType>ibm.bpm.task</objectType>
		</object>
		<published>2012-01-09-05:00</published>
		<verb>POST</verb>
	</items>
	<items>
		<actor>
			<displayName>System</displayName>
			<id>ibm.bpm.system</id>
			<image>
				<height>30</height>
				<width>30</width>
				<url>/ProcessPortal/com/ibm/bpm/social/img/System_avatar4_30x30.png
				</url>
			</image>
			<objectType>SERVICE</objectType>
		</actor>
		<content>
			This instance was created and named
			<span class=proper-noun>Employee Requisition for (3)</span>
			. It is being orchestrated by the
			<span class=proper-noun>HR Open New Position</span>
			process definition.
		</content>
		<object>
			<displayName>Employee Requisition for (3)</displayName>
			<id>2072.3</id>
			<objectType>ibm.bpm.instance</objectType>
		</object>
		<published>2012-01-09-05:00</published>
		<verb>POST</verb>
	</items>
	<totalItems>5</totalItems>
	<more>false</more>
</soc:StreamActivityCollection>

MIME type: application/x-javascript

Error Response content

Detailed error information.

The default content type is application/json.

MIME type: application/json


+ View schema
{  "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."
      }
   }
} 

MIME type: application/xml


+ View schema
<?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>

MIME type: application/x-javascript

Status codes

The method returns one of the following status codes:
CodeDescription
200 OKSuccess completion.
400 Bad RequestThe parameters are not valid or they are missing.
404 Not Found
The task does not exist, or is not associate with a valid instance.
406 Not AcceptableThe requested content type or content encoding is not supported.
500 Internal Server ErrorA severe problem has occurred, programmer's details are provided.

Available since

8.0.0

Parent Topic: Task Activity Stream Resource