Formato de Arquivo de Importação e Exportação para Dimensões Definidas pelo Usuário

Ao importar e exportar dados para dimensões definidas pelo usuário, você deverá usar um arquivo delimitado por vírgulas (.csv).

A seguinte lista descreve o formato e outras considerações para arquivos de importação e de exportação:

  • O arquivo deve ter as seguintes colunas:
    • Nome: O nome do nó.
    • Pai. O nome do nó pai, se a dimensão for uma hierarquia. Se o nó não tiver um nó pai, esse campo deverá permanecer vazio.

    Nota:

    O cabeçalho da coluna para Nome assume como padrão. É possível personalizar os cabeçalhos de coluna para Nome e Pai podem durante o registro.

  • Se a dimensão tiver propriedades, o arquivo conterá uma coluna para cada propriedade. O cabeçalho da coluna é o valor especificado quando a propriedade foi criada. Consulte Adição de uma Propriedade Existente a um Tipo de Nó para uma Dimensão Definida pelo Usuário e Criação de uma Propriedade Personalizada.
  • Você pode criar, editar e excluir colunas constantes no arquivo de exportação. Consulte Gerenciamento de Chaves Constantes para Aplicativos Universais em Edição de Chaves de Associação.
  • A forma na qual a dimensão está configurada determina se há colunas para tipos de nó e como os nós superiores são indicados. Consulte Configurações de Exportação e Importação de Dimensões Definidas pelo Usuário.
  • Os dados são importados na ordem das linhas. As linhas dos nós pais devem preceder as linhas dos nós filhos. Se uma linha de um nó filho preceder a linha de seu nó pai, um erro ocorrerá quando o arquivo for importado.
  • Você pode colocar as colunas em qualquer ordem no arquivo de importação.
  • Se um cabeçalho de coluna não corresponder às colunas descritas acima, a importação ignorará a coluna.

    Dica:

    Isso significa que um arquivo de importação pode conter informações que não serão importadas. Por exemplo, um arquivo de importação pode incluir uma coluna para comentários.
  • A importação ignora linhas duplicadas.
  • As strings que contêm o caractere delimitador, aspa ou o caractere de fim de linha (CR/LF) do arquivo ou que começam com caracteres de ASCII 35 para baixo (como Tabulação, ! ou #) serão colocadas entre aspas. (Por exemplo: "# Filhos", "Depreciação Acumulada, Equipamento".)

  • As datas e os timestamps para as configurações regionais suportadas devem estar em um destes padrões de formato de data Java:
    • Curto

    • Padrão

    • Longo

    • Médio

    Nota:

    Para obter informações sobre formatos de data e horário Java, consulte Utilização de Formatos Predefinidos.

Exemplo 38-1 Arquivo de Importação para uma Dimensão

Suponha que você tenha uma dimensão Departments definida da seguinte forma:

  • Existem dois tipos de nó, cujos nomes são Department e Department Rollup.
  • Ambos os tipos de nó utilizam a propriedade Description.
  • O tipo de nó Department Rollup tinha uma propriedade com o nome Company, configurada para usar a abreviação CO como cabeçalho de coluna.
  • A dimensão foi definida com as seguintes configurações de importação e exportação:
    • TOPNODE representa os nós superiores.
    • Os arquivos podem ter uma coluna para tipos de nó. O cabeçalho da coluna é Tipo de Nó.
    • Os arquivos podem ter uma coluna para tipos de nó pai. O cabeçalho da coluna é Tipo de Nó Pai.
    • Se o arquivo de importação não contiver as colunas Tipo de Nó e Tipo de Nó Pai, as importações designarão os nós inferiores ao tipo de nó Department e os nós pais ao tipo de nó Department Rollup.

    As configurações de dimensão descritas na lista anterior.

A seguinte tabela mostra as primeiras linhas de um arquivo de importação para a dimensão neste exemplo:

Nome Descrição Tipo de Nó Pai Tipo de Nó Pai CO
TD Total Department Department Rollup TOPNODE   1
100 Recursos Departament TD Department Rollup  
110 Recursos das Unidades Organizacionais Departament 100 Departament  
111 Recursos da Região Oeste Departament 100 Departament  

Nota:

O valor TOPNODE na coluna Pai indica que TD é o nó-raiz. O cabeçalho da coluna para a propriedade Companhia é CO.