Documentation sur les intégrations

Service de gestion de personnel (SGP)

Ce service gère les comptes des utilisateurs Brightspace.

Opérations mises en œuvre

deletePerson
replacePerson
readPerson

Prénom et nom de famille préférés

Les clients dotés de LIS 2.0 peuvent inclure et conserver les noms préférés des utilisateurs au moyen de balises XML dans une intégration LIS. Les règles suivantes s’appliquent lorsque IPSIS permet au SIS de remplacer les noms préférés dans Brightspace :

Si le prénom préféré indiqué dans le service LIS est vide pour un utilisateur ayant un prénom préféré dans Brightspace, le prénom préféré est supprimé.
Si le nom de famille préféré indiqué dans le service LIS est vide pour un utilisateur qui comprend un nom de famille préféré dans Brightspace, le nom de famille préféré est supprimé.
Si la section nom préféré dans le service LIS indique seulement le nom de famille préféré, le prénom préféré ne change pas et le nom de famille préféré est mis à jour.
Si la section nom préféré dans le service LIS indique seulement le prénom préféré est indiqué, le nom de famille préféré ne change pas et le prénom préféré est mis à jour.
Lorsque la section Nom Préféré est absente de la requête, le prénom et le nom de famille préférés sont supprimés.
Si la section Nom Préféré est présente dans le service LIS et que les deux noms sont présents, le prénom et nom de famille sont remplacés.

À propos de l’opération deletePerson

L’opération deletePerson supprime des utilisateurs de Brightspace.

Flux de traitement : deletePerson

L’adaptateur obtient l’ID utilisateur unique à partir du champ sourcedId de la demande.
Les gestionnaires configurés pour IDeleteUserHandler traitent la demande.
La réponse du LIS est ensuite générée depuis le gestionnaire de réponse.

Exemple de requête deletePerson

				<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
				xmlns:ims="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0">
				<soapenv:Header>
				<ims:imsx_syncRequestHeaderInfo>
				<ims:imsx_version>V1.0</ims:imsx_version>
				<ims:imsx_messageIdentifier>1234</ims:imsx_messageIdentifier>
				</ims:imsx_syncRequestHeaderInfo>
				</soapenv:Header>
				<soapenv:Body>
				<ims:deletePersonRequest>
				<ims:sourcedId>Demo_User</ims:sourcedId>
				</ims:deletePersonRequest>
				</soapenv:Body>
				</soapenv:Envelope>

Exemple de réponse deletePerson

				<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
				<s:Header>
				<h:imsx_syncResponseHeaderInfo
				xmlns:h="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0"
				xmlns="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xmlns:xsd="http://www.w3.org/2001/XMLSchema">
				<imsx_version>V1.0</imsx_version>
				<imsx_messageIdentifier>PMS_deletePerson_20120120T191434_9913552Z</imsx_messageIdentifier>
				<imsx_statusInfo>
				<imsx_codeMajor>success</imsx_codeMajor>
				<imsx_severity>status</imsx_severity>
				<imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>
				<imsx_description/>
				<imsx_codeMinor>
				<imsx_codeMinorField>
				<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
				<imsx_codeMinorFieldValue>fullsuccess</imsx_codeMinorFieldValue>
				</imsx_codeMinorField>
				</imsx_codeMinor>
				</imsx_statusInfo>
				</h:imsx_syncResponseHeaderInfo>
				</s:Header>
				<s:Body/>
				</s:Envelope>

À propos de l’opération replacePerson

L’opération replacePerson crée ou met à jour des utilisateurs de Brightspace.

Flux de traitement : replacePerson

La demande est traduite à l’aide de traducteurs ITranslatePerson.
Les gestionnaires configurés pour IReplaceUserHandler traitent la demande.
Une réponse est générée par le gestionnaire sélectionné.

Exemple de requête readPerson

				<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
				xmlns:ims="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0">
				<soapenv:Header>
				<ims:imsx_syncRequestHeaderInfo>
				<ims:imsx_version>1.0</ims:imsx_version>
				<ims:imsx_messageIdentifier>1234567</ims:imsx_messageIdentifier>
				</ims:imsx_syncRequestHeaderInfo>
				</soapenv:Header>
				<soapenv:Body>
				<ims:readPersonRequest>
				<ims:sourcedId>Demo_User</ims:sourcedId>
				</ims:readPersonRequest>
				</soapenv:Body>
				</soapenv:Envelope>