O Adaptador do IPSIS LIS v2.0 implementa os Serviços do LIS e as operações necessários para oferecer suporte aos seguintes perfis do IMS LIS:
- Perfil principal do IMS Global LIS v2.0
- Perfil de hierarquia de curso completo do IMS Global LIS v2.0
- Perfil principal de seções combinadas do IMS Global LIS v2.0
Cada serviço implementado pela D2L como parte do Adaptador do LIS v2.0 foi realizado de forma que os campos nas solicitações LIS possam ser mapeados para os campos da D2L com base nos requisitos da instituição. Isso é feito por meio de tradutores configuráveis e extensíveis, que mapeiam efetivamente os campos do LIS para os campos da Plataforma de aprendizagem da D2L.
Mais detalhes sobre os mapeamentos e comportamentos disponíveis são delineados na Operação do Serviço do LIS específica e nas Interfaces de tradutor usadas.
Pontos de extremidade do Serviço do LIS v2.0
Há pontos de extremidade separados para HTTP e HTTPS. Você deve usar o ponto de extremidade de serviço apropriado para sua implementação, dependendo de como o site é visto pelo IIS. Se o Suporte SSL for fornecido por um balanceador de carga, talvez seja necessário usar os pontos de extremidade HTTP.
HTTP
|
Nome do serviço
|
Ponto de extremidade do serviço
|
|
Serviço de gestão de troca de dados em lote (BDEMS)
|
/d2l/im/ipsis/lis/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
Serviço de gestão de oferta de curso (COMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseOfferingManagementServices.svc
|
|
Serviço de gestão de seção de curso (CSMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseSectionManagementServices.svc
|
|
Serviço de gestão de modelo de curso (CTMS)
|
/d2l/im/ipsis/lis/cmsv1p0/CourseTemplateManagementServices.svc
|
|
Serviço de gestão de grupo (GMS)
|
/d2l/im/ipsis/lis/gmsv2p0/GroupManagementServices.svc
|
|
Serviço de gestão de associação (MMS)
|
/d2l/im/ipsis/lis/mmsv2p0/MembershipManagementServices.svc
|
|
Serviço de gestão de resultados (OMS)
|
d2l/im/ipsis/lis/omsv1p0/ResultManagementServices.svc
|
|
Serviço de gestão de pessoas (PMS)
|
/d2l/im/ipsis/lis/pmsv2p0/PersonManagementServices.svc
|
|
Serviço de gestão de associação de seção (SAMS)
|
/d2l/im/ipsis/lis/cmsv1p0/SectionAssociationManagementServices.svc
|
HTTPS
|
Nome do serviço
|
Ponto de extremidade do serviço
|
|
Serviço de gestão de troca de dados em lote (BDEMS)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/BulkDataExchangeManagementServices.svc
|
|
Serviço de gestão de oferta de curso (COMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseOfferingManagementServices.svc
|
|
Serviço de gestão de seção de curso (CSMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseSectionManagementServices.svc
|
|
Serviço de gestão de modelo de curso (CTMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/CourseTemplateManagementServices.svc
|
|
Serviço de gestão de grupo (GMS)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/GroupManagementServices.svc
|
|
Serviço de gestão de associação (MMS)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/MembershipManagementServices.svc
|
|
Serviço de gestão de resultados (OMS)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/ResultManagementServices.svc
|
|
Serviço de gestão de pessoas (PMS)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/PersonManagementServices.svc
|
|
Serviço de gestão de associação de seção (SAMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/SectionAssociationManagementServices.svc
|
WSDLS do Serviço do LIS v2.0
Se o WSDL for necessário, você não deve usar os WSDLs encontrados no Ponto de extremidade do serviço, mas sim os WSDLs encontrados nos seguintes locais:
HTTP
|
Serviço do LIS
|
WSDL
|
|
Serviço de gestão de troca de dados em lote (BDEMS)
|
/d2l/im/ipsis/lis/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de oferta de curso (COMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de seção de curso (CSMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de modelo de curso (CTMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de grupo (GMS)
|
/d2l/im/ipsis/lis/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de associação (MMS)
|
/d2l/im/ipsis/lis/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de resultados (OMS)
|
/d2l/im/ipsis/lis/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de pessoas (PMS)
|
/d2l/im/ipsis/lis/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de associação de seção (SAMS)
|
/d2l/im/ipsis/lis/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
HTTPS
|
Serviço do LIS
|
WSDL
|
|
Serviço de gestão de troca de dados em lote (BDEMS)
|
/d2l/im/ipsis/lis/ssl/bdemsv1p0/wsdl/BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de oferta de curso (COMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de seção de curso (CSMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de modelo de curso (CTMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de grupo (GMS)
|
/d2l/im/ipsis/lis/ssl/gmsv2p0/wsdl/GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de associação (MMS)
|
/d2l/im/ipsis/lis/ssl/mmsv2p0/wsdl/MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de resultados (OMS)
|
/d2l/im/ipsis/lis/ssl/omsv1p0/wsdl/OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de pessoas (PMS)
|
/d2l/im/ipsis/lis/ssl/pmsv2p0/wsdl/PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
|
|
Serviço de gestão de associação de seção (SAMS)
|
/d2l/im/ipsis/lis/ssl/cmsv1p0/wsdl/CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
|
Autenticação
Os Serviços do IPSIS LIS v2.0 requerem autenticação via Segurança WS ou Autenticação básica HTTP e usam o banco de dados da D2L para autenticar o nome de usuário e a senha. Para que qualquer um dos serviços seja usado, o userid usado para autenticação deve estar associado a um sistema de origem.
Todos os Serviços identificam a autenticação tentando validar o nome de usuário e a senha contra a Plataforma de aprendizagem. Se for fornecido um Nome de usuário e uma Senha válidos da Plataforma de aprendizagem e existir um sistema de origem de IPSIS ativo associado a esse usuário, todas as solicitações de serviço do LIS serão reconhecidas e processadas.
Se for fornecido um nome de usuário e uma senha inválidos, ou se o usuário não estiver associado a um sistema de origem de IPSIS ativo, a solicitação será negada com uma mensagem de resposta apropriada de acordo com a especificação do LIS. Para fins de solução de problemas, a criação de logs de depuração pode ser ativada para ajudar a determinar por que a autenticação não está sendo executada com sucesso.
O grupo de trabalho de IMS do LIS estabeleceu o uso da Segurança WS ou Autenticação básica HTTP para autenticar o remetente das solicitações do Serviço do LIS.
Cabeçalhos de solicitação
Todos os cabeçalhos de solicitação do LIS contêm os mesmos campos e a D2L os manipula da seguinte maneira:
|
Cabeçalho
|
Finalidade
|
Observação
|
|
imsx_syncRequestHeaderInfo.imsx_messageIdentifier
|
Esse cabeçalho é obrigatório.
O identificador da mensagem de solicitação é retornado na resposta (imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier) para permitir a associação da resposta a uma solicitação de origem.
|
Nem todos os fornecedores enviam um valor válido, portanto, a D2L manipula-o de uma dessas maneiras. Se eles enviarem, a D2L o retornará na resposta.
|
|
imsx_syncRequestHeaderInfo.imsx_version
|
Esse cabeçalho é obrigatório.
Essa versão destina-se a permitir que o serviço garanta que os dois sistemas estão esperando a mesma versão do serviço.
|
Nesse ponto, não fazemos nada com a versão de entrada.
|
|
imsx_syncRequestHeaderInfo.imsx_sendingAgentIdentifier
|
Este cabeçalho é opcional (adicionado em 31-01-2012 WSDL).
O identificador do agente remetente é usado para identificar a parte remetente. Para solicitações de saída da D2L, o valor é preenchido usando o valor do Nome de sistema de origem de IM_Sources.
|
Nem todos os fornecedores enviam isso e a D2L não o usa em todas as solicitações de entrada. A D2L usa o userid que foi usado para autenticar para determinar o remetente.
|
Cabeçalhos de resposta
Todos os Cabeçalhos de resposta do LIS contêm os mesmos campos. A D2L manipula-os da seguinte forma:
|
Cabeçalho
|
Resposta
|
Valor
|
|
imsx_syncResponseHeaderInfo.imsx_version
|
A D2L retorna "V1.0" independentemente do valor no Cabeçalho da solicitação.
|
|
|
imsx_syncResponseHeaderInfo.imsx_messageIdentifier
|
A D2L gera e retorna um identificador exclusivo para esse cabeçalho.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor
|
A D2L retorna o Código de status principal definido pelo IMS.
|
Falha - quando há um problema no processamento da solicitação.
Processando - quando a solicitação está sendo processada.
Sucesso - quando o processamento da solicitação é bem-sucedido.
Não suportado - quando não há implementação para a solicitação do LIS ou não há tradutores registrados para a operação.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity
|
A D2L retorna a gravidade definida pelo IMS.
|
Erro - quando algo ruim ou inesperado ocorreu. O sistema de chamada pode precisar tomar as ações apropriadas.
Status - informações. Uma ação normalmente não é exigida do sistema de chamada.
Aviso - Quando algo inesperado ocorreu. O sistema de chamada pode precisar tomar as ações apropriadas.
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier
|
A D2L retorna o valor de imsx_syncRequestHeaderInfo.imsx_messageIdentifier.
Se um identificador de mensagem não foi enviado na solicitação, esse campo não será incluído.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_description
|
A D2L retorna uma mensagem contendo uma descrição legível por humanos de quaisquer mensagens de status.
|
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldName
|
A D2L retorna o Nome do campo do código de status secundário definido pelo IMS.
|
TargetEndSystem
|
|
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue
|
A D2L retorna o Valor do campo do código de status secundário definido pelo IMS.
|
deletefailure - quando há um problema no processamento de uma solicitação delete.
fullsuccess - quando tudo é processado com sucesso.
invaliddata - quando a solicitação tem campos obrigatórios ausentes e, portanto, o processamento não pode continuar.
partialdatastorage - quando a D2L salva com sucesso algumas das solicitações no banco de dados.
unknownobject - quando a solicitação faz referência a um objeto que não é encontrado no IPSIS e, portanto, a D2L não pode executar a ação solicitada.
unsupportedLISoperation - quando atualmente não há implementação para a solicitação do LIS ou não há tradutores registrados para a operação.
idallocinusefail - quando a solicitação está tentando reutilizar ou alterar uma entidade existente de um tipo diferente (por exemplo, se um replaceGroupRequest tentar alterar uma Faculdade para um Semestre).
|