Principais conceitos dos conjuntos de importação

Saiba mais sobre conjuntos de importação antes de importar dados para sua instância.

A tabela de conjuntos de importação atua como uma área de preparação para registros importados de uma fonte de dados.

Nota:

Não importe dados em partes extremamente grandes. Criar um conjunto de importação extremamente grande pode causar atrasos e indisponibilidades do sistema.

Um mapa de transformação determina os relacionamentos entre os campos exibidos em uma tabela de conjunto de importação e os campos em uma tabela ServiceNow existente, como a tabela Incidentes ou Usuários.

Os conjuntos de importação ignoram registros quando os dados na instância correspondem aos dados que estão sendo importados.

Nota:

Os conjuntos de importação são executados como sistema do usuário e, portanto, não podem adicionar dados a campos criptografados.

Terminologia de conjuntos de importação

Tabela 1. Termos-chave

Termo	Definição
Tabela do conjunto de importação	Uma tabela que atua como um local de preparação para registros importados de uma fonte de dados antes de transformar esses registros. Os campos nessas tabelas são gerados automaticamente com base nos dados importados e não devem ser modificados manualmente. Nota: As colunas em uma tabela de conjunto de importação são geradas automaticamente e não devem ser adicionadas manualmente. Adicionar colunas manualmente pode afetar negativamente a limpeza programada da tabela e levar a uma limpeza incompleta e a registros órfãos. Se você precisar adicionar colunas a uma tabela de conjunto de importação, primeiro adicione a coluna aos dados de entrada e selecione Testar carregamento de 20 registros ou Carregar todos os registros para gerar automaticamente as colunas na tabela de conjunto de importação. As colunas em uma tabela de conjunto de importação podem não ter o mesmo tipo que os dados de entrada. Por exemplo, uma coluna de moeda pode ser representada como uma coluna de cadeia de caracteres em uma tabela de conjunto de importação até que seja atribuída a uma coluna de tabela de destino que seja do tipo moeda.
Fonte de dados	Um registro que define de onde obter os dados para importar. Uma fonte de dados pode apontar para um arquivo, um banco de dados compatível com JDBC ou uma unidade organizacional LDAP.
Transformação	A conversão de dados de uma tabela de conjunto de importação para outra tabela de acordo com as regras definidas em um mapa de transformação.
Mapa de transformação	Um conjunto de mapas de campo que definem os relacionamentos entre os campos em um conjunto de importação e os campos em uma tabela, como Incidente. Durante a transformação, os dados são copiados da tabela Import Set para a tabela de destino com base no mapa de transformação. Um único campo de conjunto de importação pode ser mapeado para vários campos em outras tabelas.
Transformador robusto do conjunto de importação	Extraia, transforme e carregue dados para uma ou mais tabelas de destino. Separe as funções de transformação e de processamento, fornecendo uma alternativa mais flexível para transformar mapas.
Inserção de registro externo	Uma inserção de registro externo ocorre quando uma importação faz uma mudança em uma tabela que não é a tabela de destino dessa importação. Essa mudança acontece ao atualizar um campo de referência em uma tabela. Por exemplo, ao atualizar um valor para o solicitante em um incidente, a importação está realmente atualizando a tabela sys_user.
Aglutinar	Permite atualizar registros de tabela de destino existentes ao transformar dados de importação. Você pode especificar se um campo de destino deve ser usado para aglutinar quando os registros do conjunto de importação forem transformados. Se a opção Aglutinar do mapa de campo estiver selecionada, quando a linha do conjunto de importação for transformada, a instância verificará se há um registro existente na tabela de destino que tenha o mesmo valor no campo Destino que no campo Origemda linha do conjunto de importação. Se um registro existente com um valor correspondente na tabela de destino for encontrado, esse registro será atualizado. Se nenhum registro correspondente for encontrado, um novo registro será criado na tabela de destino.

Formatos de importação compatíveis

Você pode importar dados de vários formatos de arquivo diferentes ou fontes de dados externas.

Tabela 2. Formatos de arquivo

Formato	Limitações
CSV	Os arquivos CSV devem estar em conformidade com o padrão CSV proposto no RFC4180. Em particular, isso significa que aspas duplas podem não aparecer dentro de campos. A primeira linha de dados em um arquivo CSV importado se torna a linha de cabeçalho e define as colunas para esse conjunto de importação.
Excel	Os arquivos do Excel devem ter a extensão XLS ou XLSX.
XML	Os arquivos XML devem ter um XPath consistente para cada linha de dados.
JSON	Para matrizes JSON, o caminho de cada linha deve especificar o elemento raiz da matriz duas vezes, como /incidents/incidents. Os arquivosJSON devem seguir RFC-4627. Por exemplo, uma única vírgula deve separar um valor do nome a seguir. Os nomes em um objeto devem ser exclusivos. Predicados como @element, [index]ou text(), bem como Eixo como secundários, secundários ou ancestrais não são compatíveis.
Personalizado (analisar por Script)	Você pode escrever JavaScript personalizado para analisar linhas de entrada na lista de mapas.

A plataforma ServiceNow® pode importar dados das seguintes fontes de dados externas.

Tabela 3. Fontes de dados externos

Fonte de dados	Limitações
JDBC	As importações de JDBC exigem um mapa de transformação válido. Algumas configurações de rede podem exigir um ServiceNow® MID Server.
LDAP	As importações LDAP exigem um mapa de transformação válido.
OIDC	As importações de OIDC exigem um mapa de transformação válido.
ServiceNow® REST (IntegrationHub)	As importações REST exigem um mapa de transformação válido.
Personalizado (carregar por script)	As importações personalizadas exigem um mapa de transformação válido.

Para obter mais detalhes sobre as diferentes fontes de dados, consulte Fontes de dados.

Mapas de transformação versus transformadores de conjunto de importação robustos

Os mapas de transformação e os transformadores de conjunto de importação robustos convertem dados. Os mapas de transformação convertem dados da tabela de preparação para o arquivo de destino. Transformadores de conjunto de importação robustos convertem dados de uma tabela de origem em um ouvinte de mensagem. Se uma fonte de dados tiver um mapa de transformação e um transformador de conjunto de importação robusto, o sistema usará o transformador de conjunto de importação robusto em vez do mapa de transformação.

Limpeza programada do conjunto de importação

O trabalho programado Import Set Deleter limpa os dados do conjunto de importação antigo todos os dias à meia-noite.

Por padrão, o trabalho exclui todos os conjuntos de importação com mais de 7 dias, bem como os registros da tabela de conjuntos de importação associados. Se este trabalho programado não estiver ativo em sua instância, ative-o para reduzir as crescentes tabelas de conjunto de importação que você pode ter, especialmente ao usar importações recorrentes.

Nota:

Se a limpeza programada não estiver ativa no seu sistema, você deverá garantir que as tabelas do conjunto de importação não sejam muito grandes (> 5 milhões de registros no total em todas as tabelas) antes de habilitar esta limpeza. Se as tabelas forem muito grandes, exclua os registros manualmente antes de prosseguir. Entre em contato com Suporte e atendimento ao cliente para coordenar a exclusão desses dados.

Figura 1. Execução programada de script

Para obter os procedimentos, consulte Excluir conjuntos de importação.

Excluidor de tabela de conjunto de importação

Você pode excluir manualmente qualquer uma ou todas as seguintes tabelas de conjunto de importação:

• Computador
• Usuário
• Notificação
• Local

Você também pode excluir os mapas de transformação relacionados ou excluir somente os dados e preservar a estrutura da tabela.

Figura 2. Tabelas disponíveis para exclusão

Para obter os procedimentos, consulte Excluir tabelas do conjunto de importação.