Configurar uma integração do Arquivo simples de instantâneo é simples, desde que você compreenda alguns princípios básicos da Estrutura do SIA 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 (SIA).
  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ção Obrigatório Insira 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ção Opcional Digite uma descrição para a sua integração. Útil para uma identificação adicional das integrações.
Nome de usuário compartilhado Obrigatório O Nome de usuário compartilhado é gerado automaticamente a partir do sistema SIA e preenchido nessa caixa de texto. É usado para as operações de publicação de dados, junto com a Senha compartilhada.
Senha compartilhada Obrigatório Digite a senha gerada pelo sistema SIA.
Delimitador de feed file Obrigatório Selecione 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ção Obrigatório Opções de status da integração:
  • Inativo: O sistema não processará as solicitações ou atualizará os dados no banco de dados.
  • Ativo: O sistema processará as solicitações, atualizará os dados no banco de dados e será visível para os usuários.
  • Teste: Os dados não são integrados no sistema ativado.

A Blackboard recomenda que as integrações comecem no Teste. Selecionar esse status permitirá que você teste a integração e resolva 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 log Obrigatório A opção Nível de detalhamento do log determina o que é visível na tela Logs SIA para essa integração.
  • Somente erros: Qualquer problema fatal ou que impeça as operações de criação, atualização, desativação ou remoção.
  • Erros e avisos: Qualquer problema que não seja fatal ou 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.

A seleção de um nível de detalhamento de registro também selecionará o nível ou níveis menos detalhados que precedem o nível selecionado. Por exemplo, se você selecionar o nível de registro de Mensagens, erros, avisos e mensagens serão registrados.

Etapa 2: Propriedades da integração

Fonte de dados do Learn Obrigatório Determine 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.

Observação: 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 código de identificação do lote Opcional Evite conflitos de código 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 principal Obrigatório Essa 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 SIA 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 SIA disponíveis.


Saiba mais

Planejamento de integrações de SIA

Visão geral da chave da fonte de dados

Visão geral da estrutura do SIA

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