Comando IMPORT PRINT
Informações do conceito
Cria uma tabela do Analytics definindo e importando um arquivo de imagem de impressão (relatório).
Sintaxe
IMPORT PRINT TO tabela nome_arquivo_importação FROM nome_arquivo_origem <SERVER nome_perfil> valor_do_conjunto_de_caracteres <número_da_página_de_código> {[sintaxe_registro] [sintaxe_campo] <...n>} <...n>
sintaxe_registro ::=
RECORD nome_registro tipo_registro linhas_no_registro transparente [sintaxe_teste] <...n>
sintaxe_teste ::=
TEST incluir_excluir tipo_correspondência AT linha_inicial,posição_inicial,intervalo lógica texto
sintaxe_campo ::=
FIELD nome tipo AT linha_inicial,posição_inicial SIZE comprimento,linhas_no_campo DEC valor WID bytes PIC formato AS nome_exibicao
Parâmetros
Parâmetros gerais
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:
|
SERVER nome_perfil opcional |
O nome do perfil do servidor onde estão os dados que você quer importar. |
valor_do_conjunto_de_caracteres |
O conjunto de caracteres usado para codificar o arquivo de imagem de impressão (Relatório). É oferecido suporte para os seguintes valores:
|
número_da_página_de_código
opcional |
Se especificar 3 (texto codificado) para valor_do_conjunto_de_caracteres, você também deverá inserir o número da página de código. |
Parâmetro RECORD
Informações gerais sobre definição de registros.
Nota
Algumas informações de definição de registros são especificadas usando códigos numéricos associados a opções no Assistente de Definição de Dados.
Em scripts, especifique o código numérico e não o nome da opção.
Nome | Descrição |
---|---|
RECORD nome_registro |
O nome do registro no Assistente de Definição de Dados. É necessário especificar nome_registro no comando IMPORT PRINT, mas o valor nome_registro não aparece na tabela do Analytics resultante. No Assistente de Definição de Dados, o Analytics oferece nomes padrão de acordo com o tipo de registro:
Você pode usar os nomes padrão ou especificar nomes diferentes. |
tipo_registro |
Os três tipos de registro possíveis ao definir um arquivo imagem de impressão:
Nota Você pode definir vários conjuntos de registros de cabeçalho e rodapé em uma única execução de IMPORT PRINT, mas apenas um conjunto de registros de detalhe. |
linhas_no_registro |
O número de linhas ocupadas em um registro no arquivo de imagem de impressão. Você pode definir registros de uma única linha ou de várias linhas para corresponder aos dados no arquivo. |
transparente |
A definição de transparência para um registro de cabeçalho. Nota Aplicável apenas a registros de cabeçalho.
Os registros de cabeçalho transparentes não dividem registros de detalhe de várias linhas. Se um registro de cabeçalho dividir um registro de detalhe de várias linhas no arquivo de imagem de impressão de origem, o que poderá acontecer na quebra de página, a especificação de 1 (transparente) unificará o registro de detalhe na tabela do Analytics resultante. |
Parâmetro TEST
Os critérios para definir um conjunto de registros no arquivo de imagem de impressão. Você pode ter uma ou mais (até 8) ocorrências de TEST para cada ocorrência de RECORD.
Nota
Alguns critérios são especificados usando códigos numéricos associados a opções no Assistente de Definição de Dados (os nomes das opções são mostrados abaixo entre parênteses).
Em scripts, especifique o código numérico e não o nome da opção.
Nome | Descrição | ||||||
---|---|---|---|---|---|---|---|
TEST incluir_excluir |
Como tratar dados correspondentes:
|
||||||
tipo_correspondência |
O tipo de correspondência a ser executada:
|
||||||
AT linha_inicial, posição_inicial, intervalo |
|
||||||
lógica |
As relações lógicas entre os critérios:
|
||||||
texto |
Caracteres literais ou curinga para correspondência:
Para outros tipos de correspondência, o texto é uma cadeia vazia "". |
Parâmetros de FIELD
Informações de definição de campo.
Nome | Descrição | ||||||
---|---|---|---|---|---|---|---|
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 linha_inicial, posição_inicial |
|
||||||
SIZE comprimento, linhas_no_campo |
|
||||||
DEC valor |
O número de casas decimais para campos numéricos. |
||||||
WID bytes |
A largura de exibição do campo em bytes. O valor especificado controla a largura de exibição do campo em exibições e relatórios do Analytics. A largura de exibição nunca altera os dados. No entanto, pode ocultá-los se for menor que o comprimento do campo. |
||||||
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. |
Exemplos
Importação de dados de um arquivo de imagem de impressão (relatório)
Importe dados de um arquivo de imagem de impressão (relatório), Relatório.txt.
Um registro de cabeçalho e um conjunto de registros de detalhes, com cinco campos, são criados na tabela do Analytics resultante, Relatório_inventário:
IMPORT PRINT TO Relatório_inventário "Relatório_inventário.FIL" FROM "Relatório.txt" 0 RECORD "Cabeçalho1" 1 1 0 TEST 0 0 AT 1;17;0 7 ":" FIELD "Campo_1" C AT 1;19 SIZE 2;1 DEC 0 WID 2 PIC "" AS "Classe Produto" FIELD "Campo_2" C AT 1;24 SIZE 31;1 DEC 0 WID 31 PIC "" AS "Descrição Produto" RECORD "Detalhe" 0 1 0 TEST 0 0 AT 1;59;59 7 "." FIELD "Campo_3" X AT 1;6 SIZE 9;1 DEC 0 WID 9 PIC "" AS "ID do item" FIELD "Campo_4" C AT 1;16 SIZE 24;1 DEC 0 WID 24 PIC "" AS "Desc. do item" FIELD "Campo_5" N AT 1;40 SIZE 10;1 DEC 0 WID 10 PIC "" AS "Na mão" FIELD "Campo_6" N AT 1;50 SIZE 12;1 DEC 2 WID 12 PIC "" AS "Custo" FIELD "Campo_7" N AT 1;62 SIZE 12;1 DEC 2 WID 12 PIC "" AS "Total"
Observações
Para obter mais informações sobre o funcionamento desse comando, consulte Definição e importação de arquivos de imagem de impressão (relatório) e arquivos PDF.
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 no 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 |