Semantic Object

Um semantic object é o substantivo da navegação no SAP Fiori; a ação é o verbo. Juntos, eles formam um intent, escrito na URL do launchpad como #SemanticObject-action, opcionalmente seguido de parâmetros.

1. Um tile, um link ou um app solicita um intent, por exemplo #PurchaseOrder-display?PurchaseOrder=4500000123.
2. O launchpad procura target mappings com o mesmo semantic object e a mesma ação entre os catálogos das roles do usuário.
3. O target mapping correspondente decide qual app abre.

Um semantic object geralmente tem muitas ações. Na SAP Fiori Apps Reference Library, PurchaseOrder-display é resolvido para a transação clássica ME23N via SAP GUI for HTML, PurchaseOrder-manage para o app Manage Purchase Orders e PurchaseOrder-displayFactSheet para um fact sheet de pedido de compra. O app chamador apenas nomeia o business object e a operação pretendida. Um semantic object é, portanto, um nome estável para uma entidade de negócio, independente da tecnologia de UI que acabará por tratá-la.

• Launchpad baseado em ABAP (on-premise, Private Edition): a SAP entrega semantic objects com os componentes de UI; a transação /UI2/SEMOBJ_SAP os exibe. Semantic objects customizados são criados com a /UI2/SEMOBJ ou com a atividade de Customizing para semantic objects customizados na SPRO (UI Technologies, SAP Fiori, conteúdo do launchpad). Uma entrada customizada com a mesma chave de uma entrada entregue pela SAP sobrepõe os atributos dela.
• SAP BTP e SAP Build Work Zone: cada app declara os semantic objects e as ações que aceita como inbounds no seu app descriptor (sap.app → crossNavigation → inbounds), onde semantic object e ação são obrigatórios. Os semantic objects vêm desses descriptors, e não de uma transação de manutenção ABAP.
• SAP S/4HANA Cloud Public Edition: os semantic objects entregues pela SAP são usados como vêm. Para um app customizado, o desenvolvedor define o tile, incluindo o seu intent, como parte do aplicativo antes de implantá-lo.

O semantic object é definido uma vez por landscape e depois referenciado em todos os pontos em que a navegação precisa dele.

Os semantic objects controlam mais do que tiles. No SAP Fiori elements, um campo anotado com um semantic object (Common.SemanticObject em OData ou CAP, @Consumption.semanticObject em ABAP CDS) é renderizado como link quando o semantic object é válido no launchpad. Ao clicar nele, são listadas todas as ações que o usuário pode alcançar para esse objeto; quando existe apenas um destino, o app navega diretamente.

Apps SAPUI5 freestyle usam o serviço de navegação do shell (sap.ushell.services.Navigation) para consultar quais links existem para um semantic object e para navegar. Nos dois casos, a lista de links é calculada por usuário a partir dos target mappings das roles desse usuário, de modo que dois usuários que clicam no mesmo campo de fornecedor podem ver opções diferentes.

Um semantic object em um campo é uma solicitação de opções de navegação, e as roles do usuário decidem quais opções aparecem.

Use este critério de decisão: a entidade já existe como business object da SAP?

• Reutilize o semantic object da SAP quando um app customizado trabalha com a mesma entidade, por exemplo um app customizado de aprovação de pedidos de compra na Alder Manufacturing. Reutilizar PurchaseOrder permite que o app customizado apareça nas mesmas listas de links que os apps standard e receba navegação a partir deles. Adicione uma ação distinta em vez de um novo semantic object.
• Crie um semantic object customizado quando a entidade não tem equivalente na SAP, como uma solicitação de ferramental customizada que só existe na extensão da Alder Manufacturing. Siga as convenções de nomenclatura acordadas para o landscape.
• Não crie um por app. Um semantic object com o nome de um app, e não de uma entidade, fragmenta a navegação e esconde o app customizado dos links standard.

Um semantic object customizado se justifica por uma nova entidade de negócio, não por um novo aplicativo.

1. Diferenças de grafia e de maiúsculas/minúsculas. A SAP descreve os target mappings como sensíveis a maiúsculas e minúsculas, de modo que um tile que envia PurchaseOrder pode não ser resolvido contra um target mapping definido para Purchaseorder. Copie os semantic objects da definição em vez de digitá-los.
2. Esperar que um semantic object conceda acesso. Um semantic object não carrega nenhuma autorização. O acesso vem dos catálogos nas roles do usuário, que contêm os target mappings desse semantic object.
3. Supor que um link significa um app. Os smart links só aparecem para destinos que o usuário pode alcançar. Um link que aparece para um key user pode não aparecer para um usuário operacional, por design.
4. Sobrepor semantic objects entregues pela SAP sem cuidado. Uma entrada customizada com a mesma chave altera os atributos para todos os apps que usam o objeto.

Quando a navegação de um semantic object se comporta de forma inesperada, execute a /UI2/FLIA para o usuário e o intent afetados antes de alterar qualquer definição. A maioria dos problemas com semantic objects são problemas de nomenclatura ou de roles, e não de definição.