Comando IMPORT XML
Cria uma tabela do Analytics definindo e importando um arquivo XML.
Sintaxe
IMPORT XML TO tabela nome_arquivo_importação FROM nome_arquivo_origem [sintaxe_do_campo] <...n>
sintaxe_campo ::= FIELD nome tipo AT posição_inicial DEC valor WID bytes PIC formato AS nome_exibicao RULE expressão_xpath
Parâmetros
Nome | Descrição | ||||
---|---|---|---|---|---|
TO tabela |
O nome da tabela do Analytics na qual os dados serão importados. Nota Os nomes de tabela são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número. |
||||
nomearquivo_importação |
O nome do arquivo de dados do Analytics a ser criado. Especifique nome_arquivo_importação como uma cadeia entre aspas com uma extensão de arquivo .FIL. Por exemplo, "Faturas.FIL". Por padrão, o arquivo de dados (.FIL) é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:
|
||||
FROM nome_arquivo_origem |
O nome do arquivo de dados de origem. nome_arquivo_origem deve ser uma cadeia entre aspas. Se o arquivo de dados de origem não está localizado no mesmo diretório que o projeto do Analytics, é necessário usar um caminho absoluto para especificar a localização do arquivo:
|
||||
FIELD nome tipo |
Os campos individuais no arquivo de dados de origem a importar, incluindo o nome e o tipo de dados do campo. Para excluir um campo da importação, não o especifique. Para obter mais informações sobre tipo, consulte Identificadores para os tipos de dados de campo. |
||||
AT posição_inicial |
A posição inicial em bytes do campo no arquivo de dados do Analytics. Nota
No Analytics Unicode, normalmente você deve especificar uma posição inicial em bytes ímpar. A especificação de uma posição inicial par pode causar exibição incorreta de caracteres. |
||||
DEC valor |
O número de casas decimais para campos numéricos. |
||||
WID bytes |
O comprimento em bytes do campo no layout da tabela do Analytics. Nota
No Analytics Unicode, especifique apenas um número de bytes par. A especificação de um número ímpar de bytes pode causar exibição incorreta de caracteres. |
||||
PIC formato |
Nota Aplica-se somente a campos numéricos ou de datahora.
formato deve estar entre aspas. |
||||
AS nome_exibicao |
O nome de exibição (título alternativo da coluna) para o campo na exibição na nova tabela do Analytics. Especifique nome_exibicao como uma cadeia entre aspas. Utilize um ponto e vírgula (;) entre palavras se quiser uma quebra de linha no título da coluna. AS é obrigatório na definição de um FIELD. Para que o nome de exibição seja igual ao nome do campo, insira um valor de nome_exibicao em branco usando a seguinte sintaxe: AS "". Verifique se não há espaço entre as duas aspas. |
||||
RULE expressão_xpath |
A expressão XPath usada para selecionar o conteúdo do campo do arquivo XML. XPath é uma maneira padrão de acessar dados de arquivos XML. Por exemplo, acct/title/text() recupera o texto na tag <title> no arquivo XML. |
Exemplos
Importação de dados de um arquivo XML para uma tabela do Analytics
Importe dados de um arquivo XML para uma tabela do Analytics chamada Funcionários:
IMPORT XML TO Funcionários "Funcionários.fil" FROM "emp.XML" FIELD "NumFunc" C AT 1 DEC 0 WID 6 PIC "" AS "" RULE "/RECORDS/RECORD/NumFunc/text()" FIELD "Nome" C AT 7 DEC 0 WID 13 PIC "" AS "" RULE "/RECORDS/RECORD/Nome/text()" FIELD "Sobrenome" C AT 20 DEC 0 WID 20 PIC "" AS "" RULE "/RECORDS/RECORD/Sobrenome/text()"FIELD "DataContratação" D AT 40 DEC 0 WID 10 PIC "AAAA-MM-DD" AS "" RULE "/RECORDS/RECORD/DataContrat/text()" FIELD "Salário" N AT 50 DEC 2 WID 8 PIC "" AS "" RULE "/RECORDS/RECORD/Salário/text()"
Observações
Nota
Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.
Identificadores para os tipos de dados de campo
A tabela abaixo lista as letras que você deve usar ao especificar o tipo para FIELD. Cada letra corresponde a um tipo de dados do Analytics.
Por exemplo, se você estiver definindo um campo Sobrenome, que exige um tipo de dados de caractere, você especificaria "C": FIELD "Sobrenome" C.
Para obter mais informações, consulte Tipos de dados do Analytics.
Nota
Ao usar o Assistente de Definição de Dados para definir uma tabela que inclui campos EBCDIC, Unicode ou ASCII, os campos recebem automaticamente a letra “C” (para o tipo CARACTERE).
Ao inserir a instrução IMPORT manualmente ou editar uma instrução IMPORT, você pode substituir as letras mais específicas “E” ou “U” para os campos EBCDIC ou Unicode.
Letra |
Tipo de dados do Analytics |
---|---|
A |
ACL |
B |
BINARY |
C |
CHARACTER |
D |
DATETIME |
E |
EBCDIC |
F |
FLOAT |
G |
ACCPAC |
I |
IBMFLOAT |
K |
UNSIGNED |
L |
LOGICAL |
N |
|
P |
PACKED |
Q |
BASIC |
R |
MICRO |
S |
CUSTOM |
T |
PCASCII |
U |
UNICODE |
V |
VAXFLOAT |
X |
NUMERIC |
Y |
UNISYS |
Z |
ZONED |