Ampliação do Relatório Master-Detail de Pedidos de Compra

1. Objetivo

Esta funcionalidade visa aprimorar o relatório Master-Detail de Pedidos de Compra existente, adicionando a capacidade de filtrar por fornecedor na lista principal, exibir detalhes do fornecedor em uma nova aba e implementar uma navegação de drill-down de 3 níveis para exibir detalhes específicos de cada item do pedido.

2. Pré-requisitos

Autorizações SAP: Acesso a um ambiente de desenvolvimento ABAP com as autorizações necessárias para a criação e modificação de objetos de dicionário de dados, serviços OData e relatórios.

Configuração na Tachyonix: O componente "Relatorio de PO com 15 dias" deve existir na plataforma Tachyonix.io, conforme criado na aula 002. Este componente serve como base para as modificações descritas.

Dados de Exemplo: Necessário ter pedidos de compra (POs) com itens e fornecedores associados no sistema SAP para testar a funcionalidade.

Modelo de Dados: A VDM (View Definition Model) YVDM_PO_PROXIMOS_15_DI deve estar disponível e conter a associação _Supplier para navegação aos dados do fornecedor.

3. Passo a Passo Detalhado

3.1 Adicionar Campo SUPPLIER na Lista Principal

Acessar o Componente: Abra o Tachyonix Builder e selecione o componente "Relatorio de PO com 15 dias" para edição.

Navegar para a Aba "Saída": Clique na aba "Saída" do componente.

Adicionar Campo SUPPLIER: Na seção "Lista Principal", localize a lista de campos exibidos e adicione o campo SUPPLIER (Fornecedor).

Configurar Filtro Visível: Selecione o campo SUPPLIER recém-adicionado e ative a propriedade "Filtro Visível" (Filter Bar). Esta ação permitirá que o usuário insira critérios de filtro para o fornecedor diretamente na barra de filtros da aplicação Fiori.

3.2 Criar Aba "Fornecedor" na Tela de Detalhe

Acessar Tela de Detalhe: Ainda na aba "Saída", navegue até a tela de detalhe principal do pedido, tipicamente nomeada "Detalhe PO".

Adicionar Painel do Tipo "Tab": Adicione um novo painel à tela de detalhe e defina seu tipo como "Tab" (Aba).

Definir Título da Aba: Atribua o nome/descrição "Fornecedor" para a nova aba.

Selecionar Associação "Supplier": Dentro da aba "Fornecedor", selecione a associação _Supplier. Esta associação, proveniente da VDM YVDM_PO_PROXIMOS_15_DI, permite acessar os dados mestre do fornecedor associado ao pedido de compra.

Adicionar Campos do Fornecedor: Adicione os seguintes campos da associação _Supplier à aba "Fornecedor":

• SUPPLIER (Número da conta do fornecedor)
• SUPPLIERACCOUNTGROUP (Grupo de contas do fornecedor)
• SUPPLIERNAME (Nome do fornecedor)
• SUPPLIERFULLNAME (Nome completo do fornecedor)
• CREATIONDATE (Data de criação do registro do fornecedor)

Gerar Versão Parcial: Clique em "Construir" (Build) para gerar os artefatos ABAP e UI5 correspondentes a estas alterações.

3.3 Adicionar Ícone à Aba "Fornecedor"

Retornar ao Tachyonix Builder: Após a geração, retorne ao Tachyonix Builder.

Editar Aba "Fornecedor": Localize e selecione a aba "Fornecedor" na tela de detalhe.

Localizar Propriedade de Ícone: Encontre a propriedade de configuração de ícone para a aba.

Pesquisar Ícone: Utilize a funcionalidade de pesquisa de ícones, digitando "supplier".

Selecionar Ícone: Escolha o ícone "customer-and-supplier" da biblioteca de ícones SAP Fiori/UI5 para representar visualmente a aba.

Confirmar Seleção: Confirme a seleção do ícone.

3.4 Criar Navegação para Detalhe do Item (Drill-down de 3 níveis)

Navegar para Tabela de Itens: No builder, acesse a tela de detalhe do pedido e localize a aba "Item", que contém a tabela de itens do pedido.

Adicionar Ação de Navegação: Selecione a tabela "Item" e adicione uma nova ação do tipo "Navegação" (Navigation Action). Esta ação será acionada ao clicar em uma linha da tabela.

Renomear Tela Gerada Automaticamente: A plataforma Tachyonix criará automaticamente uma nova tela de detalhe, geralmente nomeada "Detalhe - 2.1". Renomeie esta tela para "Detalhe - Item" para maior clareza.

Alterar Layout da Tela "Detalhe - Item": Defina o layout da tela "Detalhe - Item" para "Tab" (Abas).

Selecionar Associação "Purchase Order Item": Na tela "Detalhe - Item", selecione a associação _PurchaseOrderItem. Esta associação fornecerá acesso aos campos de detalhe do item do pedido de compra.

Adicionar Campos do Item: Adicione os seguintes campos da associação _PurchaseOrderItem à tela "Detalhe - Item":

• PURCHASEORDER (Número do documento de compra)
• PURCHASEORDERITEM (Número do item do pedido)
• PURCHASEORDERCATEGORY (Categoria do documento de compras)
• DOCUMENTCURRENCY (Código da moeda do documento)
• MATERIALGROUP (Grupo de mercadorias)
• MATERIAL (Número do material)
• MATERIALTYPE (Tipo de material)
• COMPANYCODE (Empresa)
• PLANT (Centro)

3.5 Construção Final e Resultado

Gerar Versão Final: Clique em "Construir" (Build) novamente para gerar a versão final ampliada da aplicação. A plataforma Tachyonix regenerará todos os artefatos ABAP (VDMs, serviços OData) e UI5 (aplicativo Fiori) com as modificações implementadas.

Verificar Aplicação: Abra a aplicação Fiori gerada no navegador para validar a implementação.

4. Verificação e Teste

Para verificar a correta implementação da funcionalidade:

Acessar o Aplicativo Fiori: Abra o aplicativo Fiori gerado no navegador.

Verificar Lista Principal:

Confirme que a coluna "Fornecedor" está visível na lista principal de pedidos de compra.

Utilize o campo de filtro "Fornecedor" na barra de filtros para testar a filtragem de pedidos por fornecedor.

Verificar Tela de Detalhe do PO:

Clique em um pedido de compra na lista principal para navegar para a tela de detalhe.

Verifique a existência de três abas: "Detalhe PO", "Item" e "Fornecedor".

Confirme que a aba "Fornecedor" exibe o ícone "customer-and-supplier".

Clique na aba "Fornecedor" e valide que os dados do fornecedor (Nº conta, Grupo de contas, Nome, Nome completo, Data de criação) são exibidos corretamente.

Verificar Navegação para Detalhe do Item:

Na tela de detalhe do PO, clique na aba "Item".

Clique em uma linha específica da tabela de itens.

Confirme que a aplicação navega para a nova tela "Detalhe - Item".

Valide que os campos de detalhe do item (Nº documento de compra, Nº item do pedido, Categoria, Moeda, Grupo de mercadorias, Material, Tipo de material, Empresa, Centro) são exibidos corretamente nesta tela.

5. Considerações Técnicas Adicionais

Padrão de Drill-Down de 3 Níveis no SAP Fiori: O padrão de drill-down de 3 níveis, conhecido como Master-Detail-SubDetail, é uma convenção de design comum em aplicações SAP Fiori. Ele permite que o usuário navegue de uma lista geral (Master) para um detalhe específico (Detail) e, em seguida, para um detalhe ainda mais granular de um item dentro do detalhe principal (SubDetail). A implementação desta funcionalidade segue este padrão, proporcionando uma experiência de usuário intuitiva para explorar dados hierárquicos.

Uso de Associações OData para Navegação: A plataforma Tachyonix.io utiliza associações definidas no modelo de dados (VDM) para gerar as relações entre as entidades no serviço OData. Ao selecionar a associação _Supplier ou _PurchaseOrderItem no Builder, o sistema automaticamente infere e configura os caminhos de navegação OData (/PurchaseOrder(PurchaseOrder)/_Supplier ou /PurchaseOrder(PurchaseOrder)/_PurchaseOrderItem(PurchaseOrderItem)) e as entidades correspondentes no serviço OData.

Impacto de Adicionar Associações no Serviço OData Gerado: Cada associação adicionada no modelo de dados e utilizada na interface do usuário resulta na inclusão de Navigation Properties e EntitySets correspondentes no serviço OData. Isso enriquece o modelo de dados exposto, permitindo que o frontend (aplicação Fiori) realize requisições para entidades relacionadas de forma eficiente e padronizada, sem a necessidade de lógica de busca manual no backend.

Boas Práticas de Uso de Ícones SAP UI5: A utilização de ícones (como "customer-and-supplier") nas abas ou outros elementos da interface Fiori é uma boa prática para melhorar a usabilidade e a clareza visual da aplicação. Os ícones da biblioteca SAP UI5 são vetoriais, garantindo escalabilidade e boa aparência em diferentes resoluções e dispositivos. Recomenda-se escolher ícones que representem de forma clara e universal o conteúdo da seção para evitar ambiguidades. A pesquisa por termos-chave na biblioteca de ícones facilita a seleção do ícone mais apropriado.