A interface de plug-in para IReadGradesHandler é usada pelos Adaptadores do IPSIS para oferecer suporte à operação de leitura para as Notas.
A implementação da interface é D2L.IM.IPSIS.OrgUnits.Memberships.Handlers.IReplaceEnrollmentHandler.
As listas de configuração a seguir, para a interface ReadGradesHandler, são fornecidas com o produto. Elas são listadas junto com o ponto de Extensão ao qual se destinam.
IPSIS, Modelo – Notas
- ReadGradesGradableMappingGetFirstMappingWithGradesHandler (Ordem de classificação = 10)
- ReadGradesResolveGradeTypeFromCourseSettingHandler (Ordem de classificação = 20)
- ReadGradesStatusDefaultAllHandler (Ordem de classificação = 30)
- ReadGradesDisplayTypeDefaultPointsHandler (Ordem de classificação = 40)
- ReadGradesValidateHandler (Ordem de classificação = 50)
- ReadGradesGetGradesForSectionMappingHandler (Ordem de classificação = 60)
- ReadGradesFilterBySISEnrollmentsHandler (Ordem de classificação = 70)
ReadGradesGradableMappingDefaultToFirstMappingHandler
Um único objeto de orgUnit no SIS pode ser mapeado para vários OrgUnits no Brightspace. Por exemplo, isso pode acontecer com os manipuladores padrão para uma seção que faz parte de uma ou mais associações de seção. Quando a entrada contém um SISId para um OrgUnit, mas não contém um mapeamento, um único mapeamento precisa ser selecionado do conjunto. O manipulador Default to First Mapping simplesmente escolhe o primeiro mapeamento na lista retornada do banco de dados.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingDefaultToFirstMappingHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Se já houver um OrgUnitMapping anexado à solicitação, o manipulador não fará nada.
- Caso contrário, se não houver SisId na solicitação, o manipulador lançará um IncompleteRequestException.
- Se o SisId existir, o manipulador procurará os Mapeamentos de OrgUnit no banco de dados.
- Se vários mapeamentos forem retornados, o manipulador selecionará o primeiro da lista. Geralmente esse é o que tem o Id mais baixo, o que significa que foi mapeado em primeiro lugar.
- O Mapeamento de objeto da solicitação é atualizado com esse valor. Essa informação está disponível para os manipuladores posteriores.
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 GradableMapping deve ser colocado antes que as notas reais sejam recuperadas do banco de dados.
- Há manipuladores planejados que usam outros critérios para selecionar um mapeamento, incluindo a escolha do primeiro mapeamento com notas ou o marcado como avaliável. Para evitar confusão, apenas um desses manipuladores GradableMapping deve ser usado em uma determinada lista de configuração.
ReadGradesGradableMappingGetIsGradableMappingHandler
Um único objeto de orgUnit no SIS pode ser mapeado para vários OrgUnits no Brightspace. Por exemplo, isso pode acontecer com os manipuladores padrão para uma seção que faz parte de uma ou mais associações de seção. Quando a entrada contém um SISId para um OrgUnit, mas não contém um mapeamento, precisamos selecionar um único mapeamento do conjunto. O manipulador Get Is Gradable Mapping seleciona o primeiro mapeamento que está marcado como É avaliável.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetIsGradableMappingHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Se já houver um OrgUnitMapping anexado à solicitação, o manipulador não fará nada.
- Caso contrário, se não houver SisId na solicitação, o manipulador lançará um IncompleteRequestException.
- Se o SisId existir, o manipulador procurará os Mapeamentos de OrgUnit no banco de dados.
- Se vários mapeamentos forem retornados, o manipulador selecionará o primeiro que tiver o destaque de avaliável configurado como verdadeiro. Se não houver esse mapeamento, o manipulador lançará um NoGradableSectionsException.
- Se vários mapeamentos estiverem configurados como avaliáveis, o manipulador lançará um MultipleGradableSectionsException.
- O Mapeamento de objeto da solicitação é atualizado com esse valor. Essa informação está disponível para os manipuladores posteriores.
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
- O manipulador GradableMapping deve ser colocado antes que as notas reais sejam recuperadas do banco de dados.
- Há manipuladores que usam outros critérios para selecionar um mapeamento, incluindo a escolha do primeiro mapeamento com notas ou apenas o primeiro mapeamento em geral. Para evitar confusão, apenas um desses manipuladores GradableMapping deve ser usado em uma determinada lista de configuração.
ReadGradesResolveGradeTypeFromCourseSettingHandler
Quando um tipo de nota (final ajustada/calculada) ainda não estiver configurado (por um tradutor ou manipulador anterior), esse manipulador configurará o tipo de nota com base na variável de configuração relevante (Grades.Calculation.ReleaseAdjustedGrade).
O manipulador lê a configuração da oferta de curso e não da seção. Ele captura o mapeamento da unidade organizacional principal (oferta de curso) para o acesso à variável de configuração.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesResolveGradeTypeFromCourseSettingHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Se o tipo de nota ainda não estiver configurado, recupere a variável de configuração para GradeType. Ele é controlado por uma configuração do livro de notas.
- Configure o tipo de nota (final calculada ou final ajustada).
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 ResolveGradeType deve ocorrer antes que as notas reais sejam recuperadas do banco de dados (isto é, antes de ReadGradesGetGradesForSectionHandler) e depois de selecionar o mapeamento.
ReadGradesStatusDefaultAllHandler
Esse manipulador configura o status de classificação como Todos.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultAllHandler
Comportamento esperado
Se o status da nota ainda não estiver configurado, configure-o como Todos.
Notas sobre a configuração
- O manipulador StatusDefault deve ocorrer antes do manipulador DisplayTypeDefault (Pontos ou Símbolos).
- O manipulador StatusDefault deve ocorrer antes que as notas reais sejam recuperadas do banco de dados (isto é, antes de ReadGradesGetGradesForSectionMappingHandler).
- Esse manipulador StatusDefault não deve ser usado em conjunto com qualquer outro manipulador StatusDefault.
ReadGradesGetGradesForSectionMappingHandler
O ReadGradesGetGradesForSectionMappingHandler recupera as notas do banco de dados.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGetGradesForSectionMappingHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Se o Id do SIS de entrada não corresponder a uma Seção nas tabelas de IM, o manipulador lançará uma exceção.
- Caso contrário, o manipulador recupera as notas reais do Gerenciador de notas, filtradas pelas opções configuradas até agora.
- Recupera as inscrições SIS para todos os usuários inscritos no OrgUnit especificado por meio do mapeamento.
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 ocorrer depois de qualquer manipulador que configura o Tipo de solicitação, Status ou Mapeamento, mas antes que as Notas sejam filtradas.
ReadGradesValidateHandler
O ReadGradesValidateHandler valida que todas as propriedades necessárias foram configuradas e o orgUnit é de um tipo que suporta as notas no Brightspace.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesValidateHandler
Comportamento esperado
- Se o Id do SIS de entrada não corresponder a uma Seção da oferta nas tabelas IM, o manipulador lançará uma exceção.
- Caso contrário, o manipulador validará que GradeType e GradeStatus no objeto de solicitação foram configurados por tradutores e/ou manipuladores anteriores.
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 ocorrer depois que o tipo e o status são selecionados, mas antes de realmente ler as notas do banco de dados.
ReadGradesMatchGradesToSISEnrolledUsersHandler
O ReadGradesMatchGradesToSISEnrolledUsersHandler aceita uma lista de notas e retorna uma lista de notas combinadas com UserIds do SIS. As notas que não corresponderem aos usuários inscritos no SIS são omitidas.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesIncludeOnlySISEnrolledUsersHandler
Comportamento esperado
O Gerenciador de notas retorna todas as Notas para o OrgUnit, mas essas Notas correspondem a um UserId do LMS e não a um UserId do SIS. Esse manipulador determina o UserId do SIS apropriado para cada Nota e retorna um conjunto de pares Nota/SISUserId. Se não houver UserId do SIS para um determinado usuário, a Nota associada será omitida dos resultados.
O manipulador realiza as seguintes tarefas:
- Recupera uma lista de inscrições para o OrgUnit atual.
- Para cada um, determina o UserId do SIS do Usuário inscrito.
- Localiza o primeiro IGrade correspondente a esse Usuário, se houver.
- Cria um novo objeto encapsulando pares de IGrade e SISUserId e anexe-o à resposta.
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 ocorrer após a leitura das notas do banco de dados.
- Esse manipulador é necessário para permitir que o SIS corresponda as notas aos usuários usando um Id que eles entendam. Esse manipulador (ou uma substituição personalizada) sempre deve ser configurado.
ReadGradesStatusDefaultReleasedOnlyHandler
O manipulador ReadGradesStatusDefaultReleasedOnlyHandler configura o tipo de nota como Lançado.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesStatusDefaultReleasedOnlyHandler
Comportamento esperado
Se o tipo de nota ainda não estiver configurado, configure-o como Lançado.
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
- O manipulador StatusDefault deve ocorrer antes do manipulador DisplayTypeDefault (Pontos ou Símbolos).
- O manipulador StatusDefault deve ocorrer antes que as notas reais sejam recuperadas do banco de dados (isto é, antes de ReadGradesGetGradesForSectionMappingHandler).
- Esse manipulador StatusDefault não deve ser usado em conjunto com qualquer outro manipulador StatusDefault.
ReadGradesGradableMappingGetFirstMappingWithGradesHandler
O ReadGradesGradableMappingGetFirstMappingWithGradesHandler configura o mapeamento da unidade organizacional para o primeiro (classificado por id do orgunitmapping) que tiver notas disponíveis.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesGradableMappingGetFirstMappingWithGradesHandler
Comportamento esperado
O manipulador realiza as seguintes tarefas:
- Se o mapeamento de unidade organizacional não estiver configurado, o manipulador captura todos os mapeamentos de unidade organizacional que correspondem ao identificador externo e os classifica por id de mapeamento de unidade organizacional.
- O manipulador verifica o primeiro que tiver uma nota marcada como disponível. As notas verificadas são extraídas com base no destaque do tipo de nota da oferta relacionado (isto é, se a oferta de curso da seção estiver configurada para lançar FinalAdjusted, o manipulador verificará se há Notas finais ajustadas disponíveis). Disponível significa que a nota tem um numerador que é maior que 0 ou tem um conjunto de símbolos. Essencialmente, disponibilidade significa que a nota tem um valor configurado nessa seção.
- O manipulador configura o mapeamento da unidade organizacional de solicitação para esse mapeamento.
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.
- Se nenhum mapeamento de unidade organizacional for encontrado, um OrgUnitMappingNotFoundException será lançado.
- Se nenhuma nota for encontrada para qualquer um dos mapeamentos da unidade organizacional, um NoGradableSectionFoundException será lançado.
Notas sobre a configuração
- Esse manipulador deve ser colocado antes que as notas sejam realmente lidas no banco de dados. Ele também deve ser colocado antes de qualquer manipulador que precise saber a unidade organizacional em que está trabalhando (como o manipulador que tenta ler a configuração da unidade organização).
- Esse manipulador é um dos vários que seleciona um mapeamento de unidade organizacional. Nunca deve haver mais de um desses manipuladores na configuração ativa ao mesmo tempo.
ReadGradesDisplayTypeDefaultPointsHandler
O ReadGradesDisplayTypeDefaultPointsHandler configura o tipo de exibição de nota como Pontos. Isso afeta a exibição na UI da Exportação de notas, bem como as notas enviadas para o SIS.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultPointsHandler
Comportamento esperado
Se o tipo de exibição de nota ainda não estiver configurado, configure-o como Pontos.
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
- O manipulador DisplayTypeDefault deve ocorrer antes que as notas reais sejam recuperadas do banco de dados (isto é, antes de ReadGradesGetGradesForSectionMappingHandler).
- Esse manipulador DisplayTypeDefault não deve ser usado em conjunto com qualquer outro manipulador DisplayTypeDefault.
ReadGradesDisplayTypeDefaultSymbolsHandler
O ReadGradesDisplayTypeDefaultSymbolsHandler configura o tipo de exibição de nota como Símbolos. Isso afeta a exibição na UI de Exportação de notas, bem como as notas enviadas para o SIS.
Implementação
D2L.IM.IPSIS.Default.Grades.Handlers.ReadGradesDisplayTypeDefaultSymbolsHandler
Comportamento esperado
Se o tipo de exibição de nota ainda não estiver configurado, configure-o como Símbolos.
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
- O manipulador DisplayTypeDefault deve ocorrer antes que as notas reais sejam recuperadas do banco de dados (isto é, antes de ReadGradesGetGradesForSectionMappingHandler).
- Esse manipulador DisplayTypeDefault não deve ser usado em conjunto com qualquer outro manipulador DisplayTypeDefault.