Documentation administrateur

Utilisation de l'intégration d'IPSIS LIS 2.0 avec Brightspace pour les parents et les tuteurs

Assurez-vous de disposer d’une stratégie vous permettant de définir une valeur SourceId unique pour les parents dans Brightspace puisque le fichier user-relationship assure la mise en correspondance des valeurs SourceId uniques entre parents et enfants. Lorsque vous envoyez des requêtes replacePerson pour créer des utilisateurs, assurez-vous de transmettre l’information d’ID source de parent dans la section Agent de la requête pour les enfants/élèves. Cela crée la relation entre le parent et l’enfant.

Cinq nouveaux plugiciels ont été ajoutés à l’adaptateur IPSIS LIS 2.0 afin d’aider à créer et à supprimer des relations parents-enfants. Les plugiciels sont automatiquement définis :

IReplaceUserHandler Interface ParentPortalUpdateRelationshipHandler
IDeleteUserHandler Interface ParentPortalDeleteRelationshipHandler
IDeleteUserHandler Interface DeleteUserRemoveRelationshipsHandler
ITranslatePerson Interface PersonRequestAgentsTranslator
ITranslateReadPersonResponse Interface ReadUserAgentsTranslator

ParentPortalCreateRelationshipHandler

Le gestionnaire ParentPortalUpdateRelationshipHandler crée et actualise implicitement les relations entre les parents et les apprenants (enfants).

Mise en œuvre

D2L.Integration.ParentPortal.IPSIS.RequestAdapters.ParentPortalUpdateRelationshipHandler,D2L.Integration.ParentPortal.IPSIS

Comportement prévu

Ce gestionnaire effectue les tâches suivantes :

Crée et actualise implicitement des relations parent-enfant pour un apprenant en fonction du champ d’agent pour une requête de remplacement d’utilisateur.

Synchronise les relations d’un utilisateur lorsque le champ d’extension SynchronizeRelationships est spécifié. L’apprenant reste dans le système, mais ses relations sont supprimées.

Comportement en cas d’erreur

Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.

Note de configuration

Ce gestionnaire devrait être placé après les gestionnaires de remplacement.

DeleteUserRemoveRelationshipsHandler

Le gestionnaire DeleteUserRemoveRelationshipsHandler est utilisé pour retirer la relation d’agent lorsque l’utilisateur est supprimé.

Mise en œuvre

D2L.IM.IPSIS.Default.Users.Handlers.DeleteUserRemoveRelationshipsHandler,D2L.IM.IPSIS.Default

Comportement prévu :

Lorsqu’un parent ou enfant est supprimé, la relation est supprimée.

Note de configuration :

Ce gestionnaire devrait être placé après le gestionnaire ParentPortalDeleteRelationshipHandler.

ParentPortalDeleteRelationshipHandler

ParentPortalDeleteRelations Handler supprime implicitement les relations entre les parents, les tuteurs et les apprenants (enfants) (c.-à-d. lorsqu’une relation est manquante, Brightspace supprimera la relation).

Mise en œuvre

D2L.Integration.ParentPortal.IPSIS.RequestAdapters.ParentPortalDeleteRelationshipHandler,D2L.Integration.ParentPortal.IPSIS

Comportement prévu

Ce gestionnaire effectue les tâches suivantes :

Supprime les relations parent-enfant

Comportement en cas d’erreur

Si un problème survient lors du traitement, le gestionnaire génère une exception et un message d’information détaillé.

Note de configuration

Ce gestionnaire devrait être placé avant les gestionnaires de suppression.

PersonRequestAgentsTranslator

Le traducteur PersonRequestAgentsTranslator est requis pour effectuer la mise en correspondance de l’identifiant d’agent.

Mise en œuvre

D2L.IM.IPSIS.LIS.RequestAdapters.PMS.Default.PersonRequestAgentsTranslator,D2L.IM.IPSIS.LIS

Comportement prévu :

Effectue la mise en correspondance des agents de la requête et crée les relations primaires.

Note de configuration :

Cet élément devrait être placé à la fin des traducteurs.

ReadUserAgentsTranslator

Le traducteur ReadUserAgentsTranslator est utilisé pour récupérer les parents et tuteurs associés à l’utilisateur.

Mise en œuvre :

D2L.IM.IPSIS.LIS.ResultAdapters.PMS.Default.ReadUserAgentsTranslator,D2L.IM.IPSIS.LIS

Note de configuration :

Cet élément devrait être placé à la fin des traducteurs.

À propos de la requête replacePerson

Extrait d’une requête replacePerson mettant en évidence la section relative à l’agent.

<ims:agent>

	<ims:agentType>

		<ims:instanceIdentifier>

			<ims:language>en-US</ims:language>

		</ims:instanceIdentifier>

<ims:instanceVocabulary>http://www.imsglobal.org/lis/pmsv2p0/agenttypevocabularyv1p0</ims:instanceVocabulary&gt;

		<ims:instanceValue>

			<ims:textString>Parent</ims:textString>

		</ims:instanceValue>

	</ims:agentType>

	<ims:agentId>

		<ims:language>en-US</ims:language>

		<ims:textString>parentsourceid</ims:textString>

	</ims:agentId>

</ims:agent>

Supported agent type: Parent or Guardian