Comando IMPORT XBRL

Informações do conceito

Importar um arquivo XBRL

Cria uma tabela do Analytics definindo e importando um arquivo XBRL.

Sintaxe

IMPORT XBRL TO tabela nome_arquivo_importação FROM nome_arquivo_origem CONTEXT nome_contexto <...n> [sintaxe_do_campo] <...n> <IGNORE num_campo> <...n>
sintaxe_campo ::=
FIELD nome tipo AT posição_inicial DEC valor WID bytes PIC formato AS nome_exibicao

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:

  • "C:\dados\Faturas.FIL"
  • "dados\Faturas.FIL"

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:

  • "C:\dados\nome_arquivo_origem"
  • "dados\nome_arquivo_origem"
CONTEXT nome_contexto

O contexto XBRL do qual será definida a tabela. Se você especificar mais de um contexto, todos os contextos deverão ser do mesmo tipo (instante, período ou contínuo).
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

Analytics não Unicode 1 byte = 1 caractere
Analytics Unicode 2 bytes = 1 caractere

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

Analytics não Unicode 1 byte = 1 caractere
Analytics Unicode 2 bytes = 1 caractere

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.

  • campos numéricos o formato de exibição de valores numéricos em exibições e relatórios do Analytics
  • campos datahora o formato físico dos valores datahora nos dados de origem (ordem de caracteres de data e hora, separadores e assim por diante)

    Nota

    Para campos de datahora, formato deve corresponder exatamente ao formato físico dos dados de origem. Por exemplo, se os dados de origem são 31/12/2014, você deve inserir o formato como "DD/MM/AAAA".

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.
IGNORE num_campo

opcional

Exclui um campo do layout da tabela.

num_campo especifica a posição do campo nos dados de origem. Por exemplo, IGNORE 5 exclui o quinto campo nos dados de origem do layout da tabela do Analytics.

Exemplos

Importação de um arquivo XBRL para uma tabela do Analytics

Importe dados do contexto Atual_Em de um arquivo XBRL para uma tabela do Analytics chamada Finanças:

IMPORT XBRL TO Finanças "Finanças.fil" FROM "DeclaraçãoFinanceiraXBRL.xml" CONTEXT "Atual_Em" FIELD "Item" C AT 1 DEC 0 WID 57 PIC "" AS "" FIELD "Valor" X AT 58 DEC 0 WID 7 PIC "" AS "" IGNORE 1 IGNORE 3

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Importar um arquivo XBRL.

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

PRINT

P

PACKED

Q

BASIC

R

MICRO

S

CUSTOM

T

PCASCII

U

UNICODE

V

VAXFLOAT

X

NUMERIC

Y

UNISYS

Z

ZONED