Adicionar Membros a um Pai Especificado

Quando você precisar adicionar novos membros ao outline do Essbase, mas os dados de origem não especificarem seus antecessores, crie uma regra de criação de dimensão que os adicione a um membro pai especificado. Use o método de criação de dimensão Adicionar como filho de para adicionar todos os novos membros como filhos de um pai especificado.

Após o Essbase adicionar todos os novos membros ao outline, você poderá revisar os membros adicionados e movê-los ou excluí-los no outline.

Para este exemplo de criação de dimensão, suponha que você queira adicionar 600-54 e 780-22 como filhos de um membro de estrutura existente, NewProducts.

Figura 14-6 Exemplo para Adicionar Membros como um Filho de um Pai Especificado


Esta imagem mostra os novos membros adicionados como filhos de NewProducts, conforme descrito no texto que precede a imagem.

Esse caso de uso chama o método de criação Adicionar como filho de. Nesse método de criação, quando o Essbase encontra um novo membro nos dados de origem, ele adiciona o novo membro como filho do nome pai que você especifica. O pai deve fazer parte do outline antes de iniciar a criação da dimensão.

Para recriar este exemplo,

  1. Importe/crie o cubo Básico de Amostra, usando a pasta de trabalho do aplicativo disponível na galeria no catálogo de arquivos do Essbase Server.

  2. Crie um arquivo de dados delimitado por tabulações como o seguinte, nomeie-o como sibpar.txt e faça upload dele para o diretório de cubo Sample Basic.

    600-54	Texas	Sales	100	120	100
    780-22	Texas	Sales	111	154	180
  3. Abra o outline Sample Basic para edição na interface Web do Essbase e, para a dimensão Produto, adicione um membro chamado NewProducts.

  4. Verifique e salve a estrutura.

  5. Na Home page, abra o aplicativo e, em seguida, abra o banco de dados (cubo).

  6. Selecione a guia Scripts e clique em Regras.


    A guia Scripts está selecionada e o bloco Regras está destacado, na interface web do Essbase.

  7. Clique em Criar e escolha Criação de Dimensão (Regular).


    Na caixa de diálogo de inspeção do banco de dados, o botão Criar é pressionado e a opção Criação de Dimensão (Regular) é selecionada

  8. Na caixa de diálogo Nova Regra,

    1. Informe um nome de regra; por exemplo, sibpar.

    2. Para Tipo de Origem, selecione Arquivo, clique em Catálogo e navegue até sibpar.txt.

      Quando você clica em Catálogo, espera-se que o arquivo esteja localizado no diretório de cubo no Essbase Server por padrão, portanto, você já deve tê-lo carregado usando a seção Arquivos da interface Web do Essbase. Se o arquivo estiver na sua máquina cliente, clique em File Browser para localizar o arquivo.

    3. Deixe os campos Número de Registro do Cabeçalho e Número de Registro de Criação de Dimensão como 0. Registros de cabeçalho não são úteis para builds de dimensão.

    4. Altere o valor de Delimitador de Vírgula para Guia.

    5. Clique em Continuar.

    6. A regra de criação de dimensão é aberta com campos indefinidos e dados de visualização (do arquivo de texto) preenchendo a grade abaixo dos campos.


      Nova regra inacabada chamada sibpar. Os metadados do campo para os campos 1-6 estão em branco nos seletores de campo. Os registros são preenchidos abaixo dos seletores de campo, correspondendo aos dados no arquivo .txt da etapa 2.

  9. Como esta é uma nova regra, ainda não há dimensões associadas.

    1. Clique em Dimensões.
      Botão Dimensões no editor de regras

    2. Selecione ou digite o nome da dimensão Produto e clique em Adicionar.
  10. Agora você precisa definir o método de criação e verificar outras instruções operacionais de criação de dimensão. Clique em Produto para editar as propriedades.
    Nome da dimensão Produto clicável na caixa de diálogo Editar Dimensões.

  11. Altere Método de Criação para Adicionar como filho de e digite o nome do membro pai de destino abaixo dele (NewProducts).


    Propriedades de criação de dimensão para Produto. Todas as opções são deixadas como padrão, exceto o Método de Criação e o Nome do Membro, que são alterados conforme descrito.

    Clique em OK.

  12. Clique no seletor Dimensão no Campo 1 e selecione Produto.


    Dimensão do produto selecionável na caixa Dimensão no Campo 1

  13. Deixe o seletor Tipo do Campo 1 em branco.

  14. Selecione os campos 2-6. Para fazer isso, clique na área de cabeçalho inativa com o rótulo Campo 2, mantenha pressionada a tecla Shift e clique na área de cabeçalho Campo 6. Clique em Ignorar.


    Nova regra concluída chamada sibpar, projetada para adicionar membros como filhos de um pai especificado. Os metadados do campo para os campos 1-6 contêm Produto para a dimensão, com Tipo em branco. Os registros são preenchidos abaixo dos seletores de campo, correspondendo aos dados no arquivo .txt da etapa 2. Os campos 2-6 são marcados para serem ignorados durante a criação da dimensão.

    Como resultado, essa regra só operará no primeiro campo de cada registro. Ignorar campos pode ser útil quando você não precisa usar todos os campos na origem para sua criação de dimensão, mas não deseja preparar diferentes origens.

  15. Verifique a regra, em seguida, salve e feche. Se houver erros, consulte Requisitos para Arquivos de Regra de Criação de Dimensão Válidos.

  16. Execute o job de criação de dimensão.

    Se os jobs falharem com o erro a seguir, isso provavelmente significa que o outline não contém o nome do membro pai obrigatório (NewProducts, neste exemplo).

    Member missing for add as child of dimension setting for dimension <name>
  17. Veja a estrutura de tópicos e inspecione o membro Produto NewProducts para confirmar se os membros foram adicionados.


    Visualizador de estrutura na interface web do Essbase. A dimensão Produto é expandida para mostrar o membro pai NewProducts com dois novos membros adicionados: 600-54 e 780-22

Tabela 14-3 Resumo da Adição de Membros como Filho de um Pai Especificado

Campo Valor Mais informações

Dimensão do produto

Selecione Adicionar como filho do método de build

Selecione um Método de Criação

Digite NewProducts na caixa de texto Adicionar como Filho de.

Campo 1 (Produto)

  • Não selecione um tipo de campo.

  • Definir a dimensão do campo como Produto

Definir Informações do Tipo de Campo de Criação de Dimensão

Campos 2 a 6

Ignorar os campos

Você pode ignorar todos os campos de uma coluna especificada dos dados de origem.

Consulte Ignorar campos.