Introdução

Este tutorial prático de 15 minutos mostra como usar uma expressão em um conversor de tipo de nó para encontrar o pai de um nó por meio de uma solicitação de assinatura. Você começa criando uma assinatura e depois adiciona expressões a um conversor de tipo de nó para derivar logicamente o nome do nó e o nome pai. Por fim, você cria e envia uma solicitação para testar a lógica e se conecta como responsável pela assinatura para exibir os resultados da solicitação de assinatura.

Histórico

Ao adicionar um nó à origem e enviar a alteração por meio de uma solicitação de assinatura, você deseja que o mecanismo do Enterprise Data Management Cloud localize um pai específico no destino com base em uma propriedade do nó de origem. Você pode fazer isso criando uma expressão no conversor de tipo de nó.

No exemplo deste tutorial, você está criando duas expressões. A primeira expressão calcula o nome do nó no destino e a segunda expressão localiza o pai apropriado no destino. Quando você envia a alteração por meio de uma solicitação de assinatura com envio automático selecionado e nenhuma aprovação é necessária, a alteração é enviada automaticamente para o destino.

Pré-requisitos

Antes de iniciar este tutorial, você deve:

  • Tenha acesso do Administrador de Serviço ao seu ambiente do Enterprise Data Management Cloud.
  • Cria um aplicativo de amostra. Para obter mais informações, consulte a documentação.

    • Atenção:

    Observe que a criação do aplicativo de amostra removerá todos os aplicativos e artefatos existentes no ambiente. Faça backup do ambiente atual antes de criar o aplicativo de amostra. Para obter mais informações sobre backup, upload e importação de aplicativos e artefatos, consulte a documentação Administrando a Migração para o Oracle Enterprise Performance Management Cloud.
  • Crie um usuário e, em seguida, adicione o usuário ao grupo Usuário e ao grupo Usuário Interativo. Neste tutorial, este usuário é Barry Dylan.

Identificando a origem e o destino

  1. Efetue sign-in como um usuário com a função Administrador de Serviço, navegue até Exibições e abra a exibição Manutenção da Conta. O ponto de vista Conta Corporativa é sua origem e o ponto de vista Conta do Plano é seu destino.
    Visualização - Manutenção da conta
  2. Selecione o ponto de vista Conta Corporativa, navegue até o nó 11000 e expanda-o.
    Ponto de Vista da Conta Corporativa
  3. Clique em Ícone de layout lado a lado (Layout Lado a Lado) para exibir os pontos de vista Conta Corporativa e Conta do Plano.
    Layout Lado a Lado
  4. Com 11000 selecionado no ponto de vista Conta Corporativa, clique em Ícone Localizar Nó (Localizar Nó da Conta Corporativa do Ponto de Vista) para localizar o nó relacionado A_11000 no ponto de vista Conta do Plano.
    Localizar Nó do Ponto de Vista

    Neste tutorial, você adiciona um nó filho ao pai 11000 na dimensão Conta Corporativa, usa expressões separadas para calcular o nome do nó de destino e para localizar o pai A_11000 na dimensão Conta do Plano e, em seguida, adiciona o nó ao pai na dimensão de destino por meio de uma solicitação de assinatura.

Criando uma assinatura

  1. Clique em Ícone Layout com Guias (Layout com Guias) para desativar o layout Lado a Lado e inspecionar o ponto de vista Conta do Plano.
    Quadro de subcontas
  2. Selecione a guia Inscrições e, depois, clique em Criar.
    Quadro de subcontas
  3. Defina o ponto de vista de origem como Conta Corporativa na exibição Manutenção da Conta e clique em Criar.
    Quadro de subcontas
  4. Selecione a guia Definição.
    Quadro de subcontas
  5. Na guia Definição, clique em Editar.
    Quadro de subcontas
  6. Adicione Barry Dylan como o Responsável Padrão e selecione Ativado e Envio Automático.
    Quadro de subcontas
  7. Salve a assinatura e selecione a guia Conta do Plano no canto inferior esquerdo. Observe que a assinatura criada está listada na guia Assinaturas
    8. Guia Inscrição

Configurando um conversor de nós

  1. No inspetor de ponto de vista Conta do Plano, selecione a guia Cadeia de Dados.
    Quadro de subcontas
  2. Selecione o objeto da cadeia de dados Tipos de Nó e, em seguida, selecione o tipo de nó Conta.
    Quadro de subcontas
  3. Na guia Geral, observe que o tipo de nó inclui o prefixo de qualificador A_.
    Quadro de subcontas
  4. Selecione Conversores e clique em Editar.
    Quadro de subcontas

Criando uma expressão para calcular o nome do nó

    Nesta seção, você adiciona a seguinte expressão para calcular o nome do nó: 
     return "A_".concat(sourceNode.properties.Core.Name)

    Por exemplo, você adiciona um nó chamado 11504 à dimensão de origem. A expressão adiciona o qualificador de prefixo A_ ao nó e o nó é adicionado como A_11504 no destino.

    Para obter mais informações sobre a criação de expressões, consulte nosso vídeo tutorial Transformando Propriedades Usando o Criador de Expressão.

  1. Para a propriedade Nome, altere a operação de Copiar para Transformar.
    Quadro de subcontas
  2. Para o nó Nome, clique em fx (Editar Expressão) para abrir o Expression Builder.
    Quadro de subcontas
  3. Faça download da expressão no arquivo Property_Transform_Name.json e clique no botão Carregar do Arquivo (Carregar do Arquivo).
    4. Fazer upload da expressão do nome do nó
  4. Na caixa de diálogo Abrir Arquivo, selecione o arquivo JSON submetido a download e clique em Abrir.
    5. Expressão do nome do nó
  5. Clique em Aplicar.
    Inspetor de tipo de nó da conta

Criando uma expressão para derivar o nome pai

    Nesta seção, adicione a seguinte expressão para derivar o nome do nó pai: 
    return "A_".concat(sourceNode.properties.Core.Name.substring(0, 2), "000")

    Por exemplo, você adiciona um nó filho chamado 11504 ao nó pai 11000 na dimensão de origem. Para localizar o nó pai na dimensão de destino, a expressão adiciona o qualificador de prefixo A_, identifica os primeiros 2 caracteres do nome do nó pai na dimensão de origem (11 neste exemplo) e adiciona 000 para identificar o pai como A_11000 no destino.

  1. Para a propriedade Pai, na lista suspensa Operação, selecione Transformar.
    Operação de propriedade-pai
  2. Para a propriedade Pai, clique em fx (Editar Expressão) para abrir o Expression Builder.
    Tipo de nó da conta
  3. Faça download da expressão no arquivo Property_Transform_Parent.json e clique no botão Carregar do Arquivo (Carregar do Arquivo).
    4. Fazer upload da expressão do nome do nó
  4. Na caixa de diálogo Abrir Arquivo, selecione o arquivo JSON submetido a download e clique em Abrir.
    5. Expressão do nome do nó pai

Testando a expressão do nome pai

Nesta seção, você testa a expressão para derivar o nome do nó pai.
  1. Clique no botão Carregar do Arquivo (Testar Expressão).
    Construtor de Expressões
  2. No painel Testar Expressão, execute as seguintes ações:
    • Para Ponto de Vista, selecione Conta Corporativa na exibição Manutenção de Conta.
    • Para Nó, selecione 11000 (Investimentos de Caixa e de Curto Prazo).
    • Clique em Avaliar.
    Testar expressão do nó pai
  3. Revise o resultado da avaliação da expressão, A_11000, e confirme se a expressão deriva corretamente o nome do nó pai na dimensão de destino.
    4. Avaliar expressão
  4. Feche o painel Testar Expressão e clique em Aplicar.
    Inspetor de tipo de nó da conta
  5. Salve e feche o inspetor.
  6. Clique em OK para confirmar que a view foi modificada.
    Quadro de subcontas

Criando uma solicitação para testar as expressões

  1. Na exibição Manutenção de conta, clique em Nova solicitação.
    Nova Solicitação
  2. No ponto de vista Conta Corporativa, expanda T > 10000 > 11000.
    Quadro de subcontas
  3. Clique em Menu Nó (menu Nó) à direita do nó 11000 para iniciar o menu de contexto e selecione Adicionar Filho para criar um novo nó como filho do nó 11000.
    Quadro de subcontas
  4. Defina as propriedades filho:

    Property Definição
    Nome 11,504
    Descrição Compensando a Conta Corrente USBNK3
    Descrição US Compensando a Conta Corrente USBNK3
    Resumo No
    Habilitado Sim
    Permitir Publicação Sim
    Tipo da Conta Ativo
    Categoria Financeira Caixa

    Quadro de subcontas
  5. No painel de solicitação, ao lado de Todos os Itens, clique em Ícone do Menu de Itens da Solicitação (Menu Itens da Solicitação) e selecione Validar.
    Quadro de subcontas

    Você deverá receber uma mensagem de validação bem-sucedida.

    Quadro de subcontas

  6. Envie a solicitação. Você deverá receber uma mensagem informando que a solicitação foi enviada com sucesso.
    Quadro de subcontas
  7. Feche a visualização.

Exibindo os resultados da solicitação

  1. Navegue até Solicitações, defina o filtro Tipo de Solicitação como Assinatura e confirme se uma solicitação foi enviada ao responsável pela solicitação: Barry Dylan. Observe que o status da solicitação é Rascunho porque há um problema com a solicitação.
    Quadro de subcontas
  2. Saia do sistema e entre novamente como Barry Dylan. Na Página inicial, selecione a guia Atividade e clique em Solicitações designadas a mim.
    Página inicial de Barry Dylan
  3. Na página Atividade da Solicitação, clique no link ID da Solicitação para revisar o problema da solicitação.
    Página inicial de Barry Dylan
  4. Observe um erro de validação com o nó A_11504.
    Erro de validação
  5. Corrija o erro definindo as propriedades do nó A_11504 conforme listado na tabela a seguir:
    Property Definição
    Tipo de Dados Moeda
    Tipo de Taxa do Exchange Média

    Confirme se o nó pai está calculado corretamente: O nó A_11504 é adicionado como filho ao pai A_11000 no ponto de vista Conta do Plano.
    6. Quadro de subcontas
  6. Valide e envie a solicitação.
    Solicitação submetida com sucesso
  7. Clique em Voltar a Solicitações. Na página Solicitar Atividade, defina o filtro Status como Tudo e o filtro Minha Atividade como Enviado. Verifique se o status da solicitação está Concluído e se o estágio da solicitação está Fechado.
    Solicitar Atividade