Configurar uma integração do Arquivo simples de instantâneo é simples, desde que você compreenda alguns princípios básicos da Estrutura do SIS e tenha uma compreensão de seus objetivos de integração em relação ao ciclo de vida dos dados. A seguir, é apresentada uma configuração básica de acordo com padrões, seguida por uma descrição de como a personalização das configurações individuais pode afetar a função da integração.


Configuração de Arquivo simples de instantâneo

Siga estas etapas para criar e configurar as informações básicas para uma integração padrão do Arquivo simples de instantâneo:

  1. No Painel do administrador, em Integrações, selecione Integração de dados.
  2. Selecione Integrações dos Sistemas de Informações do Aluno (SIS).
  3. Aponte para Criar Integração.
  4. Selecione Arquivo simples de instantâneo.

Na tela seguinte, serão exibidas as opções editáveis para a configuração.

Etapa 1: Propriedades da integração

Nome da integraçãoObrigatórioInsira um nome exclusivo para a integração – é o nome mostrado na lista de integrações configuradas na página Integrações dos Sistemas de informação do aluno.
DescriçãoOpcionalDigite uma descrição para a sua integração. Útil para uma identificação adicional das integrações.
Nome de usuário compartilhadoObrigatórioO Nome de usuário compartilhado é gerado automaticamente a partir do sistema SIS e preenchido nessa caixa de texto. É usado para as operações de publicação de dados, junto com a Senha compartilhada.
Senha compartilhadaObrigatórioDigite a senha gerada pelo sistema SIS.
Delimitador de feed fileObrigatórioSelecione o tipo de delimitador usado no Arquivo de feed atual. O delimitador é o caractere usado para separar campos no arquivo de dados. Opções de delimitador:
  • Vírgula
  • Ponto e vírgula
  • Barra vertical
  • Tabulação
  • Outro
Status da integraçãoObrigatórioOpções de status da integração:
  • Inativo: O sistema não processará solicitações nem atualizará os dados na base de dados.
  • Ativo: O sistema processará solicitações, atualizará dados na base de dados e estará visível aos usuários.
  • Teste: Os dados não são integrados no sistema ativo.

A Blackboard recomenda que as integrações comecem em Teste. Selecionar este status permitirá que você teste a integração e repare quaisquer problemas que possam surgir antes da integração. Depois que o teste estiver concluído, o status deve ser configurado como Inativo ou Ativo.

Para executar a configuração avançada, uma integração deve ser configurada com o status Teste de Ativo.

Nível de detalhamento do logObrigatórioA opção Nível de detalhamento do log determina o que é visível na tela Logs SIS para essa integração.
  • Somente erros: Qualquer problema fatal, qualquer problema que impeça a criação, atualização, desativação ou remoção de operações.
  • Erros e avisos: Qualquer problema não fatal, qualquer problema com um registro individual, ou qualquer operação bem-sucedida que exija a alteração do registro.
  • Todas as mensagens de diagnóstico: Qualquer atividade bem-sucedida, incluindo tipos de registros e contagens, cronometragem e dados.
  • Todas as mensagens de diagnóstico e depuração: Todos os registros individuais e tentativas de transformação de dados.

Selecionar um nível de log detalhado também selecionará o nível de log menos detalhado ou níveis que precedem o nível de log selecionado. Por exemplo, se você selecionar o nível de log de Mensagem, erros, avisos e mensagens serão registrados em log.

Etapa 2: Propriedades da integração

Fonte de dados do LearnObrigatórioDetermine a fonte de dados usada durante a integração com o Blackboard Learn.
  • Use a fonte de dados do Learn definida nos dados de entrada
  • Use a mesma fonte de dados do Learn para todos os novos dados de entrada. Selecione Nova fonte de dados na lista suspensa e digite a nova chave de fonte de dados na caixa de texto.
  • Use a mesma fonte de dados do Learn para todos os novos dados de entrada. Selecione uma chave de fonte de dados existente na lista suspensa.

Nota: As chaves de Fonte de dados devem ser previamente definidas usando a ferramenta de Gerenciamento de fonte de dados (consulte Visão geral da chave de fonte de dados)

Prefixo de UID em loteOpcionalEvite conflitos de ID prefixando os identificadores dos objetos criados durante a integração. A Blackboard recomenda que você não altere essa configuração depois que os dados tiverem sido criados para a integração.
Nó de hierarquia principalObrigatórioEssa opção está disponível somente para o IMS Enterprise 1.1, IMS Enterprise 1.1 – Vista e integrações de Arquivo simples de instantâneo.
  • Criar hierarquia sob o nível superior
  • Criar hierarquia sob o nó especificado. Selecione Localizar nó se houver nós disponíveis para serem escolhidos.

Neste ponto, a configuração de uma integração padrão do Arquivo simples de instantâneo está completa e você pode testá-la configurando o status de integração para Teste e carregando manualmente um arquivo de dados do Arquivo simples de instantâneo. Consulte Formato de dados de arquivo simples de instantâneo para obter exemplos de inicialização.

Configurações avançadas da integração

Embora as configurações padrão sejam adequadas para a maioria das condições, os objetivos de integração podem representar requisitos que exigem alterações adicionais na configuração. Em alguns casos, o alinhamento entre os objetivos desejados para o gerenciamento de dados do Learn e o do SIS pode não ser possível. As configurações avançadas permitem o gerenciamento dos dados recebidos dentro do Framework, a fim de reforçar os objetivos de dados do Learn.

As configurações avançadas para uma integração são possíveis por meio de três pontos na interface do administrador da Integração dos Sistemas de informação do aluno:

  1. Criação de mapeamentos de campo personalizados
  2. Criando cabeçalhos personalizados
  3. Configurações avançadas da integração; Etapa 3 de uma configuração de integração.

Para saber mais sobre criação de mapeamento de campo personalizado do arquivo simples de instantâneo, consulte Snapshot Flat File Custom Field Mapping and Snapshot Flat File Header Descriptions.

As configurações avançadas de integração disponíveis para as inserções e atualizações são:

  • Não inserir nem atualizar: Ignorar os dados recebidos para este objeto.
  • Inserir somente: Adicionar somente novos objetos; não fazer nada se um objeto correspondente a essa chave externa de dados já existir.
  • Somente atualizações: Somente atualizar os objetos existentes; não fazer nada se um objeto não existir.
  • Inserções inteligentes ou atualizações (Padrão): Se não houver nenhum objeto correspondente no Learn, adicione como um novo objeto; se um objeto correspondente existir no Learn, atualize com os dados recebidos.

Você também pode determinar o que acontece quando um processo de exclusão está sendo executado:

  • Não desabilitar nem remover: Não excluir ou marcar para excluir qualquer objeto no sistema com base no arquivo de feed.
  • Desativar: Marcar para exclusão, mas não excluir realmente os objetos no sistema com base no arquivo de feed.
  • Remover: Excluir o objeto do sistema com base no arquivo de feed.

As configurações acima podem ser aplicadas a cada objeto suportado pelo Arquivo simples de instantâneo (como mostrado na UI). As alterações das configurações padrão permitirão um ajuste da integração para fornecer o gerenciamento do objeto além do que é fornecido somente pelos dados nos feeds SIS disponíveis.


Saiba mais

Planejamento de integrações de SIS

Visão geral da chave da fonte de dados

Visão geral da estrutura SIS

Visão geral do XML de instantâneo e Arquivo simples de instantâneo