Target Mapping

Cada navegación en el SAP Fiori Launchpad es una solicitud de un intent, no de una app concreta. La resolución se realiza en cinco pasos:

1. Un tile, un enlace u otra app dispara un intent: un semantic object más una acción, opcionalmente con parámetros como un número de documento.
2. El launchpad reúne todos los target mappings disponibles para el usuario a través de los catálogos de sus roles.
3. El launchpad filtra esos target mappings por semantic object, acción, tipo de dispositivo y reglas de parámetros.
4. El target mapping coincidente proporciona el destino: el tipo de aplicación, el componente de la app o la transacción, y el alias de sistema.
5. El launchpad inicia ese destino y le pasa los parámetros.

Si ningún target mapping supera el paso 3, el usuario recibe un error de navegación en lugar de una app. Por tanto, un target mapping es una regla de enrutamiento que se evalúa en tiempo de ejecución, no un elemento de UI.

Un mismo intent puede tener destinos distintos según el tipo de dispositivo o el rol; así es como un tile puede abrir una app completa en el escritorio y una simplificada en un teléfono. Cada campo de un target mapping acota o redirige el lugar al que llega un intent.

Un tile es el punto de entrada visual que almacena un intent; un target mapping es la regla que resuelve ese intent. Son dos objetos separados, a menudo definidos juntos pero a veces en technical catalogs distintos. Para que un clic abra una app, el usuario necesita acceso a ambos: al tile, mediante los catálogos que lo colocan, y al target mapping, mediante los catálogos de sus roles. Un target mapping puede servir a muchos tiles y enlaces dentro de las apps, y un tile puede resolverse de forma distinta según el dispositivo. Los tiles deciden lo que ven los usuarios; los target mappings deciden lo que realmente se abre.

Cree o modifique un target mapping cuando:

• una app SAPUI5 personalizada deba poder iniciarse desde el SAP Fiori Launchpad;
• una transacción de SAP GUI o una aplicación Web Dynpro ABAP sin app SAP Fiori nativa necesite un tile;
• un rol deba abrir una app distinta para el mismo intent, por ejemplo una app personalizada en lugar de la estándar; en ese caso, evite dejar varios target mappings coincidentes en los roles del mismo usuario y haga pruebas con /UI2/FLIA.

Evite dos atajos habituales:

• copiar target mappings entregados por SAP en catálogos personalizados cuando referenciarlos mantendría el flujo de actualizaciones de SAP, ya que los cambios en el original se propagan a sus referencias;
• usar acciones comodín o reglas de parámetros abiertas que hacen impredecible la resolución.

Un cambio en un target mapping es una decisión de diseño de la navegación y merece la misma revisión que un cambio de rol.

Un tile visible demuestra que el usuario puede ver el tile, no que el intent se resuelva. Las causas habituales, en el orden de frecuencia que indican los profesionales:

1. El catálogo del tile está asignado, pero el catálogo del target mapping falta en los roles del usuario.
2. El target mapping no está habilitado para el tipo de dispositivo del usuario, por lo que la app funciona en el escritorio y falla en un teléfono.
3. Las reglas de parámetros rechazan los parámetros que envía el tile o el enlace.
4. El alias de sistema apunta al back-end equivocado.
5. Las cachés del launchpad siguen conservando el contenido antiguo tras un cambio. En el front-end server ABAP, ejecute el report /UI2/INVALIDATE_GLOBAL_CACHES en SE38 o la transacción /UI2/INVAL_CACHES; SAP reserva /UI2/INVALIDATE_CLIENT_CACHES para casos excepcionales.

Ejecute /UI2/FLIA para el usuario afectado antes de editar ningún contenido, porque el análisis de intents muestra qué target mappings ha tenido realmente en cuenta el launchpad. Los fallos de navegación casi siempre son problemas de asignación de roles o de coincidencia de reglas, no apps dañadas.

• Apps en SAP BTP: una app declara sus destinos de navegación como inbounds en su app descriptor (manifest.json, en sap.app → crossNavigation → inbounds). SAP Build Work Zone usa esos inbounds como target mappings del site.
• Contenido de SAP S/4HANA: el back-end expone determinados roles mediante content exposure, y SAP Build Work Zone los consume con el sistema SAP S/4HANA configurado como proveedor de contenido.

El concepto es idéntico en todas las opciones de implementación: entra un intent, sale una aplicación. Solo cambia el lugar donde se mantiene la regla.