A interface de plug-in para IDeleteSectionAssociationHandler é usada pelos Adaptadores do IPSIS (Pacote de integração para sistemas de informação ao aluno) para excluir SectionAssociations do Brightspace.
A implementação da interface é D2L.IM.IPSIS.OrgUnits.SectionAssociations.Handlers.IDeleteSectionAssociationHandler.
A lista de configuração do IPSIS, Modelo - Associação de seção fornece um ponto de partida para qualquer implementação do IPSIS.
A seguinte lista de manipuladores é usada como ponto de partida:
- DeleteSectionAssociationValidateHandler (Ordem de classificação = 10)
- DeleteSectionAssociationIMHandler (Ordem de classificação = 20)
DeleteSectionAssociationValidateHandler
O DeleteSectionAssociationValidateHandler sempre deve ser usado. Ele executa validação de entrada que é necessária para garantir que todos os outros manipuladores Delete executem corretamente.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Verifica se o ID do SIS na solicitação corresponde a um item real nas tabelas IM.
- Verifica se o Tipo de OrgUnit esperado pelo serviço corresponde ao Tipo do OrgUnit no banco de dados.
- Se todas as verificações passarem, o manipulador salvará o ExternalOrgUnitInfo na solicitação para os manipuladores posteriores usarem.
Comportamento de erro
Se alguma parte da validação falhar, uma exceção será lançada, junto com o máximo possível de detalhes.
Nota sobre a configuração
O manipulador Validate normalmente deve ser executado primeiro na lista de manipuladores, antes de qualquer manipulador que atualize ou exclua as informações do banco de dados.
DeleteSectionAssociationIMHandler
O DeleteSectionAssociationIMHandler sempre deve ser usado. Ele executa validação de entrada que é necessária para garantir que todos os outros manipuladores Delete executem corretamente.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationValidateHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Verifica se o ID do SIS na solicitação corresponde a um item real nas tabelas IM.
- Verifica se o Tipo de OrgUnit esperado pelo serviço corresponde ao Tipo do OrgUnit no banco de dados.
- Se todas as verificações passarem, o manipulador salvará o ExternalOrgUnitInfo na solicitação para os manipuladores posteriores usarem.
Comportamento de erro
Se alguma parte da validação falhar, uma exceção será lançada, junto com o máximo possível de detalhes.
Nota sobre a configuração
O manipulador Validate normalmente deve ser executado primeiro na lista de manipuladores, antes de qualquer manipulador que atualize ou exclua as informações do banco de dados.
DeleteSectionAssociationIMHandler
O manipulador DeleteSectionAssociationIMHandler executa uma exclusão reversível do SectionAssociation nas Tabelas IM.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationIMHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Marca o SectionAssociation como excluído na Tabela de OrgUnits de IM.
- Remove os registros de Hierarquia para o SectionAssociation.
- Se houver um problema durante o processamento, o manipulador configurará o status do resultado para o código de erro apropriado.
- Se houver sucesso em tudo, o processamento continuará para o próximo manipulador (Return True).
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.
Nota sobre a configuração
O manipulador IM Delete deve ocorrer por último.
DeleteSectionAssociationInactiveLMSOfferingHandler
O DeleteSectionAssociationInactiveLMSOfferingHandler será usado se o comportamento desejado for que todas as Ofertas de LMS mapeadas sejam inativadas.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationInactiveLMSOfferingHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Inativar todas as Ofertas de curso associadas ao SectionAssociation especificado no LMS. Esse manipulador marca todos os mapeamentos para as Ofertas de curso do LMS como inativos.
- Se houver sucesso em tudo, o manipulador configurará o status do resultado para EntityDeleted.
- O processamento continua para o próximo manipulador (Return True).
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.
Notas sobre a configuração
Esse manipulador deve ser executado antes do manipulador DeleteIM.
DeleteSectionAssociationDeleteLMSGroupSectionHandler
O DeleteSectionAssociationDeleteLMSGroupSectionHandler será usado se o comportamento desejado for excluir quaisquer Grupos ou Seções do LE associados a uma Oferta de curso do LE atribuída à Associação de seção.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSGroupSectionHandler
Comportamento esperado
Esse manipulador só poderá prosseguir se houver um mapeamento para o registro de Associação de seção propriamente dito. O manipulador realiza as seguintes tarefas:
- Para cada OrgUnit do Sistema de gestão de aprendizagem (LMS) ao qual a Associação de seção está mapeada, o manipulador determinará os secundários do OrgUnit do LMS no Brightspace
- Para cada um desses Grupos ou Seção do LMS secundários de um OrgUnit para o qual o SA é mapeado, o manipulador excluirá o Grupo/Seção do LMS (resultando automaticamente em uma entrada de auditoria) e excluirá todos os registros de Mapeamento de IM associados ao Grupo/Seção do LMS.
- Se houver sucesso em tudo, o manipulador configurará o status do resultado para EntityDeleted.
- O processamento continua para o próximo manipulador (Return True)
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.
Nota sobre a configuração
- Esse manipulador deve ser executado antes do manipulador DeleteIM
- Se esse manipulador for usado em conjunto com o manipulador DeleteLMSOffering, DeleteLMSGroupSection deverá preceder DeleteLMSOffering.
DeleteSectionAssociationDeleteLMSOfferingHandler
O DeleteSectionAssociationDeleteLMSOfferingHandler é usado se o comportamento desejado for associar a Oferta de curso do Brightspace à Associação de seção excluída.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationDeleteLMSOfferingHandler
Comportamento esperado
Para cada Oferta de curso do LMS mapeada, o manipulador executa as seguintes tarefas:
- Se a Oferta não tiver mais Seções mapeadas como seus secundários (necessidade de comparar todos os secundários da Oferta com as unidades organizacionais na tabela de Mapeamento de IM), o manipulador excluirá a Oferta de curso do LMS (resultando automaticamente em uma entrada de auditoria).
- Se a oferta tiver mais Seções mapeadas como seus secundários, o manipulador não excluirá a Oferta de curso do LMS.
- O manipulador faz uma exclusão reversível do registro de Mapeamento de IM associado com a Oferta.
- Se houver sucesso em tudo, o manipulador configurará o status do resultado para EntityDeleted.
- O processamento continua para o próximo manipulador (Return True).
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.
Notas sobre a configuração
Esse manipulador deve ser executado antes do manipulador DeleteIM.
DeleteSectionAssociationUnenrolLMSGroupSectionHandler
O DeleteSectionAssociationUnenrolLMSGroupSectionHandler cancela a inscrição dos usuários de quaisquer seções que devem ser removidas da associação.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrollLMSGroupSectionHandler
Comportamento esperado
Esse manipulador só executa se houver um mapeamento para a Associação de seção e se houver seções associadas (com um mapeamento) a serem removidas do LMS. O manipulador realiza as seguintes tarefas:
- Para cada Seção na Hierarquia de associação de seção, o manipulador determina quais usuários estão inscritos na Seção (da Tabela de inscrições de IM).
- Cancela a inscrição dos usuários da Seção específica do curso do LMS que será removida (resultando automaticamente em uma entrada de auditoria).
- Se houver sucesso em tudo, o manipulador configurará o status do resultado para EntityDeleted.
- O processamento continua para o próximo manipulador (Return True).
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.
Nota sobre a configuração
Esse manipulador deve ser colocado antes do manipulador DeleteLMSGroupSection para garantir a remoção de todas as inscrições necessárias do LMS.
DeleteSectionAssociationUnenrolLMSOfferingHandler
Os usuários DeleteSectionAssociationUnenrolLMSOfferingHandlerUnenrolls da oferta principal do mapeamento da seção excluída, a menos que estejam inscritos em outro grupo/seção com o mesmo tipo de grupo sob a oferta.
Implementação
D2L.IM.IPSIS.Default.OrgUnits.SectionAssociations.Handlers.DeleteSectionAssociationUnenrolLMSOfferingHandler
Comportamento esperado
Esse manipulador só executa se houver um mapeamento para a Associação de seção e se houver seções associadas (com um mapeamento) a serem removidas do LMS. O manipulador realiza as seguintes tarefas:
- Para cada Seção na Hierarquia de associação de seção, o manipulador determina quais usuários estão inscritos na Seção (da Tabela de inscrições de IM).
- Se o Usuário não estiver inscrito em Seções (ou Grupos) com o mesmo tipo de grupo, sob a Oferta do LMS, o manipulador cancelará a inscrição dos usuários da Oferta de curso do LMS que será removida (resultando automaticamente em uma entrada de auditoria).
- Se houver sucesso em tudo, o manipulador configurará o status do resultado para EntityDeleted.
- O processamento continua para o próximo manipulador (Return True).
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.
Notas sobre a configuração
- Esse manipulador deve ser colocado após o manipulador Create IM.
- Esse manipulador deve ser colocado antes do manipulador DeleteLMSGroupSection para garantir a remoção de todas as inscrições necessárias do LMS.
- Esse manipulador deve ser colocado antes do manipulador Save IM.