De plug-in-interface voor IReplaceUserHandler wordt door IPSIS-adapters gebruikt om het vervangen van gebruikers te ondersteunen.
De interface-implementatie is D2L.IM.IPSIS.Users.Handlers.IReplaceUserHandler.
De volgende configuratielijst biedt een startpunt voor elke IPSIS-implementatie:
Sjabloon - Gebruiker, IPSIS
- ReplaceUserReadIPSISHandler (sorteervolgorde = 10)
- ReplaceUserReadLMSHandler (sorteervolgorde = 20)
- ReplaceUserStatusDefaultActiveHandler (sorteervolgorde = 30)
- ReplaceUserRoleDefaultFirstRoleHandler (sorteervolgorde = 40)
- ReplaceUserValidateBaseHandler (sorteervolgorde = 50)
- ReplaceUserCreateLMSHandler (sorteervolgorde = 60)
- ReplaceUserCreateIPSISHandler (sorteervolgorde = 70)
- ReplaceUserSaveLMSHandler (sorteervolgorde = 80)
- ReplaceUserSaveIPSISHandler (sorteervolgorde = 90)
- ReplaceUserSavePasswordPlainTextHandler (sorteervolgorde = 100)
- ParentPortalCreateRelationshipHandler
ReplaceUserReadIPSISHandler
De ReplaceUserReadIPSISHandler vult het aanvraagobject in met informatie uit de IM-tabellen die betrekking heeft op de gebruiker die in de aanvraag is opgegeven.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserReadIPSISHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als de gebruiker eerder is ingediend, haalt deze handler eerst bestaande gegevens op voor deze gebruiker, inclusief de toewijzing (gebruikers-id) uit de IM-tabellen.
- De verwerking gaat door naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
De IPSIS Read-handler moet plaatsvinden vóór een LMS Read-handler.
ReplaceUserReadLMSHandler
De ReplaceUserReadLMSHandler vult het aanvraagobject in met informatie uit de LMS-tabellen die betrekking heeft op de gebruiker die in de aanvraag is opgegeven.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserReadLMSHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als de LMS-gebruikers-id beschikbaar is, leest de handler de bestaande LMS-waarden voor gebruikerseigenschappen.
- De verwerking gaat door naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
De IPSIS Read-handler moet plaatsvinden vóór een LMS Read-handler.
ReplaceUserStatusDefaultActiveHandler
De ReplaceUserStatusDefaultActiveHandler stelt de status van de gebruiker standaard in op Actief als deze nog niet eerder is ingesteld.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserStatusDefaultActiveHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Stelt de status in op actief als deze nog niet eerder is ingesteld.
- De verwerking gaat door naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler moet vóór de Validate-handler worden geplaatst.
ReplaceUserValidateBaseHandler
De ReplaceUserValidateBaseHandler zorgt ervoor dat de minimaal vereiste eigenschappen voor de gebruiker zijn ingesteld. Dit zijn de gebruikers-id, de gebruikersnaam, de rol en de status.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserValidateBaseHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Zorgt ervoor dat de volgende waarden worden ingesteld: Entiteit-id, gebruikersnaam, rol en status.
- Als een of meer van de waarden niet zijn ingesteld, wordt er een ArgumentNullException gemeld met details van de ontbrekende waarde. De adapter registreert het specifieke uitzonderingsbericht en stuurt een algemene fout terug naar de SIS.
- Als het wachtwoord is ingesteld om te worden bijgewerkt en het versleutelingstype wordt niet ondersteund, wordt er een InvalidDataException-bestand met specifieke kenmerken van het niet-ondersteunde versleutelingstype gemeld. De adapter registreert het specifieke uitzonderingsbericht en stuurt een algemene fout terug naar de SIS.
- De verwerking gaat door naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze moet vóór de eerste Create-handler worden geplaatst.
ReplaceUserCreateLMSHandler
De ReplaceUserCreateLMSHandler maakt de gebruiker in het LMS als deze daar nog niet bestaat.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserCreateLMSHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er geen geldig LMS-gebruikersobject in de aanvraag is, maakt de handler de gebruiker aan in de tabellen van Brightspace® (waarbij automatische registratie in het controlelogboek wordt geactiveerd).
- Voert de controle in voor het maken van een gebruiker als de gebruiker is gemaakt.
- Als alles succesvol is, stelt de handler ReplaceRequestStatus = EntityCreated in.
- De verwerking gaat door naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze moet vóór de IPSIS Create-handler worden geplaatst.
ReplaceUserCreateIPSISHandler
De ReplaceUserCreateIPSISHandler maakt de gebruiker in de IM-tabellen als deze daar nog niet bestaat.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserCreateIPSISHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Maakt de gebruiker in de IM-tabellen als deze nog niet bestaat.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- Deze handler moet na de LMS Create-handler worden geplaatst.
- De handler moet vóór de Save-handlers worden geplaatst.
ReplaceUserSaveLMSHandler
De ReplaceUserSaveLMSHandler slaat alle updates op die nodig zijn voor het educatief beheersysteem.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSaveLMSHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er gebruikersupdates voor het educatief beheersysteem zijn, slaat de handler deze op (waardoor automatische registratie in het controlelogboek wordt geactiveerd).
- Als er een probleem is met het opslaan, wordt de status ingesteld op Fout.
- Als alles succesvol is, maakt de handler een gebruiker die wordt bijgewerkt wanneer gegevens worden gewijzigd en wordt ReplaceRequestStatus = EntityUpdated ingesteld.
- De verwerking gaat door naar de volgende handler (retourneert True).
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze moet na de Create-handlers worden geplaatst.
ReplaceUserSaveIPSISHandler
De ReplaceUserSaveIPSISHandler slaat alle updates op die nodig zijn voor de IM-tabellen.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSaveIPSISHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er gebruikersupdates zijn voor de IM-tabellen, worden deze door de handler opgeslagen.
- De verwerking gaat door naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze moet na de Create-handlers worden geplaatst.
ReplaceUserSavePasswordPlainTextHandler
De ReplaceUserSavePasswordPlainTextHandler slaat het wachtwoord in platte tekst op in het LMS.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSavePasswordPlainTextHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als een wachtwoord in platte tekst is opgegeven en als bijgewerkt wordt geïdentificeerd, slaat de handler het wachtwoord op in het LMS. Als het wachtwoord in een ander coderingstype wordt opgeslagen, doet de handler niets.
- De handler maakt een bijgewerkte wachtwoordcontrolevermelding.
- Er moet een handler worden geconfigureerd voor het specifieke coderingstype.
- Als het wachtwoord is bijgewerkt en de status niet EntityCreated was, wordt de status ingesteld op EntityUpdated.
- Ga verder met de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze moet na de Create-handlers worden geplaatst.
ReplaceUserRoleDefaultFirstRoleHandler
De ReplaceUserRoleDefaultFirstRoleHandler stelt de primaire rol van de LMS-gebruiker standaard in op de eerste rol uit de rollenlijst in de aanvraag, als er nog geen rol is ingesteld.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleDefaultFirstRoleHandler®
Verwacht gedrag
Als er geen primaire rol is ingesteld, stelt u deze in op de eerste rol uit de lijst met aanvraagrollen en gaat u verder met de volgende handler.
Als er geen primaire rol is ingesteld en de lijst met aanvraagrollen is leeg, gaat deze handler door naar de volgende handler zonder een gedefinieerde primaire rol.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- Deze handler moet vóór de Validate-handler worden geplaatst.
- Deze handler vult de rol in het IPSIS-aanvraagobject in en deze rol wordt gebruikt bij het maken/bijwerken van de LMS-gebruiker. Deze handler moet worden geconfigureerd als een rol uit de aanvraag moet worden toegepast op LMS-gebruikers. Zonder deze handler worden de aanvraagrollen niet gebruikt bij het maken/bijwerken van de LMS-gebruiker.
- Wanneer deze handler wordt gebruikt in combinatie met ReplaceUserRoleDefaultConfigVariableHandler, moet deze handler ervoor worden geplaatst als u ooit wilt dat de rol van de aanvraag wordt ingesteld als de rol van de gebruiker. Als u verwacht dat er rolgegevens ontbreken in de aanvraag, configureert u ook ReplaceUserRoleDefaultConfigVariableHandler om deze handler te volgen.
ReplaceUserRoleDefaultConfigVariableHandler
De ReplaceUserRoleDefaultConfigVariableHandler wordt gebruikt om een rol in te stellen op basis van de configuratievariabele d2l.Integrations.IPSIS.DefaultRole als er nog geen was toegewezen. De configuratievariabele is ingesteld op een rol-id van Brightspace®.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleDefaultConfigVariableHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er geen primaire rol is ingesteld, stelt de handler deze in op de rol die wordt gevonden in d2l.Integrations.IPSIS.DefaultRole en gaat verder naar de volgende handler.
- Als er een primaire rol is ingesteld, doet de handler niets en gaat verder naar de volgende handler.
Foutgedrag
- Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
- Als de configuratievariabele niet is geconfigureerd, wordt een RoleNotFoundException weergegeven met het bericht "Er is geen standaardrol ingesteld voor de configuratiewaarde: d2l.Integrations.IPSIS.DefaultRole".
Opmerkingen over de configuratie
- Deze moet vóór de Validate-handler worden geplaatst.
- Deze handler vult de rol in het IPSIS-aanvraagobject in en deze rol wordt gebruikt bij het maken/bijwerken van de LMS-gebruiker. Deze handler moet in twee situaties worden geconfigureerd:
- Aanvragen van LIS-personen sluiten altijd een rol uit. Er is een rol nodig om een LMS-gebruiker te maken.
- Aanvragen van LIS-personen kunnen soms, maar niet altijd, een rol specificeren. Een andere handler, zoals de ReplaceUserRoleDefaultFirstRoleHandler, moet vóór deze worden geconfigureerd om de rol van het IPSIS-aanvraagobject in te stellen op de rol van de aanvraag, zodat de gebruiker wordt gemaakt/bijgewerkt met de rol van de aanvraag. Wanneer er echter een rol ontbreekt aan de aanvraag, stelt deze handler een rol in en zorgt ervoor dat de gebruiker correct kan worden gemaakt.
ReplaceUserUsernameFromEmailPrefixHandler
De ReplaceUserUsernameFromEmailPrefixHandler stelt de gebruikersnaam in op het voorvoegsel voor het e-mailadres ( voor de @ ) als er nog geen gebruikersnaam is ingesteld.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUsernameFromEmailPrefixHandler®
Verwacht gedrag
Als er geen gebruikersnaam is ingesteld en er een waarde in het e-mailadres staat, wordt de gebruikersnaam ingesteld op het voorvoegsel van het e-mailadres en gaat het naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór Validation geplaatst.
ReplaceUserUsernameGenerateHandler
De ReplaceUserUsernameGenerateHandler genereert een gebruikersnaam met behulp van de LMS-methode voor het genereren van de gebruikersnaam als er nog geen gebruikersnaam is ingesteld.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameGenerateHandler®
Verwacht gedrag
Als er geen gebruikersnaam is ingesteld, genereert u er een met het algoritme voor het genereren van de LP-gebruikersnaam en gaat u verder met de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans geplaatst als de laatste handler voor de gebruikersnaam vóór validatie.
ReplaceUserUsernameFromEmailHandler
De ReplaceUsernameFromEmailHandler stelt de gebruikersnaam in op het volledige e-mailadres als er nog geen gebruikersnaam is ingesteld.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameFromEmailHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er geen gebruikersnaam is ingesteld en het e-mailadres een waarde bevat, stelt de handler de gebruikersnaam in op het e-mailadres.
- De handler gaat naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór Validation geplaatst.
ReplaceUserUsernameNoUpdateHandler
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameNoUpdateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Hiermee werkt u het aanvraagobject bij om aan te geven dat de gebruikersnaam niet mag worden bijgewerkt.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór de Create/Save-handlers geplaatst.
ReplaceUserFirstNameNoUpdateHandler
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserFirstNameNoUpdateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Werkt het aanvraagobject bij om aan te geven dat de voornaam niet mag worden bijgewerkt.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór de Create/Save-handlers geplaatst.
ReplaceUserLastNameNoUpdateHandler
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserLastNameNoUpdateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Hiermee werkt u het aanvraagobject bij om aan te geven dat de achternaam niet mag worden bijgewerkt.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór de Create/Save-handlers geplaatst.
ReplaceUserOrgDefinedIdNoUpdateHandler
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserOrgDefinedIdNoUpdateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Hiermee wordt het aanvraagobject bijgewerkt om aan te geven dat de orgdefinedid niet mag worden bijgewerkt.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór de Create/Save-handlers geplaatst.
ReplaceUserPasswordNoUpdateHandler
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserPasswordNoUpdateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Werkt het aanvraagobject bij om aan te geven dat het wachtwoord niet mag worden bijgewerkt in het educatief beheersysteem.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór de Create/Save-handlers geplaatst.
ReplaceUserRoleNoUpdateHandler
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleNoUpdateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Werkt het aanvraagobject bij om aan te geven dat de rol niet mag worden bijgewerkt in het educatief beheersysteem (LMS).
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerkingen over de configuratie
- Deze handler moet worden geplaatst na een handler die de Brightspace®-rol in de aanvraag instelt.
- Deze handler moet vóór de Create/Save-handlers worden geplaatst.
ReplaceUserMapByUsernameAndOrgDefinedIdHandler
De ReplaceUserMapByUsernaamAndOrgDefinedIdHandler koppelt een SIS-gebruiker aan bestaande LMS-gebruikers door te zoeken op gebruikersnaam en OrgDefinedId.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByUsernameAndOrgDefinedIdHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er geen bestaande gebruikerstoewijzing in de IM-tabellen is, probeert de handler een gebruiker in het LMS te vinden die zowel overeenkomt voor gebruikersnaam als voor OrgDefinedId.
- Als er een overeenkomst wordt gevonden, werkt de handler het aanvraagobject bij om de overeenkomende gebruiker te bevatten. De overeenkomst, indien van toepassing, is altijd uniek.
- Gaat verder naar de volgende handler.
Foutgedrag
- Als een toewijzing al bestaat met dezelfde gebruikersnaam, maar een andere sourcedId heeft, wordt een DuplicateUsernameException gemeld.
- Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans tussen de Read-handlers en de Create-handlers geplaatst. In dat geval wordt deze handler alleen uitgevoerd als de Read-handlers geen toegewezen OrgUser kunnen vinden.
ReplaceUserMapByUsernameHandler
De ReplaceUserMapByUsernameHandler koppelt een SIS-gebruiker aan bestaande LMS-gebruikers door deze te koppelen aan de gebruikersnaam.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByUsernameHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er geen bestaande gebruikerstoewijzing in de IM-tabellen is, probeert de handler een gebruiker in het LMS te vinden die overeenkomt met de gebruikersnaam.
- Als er een overeenkomst wordt gevonden, werkt de handler het aanvraagobject bij om de overeenkomende gebruiker te bevatten. De overeenkomst, indien van toepassing, is altijd uniek.
- Gaat verder naar de volgende handler.
Foutgedrag
- Als een toewijzing al bestaat met dezelfde gebruikersnaam, maar een andere sourcedId heeft, wordt een DuplicateUsernameException gemeld.
- Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans tussen de Read-handlers en de Create-handlers geplaatst. In dat geval wordt deze handler alleen uitgevoerd als de Read-handlers geen toegewezen OrgUser kunnen vinden.
ReplaceUserMapByOrgDefinedIdHandler
De ReplaceUserMapByOrgDefinedIdHandler koppelt een SIS-gebruiker aan bestaande LMS-gebruikers door te matchen op OrgDefinedId.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByOrgDefinedIdHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als er geen gebruikerstoewijzing en geen OrgUser in het aanvraagbericht is, probeert de handler een gebruiker in het LMS te vinden die overeenkomt met OrgDefinedId.
- Als er een overeenkomst wordt gevonden, werkt de handler het aanvraagobject bij om de overeenkomende gebruiker te bevatten.
- De database kan meer dan één overeenkomst hebben, maar platform retourneert slechts één resultaat. Deze handler mag alleen worden gebruikt als de OrgDefinedId naar verwachting uniek is binnen een organisatie.
- Gaat verder naar de volgende handler.
Foutgedrag
- Als een toewijzing al bestaat met dezelfde gebruikersnaam, maar een andere sourcedId heeft, wordt een DuplicateUsernameException gemeld.
- Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans tussen de Read-handlers en de Create-handlers geplaatst. In dat geval wordt deze handler alleen uitgevoerd als de Read-handlers geen toegewezen OrgUser kunnen vinden.
ReplaceUserRequirePasswordChangeOnCreateHandler
De ReplaceUserRequirePasswordChangeOnCreateHandler zorgt ervoor dat nieuwe gebruikers hun wachtwoord bij de eerste toegang moeten wijzigen.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRequirePasswordChangeOnCreateHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Hiermee stelt u de markering in op de aanvraag die wordt doorgegeven aan de Create-handler, die aangeeft dat de gebruiker het wachtwoord moet wijzigen bij eerste aanmelding.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór de Create/Save-handlers geplaatst.
ReplaceUserStatusDefaultInactiveHandler
De ReplaceUserStatusDefaultInactiveHandler stelt de status standaard in op inactief als er geen status wordt opgegeven.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserStatusDefaultInactiveHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Stelt de status in op inactief als deze nog niet eerder is ingesteld.
- Gaat verder naar de volgende handler.
Foutgedrag
Als zich een probleem voordoet tijdens de verwerking, wordt er een uitzondering gegenereerd, samen met zoveel mogelijk gedetailleerde informatie.
Opmerking over de configuratie
Deze handler wordt doorgaans vóór Validation geplaatst.
ReplaceUserVerifyConsistentSourcedIdHandler
De ReplaceUserVerifyConsistentSourcedIdHandler verifieert dat de aanvraag niet probeert een nieuwe bron-id te verstrekken aan een gebruiker die al is toegewezen.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserVerifyConsistentSourcedIdHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als de aanvraag geen D2LOrgUser heeft ingesteld, doet de handler niets.
- Als er een org-gebruiker is ingesteld, controleert de handler of er toewijzingen voor die gebruiker zijn in het huidige systeem/de huidige organisatie.
- Als dat niet het geval is, doet de handler niets.
- Als er wel toewijzingen zijn, controleert de handler of de bestaande bron-id van de toewijzing overeenkomt met de bron-id van de aanvraag.
- Als ze overeenkomen, doet de handler niets.
- Als ze niet overeenkomen, genereert de handler een DuplicatedUsernameException om het studentinformatiesysteem te laten weten dat het probeert een nieuwe bron-id in te stellen op een bestaande gebruiker.
Foutgedrag
Als er al een gebruikerstoewijzing bestaat voor de gebruiker en deze een andere bron-id heeft, genereert de handler een uitzondering.
Opmerking over de configuratie
Deze handler moet na een MapBy-handler (zoals ReplaceUserMapByUsername Handler) worden geplaatst om te controleren of de gebruiker nog niet is toegewezen aan een andere bron-id. Deze handler moet ook worden geplaatst vóór de Save-/Create-handlers.
ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler
De ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler controleert of de aanvraag niet probeert een nieuwe sourcedId te geven aan een gebruiker die al is toegewezen.
Implementatie
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler®
Verwacht gedrag
De handler voert de volgende taken uit:
- Als de aanvraag geen D2LOrgUser heeft ingesteld, doet de handler niets.
- Als er een org-gebruiker is ingesteld, controleert de handler of er toewijzingen voor die gebruiker zijn in het huidige systeem/de huidige organisatie.
- Als er geen toewijzingen zijn, doet de handler niets.
- Als er toewijzingen zijn, controleert de handler of de bestaande sourcedId van de toewijzing overeenkomt met de sourcedId van de aanvraag.
- Als ze overeenkomen, doet de handler niets.
- Als deze niet overeenkomen, controleert de handler of er al een gebruikerstoewijzing bestaat in het bronsysteem met de sourcedId van de aanvraag.
- Als de toewijzing bestaat, meldt de handler een DuplicatedUsernameException om het SIS te laten weten dat het probeert een nieuwe sourcedId in te stellen op een bestaande gebruiker, en dat de sourcedId van de bestaande gebruiker niet kan worden gewijzigd in de nieuwe als gevolg van een conflict.
- Als deze niet overeenkomen, wijzigt de handler de sourcedId van de gebruiker in de tabel met toewijzingen in de sourcedId op de aanvraag en stelt de UserMapping op de aanvraag in op de nu hernoemde toewijzing.
Foutgedrag
Als er al een gebruikerstoewijzing bestaat voor de gebruiker en deze een andere sourcedId heeft EN de gevraagde sourcedId al in gebruik is, meldt de handler een uitzondering.
Opmerking over de configuratie
Deze handler moet na een MapBy-handler (zoals ReplaceUserMapByUsernameHandler) worden geplaatst, maar vóór de save/create-handlers. Deze handler moet worden gebruikt in plaats van de ReplaceUserVerifyConsistentSourcedIdHandler.