Documentação do Oracle Cloud Infrastructure

Caso de Uso 1: Estender uma Dimensão em Conformidade

Você pode estender uma pasta de dimensão adicionando novas colunas que representam atributos descritivos adicionais relacionados à dimensão em conformidade.

A pasta Detalhes de Faturamento do Cliente (uma subpasta da pasta Local do Cliente da Área de Assunto pré-criada Financials - Ajustes do CR) já contém o atributo País de Faturamento que contém a abreviação de país de duas letras. No entanto, está faltando o atributo descritivo adicional Country Full Name.

Nesse caso de uso, você adiciona a coluna Nome Completo do País de uma origem externa à pasta Detalhes de Faturamento do Cliente pré-criada para associar o atributo de país completo ao local do cliente. Você une a extensão personalizada à dimensão em conformidade predefinida Dim – Customer Bill To Location usando o Customer Location ID.

Este caso de uso requer a assinatura do Fusion ERP Analytics. No entanto, você pode aplicar os conceitos abordados neste caso de uso a qualquer outra assinatura do Fusion Data Intelligence. O caso de uso pode fazer referência às tabelas e sinônimos pré-criados do Autonomous Data Warehouse e simular tabelas e views de banco de dados personalizadas. Se você tiver ativado a assinatura especificada do Fusion Data Intelligence, poderá usar as amostras fornecidas. A recomendação é substituir os objetos de amostra por seus próprios objetos personalizados do Autonomous Data Warehouse, como tabela personalizada, view materializada, view, sinônimo personalizado ou sinônimo de conjunto de dados de aumento de dados.

Nesta tarefa, você:
  1. Adicionar uma Extensão de Dimensão ao Modelo Semântico
  2. Apresentar a Extensão de Dimensão no Modelo Semântico
  3. Aplicar e Publicar as Personalizações
  4. Validar os Resultados
Use o seguinte para concluir esta tarefa:
  • Tabela de extensão de dimensão de amostra - FDI_X_COUNTRY_D
  • Atributo - País FullName
  • Área do assunto - Ajustes do AR
  • Pasta da Dimensão Pai - Cliente
  • Pasta Dimensão - Dimensão - Local para Faturamento do Cliente
  • Tabela ADW pré-criada - DW_CUSTOMER_LOCATION_D
Certifique-se de consultar Fazer Upload de Amostras para os Casos de Uso de Extensões de Modelo Semântico e concluir estes pré-requisitos:
  1. Crie um sandbox intitulado MySandbox5Mar25. Consulte Criar Sandbox. Ou edite uma sandbox existente na página Extensões de Modelo Semântico; por exemplo, clicando na sandbox MySandbox5Mar25.
  2. Crie a tabela de extensão de dimensão de amostra, FDI_X_COUNTRY_D, no data warehouse autônomo associado à sua instância do Fusion Data Intelligence usando os arquivos de amostra FDI_X_COUNTRY_D.xlsx ou FDI_X_COUNTRY.sql.
  3. Crie uma view intitulada FDI_X_CUSTOMER_LOCATION_D_V para unir a tabela personalizada FDI_X_COUNTRY_D à tabela de dimensão pré-criada DW_CUSTOMER_LOCATION_D que contém a chave primária CUSTOMER_LOCATION_ID, que será usada para unir ao estender a dimensão. Use o seguinte script SQL para criar a view:
    CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_CUSTOMER_LOCATION_D_V" ("CUSTOMER_LOCATION_ID", "COUNTRY_FULLNAME") DEFAULT COLLATION "USING_NLS_COMP"  AS 
  (
SELECT p.CUSTOMER_LOCATION_ID, NVL(c.COUNTRY_FULLNAME,'~NOVALUE~') AS COUNTRY_FULLNAME
FROM OAX$OAC.DW_CUSTOMER_LOCATION_D p
LEFT JOIN FDI_X_COUNTRY_D c
ON p.COUNTRY_CODE = c.COUNTRY_CODE
);
  4. Conceda acesso ao modelo semântico à view FDI_X_CUSTOMER_LOCATION_D_V para o esquema OAX$OAC usando o seguinte script SQL:
    GRANT SELECT ON "OAX_USER"."FDI_X_CUSTOMER_LOCATION_D_V" TO "OAX$OAC";
  5. Valide se os dados estão sendo carregados da amostra conforme esperado usando o seguinte script SQL:
    SELECT * FROM OAX_USER.FDI_X_CUSTOMER_LOCATION_D_V;

Adicionar uma Extensão de Dimensão ao Modelo Semântico

Edite a estrela lógica para definir o objeto do data warehouse autônomo, os atributos, os rótulos de exibição e as chaves e, em seguida, una o objeto personalizado à dimensão em conformidade predefinida que está sendo estendida.

Nesta tarefa, edite a estrela lógica Fact – Fins – AR Adjustments para adicionar uma extensão de dimensão ao objeto de data warehouse autônomo FDI_X_CUSTOMER_LOCATION_V em Dim – Customer Bill To Location. A extensão personalizada é associada à dimensão em conformidade predefinida Dim – Customer Bill To Location usando o Customer Location ID.
  1. Na página Extensões de Modelo Semântico, clique no sandbox MySandbox5Mar25.

    A página Extensões de Modelo Semântico exibindo o sandbox que você criou

  2. In Perform Action, click Manage Logical Star, then Edit Logical Star, then Out of the box, then select Financials - AR Adjustments as the subject area, select Fact – Fins – AR Adjustments as the corresponding fact, and then Next.

    A caixa de diálogo Executar Ação

  3. Na página Estrela Lógica: Fato, localize a tabela de dimensões Dim - Local para Faturamento do Cliente, clique com o botão direito do mouse nela e clique em Gerenciar Extensão.

    A página Estrela Lógica: Fato exibindo a tabela de dimensão Dim - Local para Faturamento do Cliente

  4. Na lista de valores Gerenciar Extensão, selecione Estender Dimensão.

    A lista Gerenciar Extensões de valores

  5. Na página Estender uma Dimensão, na etapa 1 do assistente, selecione OAX_USER no Esquema e selecione FDI_X_CUSTOMER_LOCATION_D_V no Objeto. Marque a caixa de seleção Usar para Chave da coluna de origem CUSTOMER_LOCATION_ID, marque a caixa de seleção Adicionar Atributos da coluna de origem COUNTRY_FULLNAME e clique em Próximo.
    Observação

    Certifique-se de que o nome para exibição seja exclusivo e não entre em conflito com nenhum dos nomes de coluna pré-criados; por exemplo, renomeie CUSTOMER_LOCATION_ID como ID do Local do Cliente FDI.

    A página Estender uma Dimensão

  6. Na etapa 2 do assistente, selecione Esquerda Externa em Selecionar Tipo de Junção.
    Observação

    O tipo de junção é principalmente Interno (correspondência) ou Esquerdo (todos da Dimensão original). O tipo de junção à esquerda garante que nenhum dado seja perdido.

    Etapa 2 do assistente Estender uma Dimensão em que você seleciona o tipo de junção

  7. Selecione ID do Local do Cliente (DOUBLE) como Chave da Dimensão e CUSTOMER_LOCATION_ID (DOUBLE) como Chave da Dimensão Estendida. Clique em Encerrar.

    Etapa 2 do assistente Estender uma Dimensão em que você seleciona as chaves de junção

  8. Revise a dimensão estendida.

    A página Estender Dimensão exibindo a dimensão estendida

Apresentar a Extensão de Dimensão no Modelo Semântico

Você modifica a área de assunto para apresentar as colunas estendidas em uma pasta de área de assunto.

Nesta etapa, você modifica a área de assunto Financials - Ajustes do CR para apresentar a coluna Nome Completo do País na pasta Detalhes de Faturamento do Cliente pré-criada.
  1. Navegue até o sandbox MySandbox5Mar25.
  2. No sandbox MySandbox5Mar25, clique em Executar Ação, Gerenciar Áreas de Assunto, Modificar uma Área de Assunto, selecione Finanças – Ajustes do CR como a área de assunto e, em seguida, Próximo.

    A caixa de diálogo Executar Ação

  3. Na etapa 1 do assistente na página Modificar uma Área de Assunto – Finanças – Ajustes do CR, exiba os detalhes e clique em Próximo.
  4. Na etapa 2 do assistente, selecione Gerenciar Elementos e clique em Gerenciar Personalizações de Factory.

    A etapa 2 do assistente na página Modificar uma Área de Assunto – Ajustes do Financials – AR exibindo as opções de Gerenciar Elementos

  5. Em Adicionar uma Área de Assunto, selecione Nome Completo do País e clique em Adicionar Pastas.

    A caixa de diálogo Adicionar uma Área de Assunto exibindo a coluna Nome Completo do País na pasta Detalhes de Faturamento do Cliente pré-criada

  6. Em Adicionar uma Área de Assunto, selecione a pasta Detalhes do Faturamento do Cliente e clique em Adicionar Pastas.

    A caixa de diálogo Adicionar uma Área de Assunto exibindo a pasta Detalhes de Faturamento do Cliente pré-criada à qual a dimensão estendida é adicionada

  7. Verifique as adições e clique em Concluir.

    A página Modificar uma Área de Assunto – Ajustes Financeiros – AR exibindo as adições

Aplicar e Publicar as Personalizações

Aplique as alterações para compilar o sandbox e verifique se o sandbox está livre de erros.

Em seguida, você usa a guia Atividade para depurar, resolver erros e confirmar que a ação Aplicar Alterações foi concluída e foi bem-sucedida. Finalmente, você mescla as alterações no sandbox principal e publica as principais extensões de usuário para compartilhar as novas extensões com os consumidores.

Nesta etapa, você aplica as alterações, usa a guia Atividade para monitorar o status, mesclar o sandbox MySandbox5Mar25 ao sandbox Principal e, em seguida, publicar a extensão de usuário principal.

  1. Na página Extensões de Modelo Semântico, passe o cursor do mouse sobre o sandbox MySandbox5Mar25 para exibir Ações e clique em Aplicar Alterações.
  2. Clique na guia Atividade para monitorar a tarefa Aplicar Alterações na página Atividade.
  3. Após a aplicação bem-sucedida das alterações, clique em Publicar Modelo na página Extensões de Modelo Semântico.
  4. Em Publicar Modelo, em Extensões de Usuário, selecione MySandbox5Mar25 e, em Configurações de Segurança, selecione Todos.
  5. Clique em Publicar.
  6. Na página Extensões de Modelo Semântico, clique na guia Atividade para monitorar a tarefa Publicar Personalizações.

Validar os Resultados

Verifique se as suas personalizações estão visíveis no modelo semântico.

  1. Na Console do Fusion Data Intelligence, clique em Ir para Home Page.
  2. Na Home page do Oracle Analytics, clique em Criar, clique em Pasta de Trabalho, em Adicionar Dados, selecione Finanças - Ajustes do AR, a área de assunto que é estendida nesse caso de uso e clique em Adicionar à Pasta de Trabalho.
  3. Expanda a pasta Local do Cliente e, em seguida, expanda a pasta Detalhes da Fatura do Cliente e verifique se o atributo estendido Nome Completo do País está visível na parte inferior da lista de atributos.
  4. Crie um relatório para exibir que o atributo de dimensão estendida foi unido com sucesso às medidas de fato desejadas.

    O relatório exibe o atributo de dimensão estendida unido com sucesso às medidas de fato desejadas