Display Activity Streams from the Social Business Toolkit in XPages

The IBM Social Business Toolkit is a new cross-product integration with the Lotus Social Business portfolio and extensibility toolkit for developers. The initial version provides an activity stream which is a federated list of items from various sources.

There is an REST API test application available on Greenhouse that can be used to see which data is returned and it can be used to create new items in the activity stream. There is also a sample user interface available for the activity stream demonstrating the embedded experience. Furthermore there is a Connections instance on Greenhouse that puts updates, e.g. status updates, new forum creations, etc. into the activity stream.

The activity stream can be accessed via REST APIs. Before you can invoke REST APIs you need to be authenticated via OAuth what I blogged about last week.

For the REST calls XPages provides built-in utilities (though not documented I think). I published on OpenNTF a sample showing how to write custom REST services generating JSON. The same package “com.ibm.commons.util.io.json.*” contains classes like JsonJavaObject, JsonJavaFactory and JsonParser to parse JSON in Java which I needed for this sample.

This video demonstrates the whole flow. There are also bigger screenshots.

Here is a screenshot of the API test page displaying the stream as JSON:

This screenshot shows the same data in the sample user interface on Greenhouse:

And the last screenshot shows the activity stream displayed in an XPage:

That same functionality can also be used to put items in the activity stream from XPages.

If you want to try this yourselves you might run into an issue that I’ve seen from time to time with OAuth where the Greenhouse doesn’t respond correctly to requests. In this case you need to revoke access for your user on the same page where you registered your app.

I hope to be able to publish this sample on OpenNTF soon.