Fontes de dados do tipo de arquivo

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 seguintes métodos de recuperação de arquivo 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 e o cliente FTP devem ser configurados para o mesmo mecanismo de autenticação selecionado aqui.


Método	Descrição
Anexo	Adicione e gerencie anexos de 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 de FTP são enviadas como texto não criptografado e não podem ser criptografadas. 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 FTP Secure 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 FTP Secure 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 os protocolos HTTP e HTTPS, o caminho do arquivo é automaticamente codificado 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 Secure Copy (SCP) transfere arquivos com segurança entre um host local e um host remoto ou entre dois hosts remotos, usando o protocolo Secure Shell (SSH).

Exemplos de fonte de dados de arquivo

Esses 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 legado sempre que possível para obter o desempenho ideal.

Nota:

Todos os arquivos .xls devem usar o sistema de data de 1900 em vez do sistema de data de 1904. O sistema de datas 1904 faz com que suas datas sejam importadas com um ano quatro anos anterior ao 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 tenha valores boolianos maiúsculos de (VERDADEIRO/FALSO), ambos os valores sempre se transformam em falso. Para evitar esse comportamento, defina a propriedade glide.transform.boolean.casesensitive 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 o XPath para cada linha. Este campo é uma expressão XPath 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 //asset, essa 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 seja 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 estaria incorreta para o arquivo de amostra a seguir, pois corresponde ao elemento do documento (raiz). Em geral, você nunca deve especificar uma expressão XPath que corresponda ao elemento raiz, a menos que queira que tudo no documento seja colocado em uma única linha. Especificar uma expressão XPath insuficientemente restritiva ao tentar carregar arquivos XML grandes pode resultar em tempos de processamento demorados e saída incorreta. Por esse motivo, é melhor testar e depurar as especificações de fonte de dados XML com pequenos arquivos XML que contenham apenas algumas linhas de dados. Depois que a especificação tiver sido testada, você poderá executá-la novamente com o arquivo completo.
<userInfo>elementos: Observe que o<userInfo> elementos contidos em<asset> contêm elementos secundários. Este tipo de aninhamento cria uma coluna chamada userInfo que contém XML para o<userInfo> elemento. Se Expandir nós secundários estiver marcado, colunas individuais também serão criadas para userInfo/lastName e userInfo/firstName. Se Expandir nós secundários não estiver marcado, somente a coluna XML userInfo será criada.
Carregando dados de um arquivo XML: Ao carregar dados de um arquivo XML, ServiceNow obtém amostras dos 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 adicionará esse campo à tabela que contém os dados importados. Certifique-se de que pelo menos um dos 10 primeiros 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 a propriedade do sistema glide.db.impex.XMLLoader.max.scan_nodes com um valor maior ou igual à posição do nó em que o campo é encontrado pela primeira vez. Esta propriedade se aplica a todas as fontes de dados XML. glide.db.impex.XMLLoader.max.scan_nodes o padrão é 10, mas você pode inserir um valor de 1 a 2147483647 para 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 aumentar o valor de glide.db.impex.XMLLoader.max.scan_nodes além do padrão de 10, todo o processamento de importação de XML poderá 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

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

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

Ao usar arquivos CSV, você pode especificar o conjunto de caracteres de codificação usando o campo Propriedades no formulário Fonte de dados. Pode ser necessário configurar o layout do formulário Configurando o layout do formulário Fonte de dados para ver este campo. Por exemplo, para usar a codificação utf-8, insira charset=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 é data.

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

A matriz de descarte se torna desmarcada e removida do formulário.
Expandir nó secundário se torna 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 marcar a caixa de seleção Dados em coluna única, Expandir nó secundário ficará selecionado e será removido do formulário.

Formato personalizado (analisar por script)

Quando você seleciona um Tipo de arquivo e um Formatopersonalizado (Analisar por script), um editor Javascript chamado Script de análise é exibido. 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:

O parâmetro line é uma cadeia de caracteres que contém dados de linha do arquivo de origem.
O lineNumber é o número da linha do arquivo de origem para os dados desta linha.
O parâmetro result é usado para passar de volta o resultado analisado do Javascript.

O parâmetro result é uma instância do objeto Java ScopedScriptParseResult. Ao digitar resultado., quatro métodos disponíveis aparecem como preenchimento automático de script no Editor Javascript:

Figura 4. Preencher menu automaticamente

anular setSkip(booliano ignorar);
booliano getSkip();
addRow(Map<String, String> mapa);
Lista <Map<String,String> > getRows()

O setSkip() e o getSkip() definem e recuperam o sinalizador de omissão. Quando o sinalizador ignorar é definido como verdadeiro, todo o resultado da análise do Javascript é ignorado.

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

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

Uma linha de dados de origem pode conter uma ou várias linhas. Depende do roteirista decidir como processar os dados da linha. Por exemplo, para a linha de dados name=john,computer=windows;name=joe,computer=linux;name=linda,computer=windows, se você usar um ponto e vírgula (;) como uma quebra de linha, essa linha conterá três linhas de dados. Cada linha é um mapa com duas chaves: name e computer. O nome e o computador se tornam os nomes das colunas do esquema da tabela de preparação. Você pode usar o seguinte exemplo de Javascript para analisar os dados desta 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 roteirista deve adicionar o resultado para que ele seja inserido na tabela de preparação.