Get the Subcommunities feed 

Get a list of subcommunities associated with a community.

Table 1. Atom API request details

Resource Description
Available from the href attribute of the <link> element associated with the community of interest that has a rel="http://www.ibm.com/xmlns/prod/sn/subcommunities" attribute value in the My Communities collection. A feed of subcommunities.

Use one or more of the input parameters to narrow the search. Separate multiple parameters with an ampersand (&).

Table 2. Input parameters

Parameter Description
asc Specifies whether the results should be displayed in ascending order. Options are true or false. This parameter is ignored if the sortOrder parameter is provided.
page Page number. Specifies the page to be returned. The default is 1.
ps Page size. Specify the number of entries to return per page.
since Includes in the resulting feed all communities updated after a specified date. Specify the date using a date-time value that conforms to RFC3339. Use an upper case "T" to separate the date and time, and an uppercase "Z" in the absence of a numeric time zone offset. For example: 2009-01-04T20:32:31.171Z.
sortBy Specifies the characteristic by which to sort the results. Options are:
modified

    Sorts the results by last modified date.

popularity

    Sorts the results by popularity.

title

    Sorts the results by title element value.

The default value of this parameter is modified.

sortOrder Specifies the order in which to display the results. Options are:

  • asc. Ascending order

  • desc. Descending order

The default value of this parameter is desc.

sortField Specifies the characteristic by which to sort the results. Options are:
count

    Sorts the results by relevance.

lastmod

    Sorts the results by last modified date.

name

    Sorts the results by entry name.

This parameter is ignored if the sortBy parameter is provided.


Example

<feed> <id> https://enterprise.example.com/communities/service/atom/community/subcommunities? communityUuid=055f503b-454b-4f30-8ba7-b21b6e2a77a7 </id> <updated>2010-09-14T21:28:32.500Z</updated> <title type="text">Day Care - Subcommunities</title> <link href="https://enterprise.example.com/communities/service/html/allcommunities" rel="alternate"/> <generator uri="http://www.ibm.com/xmlns/prod/sn" version="3.0.1.0"> IBM Connections - Communities </generator> <opensearch:totalResults>1</opensearch:totalResults> <opensearch:startIndex>1</opensearch:startIndex> <opensearch:itemsPerPage>10</opensearch:itemsPerPage> <link href="https://enterprise.example.com/communities/service/atom/community/subcommunities? communityUuid=055f503b-454b-4f30-8ba7-b21b6e2a77a7" rel="self"/> <link href="https://enterprise.example.com/communities/service/atom/service" rel="http://www.ibm.com/xmlns/prod/sn/service" type="application/atomsvc+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/subcommunities? communityUuid=055f503b-454b-4f30-8ba7-b21b6e2a77a7&outputType=categories" rel="http://www.ibm.com/xmlns/prod/sn/tag-cloud" type="application/atomcat+xml"/> <entry> <id> http://communities.ibm.com:2006/service/atom/community/instance?communityUuid= 9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b </id> <title type="text">Massachusetts area</title> <summary type="text"> Share information and resources about day care options in the Massachusetts area. </summary> <content type="html"/> <published>2010-09-14T21:23:55.981Z</published> <author> <name>Sally Mar</name> <email>smar@example.com</email> <snx:userid>50730340-0101-102e-88e1-f78755f7e0ed</snx:userid> <snx:userState>active</snx:userState> </author> <updated>2010-09-14T21:23:56.047Z</updated> <contributor> <name>Sally Mar</name> <email>smar@example.com</email> <snx:userid>50730340-0101-102e-88e1-f78755f7e0ed</snx:userid> <snx:userState>active</snx:userState> </contributor> <category term="community" scheme="http://www.ibm.com/xmlns/prod/sn/type"/> <link href="https://enterprise.example.com/communities/service/atom/community/instance? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="self"/> <link href="https://enterprise.example.com/communities/service/atom/community/instance? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="edit"/> <link href="https://enterprise.example.com/communities/service/html/communityview? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="alternate" type="text/html"/> <link href="https://enterprise.example.com/communities/service/html/image? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b&lastMod=1284499436047" rel="http://www.ibm.com/xmlns/prod/sn/logo"/> <link href="https://enterprise.example.com/communities/service/atom/community/service? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/service" type="application/atomsvc+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/members? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/member-list" type="application/atom+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/bookmarks? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/bookmarks" type="application/atom+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/feeds? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/feeds" type="application/atom+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/ remoteApplications?communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/remote-applications" type="application/atom+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/forum/topics? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/forum-topics" type="application/atom+xml"/> <link href="https://enterprise.example.com/communities/service/atom/community/invites? communityUuid=9dc395ef-bcc3-4cc8-88c5-18fa1aa91d4b" rel="http://www.ibm.com/xmlns/prod/sn/invitations-list" type="application/atom+xml"/> <snx:membercount>2</snx:membercount> <snx:communityType>public</snx:communityType> <snx:handle>ma</snx:handle> <link href="https://enterprise.example.com/communities/service/atom/community/instance? communityUuid=055f503b-454b-4f30-8ba7-b21b6e2a77a7" rel="http://www.ibm.com/xmlns/prod/sn/parentcommunity" type="application/atom+xml"/> </entry> </feed>


Parent topic

Getting Communities feeds

Related reference
Retrieve a subcommunity


   

 

});