Um manipulador do IPSIS é a implementação de uma ou mais regras de negócios que se aplicam aos dados provenientes do Sistema de informações do aluno. Cada manipulador é uma implementação de uma interface de manipulador específica, que está alinhada com ações comumente aplicadas à Plataforma de aprendizagem e ao Brightspace (p. ex., Criar usuário ou Excluir seção). O uso das interfaces de manipuladores do IPSIS e seus manipuladores configuráveis permitem que as instituições configurem, com flexibilidade, o sistema faz quando uma solicitação é recebida de um sistema externo.
A fim de promover a reutilização o máximo possível, manipuladores são implementados para fazer tarefas muito específicas. Múltiplos manipuladores são usados em série para executar tarefas mais complexas. Em alguns casos, pode haver muitos manipuladores em ação; portanto, é útil agrupá-los em categorias diferentes, servindo a fins específicos.
Os manipuladores são implementados usando as convenções de manipuladores do IPSIS, o que ajuda as organizações a entender as diversas opções de manipuladores disponíveis.
A Plataforma IPSIS define uma coleção de interfaces de manipuladores que são específicas para os tipos de ações em objetos que normalmente são enviados de um SIS para o Brightspace. Cada interface possui um conjunto de manipuladores que implementam a interface para aplicar um conjunto específico de regras de negócios para uma organização. Em alguns casos, não há muitos manipuladores para escolher porque as regras de negócios são genéricas e reutilizáveis; no entanto, em muitos casos, há um grande número de manipuladores para escolher.
ReplaceUserUpdateAuditorsHandler
O ReplaceUserUpdateAuditorsHandler cria as relações de auditor, se ainda não existirem no Brightspace.
Implementação
D2L.IM.IPSIS.Default.Users.Handlers.ReplaceUserUpdateAuditorsHandler,D2L.IM.IPSIS.Default
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Se o auditor declarado no XML já existir no Brightspace, a relação auditor/auditado será criada automaticamente no Brightspace
- Relações ausentes fazem com que o sistema exclua a relação no Brightspace
- O processamento prossegue para o próximo manipulador
Comportamento de erro
Se houver um problema durante o processamento, uma exceção será lançada, junto com o máximo possível de detalhes.
Configuração
Deve ser colocado após os manipuladores Create.
ReplaceCourseTemplateParentsNoUpdateLMSHandler
Quando um ReplaceTemplateRequest é processado através de IPSIS, o ReplaceCourseTemplateParentsNoUpdateLMSHandler recupera
unidades organizacionais acima do modelo do curso e preserva essa relação, mesmo que elas não tenham sido criadas por meio de IPSIS, portanto ele não é substituído pela operação de atualização.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.CourseTemplates.Handlers.ReplaceCourseTemplateParentsNoUpdate
LMSHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- O manipulador busca todos os principais modelos de curso e atualiza a lista principal
- O processamento prossegue para o próximo manipulador
Comportamento de erro
- Nenhum erro é lançado nesse manipulador
Nó de configuração
- Esse manipulador deve ocorrer após os manipuladores Read e Validate
- Esse manipulador deve ocorrer antes dos manipuladores Save