Caso de Uso 3: Adicionar Dimensão Personalizada a um Fato Pré-Criado

Você pode adicionar uma pasta de dimensão personalizada contendo atributos descritivos e unir a dimensão personalizada a uma tabela de fatos pré-criada com chaves definidas.

A área de assunto predefinida SCM – Pedido de venda não contém o atributo de dimensão Departamento de item personalizado necessário. Nesse caso de uso, adicione uma pasta Departamento de item personalizado à área de assunto pré-criada SCM – Pedidos de venda. Esta pasta contém o atributo Departamento. A dimensão personalizada é associada ao fato Fact – OM Sales Orders pré-criado usando uma chave composta de ID da Organização e ID do Item do Estoque.

Este caso de uso requer assinatura do Fusion SCM 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 a 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.

Use o seguinte para concluir esta tarefa:
  • Atributo - Departamento
  • Área do assunto - SCM - Pedidos de venda
  • Pasta de fatos - Dimensão - Ordens de Venda OM
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. Gere a visualização de dimensão de amostra FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V usando este script SQL:
    CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V" ("ORG_ITEM_KEY", "ORGANIZATION_ID", "INVENTORY_ITEM_ID", "DEPARTMENT") DEFAULT COLLATION "USING_NLS_COMP"  AS 
      (
    SELECT ORGANIZATION_ID || INVENTORY_ITEM_ID AS ORG_ITEM_KEY,
    ORGANIZATION_ID, INVENTORY_ITEM_ID,
    CASE SUBSTR(INVENTORY_ITEM_ID,-1,1)
    WHEN '1' THEN 'Clothing'
    WHEN '2' THEN 'Shoes'
    WHEN '3' THEN 'Cosmetics'
    WHEN '4' THEN 'Furniture'
    WHEN '5' THEN 'Gardening'
    WHEN '6' THEN 'Hardware'
    WHEN '7' THEN 'Home Appliances'
    WHEN '8' THEN 'Houseware'
    WHEN '9' THEN 'Paint'
    WHEN '0' THEN 'Sporting Goods'
    ELSE 'Other'
    END DEPARTMENT
    FROM OAX$OAC.DW_INVENTORY_ITEM_D
    );
  3. Conceda acesso ao modelo semântico para a view FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V do esquema OAX$OAC usando o seguinte script SQL:
    GRANT SELECT ON "OAX_USER"."FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V" TO "OAX$OAC";
  4. Valide se os dados estão sendo carregados da amostra conforme esperado usando o seguinte script SQL:
    SELECT * FROM OAX_USER.FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V;

Adicionar uma Dimensão Personalizada ao Modelo Semântico

Edite a estrela lógica para definir o objeto, os atributos, os rótulos de exibição, as chaves e a hierarquia do autonomous data warehouse.

Nesta etapa, você edita a estrela lógica Fact – OM Sales Orders para adicionar uma dimensão personalizada Custom Item Department que faz referência ao objeto de data warehouse autônomo FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V.
  1. Na página Extensões de Modelo Semântico, clique no sandbox MySandbox5Mar25.
  2. In Perform Action, click Manage Logical Star, then Edit Logical Star, then Out of the box, then select SCM - Sales Orders as the subject area, select Fact - OM Sales Orders as the corresponding fact, and then click Next.
  3. Na página Estrela Lógica: Fato, clique em Gerenciar Dimensão e em Adicionar Dimensão.

    A página Estrela Lógica: Fato exibindo a lista Gerenciar Dimensão de valores

  4. Na etapa 1 do assistente Adicionar uma Dimensão, selecione OAX_USER em Esquema, FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V em Objeto e informe Departamento do Item Personalizado em Nome da Dimensão. Marque a caixa de seleção Add Attributes para DEPARTMENT e ORG_ITEM_KEY. Marque a caixa de seleção Usar para Chave para INVENTORY_ITEM_ID, ORGANIZATION_ID e ORG_ITEM_KEY. Clique em Avançar.

    A página Adicionar uma Dimensão exibindo a etapa 1 do assistente

  5. Na etapa 2 do assistente, deixe a caixa de seleção Adicionar hierarquia à Área de Assunto desmarcada para omitir uma hierarquia. No entanto, é um requisito nomear a hierarquia e mapear uma chave primária e um atributo de exibição na estrela lógica, embora a hierarquia não apareça na área de assunto. Conclua esta etapa da seguinte forma:
    • Informe Hierarquia do Departamento do Item Personalizado em Nome da Hierarquia.
    • Em Propriedades, defina a chave primária e o atributo de exibição da seguinte forma:
      • Clique no ícone de lápis de Chave Primária e selecione Chave do Item da Organização.
      • Clique no ícone de lápis para Exibir Atributo e selecione Chave do Item da Organização.
    • Em Elementos de Dados Selecionados, em Elementos de Dados Disponíveis, arraste e adicione Departamento e Chave do Item da Organização ao nível Detalhe.
      Observação

      Você pode adicionar os atributos de exibição da dimensão a um nível ou ao nível de Detalhe.

    A página Adicionar uma Dimensão exibindo a etapa 2 do assistente

  6. Clique em Encerrar. Vá para a próxima tarefa sem sair do assistente, Adicionar Coluna Física a um Fato Pré-Criado.

Adicionar Coluna Física a um Fato Pré-Criado

Você estende o fato pré-criado para expor colunas físicas que você usa como chaves para unir a nova dimensão personalizada na estrela lógica.

Nesta etapa, você estende Fato – Ordens de Venda do OM para expor as colunas físicas ORGANIZATION_ID e INVENTORY_ITEM_ID a serem usadas como chaves para associação à nova dimensão personalizada Departamento de Item Personalizado. Forneça nomes exclusivos para as colunas lógicas; por exemplo, ORGANIZATION_ID recebe um nome exclusivo ID da Organização de UC e INVENTORY_ITEM_ID recebe um nome exclusivo ID do Item de Inventário de UC.
  1. Na página Estrela Lógica: Fato, clique com o botão direito do mouse em Fato - Ordens de Venda do OM e, em seguida, clique em Gerenciar Extensão.

    A página Estrela Lógica: Fato exibindo o Fato - Ordens de Venda do OM em que você clica com o botão direito do mouse

  2. Na página Sandbox: MySandbox5Mar25, clique em Gerenciar Extensão e depois clique em Adicionar Colunas.

    A página Sandbox: MySandbox5Mar25 exibindo a opção em Gerenciar Extensão

  3. Na página Adicionar Colunas, clique em Adicionar Coluna Física.

    Página Adicionar Colunas

  4. Em Selecionar Colunas Físicas, marque a caixa de seleção ORGANIZATION_ID e INVENTORY_ITEM_ID e clique em OK.

    Página Selecionar Colunas Físicas

    Observação

    Essas colunas são provenientes da tabela Fact_DW_OM_FULFILLMENT_CF.
  5. Na página Adicionar Colunas, em Coluna Lógica, informe nomes de colunas lógicas exclusivos, como ID da Organização de UC e ID do Item de Inventário de UC, e clique em Finalizar.
    Observação

    É muito importante que o Nome da Coluna Lógica seja exclusivo e não entre em conflito com o nome da coluna pré-criada.

    A página Adicionar Colunas exibindo a Coluna Lógica na qual você deve informar nomes exclusivos de colunas lógicas

  6. Vá para a próxima tarefa sem sair do assistente, Junte a Dimensão Personalizada ao Fato Pré-Criado.

Associar a Dimensão Personalizada ao Fato Predefinido

Você une a dimensão personalizada ao fato pré-criado definindo o tipo de junção, a condição de junção e o nível de contexto. Você pode definir junções complexas; no entanto, a recomendação é tentar usar junções padrão sempre que possível.

Nesta etapa, você define uma junção externa esquerda padrão no fato Fact – OM Sales Orders pré-criado para a dimensão personalizada Dim – Custom Item Department usando uma chave composta formada por ID da Organização de UC e ID do Item de Estoque de UC de cada tabela. O nível de Conteúdo é definido como Detalhe.
  1. Na página Estrela Lógica: Fato, clique e arraste o círculo da dimensão personalizada Dim – Departamento de Item Personalizado para o círculo de fato pré-criado Fato – Ordens de Venda do OM no formato gráfico para abrir a caixa de diálogo Junção.

    A página Estrela Lógica: Fato exibindo a dimensão personalizada Dim – Departamento de Item Personalizado e o fato pré-criado Fato – Ordens de Venda OM para se juntar a eles

  2. Na caixa de diálogo Associar, defina Tipo de Junção como Externa da Esquerda, defina Nível de conteúdo como Detalhe, defina Condição de Junção da seguinte forma e clique em Concluído:
    • Para Fato - Ordens de Venda OM, selecione ID da Organização de UC (DOUBLE) e, para Dim - Departamento de Item Personalizado, selecione ID da Organização (DOUBLE).
    • Para Fato – Pedidos de venda do OM, selecione ID do item de estoque do UC (DOUBLE) e, para Dim – Departamento de item personalizado, selecione ID do item do estoque (DOUBLE).

    A caixa de diálogo Join

  3. Revise as junções personalizadas no formato tabular.

    Junções personalizadas no formato tabular

  4. Revise as junções personalizadas no formato gráfico.

    Junções personalizadas no formato gráfico

Apresentar a Dimensão Personalizada no Modelo Semântico

Modifique a área de assunto para apresentar a nova dimensão personalizada e seus atributos. A dimensão é representada como uma pasta que contém colunas na área de assunto.

Nesta etapa, você modifica a área de assunto SCM – Ordem de Venda para apresentar a nova pasta de dimensão personalizada Departamento de Item Personalizado que contém a coluna de atributo Departamento.
  1. Navegue de volta para o sandbox MySandbox5Mar25, clique em Executar Ação, em Gerenciar Áreas de Assunto e clique em Modificar uma Área de Assunto. Selecione SCM – Pedidos de venda e clique em Próximo.
  2. Na página Modificar uma Área de Assunto - SCM - Ordens de Venda, revise os detalhes da área de assunto na etapa 1 do assistente e clique em Próximo.
  3. Na etapa 2 do assistente, clique em Gerenciar Elementos e depois clique em Gerenciar Novas Personalizações.

    A etapa 2 do assistente na página Modificar uma Área de Assunto - SCM - Ordens de Venda exibindo a lista de valores Gerenciar Elementos

  4. Em Adicionar Área de Assunto, em Personalizado, selecione a coluna de atributo Departamento e clique em Adicionar.

    Isso adiciona a pasta Dim - Departamento de Item Personalizado ao modelo semântico e coloca a coluna Departamento dentro da pasta.


    A caixa de diálogo Adicionar Área de Assunto exibindo os atributos que você pode selecionar

  5. Revise os elementos de dados selecionados e clique em Concluir.

    A página Modificar uma Área de Assunto – SCM – Pedidos de Vendas exibindo os elementos de dados selecionados

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 SCM – Pedidos de Vendas, a área de assunto estendida nesse caso de uso e clique em Adicionar à Pasta de Trabalho.
  3. Expanda a pasta Departamento de Item Personalizado e verifique se a coluna de atributo Departamento aparece na parte inferior da área de assunto por padrão. Arraste a coluna Departamento para a pasta de trabalho.

    A dimensão personalizada, Departamento do Item Personalizado, que você adicionou

  4. Arraste uma medida como Contagem de Linhas da pasta Fatos - Ordens de Venda para confirmar se o fato pode se associar à dimensão personalizada.

    Uma medida da pasta Fatos - Ordens de Venda

  5. Verifique os resultados.

    O resultado mostrando que o fato pré-criado pode se associar à dimensão personalizada