Conceitos-chave de 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 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 de importação e os campos em um existente ServiceNow Tabela, 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 dos conjuntos de importação

Tabela 1. Termos principais

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 pode levar a uma limpeza incompleta e 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 Carregar 20 registros ou Carregar todos os registros para gerar automaticamente as colunas na tabela do 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 da tabela de destino que seja do tipo moeda.
Fonte de dados	Um registro que define onde obter os dados a serem importados. 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 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 processamento, fornecendo uma alternativa mais flexível para mapas de transformação.
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. Esta 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á 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 são transformados. Se o mapa de campo Aglutinar quando a linha do conjunto de importação é transformada, a instância verifica se há um registro existente na tabela de destino que tenha o mesmo valor em Campo de destino como a linha do conjunto de importação Campo de origem . 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 em 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 desse 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 JSON matrizes, o caminho de cada linha deve especificar o elemento raiz da matriz duas vezes, como /incidentes/incidentes . JSON os 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 elemento , [índice] ou texto () , assim como eixos, como secundários, irmãos 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.

. ServiceNow® a plataforma 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 ( IntegrationHub)	As importações REST exigem um mapa de transformação válido.
Personalizado (carregar por script)	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.

Transformadores de mapas de transformação versus transformadores robustos de conjunto de importação

Mapas de transformação e transformadores robustos de conjunto de importação convertem dados. Os mapas de transformação convertem dados da tabela de preparação para o arquivo de destino. Transformadores robustos de 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 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

. Import Set Deletero trabalho agendado 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 agendado não estiver ativo em sua instância, ative-o para mitigar as crescentes tabelas de conjuntos 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, você deverá garantir que as tabelas do conjunto de importação não sejam muito grandes (total de > 5 milhões de registros em todas as tabelas) antes de habilitar esta limpeza. Se as tabelas forem muito grandes, exclua manualmente os registros antes de prosseguir. Contato Suporte e atendimento ao cliente coordenar a exclusão desses dados.

Figura 1. Execução de script agendada

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

Eliminador de tabela do conjunto de importação

Você pode excluir manualmente uma ou todas as seguintes tabelas de conjuntos 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.