El Adaptador IPSIS LIS v 2.0 implementa las operaciones y los Servicios de LIS necesarios para admitir los siguientes perfiles de LIS del IMS:
- Perfil Principal de IMS Global LIS v2.0
- Perfil Jerarquía de cursos completa de IMS Global LIS v2.0
- Perfil Secciones combinadas de IMS Global LIS v2.0
Cada servicio implementado por D2L como parte del adaptador LIS v2.0 se realizó de forma tal que los campos en las solicitudes de LIS se puedan a asignar a los campos de D2L en función de los requisitos de una institución en particular. Esto se realiza mediante traductores configurables y extensibles, que asignan efectivamente los campos de LIS a los campos en la plataforma de aprendizaje de D2L.
Los detalles acerca de las asignaciones y los comportamientos disponibles se detallan en las interfaces de Operación de servicios de LIS y el Traductor que cada uno utiliza.
Extremos de los servicios LIS v2.0
Hay extremos separados para HTTP y HTTPS. Debe utilizar el extremo de servicio apropiado para su implementación de acuerdo con la forma en que el IIS ve el sitio. Si un equilibrador de carga proporciona el soporte de SSL, es posible que deba utilizar los extremos HTTP.
HTTP
|
Nombre del servicio
|
Extremo de servicio
|
|
Servicio de gestión de intercambio de datos en masa (BDEMS)
|
/d2l/im/ipsis/lis/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
Servicio de gestión de oferta de cursos (COMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseOfferingManagementServices.svc
|
|
Servicio de gestión de sección de cursos (CSMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseSectionManagementServices.svc
|
|
Servicio de gestión de plantilla del curso (CTMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseTemplateManagementServices.svc
|
|
Servicio de gestión de grupos (GMS)
|
/d2l/im/ipsis/lis/gmsv2p0/GroupManagementServices.svc
|
|
Servicio de gestión de membresía (MMS)
|
/d2l/im/ipsis/lis/mmsv2p0/MembershipManagementServices.svc
|
|
Servicio de gestión de resultados (OMS)
|
d2l/im/ipsis/lis/omsv1p0/ResultManagementServices.svc
|
|
Servicio de gestión de personas (PMS)
|
/d2l/im/ipsis/lis/pmsv2p0/PersonManagementServices.svc
|
|
Servicio de gestión de asociación de sección (SAMS)
|
/d2l/im/ipsis/lis/cmsv1p0/SectionAssociationManagementServices.svc
|
HTTPS
|
Nombre del servicio
|
Extremo de servicio
|
|
Servicio de gestión de intercambio de datos en masa (BDEMS)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
Servicio de gestión de oferta de cursos (COMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseOfferingManagementServices.svc
|
|
Servicio de gestión de sección de cursos (CSMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseSectionManagementServices.svc
|
|
Servicio de gestión de plantilla del curso (CTMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseTemplateManagementServices.svc
|
|
Servicio de gestión de grupos (GMS)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/GroupManagementServices.svc
|
|
Servicio de gestión de membresía (MMS)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/MembershipManagementServices.svc
|
|
Servicio de gestión de resultados (OMS)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/ResultManagementServices.svc
|
|
Servicio de gestión de personas (PMS)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/PersonManagementServices.svc
|
|
Servicio de gestión de asociación de sección (SAMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/SectionAssociationManagementServices.svc
|
WSDLS del Servicio de LIS v2.0
Si el WSDL es necesario, no debe utilizar los WSDL que se encuentran en los Extremos del servicio, sino los WSDL que se encuentran en las siguientes ubicaciones:
HTTP
|
Servicio de LIS
|
WSDL
|
|
Servicio de gestión de intercambio de datos en masa (BDEMS)
|
/d2l/im/ipsis/lis/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de oferta de cursos (COMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de sección de cursos (CSMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de plantilla del curso (CTMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de grupos (GMS)
|
/d2l/im/ipsis/lis/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de membresía (MMS)
|
/d2l/im/ipsis/lis/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de resultados (OMS)
|
/d2l/im/ipsis/lis/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de personas (PMS)
|
/d2l/im/ipsis/lis/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de asociación de sección (SAMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
HTTPS
|
Servicio de LIS
|
WSDL
|
|
Servicio de gestión de intercambio de datos en masa (BDEMS)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de oferta de cursos (COMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de sección de cursos (CSMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de plantilla del curso (CTMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de grupos (GMS)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de membresía (MMS)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de resultados (OMS)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de personas (PMS)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Servicio de gestión de asociación de sección (SAMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
Autenticación
En el caso de los Servicios LIS v2.0 de IPSIS se requiere la autenticación a través de la Seguridad en servicios web (WS-Security) o la Autenticación básica de HTTP, además de utilizar la base de datos de D2L para autenticar el nombre de usuario y la contraseña. Con el fin usar cualquiera de los servicios, el userid usado para autenticar debe asociarse a un sistema de origen.
Todos los servicios controlan la autenticación mediante intentos por validar el nombre de usuario y la contraseña contra la Plataforma de aprendizaje. Si se provee un Nombre de usuario y una Contraseña válidos desde la Plataforma de aprendizaje y existe un sistema de origen de IPSIS activo asociado con el usuario, las solicitudes del servicio de LIS se reconocerán y procesarán.
Si se proveen un nombre de usuario y una contraseña inválidos, o el usuario no está asociado con un sistema de origen del IPSIS activo, se denegará la solicitud con el mensaje de respuesta apropiado, según la especificación del LIS. Con el fin de solucionar problemas, el registro de depuración puede activarse para ayudar a determinar el motivo por el que la autenticación no se realizó correctamente.
El grupo de trabajo LIS del IMS se estableció en el uso de Seguridad en servicios web o Autenticación básica de HTTP para autenticar al remitente de las Solicitudes de servicio de LIS.
Solicitar encabezados
Todos los encabezados de solicitud de LIS contienen los mismos campos, y D2L los controla de la siguiente forma:
|
Encabezado
|
Propósito
|
Nota
|
|
imsx_syncRequestHeaderInfo.imsx_messageIdentifier
|
Este encabezado es obligatorio.
El identificador del mensaje de solicitud se devuelve en la respuesta (imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier) para permitir la asociación de la respuesta con la solicitud original.
|
No todos los proveedores envían un valor válido, por lo que D2L lo controla a su manera. Si lo hacen, D2L lo devuelve en la respuesta.
|
|
imsx_syncRequestHeaderInfo.imsx_version
|
Este encabezado es obligatorio.
El propósito de la versión es permitir que el servicio garantice que los dos sistemas están esperando la misma versión del servicio.
|
En este punto, no debemos hacer nada con la versión entrante.
|
|
imsx_syncRequestHeaderInfo.imsx_sendingAgentIdentifier
|
Este encabezado es opcional (agregado al 2012-01-31 WSDL).
El identificador del agente de envío se utiliza para identificar al remitente. Para las solicitudes salientes desde D2L, el valor se completa con el valor Nombre del sistema de origen de IM_Sources.
|
No todos los proveedores lo envían y D2L no lo utiliza para todas las solicitudes entrantes. D2L utiliza el userid que se utilizó para la autenticación, con el propósito de determinar el remitente.
|
Encabezados de respuesta
Todos los Encabezados de respuesta LIS contienen los mismos campos. D2L los controla de la siguiente forma:
|
Encabezado
|
Respuesta
|
Valor
|
|
imsx_syncResponseHeaderInfo.imsx_version
|
D2L devuelve “V1.0”, independientemente del valor del encabezado de la solicitud.
|
|
|
imsx_syncResponseHeaderInfo.imsx_messageIdentifier
|
D2L genera y devuelve un identificador único para este encabezado.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor
|
D2L devuelve el código de estado mayor definido por el IMS.
|
Error: cuando se produce un problema de procesamiento de la solicitud.
Procesamiento: cuando se procesa la solicitud.
Correcto: cuando la solicitud se procesa correctamente.
No compatible: cuando no existe una implementación para la solicitud de LIS, o no hay Traductores registrados para la operación.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity
|
D2L devuelve la gravedad según lo definido por el IMS.
|
Error: cuando se produce algo malo o inesperado. El sistema de llamadas deberá tomar la medida adecuada.
Estado: información. Generalmente, no se requiere una medida por parte del sistema de llamadas.
Advertencia: cuando se produce algo inesperado. El sistema de llamadas deberá tomar la medida adecuada.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier
|
D2L devuelve el valor desde imsx_syncRequestHeaderInfo.imsx_messageIdentifier.
Si no se envió un identificador de mensajes en la solicitud, este campo no se incluirá.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_description
|
D2L devuelve un mensaje que contiene una descripción legible de los mensajes de estado.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldName
|
D2L devuelve el nombre del campo del código de estado menor definido por el IMS.
|
TargetEndSystem
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue
|
D2L devuelve el valor del campo del código de estado menor definido por el IMS.
|
deletefailure: cuando se produce un problema de procesamiento de la solicitud.
fullsuccess: cuando todo se ha procesado correctamente.
invaliddata: cuando faltan campos obligatorios en la solicitud y, por lo tanto, el procesamiento no puede continuar.
partialdatastorage: cuando D2L guarda correctamente algunas de las solicitudes en la base de datos.
unknownobject: cuando la solicitud hace referencia a un recurso que no se encuentra en el IPSIS y, por lo tanto, D2L no puede tomar la medida solicitada.
unsupportedLISoperation: cuando no existe una implementación actual para la solicitud de LIS, o no hay traductores registrados para la operación.
idallocinusefail: cuando la solicitud intenta reutilizar o cambiar una entidad existente de un tipo diferente (p. ej., si una replaceGroupRequest intenta cambiar una Universidad a un Semestre).
|