Documentation sur les intégrations

Dépannage d'IPSIS et de LIS

Dépannage du système IPSIS

Le dépannage du système IPSIS commence généralement par l’affichage du journal système. Si ce journal ne comprend aucune information utile, il peut être nécessaire de configurer la journalisation de débogage. Le cas échéant, il importe de ne pas oublier de désactiver cette fonctionnalité dès qu’elle n’est plus requise.

Messages d’erreur courants

Erreur	Description
Invalid Configuration: Missing Role Mapping for Role {Role Name}. – (Configuration non valide : Correspondance de rôle manquante pour le rôle {nom du rôle}.)	Cette réponse indique généralement qu'il n'existe pas de correspondance de rôle pour {nom du rôle}. Créez une correspondance dans la console Administration d'IPSIS pour le système source en question.
Error in LIS PMS.replacePerson: Unable to create user. – (Erreur dans LIS PMS.replacePerson : Impossible de créer l'utilisateur.)	Cette erreur indique que l’utilisateur existe déjà dans et qu’il a été supprimé par le gestionnaire ReplaceDelete. La ou les personnes sont des gestionnaires par défaut utilisant ReplaceUserValidateBaseHandler et l’enregistrement attendu n’existe pas. Vous pouvez contourner ce problème en utilisant un gestionnaire qui s’attend plutôt à trouver l’utilisateur, par exemple ReplaceUserLastNameNoUpdateHandler.
Unhandled Exception in LIS PMS.replacePerson: password is not valid Parameter name: password. – (Exception non gérée dans LIS PMS.replacePerson : mot de passe non valide Nom de paramètre : mot de passe)	Ce message est consigné en tant qu’erreur lorsque le message fourni dans un segment PMS replacePerson ne contient pas un mot de passe qui répond aux exigences de la variable de configuration d2l.Auth.Password.ValidationRegex.
Error with update of user with code {User Code}. Account mapped to invalid LMS UserId {User Id}. The account may have been deleted. – (Erreur d'actualisation de l'utilisateur affichant le code {Code d'utilisateur}. Compte correspondant à une valeur LMS UserId {ID utilisateur} non valide. Ce compte peut avoir été supprimé.)	Cette réponse indique généralement que l'utilisateur associé à l'ID {ID utilisateur} a été supprimé dans. Le dépannage nécessite l'actualisation de la valeur IM_USER_MAPPINGS.UserId à l'aide d'un nouvel ID d'utilisateur (ou la restauration de l'utilisateur supprimé dans Brightspace).
Invalid Configuration: Role Mapping for Role {Role Name}. – (Configuration non valide : Correspondance de rôle pour le rôle {nom du rôle}.) Desire2Learn RoleId {Role Id} does not exist. – (Configuration non valide : Correspondance de rôle pour le rôle {nom du rôle}. L'ID de rôle Desire2Learn {ID rôle} n'existe pas.)	Cette réponse indique généralement que le rôle associé à l'ID de rôle {ID rôle} a été supprimé dans. Le dépannage nécessite l'actualisation de la valeur IM_ROLE_MAPPINGS.RoleId à l'aide d'un nouvel ID de rôle (ou la restauration du rôle supprimé dans Brightspace).
Error with update of org unit with code {Org Unit Code}. Org unit mapped to invalid LMS OrgUnitId {Org Unit Id}. This org unit may have been deleted. – (Erreur d'actualisation de l'unité organisationnelle affichant le code {Code UO}. Correspondance de l'UO avec la valeur LMS OrgUnitId {ID d'UO} non valide. Cette UO peut avoir été supprimée.)	Cette réponse indique généralement que l'unité organisationnelle associée à l'ID d'UO {ID d'UO} a été supprimée dans. Le dépannage nécessite la restauration de l'UO supprimée dans.
Invalid Configuration: OrgUnitTypeMapping for OrgUnitType {Org Unit Type}. L'OrgUnitTypeId {Org Unit Type Id} de D2L n'existe pas.	Cette réponse indique généralement que le type d'unité organisationnelle associé à la valeur {ID de type d'UO} a été supprimé dans. Le dépannage nécessite la restauration du type d'UO supprimé dans.
Create D2L.IM.Platform.OrgUnits.Default.CourseOffering object failed: Org Structure constraint preventing create of course offering. Veuillez vérifier les variables de configuration de l'outil Cours.	Ce message s'affiche dans l'onglet Messages du journal d'Administration d'IPSIS. Vérifiez la variable de configuration d2l.Tools.Courses.SemesterOptions pour voir si elle est correctement réglée. Si c'est le cas, vous pouvez fournir un semestre valide avec votre requête ou modifier la valeur de la variable de configuration à « non requis » (auquel cas votre requête actuelle fonctionnera).
Create D2L.IM.Platform.OrgUnits.Default.CourseTemplate object failed. – (Échec de création de l'objet Create D2L.IM.Platform.OrgUnits.Default.CourseTemplate.)	Ce message peut être consigné lorsque la valeur de la variable de configuration d2l.Tools.Courses.DepartmentOptions est définie à Au besoin et qu'aucun département n'est fourni.
Unable to change the parent offering of course section with id {id}. This behavior is not supported. – (Impossible de modifier l'offre primaire de la section de cours affichant l'ID {ID}. Ce comportement n'est pas pris en charge.)	Ce message est consigné lors d'une tentative d'actualisation d'une section de cours existante en fonction d'une offre de cours primaire différente. Ce comportement n'est pas pris en charge par la mise en œuvre par défaut.
IMExternalOrgUnitInfo is null for LIS_Membership_{ListingCode} – (Valeur IMExternalOrgUnitInfo nulle pour LIS_Membership_{Code de liste})	Cette erreur survient lors d'une tentative d'inscription à une unité organisationnelle qui n'est pas présente dans les tableaux IM de la base de données. L'erreur est généralement due à une tentative d'inscription à une UO manuellement créée dans. Les inscriptions à l'aide d'IPSIS ne doivent être traitées que pour les UO également créées à l'aide d'IPSIS. Type de collecteur de données D2L.IM.IPSIS.LIS.MMS.LISMembershipManagementServices

Dépannage de l'adaptateur LIS

SoapUI est un excellent outil de dépannage de l'adaptateur LIS et d'autres interfaces basées sur les services Web. Cet outil peut servir à transmettre des requêtes LIS aux services et opérations LIS prises en charge par l'adaptateur LIS. Il peut également être utilisé pour définir des services factices permettent de dépanner les appels sortants vers les services et opérations LIS mises en œuvre par un Système informatique de renseignements sur les élèves (SIS).

Messages de réponse LIS

Erreur

Description

Internal Server (500 Error) when accessing service endpoint – (Erreur 500 de serveur interne à l'accès du point d'extrémité du service)

Une erreur survient lors d'une tentative d'accès à un fichier .svc.

Étapes à vérifier :

L’application d2l au sein d’IIS comprend-elle un répertoire virtuel IM?
Y a-t-il une correspondance du gestionnaire *.svc pour l’application au sein d’IIS?
Pouvez-vous effectuer une requête pour le fichier wsdl dans le dossier de service auquel vous tentez d’accéder?
Vérifiez que vous accédez au site à l’aide du protocole (HTTP ou HTTPS) autorisé par les liaisons de site dans IIS (un protocole ou les deux peuvent être activés). Le réglage supérieur est pour le protocole http (basicHttpBinding_Insecure) et le réglage inférieur, pour https (basicHttpBinding_SSL_WS_Security).
Vous pourriez devoir alterner entre les liaisons HTTP et HTTPS selon la configuration de votre site Web.

No security header found in request – (En-tête de sécurité introuvable dans la requête)

Cette réponse indique généralement que la requête LIS n'utilise pas WS-Security ou ne fournit pas un nom d'utilisateur et un mot de passe comme éléments de l'en-tête de sécurité.