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:
- No Painel do administrador, em Integrações, selecione Integração de dados.
- Selecione Integrações dos Sistemas de Informações do Aluno (SIA).
- Aponte para Criar Integração.
- 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:
|
Status da integração | Obrigatório | Opções de status da integração:
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.
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.
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.
|
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:
- Criação de mapeamentos de campo personalizados
- Criando cabeçalhos personalizados
- 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