L'interface du gestionnaire IReplaceUserHandler est utilisée par les adaptateurs IPSIS pour prendre en charge l'opération de remplacement pour les utilisateurs.
La mise en œuvre de l'interface est D2L.IM.IPSIS.Users.Handlers.IReplaceUserHandler.
La liste de configuration suivante offre un point de départ pour toute mise en œuvre IPSIS :
IPSIS, Template – User
- ReplaceUserReadIPSISHandler (Sort Order = 10)
- ReplaceUserReadLMSHandler (Sort Order = 20)
- ReplaceUserStatusDefaultActiveHandler (Sort Order = 30)
- ReplaceUserRoleDefaultFirstRoleHandler (Sort Order = 40)
- ReplaceUserValidateBaseHandler (Sort Order = 50)
- ReplaceUserCreateLMSHandler (Sort Order = 60)
- ReplaceUserCreateIPSISHandler (Sort Order = 70)
- ReplaceUserSaveLMSHandler (Sort Order = 80)
- ReplaceUserSaveIPSISHandler (Sort Order = 90)
- ReplaceUserSavePasswordPlainTextHandler (Sort Order = 100)
- ParentPortalCreateRelationshipHandler
ReplaceUserReadIPSISHandler
L'interface ReplaceUserReadIPSISHandler remplit les champs de la requête à l'aide des informations des tableaux IM relatives à l'utilisateur indiqué.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserReadIPSISHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si l'utilisateur a été soumis au préalable, le gestionnaire récupère premièrement des tableaux IM toutes les données existantes qui lui sont associées, y compris la correspondance (UserId).
- Le traitement est cédé au prochain gestionnaire.
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
Un gestionnaire ReadIPSIS devrait survenir avant un gestionnaire ReadLMS.
ReplaceUserReadLMSHandler
L'interface ReplaceUserReadLMSHandler remplit les champs de la requête à l'aide des informations des tableaux LMS (SGA) relatives à l'utilisateur indiqué.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserReadLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si l'ID utilisateur du SGA est disponible, le gestionnaire lit les valeurs de SGA existantes pour les propriétés de l'utilisateur.
- Le traitement est cédé au prochain gestionnaire.
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
Un gestionnaire ReadIPSIS devrait survenir avant un gestionnaire ReadLMS.
ReplaceUserStatusDefaultActiveHandler
Le gestionnaire ReplaceUserStatusDefaultActiveHandler définit par défaut l'état de l'utilisateur à actif s'il n'était pas préalablement défini.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserStatusDefaultActiveHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Définit par défaut l'état de l'utilisateur à actif s'il n'était pas préalablement défini.
- Le traitement est cédé au prochain gestionnaire.
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 le gestionnaire de validation.
ReplaceUserValidateBaseHandler
Le gestionnaire ReplaceUserValidateBaseHandler vérifie que les propriétés minimales requises pour l'utilisateur ont été définies. Ces propriétés comprennent l'identificateur de l'utilisateur, le nom d'utilisateur, le rôle et l'état.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserValidateBaseHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Vérifie que les données suivantes sont définies : Identificateur de l'entité, nom d'utilisateur, rôle et état.
- Si l'une des valeurs n'est pas définie, le gestionnaire génère une exception ArgumentNullException précisant la valeur manquante. L'adaptateur consigne le message d'exception et renvoie une erreur générale au SIS.
- Si le mot de passe doit être actualisé et que le type de chiffrement n'est pas pris en charge, le gestionnaire génère une exception InvalidDataException et précise le type de chiffrement à l'origine du problème. L'adaptateur consigne le message d'exception et renvoie une erreur générale au SIS.
- Le traitement est cédé au prochain gestionnaire.
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 le premier gestionnaire de création.
ReplaceUserCreateLMSHandler
Le gestionnaire ReplaceUserCreateLMSHandler crée l'utilisateur dans le SGA s'il ne s'y trouve pas déjà.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserCreateLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Crée l’utilisateur dans les tableaux de Brightspace si la requête ne comprend pas un utilisateur SGA valide (ce qui génère automatiquement une entrée de vérification).
- Consigne la vérification pour la création de l'utilisateur, le cas échéant.
- Si toutes les étapes aboutissent, le gestionnaire attribue l'état EntityCreated à l'objet ReplaceRequestStatus.
- Le traitement est cédé au prochain gestionnaire.
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 le gestionnaire CreateIPSIS.
ReplaceUserCreateIPSISHandler
Le gestionnaire ReplaceUserCreateIPSISHandler crée l'utilisateur dans les tableaux IM s'il ne s'y trouve pas déjà.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserCreateIPSISHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Crée l'utilisateur dans les tableaux IM s'il ne s'y trouve pas déjà.
- Le traitement est cédé au prochain gestionnaire.
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é.
Notes de configuration
- Ce gestionnaire devrait être placé après le gestionnaire CreateLMS.
- Ce gestionnaire devrait être placé avant les gestionnaires d'enregistrement.
ReplaceUserSaveLMSHandler
Le gestionnaire ReplaceUserSaveLMSHandler enregistre toute modification requise dans le SGA.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSaveLMSHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Enregistre toute mise à jour d'utilisateur pour le SGA (ce qui génère automatiquement une entrée de journal de vérification).
- Si l'enregistrement présente un problème, l'état est défini à Error (erreur).
- Si toutes les étapes aboutissent, le gestionnaire crée et actualise l'utilisateur dès que les données changent, puis attribue l'état EntityUpdated à l'objet ReplaceRequestStatus.
- Le traitement est cédé au prochain gestionnaire (renvoi de la valeur True [vrai]).
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 création.
ReplaceUserSaveIPSISHandler
Le gestionnaire ReplaceUserSaveIPSISHandler enregistre toute modification requise dans les tableaux IM.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSaveIPSISHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Enregistre toute mise à jour d'utilisateur pour les tableaux IM (ce qui génère automatiquement une entrée de journal de vérification).
- Le traitement est cédé au prochain gestionnaire.
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 création.
ReplaceUserSavePasswordPlainTextHandler
Le gestionnaire ReplaceUserSavePasswordPlainTextHandler enregistre le mot de passe en texte en clair dans le SGA.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserSavePasswordPlainTextHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Enregistre le mot de passe dans le SGA (si un mot de passe fourni en texte en clair est identifié comme étant actualisé). Si le mot de passe présente tout autre type de chiffrement, le gestionnaire ne fait rien.
- Crée une entrée de mot de passe actualisé dans le journal de vérification.
- Un gestionnaire devrait être configuré pour le type de chiffrement particulier.
- Si le mot de passe a été actualisé et que son état n'affichait pas la valeur EntityCreated, le gestionnaire lui attribue l'état EntityUpdated.
- Le traitement est cédé au prochain gestionnaire.
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 création.
ReplaceUserRoleDefaultFirstRoleHandler
Le gestionnaire ReplaceUserRoleDefaultFirstRoleHandler définit par défaut le rôle primaire de l'utilisateur SGA au premier rôle de la liste des rôles dans la requête (si aucun rôle n'était préalablement défini).
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleDefaultFirstRoleHandler
Comportement prévu
Si aucun rôle primaire n'a été défini, le gestionnaire lui attribue par défaut le premier rôle de la liste des rôles de la requête, puis cède le traitement au prochain gestionnaire.
Si aucun rôle primaire n'a été défini et que la liste des rôles de la requête est vide, le gestionnaire cède le traitement au prochain gestionnaire sans modifier la valeur de rôle.
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é.
Notes de configuration
- Ce gestionnaire devrait être placé avant le gestionnaire de validation.
- Ce gestionnaire attribut à la requête IPSIS la valeur du rôle qui sera utilisé à la création ou à l'actualisation de l'utilisateur SGA. Ce gestionnaire devrait être configuré si un rôle de la requête doit être attribué aux utilisateurs SGA. Sans ce gestionnaire, le ou les rôles de la requête ne seront pas utilisés à la création ou à l'actualisation de l'utilisateur SGA.
- Lorsqu'il est utilisé conjointement au gestionnaire ReplaceUserRoleDefaultConfigVariableHandler, ce gestionnaire devrait être placé avant si vous désirez que le rôle de la requête soit défini comme rôle de l'utilisateur. Si vous croyez que la requête ne comprendra aucune valeur de rôle, configurez également le gestionnaire ReplaceUserRoleDefaultConfigVariableHandler après ce gestionnaire.
ReplaceUserRoleDefaultConfigVariableHandler
Le gestionnaire ReplaceUserRoleDefaultConfigVariableHandler est utilisé pour définir un rôle basé sur la variable de configuration d2l.Integrations.IPSIS.DefaultRole, si aucun rôle n'était préalablement attribué. La variable de configuration est définie à un ID de rôle de Brightspace.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleDefaultConfigVariableHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si aucun rôle primaire n'a été défini, le gestionnaire lui attribue le rôle de la variable d2l.Integrations.IPSIS.DefaultRole et cède le traitement au prochain gestionnaire.
- Si un rôle primaire est défini, le gestionnaire ne fait rien et cède le traitement au prochain gestionnaire.
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é.
- Si la variable de configuration n'est pas configurée, le gestionnaire génère une exception RoleNotFoundException comprenant le message « No default role is set for config value: d2l.Integrations.IPSIS.DefaultRole » (Aucun rôle par défaut n'est défini pour la variable de configuration : d2l.Integrations.IPSIS.DefaultRole).
Notes de configuration
- Ce gestionnaire devrait être placé avant le gestionnaire de validation.
- Ce gestionnaire attribut à la requête IPSIS la valeur du rôle qui sera utilisé à la création ou à l'actualisation de l'utilisateur SGA. Ce gestionnaire devrait être configuré dans l'un des deux cas suivants :
- Les requêtes de personne LIS excluent toujours un rôle. Un rôle est nécessaire pour créer un utilisateur SGA.
- Les requêtes de personne LIS indiquent parfois (mais non toujours) un rôle. Il est recommandé de configurer un autre gestionnaire (par exemple ReplaceUserRoleDefaultFirstRoleHandler) avant celui-ci pour définir le rôle de la requête IPSIS au rôle de la requête, de façon à s'assurer que l'utilisateur est créé ou actualisé en fonction du rôle de la requête. Si toutefois la requête ne comprend pas de rôle, ce gestionnaire en définit un et assure la création appropriée de l'utilisateur.
ReplaceUserUsernameFromEmailPrefixHandler
Le gestionnaire ReplaceUserUsernameFromEmailPrefixHandler définit le nom d'utilisateur au préfixe de l'adresse courriel (soit ce qui précède le symbole @) si aucun nom d'utilisateur n'est défini.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUsernameFromEmailPrefixHandler
Comportement prévu
Si aucun nom d'utilisateur n'est défini et que l'adresse courriel affiche une valeur, le gestionnaire définit le préfixe de l'adresse courriel comme nom d'utilisateur, puis cède le traitement au prochain gestionnaire.
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 est généralement placé avant le gestionnaire de validation.
ReplaceUserUsernameGenerateHandler
Le gestionnaire ReplaceUserUsernameGenerateHandler génère un nom d'utilisateur à l'aide de l'algorithme de génération de nom du SGA si aucun nom d'utilisateur n'est défini.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameGenerateHandler
Comportement prévu
Si aucun nom d'utilisateur n'est défini, ce gestionnaire en génère un à l'aide de l'algorithme de génération de nom d'utilisateur, puis cède le traitement au prochain gestionnaire.
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 est généralement placé comme dernier gestionnaire de nom d'utilisateur avant les gestionnaires de validation.
ReplaceUserUsernameFromEmailHandler
Le gestionnaire ReplaceUserUsernameFromEmailHandler définit le nom d'utilisateur à l'adresse courriel complète si aucun nom d'utilisateur n'est défini.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameFromEmailHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si aucun nom d'utilisateur n'est défini et que l'adresse courriel affiche une valeur, le gestionnaire définit l'adresse courriel entière comme nom d'utilisateur.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant le gestionnaire de validation.
ReplaceUserUsernameNoUpdateHandler
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUsernameNoUpdateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le nom d'utilisateur ne doit pas être actualisé.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserFirstNameNoUpdateHandler
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserFirstNameNoUpdateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le prénom ne doit pas être actualisé.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserLastNameNoUpdateHandler
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserLastNameNoUpdateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le nom de famille ne doit pas être actualisé.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserOrgDefinedIdNoUpdateHandler
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserOrgDefinedIdNoUpdateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que l'ID défini par l'organisation ne doit pas être actualisé.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserPasswordNoUpdateHandler
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserPasswordNoUpdateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le mot de passe ne doit pas être actualisé.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserRoleNoUpdateHandler
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRoleNoUpdateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Actualise l'objet de requête pour indiquer que le rôle ne doit pas être actualisé.
- Le traitement est cédé au prochain gestionnaire.
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é.
Notes de configuration
- Ce gestionnaire doit être placé après un gestionnaire de définition du rôle de Brightspace dans la requête.
- Ce gestionnaire doit être placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserMapByUsernameAndOrgDefinedIdHandler
Le gestionnaire ReplaceUserMapByUsernameAndOrgDefinedIdHandler associe un utilisateur SIS à des utilisateurs SGA existants en faisant correspondre les noms d'utilisateurs et les ID définis par l'organisation.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByUsernameAndOrgDefinedIdHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- S'il n'existe aucune correspondance d'utilisateur dans les tableaux IM, le gestionnaire tente de trouver dans le SGA un utilisateur correspondant à la fois au nom d'utilisateur et à l'ID défini par l'organisation.
- S'il trouve une correspondance, le gestionnaire actualise l'objet de requête en fonction de l'utilisateur correspondant. Le cas échéant, la correspondance est toujours unique.
- Le traitement est cédé au prochain gestionnaire.
Comportement en cas d'erreur
- Si une correspondance existante affiche le même nom d'utilisateur, mais un identificateur SourcedId différent, le gestionnaire génère une exception DuplicateUsernameException.
- 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 est généralement placé entre les gestionnaires de lecture et les gestionnaires de création, auquel cas il ne s'exécuterait que si les gestionnaires de lecture ne réussissent pas à trouver un utilisateur d'organisation correspondant.
ReplaceUserMapByUsernameHandler
Le gestionnaire ReplaceUserMapByUsernameHandler associe un utilisateur SIS à des utilisateurs SGA existants en faisant correspondre les noms d'utilisateurs.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByUsernameHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- S'il n'existe aucune correspondance d'utilisateur dans les tableaux IM, le gestionnaire tente de trouver dans le SGA un utilisateur correspondant au nom d'utilisateur.
- S'il trouve une correspondance, le gestionnaire actualise l'objet de requête en fonction de l'utilisateur correspondant. Le cas échéant, la correspondance est toujours unique.
- Le traitement est cédé au prochain gestionnaire.
Comportement en cas d'erreur
- Si une correspondance existante affiche le même nom d'utilisateur, mais un identificateur SourcedId différent, le gestionnaire génère une exception DuplicateUsernameException.
- 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 est généralement placé entre les gestionnaires de lecture et les gestionnaires de création, auquel cas il ne s'exécuterait que si les gestionnaires de lecture ne réussissent pas à trouver un utilisateur d'organisation correspondant.
ReplaceUserMapByOrgDefinedIdHandler
Le gestionnaire ReplaceUserMapByOrgDefinedIdHandler associe un utilisateur SIS à des utilisateurs SGA existants en faisant correspondre les ID définis par l'organisation.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserMapByOrgDefinedIdHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si le message de la requête ne comprend aucune correspondance d'utilisateur ni utilisateur de l'organisation, le gestionnaire tente de trouver dans le SGA un utilisateur correspondant à l'ID défini par l'organisation.
- S'il trouve une correspondance, le gestionnaire actualise l'objet de requête en fonction de l'utilisateur correspondant.
- La plateforme ne renvoie qu'un seul résultat, même si la base de données comprend plusieurs correspondances. Ce gestionnaire ne devrait être utilisé que si l'ID défini par l'organisation devait s'avérer unique au sein d'une organisation.
- Le traitement est cédé au prochain gestionnaire.
Comportement en cas d'erreur
- Si une correspondance existante affiche le même nom d'utilisateur, mais un identificateur SourcedId différent, le gestionnaire génère une exception DuplicateUsernameException.
- 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 est généralement placé entre les gestionnaires de lecture et les gestionnaires de création, auquel cas il ne s'exécuterait que si les gestionnaires de lecture ne réussissent pas à trouver un utilisateur d'organisation correspondant.
ReplaceUserRequirePasswordChangeOnCreateHandler
Le gestionnaire ReplaceUserRequirePasswordChangeOnCreateHandler s'assure que les nouveaux utilisateurs modifient leur mot de passe à la première ouverture de session.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserRequirePasswordChangeOnCreateHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Définit l'indicateur de la requête transmis au gestionnaire de création, lequel signale que l'utilisateur doit modifier son mot de passe à la première ouverture de session.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant les gestionnaires de création ou d'enregistrement.
ReplaceUserStatusDefaultInactiveHandler
Le gestionnaire ReplaceUserStatusDefaultInactiveHandler définit par défaut l'état à inactif si aucun état n'est fourni.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserStatusDefaultInactiveHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Définit par défaut l'état à inactif s'il n'était pas préalablement défini.
- Le traitement est cédé au prochain gestionnaire.
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 est généralement placé avant le gestionnaire de validation.
ReplaceUserVerifyConsistentSourcedIdHandler
Le gestionnaire ReplaceUserVerifyConsistentSourcedIdHandler vérifie que la requête ne tente pas d'attribuer un nouvel identificateur SourcedId à un utilisateur déjà mis en correspondance.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserVerifyConsistentSourcedIdHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si la requête n'affiche aucun utilisateur de l'organisation de D2L, le gestionnaire ne fait rien.
- Si un utilisateur de l'organisation est défini, le gestionnaire vérifie la présence de correspondances pour cet utilisateur dans le système ou l'organisation en cours.
- S'il ne trouve aucune correspondance, le gestionnaire ne fait rien.
- S'il trouve des correspondances, le gestionnaire vérifie si l'identificateur SourcedId de la correspondance existante correspond à l'identificateur SourcedId de la requête.
- S'ils correspondent, le gestionnaire ne fait rien.
- S'ils ne correspondent pas, le gestionnaire génère une exception DuplicatedUsernameException pour aviser le SIS qu'il tente de définir un nouvel identificateur SourcedId pour un utilisateur existant.
Comportement en cas d'erreur
Si une correspondance d'utilisateur existe déjà pour l'utilisateur et qu'elle affiche un identificateur SourcedId différent, le gestionnaire génère une exception.
Note de configuration
Ce gestionnaire devrait être placé après un gestionnaire MapBy (par exemple ReplaceUserMapByUsernameHandler) pour vérifier que l'utilisateur n'est pas déjà mis en correspondance avec un identificateur SourcedId différent. Ce gestionnaire devrait également être placé avant les gestionnaires d'enregistrement et de création.
ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler
Le gestionnaire ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler vérifie que la requête ne tente pas d'attribuer un nouvel identificateur SourcedId à un utilisateur déjà mis en correspondance.
Mise en œuvre
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUpdateIPSISSourcedIdForMatchedUserHandler
Comportement prévu
Ce gestionnaire effectue les tâches suivantes :
- Si la requête n'affiche aucun utilisateur de l'organisation de D2L, le gestionnaire ne fait rien.
- Si un utilisateur de l'organisation est défini, le gestionnaire vérifie la présence de correspondances pour cet utilisateur dans le système ou l'organisation en cours.
- S'il ne trouve aucune correspondance, le gestionnaire ne fait rien.
- S'il trouve des correspondances, le gestionnaire vérifie si l'identificateur SourcedId de la correspondance existante correspond à l'identificateur SourcedId de la requête.
- S'ils correspondent, le gestionnaire ne fait rien.
- S'ils ne correspondent pas, le gestionnaire vérifie si le système source comprend déjà une correspondance d'utilisateur affichant l'identificateur SourcedId de la requête.
- Si la correspondance existe, le gestionnaire génère une exception DuplicatedUsernameException pour aviser le SIS qu'il tente de définir un nouvel identificateur SourcedId pour un utilisateur existant, et que l'identificateur SourcedId de cet utilisateur ne peut pas être changé au nouveau en raison d'un conflit.
- Si les identificateurs ne correspondent pas, le gestionnaire modifie l'identificateur SourcedId de l'utilisateur dans le tableau des correspondances à celui de la requête, puis définit l'objet UserMapping de la requête en fonction de la correspondance renommée.
Comportement en cas d'erreur
Si une correspondance d'utilisateur existe déjà pour l'utilisateur et qu'elle affiche un identificateur SourcedId différent ALORS que l'identificateur SourcedId demandé est déjà utilisé, le gestionnaire génère une exception.
Note de configuration
Ce gestionnaire devrait être placé après un gestionnaire MapBy (par exemple ReplaceUserMapByUsernameHandler), mais avant les gestionnaires d'enregistrement et de création. Ce gestionnaire devrait être utilisé au lieu du gestionnaire ReplaceUserVerifyConsistentSourcedIdHandler.