Navegación basada en intents

En el SAP Fiori Launchpad, la parte de la URL que sigue a # es un intent, no la dirección de una aplicación. Un intent típico tiene este aspecto: #PurchaseOrder-display?PurchaseOrder=4500000123.

1. El usuario hace clic en un tile o en un enlace, o una app desencadena la navegación en el código. Cada uno de ellos indica solo el semantic object, la acción y parámetros opcionales.
2. El launchpad comprueba qué intents puede utilizar el usuario. En el launchpad ABAP, estos proceden de los catálogos de los roles PFCG del usuario.
3. La resolución de destinos del launchpad compara el intent con los target mappings disponibles, incluidas las reglas de tipo de dispositivo y de parámetros.
4. El target mapping ganador aporta la aplicación: un componente SAPUI5, una transacción de SAP GUI for HTML, una aplicación Web Dynpro ABAP o una URL, además del sistema contra el que se ejecuta.
5. El launchpad inicia el destino y le pasa los parámetros.

El lado que llama nunca sabe qué app ha respondido. La navegación basada en intents es un contrato de vinculación tardía entre lo que el usuario quiere hacer y la app que lo hace.

Esta indirección resuelve problemas reales del ciclo de vida:

• Destinos específicos por rol. El mismo intent puede abrir una vista de responsable para un rol y una vista de administrativo para otro, solo mediante configuración.
• Destinos específicos por dispositivo. Un usuario de escritorio y un usuario de teléfono pueden llegar a apps distintas a través del mismo enlace.
• Apps sustituibles. Un intent puede apuntar hoy a una aplicación Web Dynpro ABAP y más adelante a una nueva app SAPUI5, sin modificar las apps que enlazan con él.
• Despliegue independiente. Las apps tienen ciclos de vida distintos; una app de origen no puede dar por hecho que una app de destino está instalada. Los intents permiten que el launchpad decida qué existe para este usuario, en este sistema.
• Extensión sin modificación. Los clientes pueden redirigir un intent estándar a una app personalizada sin tocar el código de SAP.

Estas propiedades explican por qué las apps SAP Fiori se enlazan entre sí mediante intents y no mediante direcciones fijas en el código. La navegación basada en intents cambia un pequeño esfuerzo de configuración por apps que pueden evolucionar de forma independiente.

• SAP Fiori elements: los campos anotados con un semantic object se convierten en smart links, y la navegación de salida se declara mediante anotaciones y el app descriptor. El framework llama al launchpad en nombre del desarrollador.
• App descriptor: sap.app → crossNavigation declara los inbounds (los intents que acepta una app, con reglas de parámetros como el tratamiento de los parámetros adicionales: permitidos, ignorados o no permitidos) y los outbounds (los intents que una app puede desencadenar).
• SAPUI5 freestyle: el servicio de shell sap.ushell.services.Navigation ofrece métodos asíncronos para navegar, construir un enlace, comprobar si un intent está admitido para el usuario y listar los enlaces de un semantic object. El servicio anterior CrossApplicationNavigation está obsoleto desde SAPUI5 1.120.

Los desarrolladores deben comprobar que un intent está admitido antes de mostrar un enlace, porque la compatibilidad varía según el usuario. En el código, la navegación basada en intents es una petición al launchpad, nunca una llamada directa a otra app.

• Necesita un launchpad o un runtime de sitio. Los intents los resuelve el shell. SAP describe que el servicio Navigation funciona dentro del ámbito del launchpad actual, por lo que una app abierta por sí sola, fuera del launchpad o de un sitio de SAP Build Work Zone, no dispone de ningún servicio que los resuelva.
• Los errores aparecen en tiempo de ejecución. Un target mapping que falta o un rol incorrecto se manifiesta cuando un usuario hace clic, no cuando se transporta el contenido, por lo que importa probar por rol.
• Los parámetros viajan en la URL. Las selecciones grandes necesitan un app state en lugar de parámetros de URL, y los valores sensibles no deben incluirse en un intent.
• Los destinos en otros sistemas dependen de la configuración. Un destino en otro sistema depende de un alias de sistema o un destino correctos.
• La navegación no es estado del proceso. Un intent abre una app con contexto; no registra lo que el usuario hace después, si una tarea está completada ni qué viene a continuación.

Estos límites se derivan del diseño: la navegación basada en intents resuelve adónde ir y deja a la app de destino lo que ocurre allí.

En el launchpad ABAP, siga las evidencias en lugar de editar primero el contenido:

1. Lea el intent en la barra de direcciones del navegador o en el mensaje de la consola.
2. Si la consola muestra un ID de log de aplicación, abra el log de aplicación UI2 en SLG1; desde el mensaje puede saltar al análisis de intents.
3. Ejecute /UI2/FLIA con el intent, el tipo de dispositivo y el usuario afectado. Muestra qué roles y catálogos contienen el intent y qué target mapping le corresponde.
4. Si el target mapping es correcto pero la app se carga en el sistema equivocado, compruebe los alias de sistema con /UI2/FSAC.
5. Si no se puede cargar un componente SAPUI5, compruebe el log del índice de aplicaciones SAPUI5 con /UI5/APP_INDEX_CALCULATE.

En SAP BTP, compare el intent del tile con los inbounds del app descriptor desplegado. Un intent que falla suele ser un problema de contenido o de roles, y las herramientas de la navegación basada en intents muestran cuál de los dos antes de cambiar nada.

La sintaxis y la idea son las mismas; solo cambia el origen de los target mappings. Las apps desplegadas en SAP BTP declaran sus inbounds en el app descriptor, y SAP Build Work Zone trata esos inbounds como los destinos del sitio. Las apps de SAP S/4HANA llegan a un sitio de Work Zone mediante la Federation of Remote Content Providers, que expone al sitio el contenido del launchpad del back-end. En todas las opciones de implementación, la navegación basada en intents mantiene el mismo contrato: entra un intent, y el contenido del usuario decide qué app sale.