Searching for a user's profile
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 16, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieve a feed that contains a specific user's profile.
This method returns a feed of profile as opposed to retrieving the Atom entry of the profile. If you want to retrieve an Atom entry document, see Retrieving a profile entry. The content element of each returned entry includes the vcard information for the person being represented by the entry. In addition, it provides a list of the fully qualified URLs for each IBM® Connections application link displayed in the business card.

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/profile.do Retrieves a user's profile.
Name Type Optional Description
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
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 the profile. Use this format if you want to update a profile.
Authorized values:
  • hcard
  • vcard
userid
string Yes Unique ID that represents a specific person. This value is specified in the <snx:userid> element.
Alternately, you can retrieve a set of profiles for multiple users. To do so, provide multiple user IDs, each separated by a comma.
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the request was received successfully.
Examples
To search for the profile of a user with the user ID 9bf4efz0-8j0y-1028-8b5a-xc07163b51b2:
> GET /profiles/atom/profile.do?userid=9bf4efz0-8j0y-1028-8b5a-xc07163b51b2

	HTTP/1.1

	> Authorization: ...

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

	> Accept: */*


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

	<feed

	xmlns:app="http://www.w3.org/2007/app"

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

	xmlns:thr="http://purl.org/syndication/thread/1.0"

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

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

	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">profile with userid 50730340-0101-102e-88e1-f78755f7e0ed</title>

	<author>

	<name>IBM Connections - Profiles</name>

	</author>

	<updated>2010-06-04T17:27:21.655Z</updated>

	<fh:complete></fh:complete>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/profileTags.do?targetKey=

	f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010"

	rel="http://www.ibm.com/xmlns/prod/sn/tag-cloud"

	type="application/atomcat+xml">

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/mv/theboard/entries.do?key=

	f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010"

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

	type="application/atom+xml">

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/mv/theboard/entry/status.do?

	key=f45c57c0-4165-43a4-94ba-cf35034074dc"

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

	type="application/atom+xml">

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/connections.do?connectionType=

	colleague&amp;key=f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010"

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

	type="application/atom+xml">

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/reportingChain.do?key=

	f45c57c0-4165-43a4-94ba-cf35034074dc"

	rel="http://www.ibm.com/xmlns/prod/sn/reporting-chain"

	type="application/atom+xml">

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/profileExtension.do?key=

	f45c57c0-4165-43a4-94ba-cf35034074dc&amp;extensionId=profileLinks&amp;lastMod=

	1275588983010"

	rel="http://www.ibm.com/xmlns/prod/sn/ext-attr"

	type="text/xml"

	snx:extensionId="profileLinks"

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

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/profile.do?userid=

	50730340-0101-102e-88e1-f78755f7e0ed"

	rel="self"

	type="application/atom+xml">

	</link>

	<entry>

	<id>tag:profiles.ibm.com,2006:entryf45c57c0-4165-43a4-94ba-cf35034074dc</id>

	<title type="text">Sam Smith</title>

	<updated>2010-06-03T18:16:23.010Z</updated>

	<category term="profile" scheme="http://www.ibm.com/xmlns/prod/sn/type"></category>

	<contributor>

	<name>Sam Smith</name>

	<snx:userid>50730340-0101-102e-88e1-f78755f7e0ed</snx:userid>

	<snx:userState>active</snx:userState>

	</contributor>

	<link

	href="https://profiles.enterprise.example.com/profiles/atom/profileEntry.do?key=

	f45c57c0-4165-43a4-94ba-cf35034074dc"

	rel="self"

	type="application/atom+xml">

	</link>

	<link

	href="https://profiles.enterprise.example.com/profiles/html/profileView.do?key=

	f45c57c0-4165-43a4-94ba-cf35034074dc"

	rel="related"

	type="text/html">

	</link>

	<link

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

	f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010"

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

	type="image">

	</link>

	<link

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

	key=f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010"

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

	type="audio">

	</link>

	<link

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

	f45c57c0-4165-43a4-94ba-cf35034074dc"

	rel="alternate"

	type="text/directory">

	</link>

	<summary type="text">Profile information for Sam Smith</summary>

	<content type="xhtml">

	<sp_0:div

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

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

	<span class="vcard">

	<div>

	<img

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

	f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010"

	class="photo">

	</img>

	</div>

	<div>

	<a

	class="fn url"

	href="https://profiles.enterprise.example.com/profiles/atom/profile.do?key=

	f45c57c0-4165-43a4-94ba-cf35034074dc">

	Sam Smith

	</a>

	</div>

	<div>

	<a

	class="sound url"

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

	f45c57c0-4165-43a4-94ba-cf35034074dc&amp;lastMod=1275588983010">

	Pronunciation

	</a>

	</div>

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

	</div>

	<div class="org">

	<span class="organization-unit">

	Example Corp. Software Group

	</span>

	</div>

	<div class="role">Example Corp. Employee</div>

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

	<div class="adr work postal">

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

	</div>

	<div class="x-office">

	<span class="x-building">test1</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"></span>

	</div>

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

	Jane Doe

	</div>

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

	<div class="x-profile-key">f45c57c0-4165-43a4-94ba-cf35034074dc</div>

	<div class="uid">50730340-0101-102e-88e1-f78755f7e0ed</div>

	<div class="x-profile-uid">Sam Smith</div>

	<div class="x-lconn-userid">50730340-0101-102e-88e1-f78755f7e0ed</div>

	<div class="rev" style="display:none">2010-06-03T18:16:23.010Z</div>

	<div class="x-profile-type" style="display:none">default</div>

	</span>

	</sp_0:div>

	</content>

	</entry>

	</feed>