About the Person Management Service (PMS)

This service is used to affect Brightspace Learning Environment user accounts.

Implemented operations

• deletePerson
• replacePerson
• readPerson

 

Preferred First and Last Names

Clients using LIS 2.0 can include and maintain users preferred names using XML tags in an LIS integration. Below are the rules that IPSIS follows when the SIS is allowed to overwrite a user’s preferred names in Brightspace:

• If LIS has an empty preferred first name for a user who has a preferred first name in Brightspace, delete preferred first name.
• If LIS has an empty preferred last name for a user who has a preferred last name in Brightspace, delete preferred last name.
• If LIS has the preferred name block, and it only includes preferred last name, do nothing with preferred first name and update preferred last name in Brightspace.
• If LIS has the preferred name block, and it only includes preferred first name, do nothing with preferred last name and updated preferred first name in Brightspace.
• When the Preferred Name block is missing from the request, delete the first and last preferred names.
• If LIS has the preferred name block and first and last name is present, overwrite preferred first or last name in Brightspace.

Note: The Preferred NameType contains the preferred name information of a user, and may be sent alongside the rest of the name and partname as part of a Person object.

 

For clients using IPSIS V1.0:

• PersonRequestPreferredFirstAndLastNameOptionalTranslator can go anywhere in the list.
• ReplaceUserPreferredFirstNameNoUpdateHandler and ReplaceUserPreferredLastNameNoUpdateHandler must go before ReplaceUserSaveLMSHandler