Community articleSearching for a person's direct reports
Added by IBM contributorIBM on April 3, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieve the profiles of the people who report to a specific user.



Retrieve the profiles of the people who report to a specific user.

The content element of each returned entry includes the vcard information for the person being represented by the entry.

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

Input
Method URI Description
GET /profiles/atom/peopleManaged.do Retrieves the profiles of the people managed by a specific user.
Name Type Optional Description
email
string Yes Internet email address of the user whose direct reports you are interested in.
Format the HTTP request using the proper URL encoding. For example, the encoded form of the @ symbol is %40 as in:
adam_eventide%40garden.com
Note: Do not use this parameter if IBM® Connections is configured to prevent email addresses from being displayed. It will return an error code 400 for an invalid request. Use the key or userid parameters instead.
format
enumerated Yes Specifies whether you want a full profile or partial profile to be returned. Options are lite or full. The default value is lite.
Authorized values:
  • lite
  • full
inclUserStatus
boolean Yes Indicates whether or not to include the status message from the message board of each colleague represented in the returned feed. This parameter accepts the values of true or false.
key
string Yes An ID generated by Profiles to identify a person.
Note: A user's key value is contained in the element with a class attribute value of x-profile-key in the user's profile feed. You can access a user's feed by searching all profiles by name, which returns information you can then use to retrieve the person's feed.
output
enumerated Yes Controls the output type of the Profiles entry content element. Options are:
hcard
Produces content according to the xhtml/vcard microformat specification. hcard content is in XML format which means it can be addressed by XPath. This value is the default option.
vcard
Produces content according to the VCARD 2.1 standard. vcard content is text based, but more compact. This output format specifies the rel="edit" link element for each profile. Use this format if you want to update a profile.
Authorized values:
  • hcard
  • vcard
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
ps
int Yes Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 250.
userid
string Yes Unique ID that represents a specific person. This value is specified in the <snx:userid> element.
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the request was received successfully.
Examples
To get profiles of all the people who report to the user with the user ID 9bf4efz0-8j0y-1028-8b5a-xc07163b51b2:
> GET /profiles/atom/peopleManaged.do?userid=9bf4efz0-8j0y-1028-8b5a-xc07163b51b2

	HTTP/1.1

	> Authorization: Basic ...

	> Host: profiles.enterprise.example.com:9447

	> Accept: */*


Response returned by the server
<?xml version="1.0" encoding="UTF-8"?>

	<feed xmlns="http://www.w3.org/2005/Atom">

	<id>tag:profiles.ibm.com,2006:feed</id>

	<generator version="3.0" uri="http://www.ibm.com/xmlns/prod/sn">

	IBM Connections - Profiles

	</generator>

	<title type="text">people managed by Amy Jones5</title>

	<author>

	<name>IBM Connections - Profiles</name>

	</author>

	<updated>2009-03-18T19:46:48.031Z</updated>

	<opensearch:totalResults

	xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">

	32

	</opensearch:totalResults>

	<fh:complete xmlns:fh="http://purl.org/syndication/history/1.0">

	</fh:complete>

	<link

	href="https://profiles.enterprise.example.com:9447/profiles/atom/

	peopleManaged.do?email=ajones5%40us.example.com"

	rel="self"

	type="application/atom+xml">

	</link>

	<entry>

	<id>tag:profiles.ibm.com,2006:entry9bf4efz0-8j0y-1028-8b5a-xc07163b51b2</id>

	<title type="text">Amy Jones115</title>

	<updated>2009-03-18T08:12:51.140Z</updated>

	<category

	term="profile"

	scheme="http://www.ibm.com/xmlns/prod/sn/type">

	</category>

	<contributor>

	<name>Amy Jones115</name>

	<userid xmlns="http://www.ibm.com/xmlns/prod/sn">

	633833c0-7d67-102c-8534-e2ebc3ec5536

	</userid>

	<email>ajones115@us.example.com</email>

	</contributor>

	<link

	href="https://profiles.enterprise.example.com:9447/profiles/html/

	profileView.do?key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd"

	rel="related"

	type="text/html">

	</link>

	<link

	href="https://profiles.enterprise.example.com:9447/profiles/photo.do?

	key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd&amp;lastMod=1237363971140"

	rel="http://www.ibm.com/xmlns/prod/sn/image"

	type="image">

	</link>

	<link

	href="https://profiles.enterprise.example.com:9447/profiles/audio.do?

	key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd&amp;lastMod=1237363971140"

	rel="http://www.ibm.com/xmlns/prod/sn/pronunciation"

	type="audio">

	</link>

	<link

	href="https://profiles.enterprise.example.com:9447/profiles/vcard/profile.do?

	key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd"

	rel="alternate"

	type="text/directory">

	</link>

	<summary type="text">

	Profile information for Amy Jones115

	</summary>

	<content type="xhtml">

	<div xmlns="http://www.w3.org/1999/xhtml">

	<span class="vcard">

	<div>

	<img

	src="https://profiles.enterprise.example.com:9447/profiles/photo.do?

	key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd&amp;lastMod=1237363971140"

	class="photo">

	</img>

	</div>

	<div>

	<a

	class="fn url"

	href="https://profiles.enterprise.example.com:9447/profiles/atom/

	profile.do?key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd">

	Amy Jones115

	</a>

	</div>

	<div>

	<a

	class="sound url"

	href="https://profiles.enterprise.example.com:9447/profiles/audio.do?

	key=f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd&amp;lastMod=1237363971140">

	Pronunciation

	</a>

	</div>

	<div>

	<a

	class="email"

	href="mailto:ajones115@us.example.com">ajones115@us.example.com

	</a>

	</div>

	<div class="x-groupwareMail" style="display:none"></div>

	<div class="org"><span class="organization-unit"></span></div>

	<div class="role">IBM Employee</div>

	<div class="title"></div>

	<div class="adr work postal">

	<div class="street-address">5 Technology Park Drive</div>

	<div class="extended-address x-streetAddress2"></div>

	<span class="locality">Westford</span>

	<span class="region">Massachusetts</span>

	<span class="postal-code">01886</span>

	<div class="country-name">United States</div>

	<div class="x-country-code" style="display:none">us</div>

	<div class="x-worklocation-code" style="display:none">WM</div>

	</div>

	<div class="x-office">

	<span class="x-building"></span>

	<span class="x-floor"></span>

	<span class="x-office-number"></span>

	</div>

	<div class="tel">

	<abbr class="type" title="work">Work:</abbr>

	<span class="value">1-978-399-0000</span>

	</div>

	<div class="x-manager-uid" style="display:none">Amy Jones5</div>

	<div class="x-is-manager" style="display:none"></div>

	<div class="x-profile-key">f4c4ab81-e5c8-4585-8dcb-3d33b98ef1cd</div>

	<div class="uid">633833c0-7d67-102c-8534-e2ebc3ec5536</div>

	<div class="x-profile-uid">Amy Jones115</div>

	<div class="x-lconn-userid">633833c0-7d67-102c-8534-e2ebc3ec5536</div>

	<div class="rev" style="display:none">2009-03-18T08:12:51.140Z</div>

	</span>

	</div>

	</content>

	</entry>

	<entry>

	...

	</entry>

	</feed>