Conceitos-chave dos conjuntos para importação

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

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

Nota:

Não importe dados em blocos 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 para 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 para importação são executados como usuário do sistema e, portanto, não podem adicionar dados a campos criptografados.

Terminologia de conjuntos para importação

Tabela 1. Termos principais

Termo	Definição
Tabela de 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 dessas 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. A adição manual de colunas 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 carga 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 para importação até que seja atribuída a uma coluna da tabela de destino que seja do tipo moeda.
Fonte de dados	Um registro que define onde obter os dados para importação. 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 define os relacionamentos entre campos em um conjunto para importação e campos em uma tabela, como Incidente. Durante a transformação, os dados são copiados da tabela Conjunto para importação 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 em 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á na verdade 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 aglutinação em quando os registros do conjunto de importação são transformados. Se a opção Aglutinar do mapa de campos 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 o 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 dos 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. JSON arquivos 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, irmãos ou ancestrais não são compatíveis.
Personalizado (analisar por Script)	Você pode gravar 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 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 OIDC exigem um mapa de transformação válido.
ServiceNow® REST (Integration Hub)	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 robustos do conjunto de importação

Os mapas de transformação e os transformadores robustos do conjunto de importação convertem dados. Os mapas de transformação convertem dados da tabela de preparação para o arquivo de destino. Os transformadores robustos do conjunto de importação 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 robusto de conjunto de importação, o sistema usará o transformador robusto de conjunto de importação em vez do mapa de transformação.

Limpeza programada do conjunto de importação

O trabalho agendado 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 para importação com mais de 7 dias, bem como os registros da tabela de conjuntos para importação associados. Se este trabalho agendado não estiver ativo em sua instância, ative-o para atenuar 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 momento em seu sistema, certifique-se de que as tabelas de conjunto para importação não sejam muito grandes (> 5 milhões de registros no total em todas as tabelas) antes de habilitar essa 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 de script agendada

Para obter os procedimentos, consulte Excluir conjuntos para 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 dados e preservar a estrutura da tabela.

Figura 2. Tabelas disponíveis para exclusão

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