Activity Stream Search provides the ability to follow a "topic", which is either a word or a term that contains several words. This topic will then be identified in the text of public events, and these events will be delivered to the personal stream of whoever followed the topic (BUT only when this stream is delivered using the search index, as the DB flow does not consider followed topics).
Following/un-following a topic, or getting a list of followed topics, is done via the standard Connections Following API - /news/follow/atom/resources . For topics, we are adding a new source called topics and a new resource type called topic.
Valid topics to follow
For performance reasons, not any topic may be followed.
Trying to follow an invalid topic will result in an HTTP Bad Request error (status code 400).
A valid topic satisfies the following rules:
- Does not start with a whitespace character
- After every special character (e.g. #, &, !) there is a normal word.
- Contains no more than 3 words
Examples of valid topics:
- Lotus Connections
Examples of invalid topics:
- Lotus Connections Version 4.5
||Follow a topic
||Un-follow a topic
||Get a list of followed topics
<category term="resource-follow" scheme="http://www.ibm.com/xmlns/prod/sn/type"></category>
<category term="topics" scheme="http://www.ibm.com/xmlns/prod/sn/source"></category>
<category term="topic" scheme="http://www.ibm.com/xmlns/prod/sn/resource-type"></category>
<category term="my_topic" scheme="http://www.ibm.com/xmlns/prod/sn/resource-id"></category>
||ID of topic entry
||Name of topic entry.