Update profile entries 

To update your profile entry, send an updated profile entry document in Atom format to the existing profile's edit web address.

All existing profile entry information is replaced with the new data. To avoid deleting all existing data, retrieve any data you want to retain first, and send it back with this request. For example, if you want to add a new tag to a profile entry, retrieve the existing tags, and send them all back with the new tag in the update request. See Retrieve a profile entry for more information.

To find out which fields in a particular profile can be edited, look for the list of <editableField> elements in the service document of the person whose profile you want to edit. You cannot programmatically change which fields can be edited; that can only be done using wsadmin commands. See Customize the Profiles user interface for more details. However, you can change the values stored in the editable fields for a profile by specifying new values for the editable fields represented as corresponding vCard values.

In addition to the default set of fields available for a profile that can be configured as editable by the administrator, the administrator can also add custom fields to a profile. Custom fields are added using extensions; see Add custom extension attributes for Profiles for more details. For information about how to edit the value of a custom field, see Work with profile extensions.

To get the rel="edit" link for a specific person's profile, retrieve a feed of the profile and specify the output=vcard parameter on the request. See Search a user's profile for more details.

Users can only update their own profiles. See Authenticating requests for information about how to authenticate the request.

Table 1. Atom API request details

Method Resource URI Input representation
PUT profile Value of the href attribute of the <link rel="edit"> element of the user's profile entry.. profile


Input

Provide a profile entry Atom entry document as the PUT data. The content type of the Atom entry document must be application/atom+xml.The content element of the profile entry must contain a vCard representation of the profile, and the type attribute must be set to text.

Use the following table as a guideline of the vCard values that represent editable profile fields:

Table 2. vCard values to use to represent new values for profile fields

<editablefield> element name vCard value
alternateLastname X_ALTERNATE_LAST_NAME
bldgId X_BUILDING
blogUrl X_BLOG_URL;VALUE
countryCode X_COUNTRY_CODE
courtesyTitle HONORIFIC_PREFIX
deptNumber X_DEPARTMENT_NUMBER
description X_DESCRIPTION
displayName FN
email EMAIL;INTERNET
employeeNumber X_EMPLOYEE_NUMBER
employeeTypeCode X_EMPTYPE
employeeTypeDesc ROLE
experience X_EXPERIENCE
faxNumber TEL;FAX
floor X_FLOOR
groupwareEmail EMAIL;X_GROUPWARE_MAIL
guid UID
ipTelephoneNumber TEL;X_IP and TEL;PAGER*
isManager X_IS_MANAGER
jobResp TITLE
lastUpdate REV
managerUid X_MANAGER_UID
mobileNumber TEL;CELL
nativeFirstName X_NATIVE_FIRST_NAME
nativeLastName X_NATIVE_:LAST_NAME
officeName X_OFFICE_NUMBER
organizationTitle ORG
orgId X_ORGANIZATION_CODE
pagerId X_PAGER_ID
pagerServiceProvider X_PAGER_PROVIDER
pagerType X_PAGER_TYPE
preferredFirstName NICKNAME
preferredLanguage X_PREFERRED_LANGUAGE
preferredLastName X_PREFERRED_LAST_NAME
telephoneNumber TEL;WORK
timezone TZ
uid X_PROFILE_UID
URL* X_BLOG_URL;VALUE
workLocation ADR;WORK
workLocationCode X_WORKLOCATION_CODE


Output

None.

Returned HTTP headers

HTTP/1.1 200 OK

Errors


Parent topic

Work with profiles

Related concepts
Work with profile extensions


Related tasks


Customize the Profiles user interface

Related reference
Retrieve a profile entry
Search for a user's profile
Profile entry content
Retrieve the Profiles service document

+

Search Tips   |   Advanced Search