La version 2.0 de l’adaptateur LIS d’IPSIS met en œuvre les services et les opérations du LIS en appui aux profils IMS LIS suivants :
- Profil principal d’IMS Global LIS v2.0
- Profil hiérarchique du cours complet d’IMS Global LIS v2.0
- Profil de sections combinées d’IMS Global LIS v2.0
Chaque service mis en œuvre par D2L intégré à l’adaptateur LIS v2.0 a été conçu de telle sorte que des champs dans les demandes du LIS peuvent être mis en correspondance avec les champs D2L d’après les exigences particulières d’un établissement. Cela se fait au moyen de traducteurs configurables et extensibles, qui mettent en correspondance les champs du LIS avec les champs de la plateforme d’apprentissage D2L.
Vous trouverez de plus amples renseignements au sujet de la mise en correspondance et des comportements sont décrits dans l’optimisation des opérations de service LIS et des interfaces du traducteur.
Point d’extrémité du service LIS v2.0
Il y a des points d’extrémité séparés pour HTTP et HTTPS. Vous devez utiliser le point d’extrémité du service approprié pour une mise en œuvre selon la façon dont le site est vu par IIS. Si votre soutien SSL est fourni par un équilibreur de charge vous devrez peut-être utiliser les points d’extrémité HTTP.
HTTP
|
Nom du service
|
Point d’extrémité du service
|
|
Bulk Data Exchange Management Service (BDEMS) (Service de gestion d’échange de données en bloc (SGEDB))
|
/d2l/im/ipsis/lis/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
Course Offering Management Service (COMS) (Service de gestion d’offre de cours (SGOC))
|
/d2l/im/ipsis/lis/cmsv1p0/CourseOfferingManagementServices.svc
|
|
Course Section Management Service (CSMS) (Service de gestion de section de cours (SGSC))
|
/d2l/im/ipsis/lis/cmsv1p0/CourseSectionManagementServices.svc
|
|
Course Template Management Service (CTMS) (Service de gestion de modèle de cours (SGMC))
|
/d2l/im/ipsis/lis/cmsv1p0/CourseTemplateManagementServices.svc
|
|
Group Management Service (GMS) (Service de gestion de groupe (SGG))
|
/d2l/im/ipsis/lis/gmsv2p0/GroupManagementServices.svc
|
|
Membership Management Service (MMS) (Service de gestion d’abonnements (SGA))
|
/d2l/im/ipsis/lis/mmsv2p0/MembershipManagementServices.svc
|
|
Outcomes Management Service (OMS) (Service de gestion de résultats (SGR))
|
d2l/im/ipsis/lis/omsv1p0/ResultManagementServices.svc
|
|
Person Management Service (PMS) (Service de gestion de personnel (SGP))
|
/d2l/im/ipsis/lis/pmsv2p0/PersonManagementServices.svc
|
|
Section Association Management Service (SAMS) (Service de gestion d’association de section (SGAS))
|
/d2l/im/ipsis/lis/cmsv1p0/SectionAssociationManagementServices.svc
|
HTTPS
|
Nom du service
|
Point d’extrémité du service
|
|
Bulk Data Exchange Management Service (BDEMS) (Service de gestion d’échange de données en bloc (SGEDB))
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
Course Offering Management Service (COMS) (Service de gestion d’offre de cours (SGOC))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseOfferingManagementServices.svc
|
|
Course Section Management Service (CSMS) (Service de gestion de section de cours (SGSC))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseSectionManagementServices.svc
|
|
Course Template Management Service (CTMS) (Service de gestion de modèle de cours (SGMC))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseTemplateManagementServices.svc
|
|
Group Management Service (GMS) (Service de gestion de groupe (SGG))
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/GroupManagementServices.svc
|
|
Membership Management Service (MMS) (Service de gestion d’abonnements (SGA))
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/MembershipManagementServices.svc
|
|
Outcomes Management Service (OMS) (Service de gestion de résultats (SGR))
|
/d2l/im/ipsis/lis/ssl/omsv1p0/ResultManagementServices.svc
|
|
Person Management Service (PMS) (Service de gestion de personnel (SGP))
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/PersonManagementServices.svc
|
|
Section Association Management Service (SAMS) (Service de gestion d’association de section (SGAS))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/SectionAssociationManagementServices.svc
|
Service WSDLS de LIS v2.0
Si WSDL est requis, vous ne devriez pas utiliser ceux qui se trouvent aux points d’extrémité du service, mais plutôt ceux qui se trouvent aux emplacements suivants :
HTTP
|
Service LIS
|
WSDL
|
|
Bulk Data Exchange Management Service (BDEMS) (Service de gestion d’échange de données en bloc (SGEDB))
|
/d2l/im/ipsis/lis/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Course Offering Management Service (COMS) (Service de gestion d’offre de cours (SGOC))
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Course Section Management Service (CSMS) (Service de gestion de section de cours (SGSC))
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Course Template Management Service (CTMS) (Service de gestion de modèle de cours (SGMC))
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Group Management Service (GMS) (Service de gestion de groupe (SGG))
|
/d2l/im/ipsis/lis/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Membership Management Service (MMS) (Service de gestion d’abonnements (SGA))
|
/d2l/im/ipsis/lis/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Outcomes Management Service (OMS) (Service de gestion de résultats (SGR))
|
/d2l/im/ipsis/lis/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Person Management Service (PMS) (Service de gestion de personnel (SGP))
|
/d2l/im/ipsis/lis/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Section Association Management Service (SAMS) (Service de gestion d’association de section (SGAS))
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
HTTPS
|
Service LIS
|
WSDL
|
|
Bulk Data Exchange Management Service (BDEMS) (Service de gestion d’échange de données en bloc (SGEDB))
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Course Offering Management Service (COMS) (Service de gestion d’offre de cours (SGOC))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Course Section Management Service (CSMS) (Service de gestion de section de cours (SGSC))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Course Template Management Service (CTMS) (Service de gestion de modèle de cours (SGMC))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Group Management Service (GMS) (Service de gestion de groupe (SGG))
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Membership Management Service (MMS) (Service de gestion d’abonnements (SGA))
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Outcomes Management Service (OMS) (Service de gestion de résultats (SGR))
|
/d2l/im/ipsis/lis/ssl/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Person Management Service (PMS) (Service de gestion de personnel (SGP))
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Section Association Management Service (SAMS) (Service de gestion d’association de section (SGAS))
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
Authentification
Les services LIS d’IPSIS v2.0 nécessitent une authentification par WS-Security ou une authentification HTTP de base et utilisent la base de données D2L pour authentifier le nom d’utilisateur et le mot de passe. Pour utiliser n’importe lequel des services, l’ID d’utilisateur qui sert à l’authentification doit être associé à un système source.
Les services gèrent tous l’authentification en essayant de valider le nom d’utilisateur et le mot de passe d’après la plateforme d’apprentissage. Si un nom d’utilisateur et un mot de passe valides qui figurent dans la plateforme d’apprentissage sont fournis et qu’il y a un système source IPSIS actif associé à cet utilisateur, toute requête de service LIS sera reconnue et traitée.
Si un nom d’utilisateur et un mot de passe non valides sont fournis, ou que l’utilisateur n’est pas associé à un système source IPSIS actif, la requête sera refusée et un message approprié sera transmis selon les spécifications LIS. Aux fins de dépannage, la journalisation de débogage peut être activée pour aider à déterminer pourquoi l’authentification ne fonctionne pas.
Le groupe de travail d’IMS LIS s’est entendu pour utiliser WS-Security ou l’authentification HTTP de base pour authentifier l’expéditeur de requêtes de service LIS.
En-têtes de requête
Tous les en-têtes de requête LIS contiennent les mêmes champs. D2L les traite comme suit :
|
En-tête
|
But
|
Note
|
|
imsx_syncRequestHeaderInfo.imsx_messageIdentifier
|
Cet en-tête est obligatoire.
L’identificateur du message de requête est retourné dans la réponse (imsx_syncresponseheaderinfo.imsx_statusinfo.imsx_messagerefidentifier) afin de permettre l’association de la réponse à une requête originale.
|
Ce ne sont pas tous les fournisseurs qui envoient une valeur valide; D2L la traite dans les deux sens. S’ils l’envoient, D2L la retourne dans la réponse.
|
|
imsx_syncRequestHeaderInfo.imsx_version
|
Cet en-tête est obligatoire.
La version a pour but de permettre au service de s’assurer que les deux systèmes reçoivent la même version du service.
|
À cette étape, il n’y a rien à faire avec la version entrante.
|
|
imsx_syncRequestHeaderInfo.imsx_sendingAgentIdentifier
|
Cet en-tête est facultatif (ajouté au WSDL le 2012-01-31).
L’identificateur de l’agent expéditeur sert à identifier la partie expéditrice. Pour les requêtes sortantes de D2L, la valeur est remplie par la valeur correspondant au nom du système source de IM_Sources.
|
Ce ne sont pas tous les fournisseurs qui l’envoient. D2L ne l’utilise pas du tout pour les requêtes entrantes. D2L utilise l’ID utilisateur qui a servi à l’authentification pour déterminer la partie expéditrice.
|
En-têtes de réponse
Tous les en-têtes de réponse de LIS contiennent les mêmes champs. D2L les traite comme suit :
|
En-tête
|
Réponse
|
Value
|
|
imsx_syncResponseHeaderInfo.imsx_version
|
D2L renvoie la valeur « V1.0 », indépendamment de la valeur dans l’en-tête de requête.
|
|
|
imsx_syncResponseHeaderInfo.imsx_messageIdentifier
|
D2L génère et retourne un identificateur unique pour cet en-tête.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor
|
D2L renvoie le code d’état principal tel que défini par IMS.
|
Échec – Lorsqu’un problème survient pendant le traitement de la requête.
En traitement – Lorsque la requête est en traitement.
Réussite – Lorsque le traitement de la requête a fonctionné.
Non pris en charge – Lorsqu’il n’y a aucune mise en œuvre pour la requête LIS, ou qu’il n’y a pas de traducteurs enregistrés pour l’opération.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity
|
D2L renvoie le code de sévérité tel que défini par IMS.
|
Erreur – Lorsque quelque chose d’indésirable ou d’inattendu est survenu. Le système appelant pourrait devoir prendre les mesures appropriées.
État – L’information. Action pas habituellement requise par le système appelant.
Avertissement – Lorsque quelque chose d’inattendu est survenu. Le système appelant pourrait devoir prendre les mesures appropriées.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier
|
D2L renvoie la valeur de l’imsx_syncRequestHeaderInfo.imsx_messageIdentifier
Si un identificateur de message n’a pas été envoyé avec la requête, ce champ n’est pas inclus.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_description
|
D2L renvoie un message contenant une description lisible par l’utilisateur pour tout message d’état.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldName
|
D2L renvoie le nom du champ de code d’état mineur comme défini par IMS.
|
TargetEndSystem
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue
|
D2L renvoie la valeur du champ de code d’état mineur comme défini par IMS.
|
deletefailure – Lorsqu’un problème survient pendant le traitement d’une requête de suppression.
fullsuccess – Lorsque le traitement de la requête a fonctionné.
invaliddata – Lorsque des champs requis manquent à la requête et que, par conséquent, le traitement ne peut pas se poursuivre.
partialdatastorage – Lorsque D2L enregistre avec succès certaines requêtes dans la base de données.
unknownobject – Lorsque la requête fait référence à un objet non trouvé dans IPSIS, et que, par conséquent, D2L ne peut pas traiter la requête.
unsupportedLISoperation – Lorsqu’il n’y a présentement aucune mise en œuvre pour la requête LIS, ou qu’il n’y a pas de traducteur enregistré pour l’opération.
idallocinusefail – Lorsque la requête essaie de réutiliser ou de modifier une entité actuelle d’un type différent (p. ex., si un replaceGroupRequest tente de changer un collège pour un semestre).
|