The atom:category elements contained within an atom:entry element convey information about the categories associated with that entry. This article explains the categories used in Search API responses.
There are four categorization schemes explicitly used by Search:
- http://www.ibm.com/xmlns/prod/sn/accesscontrolled which will be referred to, for convenience, as the "AccessControlled" category in this article
- http://www.ibm.com/xmlns/prod/sn/component which will be referred to, for convenience, as the "Component" category in this article
- http://www.ibm.com/xmlns/prod/sn/doctype which will be referred to, for convenience, as the "DocType" category in this article
- http://www.ibm.com/xmlns/prod/sn/type which will be referred to, for convenience, as the "Type" category in this article
The case in which a categorization scheme is not specified by Search will be referred to as the "Tag" category in this article.
The AccessControlled category represents the access control category the search result is associated with. There are two possible values for the term attribute:
The component category represents the 'Source' facet of the facets taxonomy the search result is associated with. The possible term attribute values include:
Possible term attribute values also include all of the above list with the prefix of "communities:" except for communities, communities:bookmark, communities:feed, communities:entry, dogear and profiles.
Each of the above term attribute values can be used as the value of a scope parameter request to the Search API
. They can also be used as a category path, after the appropriate transformation (replace the separator ":" with "/" and prefix with "Source/"), in the values attribute of a constraint
. Some examples:
The DocType category represents the 'DocType' taxonomy categories the search result is associated with.
The Tag category represents what tags the search result is associated with. The term attribute value of the category element specifies the relevant tag.
The Type category element will always have a term attribute value of "search" in a Search API