Fontes de dados de tipo de arquivo

Importe um arquivo de uma origem local, um servidor de rede remoto ou outra instância fornecendo um caminho e informações de autenticação.

Para conjuntos de importação de tipo de arquivo, você pode selecionar em uma lista de métodos de recuperação de arquivo: SFTP, FTP, FTPS, HTTP, HTTPS, e SCP.

Nota:

O FTPS não é recomendado porque não é mais compatível com alguns fornecedores de firewall. Considere usar o SFTP como alternativa.

Métodos de recuperação de arquivo

Os métodos de recuperação de arquivo a seguir estão disponíveis para copiar o arquivo de onde ele reside para a ServiceNow para ser carregado em um conjunto de importação.

Depois de definir os arquivos compatíveis para importação, defina como os arquivos podem ser importados.

Nota:

Para que a importação seja bem-sucedida, o servidor FTP e o cliente devem ser configurados para o mesmo mecanismo de autenticação selecionado aqui.

Método	Descrição
Anexo	Adicionar e gerenciar anexos um arquivo para o registro e importe esse arquivo em um conjunto de importação.
SFTP	Recupere um arquivo usando SFTP. Os campos são fornecidos para o nome do servidor e as credenciais de login.
FTP	Recupere um arquivo de um servidor FTP em sua rede. Os campos são fornecidos para o nome do servidor e as credenciais de login. Nota: As transferências FTP são enviadas como texto não criptografado e não podem ser criptografadas. Em vez disso, use SCP ou SFTP sempre que possível.
FTPS (Auth SSL) [não recomendado]	Não recomendado porque o FTPS não é mais compatível com alguns fornecedores de firewall. Considere usar o SFTP como alternativa. Um comando de autenticação segura de FTP emitido por meio do protocolo SSL (Secure Socket Layer). Este método também é conhecido como FTP explícito sobre SSL.
FTPS (Auth TLS) [não recomendado]	Não recomendado porque o FTPS não é mais compatível com alguns fornecedores de firewall. Considere usar o SFTP como alternativa. Um comando de autenticação segura de FTP emitido por meio do protocolo TLS (Transport Layer Security). Este método também é conhecido como FTP explícito sobre TLS.
FTPS (SSL implícito) [não recomendado]	Não recomendado porque o FTPS não é mais compatível com alguns fornecedores de firewall. Considere usar o SFTP como alternativa. Na segurança implícita, o servidor FTPS define uma porta específica para o cliente (990) usar para conexões seguras. A segurança implícita começa automaticamente com uma conexão SSL no momento em que um cliente FTPS se conecta a um servidor FTPS.
FTPS (TLS implícito) [não recomendado]	Não recomendado porque o FTPS não é mais compatível com alguns fornecedores de firewall. Considere usar o SFTP como alternativa. Na segurança implícita, o servidor FTPS define uma porta específica para o cliente (990) usar para conexões seguras. A segurança implícita começa automaticamente com uma conexão TLS no momento em que um cliente FTP se conecta a um servidor FTP.
HTTP	Recupere um arquivo usando HTTP. Os campos são fornecidos para o nome do servidor e as credenciais de login. Importante: Para protocolos HTTP e HTTPS, o caminho do arquivo é codificado automaticamente por URL. Não especifique um caminho de arquivo codificado por URL ao usar um desses protocolos.
HTTPS	Recupere um arquivo usando HTTPS. Os campos são fornecidos para o nome do servidor e as credenciais de login. Use este método para transferir dados entre instâncias da ServiceNow.
SCP	O protocolo SCP (Secure Copy Protocol, cópia segura) transfere arquivos com segurança entre um host local e remoto ou entre dois hosts remotos, usando o protocolo SSH (Secure Shell).

Exemplos de fonte de dados de arquivo

Estes exemplos descrevem como importar vários tipos de arquivo como fontes de dados.

Arquivo de fonte de dados do Excel

Você pode importar usando o formato XLSX e o formato XLS legado. Xls é o formato padrão para planilhas criadas no Excel para versões 2003 e anteriores. XLSX é o formato padrão do Excel 2007 ou posterior. Use XLSX em vez de XLS legados sempre que possível para obter o desempenho ideal.

Nota:

• Todos os arquivos .xls devem usar o sistema de data 1900 em vez do sistema de data 1904. O sistema de data 1904 faz com que suas datas sejam importadas com um ano quatro anos antes do que aparece na planilha. Consulte o Suporte da MS para obter informações adicionais sobre sistemas de data.
• Ao importar um arquivo do Excel que tem valores boolianos em maiúsculas de (VERDADEIRO/FALSO), ambos os valores sempre se transformam em falso. Para impedir esse comportamento, defina glide.transform.boolean.casesensitivepropriedade como falsa.

Figura 1. Dados de demonstração do Microsoft Excel

Arquivo de fonte de dados XML

XPath para cada linha

As definições de fonte de dados XML têm um campo extra para especificar XPath para cada linha . Este campo é um XPath expressão para selecionar os elementos cujos secundários são convertidos em linhas na tabela de conjunto de importação. Cada elemento selecionado faz com que uma linha seja criada na tabela de conjunto de importação. Os secundários do elemento selecionado são convertidos em colunas na linha. Por exemplo, para importar as informações do ativo do arquivo XML de amostra abaixo, a expressão XPath deve ser especificada como /export/asset . Esta expressão corresponde aos três <asset> elementos no arquivo, portanto, três linhas são criadas. Embora você também possa especificar //ativo esta expressão é muito menos eficiente para arquivos grandes. Use o formulário de caminho de local absoluto para expressões XPath ao usar o carregador XML. Em outras palavras, evite expressões que contenham // a menos que estritamente necessário.

Tenha cuidado para não especificar uma expressão XPath insuficientemente restritiva com um arquivo XML grande. Por exemplo, a expressão /export seria errado para o arquivo de amostra a seguir, já que ele corresponde ao elemento de documento (raiz). Em geral, você nunca deve especificar uma expressão XPath que corresponda ao elemento raiz, a menos que você queira que tudo no documento seja transformado em uma única linha. Especificar uma expressão XPath insuficientemente restritiva ao tentar carregar arquivos XML grandes pode resultar em tempos de processamento longos e saída incorreta. Por esse motivo, é melhor testar e depurar especificações de fonte de dados XML com pequenos arquivos XML contendo apenas algumas linhas de dados. Depois que a especificação for testada, você poderá executá-la novamente com o arquivo completo.

Elementos do <userInfo>

Observe que <userInfo> elementos contidos em <asset> contém elementos secundários. Este tipo de aninhamento cria uma coluna chamada Userinfo Que contém XML para <userInfo> elemento. Se Expandir nós secundários está marcado, colunas individuais também são criadas para Userinfo/lastName e. Userinfo/firstName . Se Expandir nós secundários não está marcado, somente Userinfo A coluna XML foi criada.

Carregando dados de um arquivo XML

Ao carregar dados de um arquivo XML, ServiceNow amostra os primeiros 10 registros para determinar quais campos são necessários para conter os dados. Se nenhum dos primeiros 10 registros especificar um valor para um campo, ServiceNow não adiciona esse campo à tabela que contém os dados importados. Certifique-se de que pelo menos um dos primeiros 10 registros especifique um valor para todos os campos que estão sendo importados.

Se o arquivo XML usado para uma fonte de dados XML não contiver um campo nos primeiros 10 nós, o campo será ignorado. Para importar o campo e garantir que ele não seja ignorado, você pode adicionar glide.db.impex.XMLLoader.max.scan_nodespropriedade do sistema com um valor maior ou igual à posição do nó em que o campo foi encontrado pela primeira vez. Esta propriedade se aplica a todas as fontes de dados XML. glide.db.impex.XMLLoader.max.scan_nodeso padrão é 10 , mas você pode inserir um valor de 1 . 2147483647 especificar quantos nós devem ser verificados para determinar os valores a serem usados para a importação. Você pode especificar -1 Para verificar todos os nós nos arquivos XML.

Importante:

Se você especificar -1 ou aumente o valor de glide.db.impex.XMLLoader.max.scan_nodesalém do padrão de 10 Todo o processamento de importação de XML pode incorrer em um aumento significativo no tempo de carregamento geral.

<?xml version= "1.0" encoding= "utf-8" ?><export><asset><assetTag>AT-01939</assetTag><type>Desktop</type><os>Windows 7 Professional</os><lastlogondate>12-07-2010 12:31:24</lastlogondate><userInfo><lastName>Loo</lastName><firstName>David</firstName></userInfo><isenabled>true</isenabled></asset><asset><assetTag>AT-53480</assetTag><type>Desktop</type><os>Windows 7 Professional</os><lastlogondate>09-07-2010 13:25:53</lastlogondate><userInfo><lastName>Merritt</lastName><firstName>Norris</firstName></userInfo><isenabled>true</isenabled></asset><asset><assetTag>AT-55782</assetTag><type>Desktop</type><os>Unknown</os><lastlogondate>01-01-1900 00:00:00</lastlogondate><userInfo><lastName>Currie</lastName><firstName>Mike</firstName></userInfo><isenabled>true</isenabled></asset></export>

Arquivo de fonte de dados CSV

Os arquivos CSV são usados como um formato de arquivo compatível com várias plataformas para transferir arquivos entre plataformas. Um arquivo CSV é um arquivo de texto que define uma grade, em que vírgulas definem colunas e quebras de linha definem linhas. Para definir o espaçamento preciso para importar cadeias de caracteres, você pode quebrar o texto entre aspas.

"user_name","name","email","sys_created_on","active"
"jared.laethem","Jared Laethem","[e-mail]","2008-02-24 22:21:32","true"
"jerrod.bennett","Jerrod Bennett","[e-mail]","2007-08-12 12:12:18","true"
"eric.schroeder","Eric Schroeder","[e-mail]","2007-07-03 11:50:20","true"
"rob.woodbyrne","Rob Woodbyrne","[e-mail]","2007-07-03 11:49:57","true"
"admin","System Administrator","[e-mail]","2007-07-03 11:48:47","true"
"christen.mitchell","Christen Mitchell","[e-mail]","2007-05-16 15:26:42","true"
"rob.phillips","Rob Phillips","[e-mail]","2007-01-22 11:25:34","true"
"davin.czukowski","Davin Czukowski","[e-mail]","2006-07-11 14:01:26","true"
"luke.wilson","Luke Wilson","[e-mail]","2006-02-07 15:29:48","true"
"bow.ruggeri","Bow Ruggeri","[e-mail]","2005-07-07 11:39:58","true"
"don.goodliffe","Don Goodliffe","[e-mail]","2005-05-02 12:28:40","true"
"david.loo","David Loo","[e-mail]","2005-02-22 16:00:00","true"
"guest","Guest","[e-mail]","2004-05-01 17:00:00","true"
"fred.luddy","Fred Luddy","[e-mail]","2004-05-01 17:00:00","true"

Ao usar arquivos CSV, você pode especificar o conjunto de caracteres de codificação usando Propriedades Campo no formulário Fonte de dados. Pode ser necessário Configurar o layout do formulário Formulário Fonte de dados para ver este campo. Por exemplo, para usar a codificação utf-8, insira utf-8 .

Dados em uma única coluna

Para os formatos JSON e XML, este recurso permite armazenar um registro completo em uma única coluna.

O nome da coluna usado para armazenar o registro completo é dados .

Se você criar uma fonte de dados no formato JSON para salvar dados em uma única coluna, selecionando Dados em coluna única a caixa de seleção atualiza as seguintes opções:

• Descartar matriz torna-se desmarcado e é removido do formulário.
• Expandir nó secundário é selecionado e removido do formulário.

Figura 2. Dados JSON em uma única coluna

Se você criar uma fonte de dados no formato XML para salvar dados em uma única coluna e selecionar Dados em coluna única caixa de seleção, Expandir nó secundário é selecionado e removido do formulário.

Figura 3. Dados XML em uma única coluna

Formato personalizado (analisar por script)

Quando você seleciona um Tipo de Arquivo e um Formato de Personalizado (analisar por script) , Um editor JavaScript chamado Script de análise aparece. Você pode usar o script de análise para criar JavaScript personalizado para analisar linhas de entrada na lista de mapas.

O JavaScript tem três parâmetros predefinidos:

• . lineo parâmetro é uma cadeia de caracteres que contém dados de linha do arquivo de origem.
• . lineNumberé o número da linha do arquivo de origem para estes dados de linha.
• . resultO parâmetro é usado para passar de volta o resultado analisado do JavaScript.

. resultO parâmetro é uma instância do objeto Java ScopedScriptParseResult. Quando você digita resultado. Quatro métodos disponíveis aparecem como preenchimento automático de script no editor JavaScript:

Figura 4. Menu de preenchimento automático

• SetSkip(boolian skip);
• GetSkip() booliano;
• AddRow(MapMapa de <String, String>);
• List<Map<String,String>> getRows()

. SetSkip() e. GetSkip() defina e recupere o sinalizador ignorar. Quando o sinalizador ignorar é definido como verdadeiro, todo o resultado de análise do JavaScript é ignorado.

. AddRow() adiciona um mapa do resultado da linha de análise, que é inserido na tabela de preparação.

. GetRows() recupera todas as linhas do resultado de análise atual, que são inseridas na tabela de preparação.

Uma linha de dados de origem pode conter uma linha ou várias linhas. Cabe ao gravador de script decidir como processar os dados de linha. Por exemplo, para dados de linha nome: john, computer se você usar um ponto-e-vírgula (;) como quebra de linha, essa linha conterá três linhas de dados. Cada linha é um mapa com duas chaves: nome e. computador . . nome e. computador se tornam os nomes de coluna do esquema da tabela de preparação. Você pode usar a seguinte amostra de JavaScript para analisar estes dados de linha:

(function(line, lineNumber, result) {
 var rowArr = line.split(";");
 var i;
 for(i in rowArr) {
 var map = {};
 var arr = rowArr[i].split(",");
 var x;
 for(x in arr) {
 var items = arr[x].split("=");
 map[items[0]]=items[1];
 }
 result.addRow(map);
 }
})(line, lineNumber, result);

O gravador de script deve adicionar o resultado para que o resultado seja inserido na tabela de preparação.