Semantic Object

Un semantic object es el sustantivo de la navegación de SAP Fiori; la acción es el verbo. Juntos forman un intent, que se escribe en la URL del launchpad como #SemanticObject-action, seguido opcionalmente de parámetros.

1. Un tile, un enlace o una app solicita un intent, por ejemplo #PurchaseOrder-display?PurchaseOrder=4500000123.
2. El launchpad busca target mappings con el mismo semantic object y la misma acción entre los catálogos de los roles del usuario.
3. El target mapping coincidente decide qué app se abre.

Un semantic object suele tener muchas acciones. En la SAP Fiori Apps Reference Library, PurchaseOrder-display se resuelve en la transacción clásica ME23N mediante SAP GUI for HTML, PurchaseOrder-manage en la app Manage Purchase Orders y PurchaseOrder-displayFactSheet en un fact sheet de pedido de compra. La app que realiza la llamada solo indica el objeto de negocio y la operación prevista. Por tanto, un semantic object es un nombre estable para una entidad de negocio, independiente de la tecnología de UI que acabe gestionándola.

• Launchpad basado en ABAP (on-premise, Private Edition): SAP entrega semantic objects con los componentes de UI; la transacción /UI2/SEMOBJ_SAP los muestra. Los semantic objects personalizados se crean con /UI2/SEMOBJ o con la actividad de Customizing para semantic objects personalizados en SPRO (UI Technologies, SAP Fiori, contenido del launchpad). Una entrada personalizada con la misma clave que una entregada por SAP sobrescribe sus atributos.
• SAP BTP y SAP Build Work Zone: cada app declara los semantic objects y acciones que acepta como inbounds en su app descriptor (sap.app → crossNavigation → inbounds), donde el semantic object y la acción son obligatorios. Los semantic objects proceden de estos descriptores y no de una transacción de mantenimiento ABAP.
• SAP S/4HANA Cloud Public Edition: los semantic objects entregados por SAP se usan tal como se suministran. Para una app personalizada, el desarrollador define el tile, incluido su intent, como parte de la aplicación antes de desplegarla.

El semantic object se define una vez por landscape y después se referencia en todos los lugares donde la navegación lo necesita.

Los semantic objects impulsan algo más que los tiles. En SAP Fiori elements, un campo anotado con un semantic object (Common.SemanticObject en OData o CAP, @Consumption.semanticObject en ABAP CDS) se muestra como enlace cuando el semantic object es válido en el launchpad. Al hacer clic en él se listan todas las acciones a las que el usuario puede acceder para ese objeto; cuando solo existe un destino, la app navega directamente.

Las apps SAPUI5 freestyle usan el servicio de navegación del shell (sap.ushell.services.Navigation) para consultar qué enlaces existen para un semantic object y para navegar. En ambos casos, la lista de enlaces se calcula por usuario a partir de los target mappings de los roles de ese usuario, de modo que dos usuarios que hacen clic en el mismo campo de proveedor pueden ver opciones distintas.

Un semantic object en un campo es una solicitud de opciones de navegación, y los roles del usuario deciden qué opciones aparecen.

Aplique este criterio de decisión: ¿la entidad ya existe como objeto de negocio de SAP?

• Reutilice el semantic object de SAP cuando una app personalizada trabaja sobre la misma entidad, por ejemplo una app personalizada de aprobación de pedidos de compra en Alder Manufacturing. Reutilizar PurchaseOrder permite que la app personalizada aparezca en las mismas listas de enlaces que las apps estándar y reciba navegación desde ellas. Añada una acción distinta en lugar de un nuevo semantic object.
• Cree un semantic object personalizado cuando la entidad no tenga equivalente en SAP, como una solicitud de utillaje personalizada que solo existe en la extensión de Alder Manufacturing. Siga las convenciones de nomenclatura acordadas para el landscape.
• No cree uno por app. Un semantic object con el nombre de una app en lugar de una entidad fragmenta la navegación y oculta la app personalizada de los enlaces estándar.

Un semantic object personalizado se justifica por una nueva entidad de negocio, no por una nueva aplicación.

1. Diferencias de ortografía y de mayúsculas. SAP describe los target mappings como sensibles a mayúsculas y minúsculas, por lo que un tile que envía PurchaseOrder puede no resolverse contra un target mapping definido para Purchaseorder. Copie los semantic objects de la definición en lugar de escribirlos a mano.
2. Esperar que un semantic object conceda acceso. Un semantic object no lleva ninguna autorización. El acceso procede de los catálogos de los roles del usuario, que contienen los target mappings para ese semantic object.
3. Suponer que un enlace implica una app. Los smart links solo aparecen para destinos a los que el usuario puede acceder. Un enlace que aparece para un key user puede no aparecer para un administrativo, por diseño.
4. Sobrescribir a la ligera semantic objects entregados por SAP. Una entrada personalizada con la misma clave cambia los atributos para todas las apps que usan el objeto.

Cuando la navegación de un semantic object se comporta de forma inesperada, ejecute /UI2/FLIA para el usuario y el intent afectados antes de cambiar ninguna definición. La mayoría de los problemas con semantic objects son problemas de nomenclatura o de roles, no de definición.