Beheerdersdocumentatie

IPSIS LIS 2.0-integratie gebruiken met Brightspace® ouder/voogd

Zorg dat u een strategie hebt om de sourceId voor ouders/voogden in Brightspace® te definiëren, omdat een gebruikersrelatie een toewijzing is van een unieke sourceId tussen ouders/voogden en kinderen. Wanneer u replacePerson-verzoeken verzendt om gebruikers te maken, moet u de sourceId-gegevens van ouders/voogden in het agentgedeelte van het verzoek voor kinderen/cursisten verzenden. Hiermee wordt de relatie tussen ouder/voogd en kind gemaakt.

Er zijn vijf nieuwe plug-ins toegevoegd aan de IPSIS LIS 2.0-adapter, waarmee u de relatie tussen ouder/voogd en kind kunt maken, bijwerken en verwijderen. Plug-ins worden automatisch ingesteld:

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

ParentPortalCreateRelationshipHandler

Met ParentPortalUpdateRelationshipHandler worden impliciet relaties tussen ouders/voogden en cursisten (kinderen) gemaakt en bijgewerkt.

Implementatie:

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

Verwacht gedrag:

De handler voert de volgende taken uit:

• Maakt en werkt ouder/voogd-kindrelaties impliciet bij, zoals gedefinieerd in het agentveld voor een cursist bij een verzoek om een gebruiker te vervangen.

• Synchroniseert relaties voor de gebruiker als het extensieveld SynchronizeRelationships is opgegeven. De cursist blijft bestaan in het systeem, maar alle relaties worden verwijderd.

Gedrag bij fouten:

Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.

Configuratie-opmerking:

• Deze moet na alle Replace-handlers worden geplaatst.

DeleteUserRemoveRelationshipsHandler

DeleteUserRemoveRelationshipsHandler wordt gebruikt om de agentrelatie te verwijderen als de gebruiker wordt verwijderd.

Implementatie

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

Verwacht gedrag:

Als een ouder/voogd of kind wordt verwijderd, wordt de relatie verwijderd.

Configuratie-opmerking:

Deze moet worden geplaatst na ParentPortalDeleteRelationshipHandler

ParentPortalDeleteRelationshipHandler

Met ParentPortalDeleteRelationshipHandler worden impliciet relaties tussen ouders/voogden en cursisten (kinderen) verwijderd (d.w.z. als een relatie ontbreekt, verwijdert Brightspace® de relatie).

Implementatie

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

Verwacht gedrag:

De handler voert de volgende taken uit:

• Verwijdert de relaties tussen ouder/voogd en kind

Gedrag bij fouten:

Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.

Configuratie-opmerking:

• Deze variabele moet vóór alle Delete-handlers worden geplaatst.

PersonRequestAgentsTranslator

PersonRequestAgentsTranslator is vereist om de agent-id toe te wijzen.

Implementatie

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

Verwacht gedrag:

Hiermee wijst u agenten van het verzoek toe en maakt u ouder-/voogdrelaties.

Configuratie-opmerking:

Deze moet aan het einde van de omzettingsprogramma's worden geplaatst.

ReadUserAgentsTranslator

ReadUserAgentsTranslator wordt gebruikt om ouders en voogden op te halen die zijn gekoppeld aan de gebruiker.

Implementatie:

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

Configuratie-opmerking:

Deze moet aan het einde van de omzettingsprogramma's worden geplaatst.

Info over het replacePerson-verzoek

Fragment uit replacePerson-verzoek met het agentgedeelte gemarkeerd.

<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>

Ondersteund agenttype: Ouder of voogd