Skip to main content

Configure o Fluxo de Trabalho de Aprovação

O fluxo de trabalho de aprovação, se habilitado, é configurado para rodar em um programação específico e extrai automaticamente as notas aprovadas. Para acessar as Configurações de Extração de Nota para o fluxo de trabalho de aprovação:

  1. Acesse o Painel do Administrador.

  2. Clique em Extensões de Plataforma em Gerenciamento de Nuvem.

  3. Escolha Editar Configurações no menu Exportação de Notas v2.

  4. Escolha a lupa na coluna Configurar na linha FLUXO_DE_TRABALHO_DE_APROVAÇÃO.

Isso vai te dar acesso à aba Configurações de Extração de Nota. Esta aba tem sete seções expansíveis.

Configurações Gerais

  1. Escolha o Tipo de Integração.

    • Integração NORMAL: formato de arquivo delimitado

    • Integração REST: Formato JSON específico do Jornada de Notas

    • Integração com Banners Legados: Formato REST API de Banners Legados

  2. O programação CRON determina com que frequência o arquivo de notas aprovadas é extraído. Habilitar o Habilitado? alternar se quiser que o processo rode no Programação indicado, então insira a expressão CRON para especificar a frequência da extração.

  3. No campo Casas Decimais, insira o número de dígitos que será exibido após a casa decimal para os valores de pontuação. O valor é truncado, não arredondado, e o padrão é cinco.

  4. Insira o valor nulo a ser devolvido para itens não avaliados, não marcados ou campos que não têm valor armazenado no campo Extrair Valor para Avaliações Não Marcadas (por exemplo, "0" ou "noValue").

  5. Especifique uma lista separada por vírgulas de notas que serão consideradas valores válidos no campo Notas Válidas. Essas deveriam ser notas por letras, não números. Se um valor de nota não for válido, ele não é incluído no extrato e aciona uma notificação por e-mail. Registros excluídos do extrato por serem inválidos são adicionados a um arquivo que está anexado à notificação por e-mail.

    Nota

    Se você deixar esta caixa em branco, todas as notas são consideradas válidas.

  6. Insira uma máscara válida de formato de data no campo Formatar para data na coluna. Esse formato será usado para quaisquer valores de data incluídos no extrato. Use Java SimpleDateFormat.

Filtro de Período

  1. Habilite a opção de Habilitado para filtrar o extrato por período.

  2. Clique em ADICIONAR ou DELETE para adicionar ou excluir linhas.

  3. Na coluna TERM, clique nos períodos pelos quais você deseja filtrar a extração. Apenas cursos associados aos períodos selecionados serão incluídos no trecho.

  4. Insira uma data de vigência e uma data de encerramento nas colunas apropriadas. Os dados serão extraídos de cursos associados ao período dado se a data atual estiver entre a data de entrada em vigor e a data de encerramento. As datas podem ficar em branco e o trecho não será limitado por datas.

Filtro de Coluna

O filtro de coluna é usado para determinar quais colunas de notas são exibidas aos avaliadores para aprovação. Apenas uma opção de filtro pode estar ativa por vez.

  • Filtro de Colunas Preencha esta caixa se quiser mostrar apenas colunas específicas para os avaliadores quando o provisionamento estiver desabilitado. Insira as colunas em uma lista separada por vírgulas de nomes de colunas. O objetivo dessa configuração é permitir que o extrato contenha apenas as colunas que precisam ser reportadas.

  • Coluna de Notas Externas (Original) ou Nota Geral (Ultra) Apenas Clique em esta caixa se quiser mostrar apenas a coluna externa de notas (nos cursos Originais) ou a nota geral (nos cursos Ultra) para os avaliadores. Essa configuração tem precedência sobre a configuração Filtro de Coluna e a configuração de Provisão Habilitada.

  • Provisão Habilitada Clique em esta caixa se quiser mostrar apenas colunas de notas importadas como parte dos itens graduáveis provisionados do Sistema de informações do aluno (SIA) para os avaliadores. Essa configuração tem precedência sobre a configuração do Filtro de Coluna.

  • Validação de Metadados em Colun Se você escolher Provisionamento Habilitado, é exibida uma caixa de Validação de Metadados em Coluna. Opcionalmente, insira um conjunto de pares chave/valor e seu número esperado de ocorrências nos metadados da coluna de notas para determinar se o curso pode ser extraído. Se esses parâmetros não forem cumpridos, o sistema retornará um erro, e os dados do curso não serão extraídos.

Mapeamento de Colunas

Insira uma lista de pares nome/valor separados por um símbolo de pipe para identificar os campos de dados da coluna de notas para incluir para cada registro no relatório. Se essa caixa ficar vazia, uma lista padrão de campos será passada no extrato.

Um exemplo de mapeamento é:

external_course_key=Course.getBatchUid|External_person_key.=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

Mapeamento adicional de colunas

Habilite o botão Habilitar para cada um dos seguintes campos de Dados Adicionais se quiser incluí-los no extrato:

  • Data Última de Participação A última data em que um exercício ou tentativa de avaliação foi criada. O valor do cabeçalho pode ser modificado atualizando o campo EXTRACTION KEY. O valor padrão é last_attendance_date.

  • Comentários do Instrutor O comentário fornecido pelo instrutor ou aprovador em uma coluna de notas calculadas. O valor do cabeçalho pode ser modificado atualizando o campo EXTRACTION KEY. O valor padrão é instructor_comment.

Definição de Funções do Curso de Extração

  1. Habilite o botão Habilitar Fluxo de Trabalho do Rremetente toggle para adicionar uma etapa adicional ao fluxo de trabalho onde as notas são enviadas a um aprovador (por exemplo, um assistente de ensino envia as notas para o instrutor aprovar).

  2. Para Funções Obrigatórias a Aprovar, especifique as funções do curso que serão exigidas para que um Usuário possa iniciar o processo de aprovação para aprovar notas (como Instrutor). Se desejar, também especifique quaisquer cargos institucionais adicionais que sejam necessários para aprovar notas (como Aprovador das Notas). Um usuário com qualquer uma dessas funções poderá aprovar as notas.

  3. Para Cargos Obrigatórios a Enviar, especifique as funções do curso que serão exigidas para que um Usuário possa iniciar o processo de aprovação para enviar notas (como Assistente de Ensino). Se desejado, especifique também quaisquer cargos institucionais adicionais que sejam obrigados a enviar notas (como Remetente das Notas). Um usuário com qualquer uma dessas funções poderá enviar notas.

    Nota

    Essa configuração só será exibida se o fluxo de trabalho do Remetente estiver habilitado.

  4. A mensagem de acesso negado não deve ser preenchida aqui; a mensagem de acesso negado personalizada agora é inserida na tela Configurar Funções.

Configurações de Transferência de Resultados

Opção de integração NORMAL

Configurações de Transferência de Resultados

  1. No campo Máscara de Nome de Arquivo, defina o padrão para o nome do extrato do arquivo. Quando o Tipo de Transferência é definido como Arquivo Combinado, "combined_" é adicionado ao início do nome do arquivo.

  2. Escolha o método Transferência. SFTP é o método de transferência mais comum e suas configurações são descritas nestes passos.

  3. Escolha o Tipo de Transferência.

    • Cada arquivo resulta em um único arquivo de extração por curso sendo transferido individualmente

    • Resultados combinados arquivo em um arquivo vão todas as linhas aprovadas para todos os cursos

      Nota

      Um extrato manual gera um arquivo de extração específico para cada curso.

  4. Habilite Use o Windows EOL se isso for processado em um ambiente Windows que exija Windows EOL.

  5. Insira a URL ou o IP do servidor SFTP no campo Servidor.

  6. Insira a porta do servidor SFTP (normalmente 22) no campo Porta .

  7. Insira o nome de usuário SFTP no campo Nome de usuário .

  8. Digite a senha do SFTP no campo Senha .

  9. Insira o caminho dos arquivos extraídos no campo Caminho.

Formato de Extração de Arquivo

  1. Insira o Delimitador de Campo para usar no arquivo de extração. O padrão é um tubo (|).

  2. Entra na Classificatória de Campo. Esse é o caractere a ser usado se os dados extraídos contêm o delimitador. O padrão é uma aspas dupla (").

Opção de integração com REST

Configurações de Transferência de Resultados

  1. Especifique o endpoint para as notas a serem publicadas no campo Post Webservice Endpoint.

  2. Insira o número máximo de registros a serem incluídos em uma operação no campo Registros Máximo de Descanso.

Opções de Segurança de Descanso (Saída)

Clique em Sim para Habilitar REST API Segura. Se habilitado, também defina um Mecanismo de Segurança.

OAuth 1.0

  • Segredo Compartilhado: entre no segredo compartilhado OAuth

  • API Key: insira a chave API OAuth

MAC Security

Saiba mais sobre segurança MAC.

  • Segredo Compartilhado: entre no segredo compartilhado

  • Chave API: insira a chave API

  • Parâmetro de carimbo de tempo: insira o parâmetro que indicará o valor de carimbo de tempo na string de consulta

  • Parâmetro MAC: insira o parâmetro que indicará o valor MAC na string de consulta

  • Parâmetro API Key: insira o parâmetro que indicará o valor MAC na string de consulta

OAuth 2.0

Grades Journ fará uma solicitação ao endpoint configurado pela URL do token REST. A autorização será enviada como um cabeçalho de solicitação. O tipo de subsídio será client_credentials e enviado no corpo da solicitação: grant_type: "client_credentials".

Preencha os seguintes campos:

  • Chave REST: Insira a chave que será usada para acessar a API

  • Segredo REST: Insira o segredo que será usado para acessar a API

  • URL do Token REST: Insira a URL que será usada para solicitar um token de acesso

Aprovação de Notas e Configurações de Transferência

Configurações de aprovação de notas e transferência

  1. Habilite Aprovação de Nota Necessária para habilitar a aprovação de nota no nível coluna ou de nota. Se isso não for habilitado, as notas só podem ser aprovadas no nível do curso.

  2. Clique em Botão Extrair Notas Habilitado para fazer o botão Extrair Notas for exibido para Aprovadores. Os avaliadores poderão rodar o extrato imediatamente. Para uma integração NORMAL, o extrato só será gerado e enviado quando o Tipo de Transferência for definido para Cada Arquivo.

    Nota

    O botão Extrair Notas sempre será exibido para usuários administradores de aprovadores de notas.

  3. Clique em Botão Enviar Notas habilitado? para fazer o botão Enviar Notas for exibido para os Enviantes.

    Nota

    Se o fluxo de trabalho do enviar não estiver habilitado, essa caixa de seleção ficará oculta.

    O botão Enviar Notas sempre será exibido para usuários do Administrador do Aprovador de Notas se o fluxo de trabalho do remetente estiver habilitado.

  4. Clique em Só permita aprovações para notas enviadas para evitar que notas com status diferente do enviado sejam aprovadas ou não aprovadas.

    Nota

    Se o fluxo de trabalho do enviar não estiver habilitado, essa caixa de seleção ficará oculta.

  5. Select Only allow extract for approved grades? to prevent grades that are not in the Approved status from being extracted. If a grader tries to manually extract grades that are not in the Approved status, they will receive an error message.

  6. Clique em Habilitar os Comentários do Instrutor se a coluna de Comentários do Instrutor deve estar disponível para os instrutores na área de Aprovação de Notas sobre notas associadas às colunas calculadas e do manual.

  7. Clique em Permitir a busca de cursos por Avaliadores de Notas? se o link de Busca Avançada deve ser visível para os instrutores na área de Aprovação de Notas para que possam buscar um curso diferente ao qual foram designados.

  8. Clique em Aprovar notas habilitado? fazer o botão Aprovar Notas for exibido para aprovadores.

    Nota

    O botão Aprovar Notas sempre será exibido para usuários administradores de aprovadores de notas.

  9. Clique em Permitir apenas desaprovações com mensagem de motivo? evitar que as notas sejam não aprovadas na ferramenta de Aprovação e Transferência de Notas caso um motivo não tenha sido inserido.

    Nota

    Se o fluxo de trabalho do enviar não estiver habilitado, a caixa de seleção ficará oculta.

  10. Clique em Limitar o acesso a cursos infantis apenas a remetentes ou aprovadores para limitar os remetentes ou aprovadores a apenas atender alunos do mesmo nível para disciplinas infantis às quais foram designados.

  11. Clique em Restringa as operações ao nível de nota para evitar todas as ações de aprovação de notas no nível do curso e da coluna de notas. Quem remete e aprova só poderá agir no nível de nota.

  12. A configuração Lançar diretamente para o nível de nota é para um recurso futuro no fluxo de trabalho de aprovação e não deve ser selecionada.

  13. Clique em Incluir Notas Não Publicadas para incluir notas que não foram publicadas no trecho de notas. Isso não inclui colunas manuais ou colunas onde as notas foram sobrepostas, mas ainda não publicadas.

  14. Select Validate Grades to prevent invalid grades from being submitted, approved, or extracted, based on the valid grades that are configured in the General Settings section. If a grader tries to submit, approve, or extract invalid grades, they will receive an error message.

Configuração do Valor de Exibição de Nota

Defina o valor da nota para ser exibido no fluxo de trabalho de Aprovação:

  • Letra de Nota : se o valor do esquema for uma letra, então ele retorna uma nota de letra; caso contrário, ele retornará uma cadeia vazia

  • Valor do Esquema: retorna a exibição primária da coluna de notas

  • Pontuação Percentual: retorna a pontuação percentual calculada

  • Valor do Esquema Secundário: retorna a exibição secundária da coluna de notas (se aplica apenas aos cursos originais)

  • Valor de Pontuação: retorna o valor da pontuação

Centro de Nota Somente Leitura (Original)

As seguintes opções se aplicam apenas à experiência do curso Original. As opções disponíveis para a experiência do curso Ultra são abordadas na próxima seção.

Você pode bloquear o centro de notas do curso e redirecionar usuários que tentam acessar as notas para uma página somente leitura. Para Travar na Aprovação, escolha uma das três opções:

  • Imediatamente após a aprovação: bloqueie o centro de notas imediatamente após a aprovação da nota daquele curso pelo aprovador

  • Após a Data de Entrega da Coluna de Notas: bloqueia o centro de notas após a data de entrega da coluna selecionada ser atingida

    Nota

    Se essa opção for selecionada, você deve habilitar Recursos Somente Leitura Aprimorados e inserir o nome da coluna de notas cuja data de entrega será usada para determinar quando o centro de notas será bloqueado na caixa Bloquear Nome da Coluna de Nota.

  • Deficiente: não bloqueie o centro de notas.

Ative a opção de Recursos Somente Leitura Aprimorados para configurar recursos adicionais somente leitura para os ambientes de curso para testes Originais.

  • Título da página: insira um título de página para a página somente leitura

  • Bloquear Nome da Coluna de Notas: insira o nome da coluna de nota cuja data de entrega será usada para determinar quando o centro de notas será bloqueado

  • Hora de travar o curso: opcionalmente, insira um horário para o trabalho de travamento ser executado. Se nenhum horário for inserido, o trabalho será executado à meia-noite.

  • Tempo para manter os ambientes de curso para testes desbloqueados manualmente (Horas): opcionalmente, insira um valor para quanto tempo (em horas) um curso desbloqueado manualmente permanecerá desbloqueado antes de ser automaticamente travado novamente

  • Tempo para bloquear automaticamente o Centro de Nota (Horas): opcionalmente, insira um valor para quanto tempo (em horas) o centro de notas deve ficar bloqueado após ocorrer o evento de aprovação de notas

  • Exceção de Aprovação de Bloqueio (Horas): opcionalmente insira um valor para quanto tempo (em horas) um cargo com privilégios de Aprovador ainda pode acessar o centro de notas após o evento de travamento

  • Exceção de Desaprovação de Bloqueio (Horas): opcionalmente insira um valor para quanto tempo (em horas) um cargo com privilégios de remetente ainda pode acessar o centro de notas após o travamento, mesmo que existam notas não aprovadas

  • Função do curso não afetada pelo bloqueio: clique em o(s) função(ões) do curso que não serão redirecionados para a página de visualização somente leitura do centro de notas e ainda poderão acessar a página completa de Transferência e Aprovação de Notas mesmo que esteja bloqueada

    Nota

    Administrador de Sistema é o único cargo que sempre poderá acessar a página completa de Transferência e Aprovação de Notas.

Somente leitura do Centro de Notas (Ultra)

As seguintes opções se aplicam apenas à experiência do curso Ultra. As opções disponíveis para a experiência do curso original são abordadas na seção anterior.

Você pode bloquear o centro de notas do curso e redirecionar usuários que tentam acessar as notas para uma página somente leitura. Para Aprovação Travada, você tem as seguintes opções:

  • Imediatamente após a aprovação: essa opção não se aplica à visualização Somente Leitura Ultra

  • Após a Data de Entrega da Coluna de Notas: bloqueia o centro de notas após a data de entrega da coluna selecionada ser atingida

    Nota

    Se essa opção for selecionada, você deve habilitar Recursos Somente Leitura Aprimorados e inserir o nome da coluna de notas cuja data de entrega será usada para determinar quando o centro de notas será bloqueado na caixa Bloquear Nome da Coluna de Nota.

    Nota

    Você pode desbloquear o percurso temporariamente, se necessário, depois que o travamento estiver concluído.

  • Deficiente: não bloqueie o centro de notas.

Ative o botão de Recursos Somente Leitura Aprimorados para configurar o Nome da Coluna de Bloquear Nota e o tempo para travar o percurso para os cursos Ultra.

  • Bloquear Nome da Coluna de Notas: insira o nome da coluna de nota cuja data de entrega será usada para determinar quando o centro de notas será bloqueado

  • Hora de travar o curso: opcionalmente, insira um horário para o trabalho de travamento ser executado. Se nenhum horário for inserido, o trabalho será executado à meia-noite.

Nota

Nenhum dos outros Recursos Somente Leitura Aprimorados se aplicará aos Cursos Ultra.

Clique em uma ou mais posições

Especifique as colocações LTI que serão usadas para rodar a ferramenta de Aprovação de Notas e Transferência dos cursos Original e Ultra. A Ferramenta de Instrutor e a Ferramenta de Administrador são estágios obrigatórios. Clique em Iniciar em uma nova janela para que o LTI abra em uma janela separada.

Clique em Enviar para salvar todas as suas opções.