Skip to main content

Configure um Extrato de Boletim de Notas

Extratos do Boletim de Notas são extratos totalmente automatizados que não exigem aprovação de notas para inclusão no extrato. Para acessar as Configurações de Extração de Notas para um extrato de Boletim de Notas:

  1. Acesse o Painel do Administrador.

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

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

  4. Escolha a lupa na coluna Configurar na linha GRADEBOOK_EXTRACT que você deseja configurar.

Isso vai te dar acesso à aba Configurações de Extração de Nota. Esta aba tem seis 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. Insira uma expressão CRON válida para especificar a frequência do extrato.

  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 Curso

Os cursos incluídos no trecho devem atender a todos os critérios configurados.

  1. Ative a opção Apenas Cursos Disponíveis para incluir apenas dados dos cursos disponíveis no extrato do Boletim de Notas.

  2. Procure por disciplinas que serão incluídas no trecho de notas. Coloque seus parâmetros de busca, e quaisquer cursos que forem retornados serão incluídos. Você pode pesquisar com base em:

    • Código de identificação do lote

    • Código do curso

    • Nome do curso

    • Chave da fonte de dados

    • Período

    • Data de Criação do Curso

    • Intervalo de Datas do Curso

  3. Insira uma lista separada por vírgulas dos códigos de cursos que você não quer que estejam incluídos no extrato do Boletim de Notas na Lista de Exclusão de Disciplinas .

Filtro de Coluna

O filtro de coluna é usado para determinar quais colunas de nota são extraídas.

  • Filtro de Colunas Preencha esta caixa se quiser extrair apenas colunas específicas 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 extrair apenas a coluna externa de notas (nos cursos Originais) ou a nota geral (nos cursos Ultra). Essa configuração tem precedência sobre a configuração Filtro de Coluna e a configuração de Provisão Habilitada. Se você tiver essa opção selecionada, será a única coluna de notas que será extraída.

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

  • Inclua apenas linhas desde a última execução Clique em esta caixa se quiser incluir apenas registros de coluna de notas onde o valor da nota mudou desde a última extração.

  • Exclua as colunas calculadas 'Todos' Clique em esta caixa de seleção em combinação com o filtro de colunas anterior para evitar que colunas calculadas sejam incluídas no extrato de nota quando o valor da coluna mudar.

  • Exclua 'Todos' registros com notas vazias Clique em esta caixa para evitar que registros sem valor de nota sejam incluídos no extrato do Boletim de Notas.

  • 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 esse campo for deixado vazio, 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. Essa configuração normalmente não se aplica ao extrato do Boletim de Notas, desde que os comentários do instrutor sejam fornecidos no fluxo de trabalho de aprovação.

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

  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

Exportação de Notas fará uma solicitação para o 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".

  • 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

Clique em Enviar para salvar suas escolhas.