Configuração de arquivo simples do Snapshot
Configurar uma integração do arquivo simples do Snapshot é 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 do Snapshot
Siga estas etapas para criar e configurar as informações básicas para uma integração padrão do arquivo simples do Snapshot:
No Painel do administrador, em Integrações, clique em Integração de dados.
Clique em Integrações dos sistemas de Informações do Aluno (SIA).
Passe o mouse sobre Criar integração e clique em arquivo simples do Snapshot.
Na próxima tela, serão exibidas as opções editáveis para a configuração.
Etapa 1: Propriedades de 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ções 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 arquivo de feed | 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 definida como Status de teste ou Ativo. |
Verbosidade de log | Obrigatório | A opção Nível de detalhamento do registro determina o que é visível na tela Registros 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 de integração
Fonte de dados do Learn | Obrigatório | Determine a fonte de dados usada durante a integração com o Blackboard.
Observação: as chaves da fonte de dados devem ser definidas previamente usando a ferramenta de gerenciamento da fonte de dados (consulte Visão geral da chave da fonte de dados) |
Prefixo do 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 pai | 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 do Snapshot.
|
Neste ponto, a configuração de uma integração padrão de arquivo simples do Snapshot está concluída e você pode testá-la definindo o Status de Integração como Teste e carregando manualmente um arquivo de dados de arquivo simples do Snapshot – consulte Formato de Dados de arquivo simples do Snapshot para obter exemplos iniciais).
Configurações avançadas de 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 as metas desejadas para o gerenciamento de dados do Blackboard e o gerenciamento de dados do Sistema de informações do aluno (SIA) pode não ser possível. As configurações avançadas permitem o gerenciamento no Framework de dados recebidos para aplicar as metas de dados do Blackboard.
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ções do aluno:
Criação de mapeamentos de campo personalizados
Criando cabeçalhos personalizados
Configurações avançadas de integração na Etapa 3 de uma configuração de integração.
Para saber mais sobre como criar mapeamentos de campos e mapeamentos de cabeçalhos personalizados, consulte Mapeamento de campos personalizados de arquivo simples do Snapshot e Descrições de cabeçalho de arquivo simples do Snapshot.
As configurações avançadas de integração disponíveis para as inserções e atualizações são:
Não inserir ou atualizar: ignore os dados de entrada para este objeto.
Inserir apenas: Adicione apenas novos objetos; Não faça nada se existir um objeto que corresponda a essa chave externa de dados.
Somente atualizações: Atualize apenas objetos existentes; não faça nada se um objeto não existir
Inserções ou atualizações inteligentes (padrão): Se não houver nenhum objeto correspondente no Blackboard, adicione-o como um novo objeto; se houver um objeto correspondente no Blackboard, atualize-o com os dados recebidos.
Você também pode determinar o que acontece quando um processo de exclusão está sendo executado:
Nota
Nem todas as opções estão disponíveis para todos os tipos de dados.
Não desabilitar ou limpar: não exclua ou marque para exclusão qualquer objeto no sistema com base no arquivo de feed.
Desabilitar: Marque para exclusão, mas não exclua nenhum objeto no sistema com base no arquivo de feed.
Limpar: Exclua o objeto do sistema com base no arquivo de feed.
Exclusão inteligente: desabilite nos modos de Atualização Completa (ou Atualização Completa por DSK). Excluir no modo Excluir.
As configurações acima podem ser aplicadas a cada objeto suportado pelo arquivo simples do Snapshot (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.