Implementar o Grades Journey usando integração SITS

  1. Na Administração do sistema, em Blackboard Building, selecione Building Blocks.
  2. Selecione Ferramentas instaladas.
  3. Localize Serviço Blackboard Grade Journey e selecione Configurações.
  4. Use as seções abaixo para configurar as propriedades em cada grupo de configurações.

Configurações de tarefas e da coluna de notas (dados de entrada)

Configure as seguintes propriedades:

  • Programar trabalho
    • Defina Status do trabalho - selecione Desativado
    • Programação CRON - N/A
    • Área de conteúdo de provisionamento - escolha a pasta padrão onde os itens passíveis de avaliação serão criados, a menos que tenham sido substituídos na transação.
    • Verificação de provisionamento de item de conteúdo - Essa configuração define a regra de correspondência para itens de conteúdo fornecidos. As opções são:
      • Nenhuma restrição: Sempre adiciona itens do feed como novos itens de conteúdo.
      • Somente uma vez: Adiciona um determinado item somente uma vez (usado para o LIS).
      • Atualizar correspondências por nome: Adiciona itens na primeira passagem e atualiza com base na correspondência pelo título do item de conteúdo durante as importações subsequentes.
    • Verificação de provisionamento de item passível de avaliação - Essa configuração define a regra de correspondência para colunas de notas manuais fornecidas ou colunas de notas criadas como resultado dos itens de conteúdo fornecidos. As opções são:
      • Atualizar correspondências por nome: Adiciona itens na primeira passagem e os atualiza com base na correspondência pelo título do item de conteúdo durante as importações subsequentes.
      • Atualizar correspondências por metadados: Adiciona itens na primeira passagem e os atualiza com base em correspondência de valor armazenado em um atributo de metadados chamado de "Tipo", incluído na lista de dados opcionais do registro de dados de entrada do item durante as importações subsequentes.
  • Configurações da transferência do resultado, Formato de arquivo e Configurações de tarefas e da coluna de notas não se aplicam ao REST.

Depois de concluir, selecione Enviar.

Configurações da extração de notas (dados de saída)

Configure as seguintes propriedades:

  • Integração
    • Tipo de integração - Selecione Integração SITS. A Integração SITS resulta em três arquivos de saída: um resumo, um arquivo de avaliação e um arquivo de reavaliação.
    • Programação CRON - Selecione com que frequência as extrações em segundo plano devem ocorrer. Por exemplo, as extrações ocorrem a cada hora com este valor definido como 0 0/60 * 1/1 * ? *
    • Número arredondado - Selecione o número máximo de dígitos fracionários para uma pontuação.
    • Valor da extração em avaliações não marcadas - Selecione o valor nulo que deseja que os itens não marcados ou não avaliados retornem.
    • Filtro de colunas - Selecione essa opção se a lista de colunas de aprovação e a lista de colunas de extração devem ser limitadas a uma lista separada por vírgula específica de nomes de colunas de notas quando o provisionamento estiver desativado. O objetivo dessa configuração é permitir que a extração contenha apenas as colunas que precisam ser informadas.
    • Somente coluna de notas externas - Selecione essa opção se a lista de colunas de aprovação e de extração devem ser limitadas à coluna de notas externas do curso, ou seja, a coluna no centro de notas marcada como Notas externas.

      Essa configuração tem precedência sobre a configuração de Filtro de colunas.

    • Provisionamento ativado - Selecione essa configuração se a lista de colunas de aprovação e extração devem ser limitadas àquelas importadas como parte do Item de conteúdo e Item passível de avaliação fornecidos pelo SIS.
    • Mapeamento de colunas - Insira uma lista de pares de nomes/valores separada por uma barra vertical para identificar os campos de dados da coluna de notas para incluir em cada registro no relatório. Se ficar em branco, será incluída uma lista padrão de campos no relatório:
      EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA
  • Requisito da função do curso de extração
    • Funções de curso - Especifique as funções de curso necessárias para que um usuário possa aprovar notas (por exemplo, um instrutor).
    • Funções institucionais - Especifique as funções institucionais necessárias para que um usuário possa aprovar notas (por exemplo, um avaliador de notas).
    • Mensagem de acesso negado - Insira uma mensagem para os usuários que tentarem extrair notas sem permissão adequada.
  • Configurações da transferência do resultado
    • Ponto de extremidade do serviço da web de publicação - Especifique o ponto de extremidade para a publicação de notas.
    • Ponto de extremidade do serviço da web de teste - (Geralmente) Ignore essa configuração.
  • Configurações de segurança de REST (saída)
    • Ativar API REST de segurança - Habilite essa configuração se a segurança será implementada pelo ponto de extremidade. Se ativado, também defina:
      • Segredo compartilhado - Insira a chave compartilhada.
      • Chave de API - Insira a chave da API.
      • Intervalo de carimbo de data/hora - Não precisa definir.
      • Parâmetro de carimbo de data/hora - Insira o parâmetro para o carimbo de data/hora.
      • Parâmetro MAC - Insira o parâmetro MAC.
      • Parâmetro de chave de API - Insira a chave da API.
  • Configurações de aprovação e transferência de notas
    • Aprovação de notas necessária - Habilite essa configuração se você desejar que as notas sejam aprovadas no nível da coluna ou nota.
    • Mostrar página de histórico? - Habilite essa configuração se não desejar a aprovação no nível de notas e desejar que a página do histórico seja exibida quando você extrair do curso.
    • Botão de realizar extração ativado? - Habilite essa configuração para permitir que avaliadores executem a extração de forma imediata.
    • Botão de extração de programação ativado? - Habilite essa configuração para permitir que avaliadores programem/aprovem a extração.
    • Bloquear na aprovação? - Habilite essa configuração para alterar o centro de notas para somente leitura. Dessa forma, as notas não podem ser modificadas após a extração.

Depois de concluir, selecione Enviar.

Configurações de notificação

Se desejar, retorne para o menu Configurações e edite as configurações de notificação.

Configurações de segurança da API REST (segurança de dados de entrada)

Configure as seguintes propriedades:

  • Configurações de segurança de REST de saída
    • Ativar API REST de segurança - Habilite essa configuração se os pontos de extremidade de entrada implementarem a segurança.
    • Filtro de IP - Habilite o filtro para quaisquer IPs de entrada. Se essa configuração estiver ativada, defina também:
      • Segredo compartilhado - Insira a chave compartilhada.
      • Chave de API - Insira a chave da API.
      • Intervalo de carimbo de data/hora - Não precisa definir.
      • Parâmetro de carimbo de data/hora - Insira o parâmetro para o carimbo de data/hora.
      • Parâmetro MAC - Insira o parâmetro MAC.
      • Parâmetro de chave de API - Insira a chave da API.

Depois de concluir, selecione Enviar.

Nível de registro em log

Configure as seguintes propriedades:

  • Configuração de registro
    • Detalhamento de log - Defina essa configuração para determinar o nível de log para o arquivo /logs/custom/bbc-GradeyJourney.log. O valor padrão é INFO, mas recomendamos que você adicione DEBUG para fins de solução de problemas. A configuração de produção deve ser definida como INFO, exceto para depuração.

Executar um teste de validação

  1. Acesse a Administração do sistema > Configurações de extração de notas (Dados de saída).
  2. Atualize o método de transferência para Local e defina o caminho para uma pasta local que possa ser lida, atualizada e excluída do usuário que executa o Blackboard Learn. Selecione a Integração SITS com base em suas necessidades. Selecione Enviar.
  3. Em Configurações, selecione Configurações de tarefas e da coluna de notas (Dados de entrada).
  4. Altere Receber arquivos de entrada via FTP para Desativado e defina o caminho para uma pasta local que possa ser lida, atualizada e excluída do usuário com a Blackboard em execução. Selecione Enviar.
  5. Crie uma coluna de notas ponderadas no curso usando um arquivo simples. Crie os arquivos dos usuários para as inscrições.
  6. Faça login no Learn como instrutor e acesse o curso.
  7. Navegue até o Centro de Notas. A coluna de notas ponderadas será exibida.
  8. Crie uma tarefa e mapeie-a 100% à coluna ponderada.
  9. Insira as notas para as inscrições.
  10. No menu Gerenciar, selecione Transferência e aprovação de notas.
  11. Selecione o botão Extrair e programar no nível do curso, da coluna de notas ou das notas.
  12. Se a extração for realizada com sucesso, o arquivo ou arquivos serão exibidos na pasta de extração.
  13. Se a extração não for realizada com êxito, consulte o logon <bb home>/custom/log/bbgs-GradeJourney.log.