Invalidación de la caché del launchpad
La invalidación de la caché del launchpad es el conjunto de reports y pasos que borran las cachés del SAP Fiori launchpad, principalmente la caché UI2 del servidor con /UI2/INVALIDATE_GLOBAL_CACHES y los recursos del navegador con /UI2/INVALIDATE_CLIENT_CACHES. Es una corrección puntual para contenido obsoleto tras transportes, upgrades o support packages, no un primer paso rutinario.
Datos clave
- Tipo
- Procedimiento de administración (reports y transacciones ABAP)
- Capa
- Contenido, navegación y acceso
- Caché UI2 del servidor
- Report /UI2/INVALIDATE_GLOBAL_CACHES; transacción /UI2/INVAL_CACHES
- Cachés del cliente
- Programa /UI2/INVALIDATE_CLIENT_CACHES, para todos los usuarios o para uno
- Evita apps obsoletas
- /UI5/APP_INDEX_CALCULATE programado (tokens de cache buster)
- Quién lo ejecuta
- Administradores de Basis y del launchpad
- Se aplica a
- SAP S/4HANA on-premise y Private Edition (front-end server ABAP)
Capa: Contenido, navegación y accesoDónde se ubica ▾
Capa: Contenido, navegación y acceso
Abrir el mapa de arquitectura →¿Qué cachés usa el SAP Fiori launchpad?
Tres cachés pueden contener contenido desactualizado del launchpad:
- Caché UI2 del servidor, en el front-end server, para los servicios propios del launchpad, como la construcción de páginas y la personalización. El sistema la invalida automáticamente cuando cambia la configuración de un tile o de un catálogo, un rol PFCG, el contenido de LPD_CUST o una app SAPUI5.
- Caché del navegador, para recursos SAPUI5, código de las apps, target mappings y metadatos OData. Los tokens de cache buster en las URL de los recursos hacen que el navegador recargue solo lo que cambió en el servidor.
- Caché de metadatos de SAP Gateway, para los modelos de los servicios OData, que se borra por separado con /IWFND/CACHE_CLEANUP y /IWBEP/CACHE_CLEANUP.
Saber cuál de las tres contiene los datos obsoletos determina qué paso de invalidación de la caché del launchpad se necesita.
¿Cuándo conviene borrar las cachés del launchpad?
La posición de SAP es que la invalidación manual de la caché UI2 normalmente no debería ser necesaria, porque los cambios la desencadenan automáticamente. Borrar las cachés está justificado cuando:
- un catálogo o una app transportados no aparecen aunque los roles y el contenido son correctos;
- se ha aplicado un support package, una nota de SAPUI5 o un upgrade de release;
- los usuarios ven el comportamiento antiguo de una app tras un despliegue y no se recalculó el índice de aplicaciones SAPUI5.
No borre las cachés como reflejo ante cada tile que falta. Un catálogo ausente en el rol o un target mapping sin el tipo de dispositivo del usuario producen el mismo síntoma, y /UI2/FLIA los encuentra en minutos. La invalidación de la caché del launchpad corrige datos obsoletos, no contenido incorrecto.
¿Cómo se borran las cachés del launchpad paso a paso?
Después de que Alder Manufacturing importa un support package en su front-end server:
- Ejecute /UI5/APP_INDEX_CALCULATE, o confirme que se ejecutó su job programado, para que los tokens de cache buster reflejen las nuevas versiones de las apps.
- Ejecute /UI2/INVALIDATE_GLOBAL_CACHES en SE38, o la transacción /UI2/INVAL_CACHES, para invalidar todas las cachés UI2.
- Si es necesario, ejecute /UI2/INVALIDATE_CLIENT_CACHES en SE38, para todos los usuarios o para uno. Invalidar las cachés de otros usuarios requiere el rol SAP_UI2_ADMIN_700.
- Ejecute /UI2/DELETE_CACHE_AFTER_IMP después de la importación si la guía de upgrade de su release lo indica.
- Limpie la caché de metadatos de SAP Gateway si cambiaron servicios OData.
- Pida a los usuarios afectados que recarguen la página, o que borren la caché del navegador si los síntomas persisten.
Cada invalidación de cachés del cliente queda registrada en el registro de aplicación (SLG1). Seguir este orden hace que la invalidación de la caché del launchpad sea predecible en lugar de un proceso de prueba y error.
¿Qué hace realmente /UI2/INVALIDATE_CLIENT_CACHES?
/UI2/INVALIDATE_CLIENT_CACHES renueva el token global de cache buster. Desde que SAP introdujo el cache busting específico por aplicación, las apps SAP Fiori del repositorio SAPUI5 obtienen sus propios tokens del índice de aplicaciones SAPUI5, y el navegador recarga una app solo cuando ha cambiado. El token global sigue cubriendo:
- los datos de las solicitudes OData propias del launchpad, como target mappings y personalización;
- los recursos SAPUI5 clásicos que no son componentes, por ejemplo algunas implementaciones de tiles personalizados;
- las apps que faltan en un índice de aplicaciones incompleto.
Por eso SAP describe la ejecución de /UI2/INVALIDATE_CLIENT_CACHES como necesaria solo en casos excepcionales. Con un índice de aplicaciones programado con regularidad, /UI2/INVALIDATE_CLIENT_CACHES rara vez hace falta.
Caché UI2 vs. caché del cliente vs. caché de metadatos de Gateway: ¿cuál es la diferencia?
| Caché UI2 del servidor | Caché del cliente (navegador) | Caché de metadatos de SAP Gateway | |
|---|---|---|---|
| Contiene | Datos de los servicios del launchpad en el front-end server | Recursos SAPUI5, target mappings, metadatos OData | Modelos de servicios OData y de anotaciones |
| Se borra con | /UI2/INVALIDATE_GLOBAL_CACHES o /UI2/INVAL_CACHES | /UI2/INVALIDATE_CLIENT_CACHES; recarga del navegador | /IWFND/CACHE_CLEANUP, /IWBEP/CACHE_CLEANUP |
| Se actualiza automáticamente con | Cambios en roles, catálogos, LPD_CUST, apps | Tokens de cache buster | Intercambio de timestamps del modelo |
| Motivo típico para borrarla | Contenido transportado no visible | Versión antigua de la app tras un despliegue | Modelo de servicio o anotaciones modificados |
Cada caché tiene su propia limpieza; borrar la equivocada deja los datos obsoletos en su sitio.
Preguntas frecuentes
¿/UI2/INVALIDATE_GLOBAL_CACHES es una transacción o un report?
/UI2/INVALIDATE_GLOBAL_CACHES es un report ABAP que se inicia en SE38. SAP también documenta la transacción /UI2/INVAL_CACHES para invalidar todas las cachés UI2. Ejecutar cualquiera de los dos en el front-end server borra las cachés del launchpad del lado del servidor, no la caché del navegador.
¿Borrar la caché cierra la sesión de los usuarios o elimina la personalización?
No se describe ningún cierre de sesión. La invalidación obliga al launchpad a reconstruir los datos en caché desde el servidor, por lo que el siguiente inicio puede ser más lento. Las cachés del cliente contienen datos del launchpad, como target mappings y datos de personalización procedentes de solicitudes OData, por lo que el launchpad vuelve a solicitar esos datos al servidor.
¿Por qué los usuarios siguen viendo el tile antiguo después de borrar las cachés?
Probablemente el contenido en sí es incorrecto, no obsoleto. Verifique que el catálogo está en el rol del usuario, que el target mapping admite el tipo de dispositivo y que una capa de customizing no oculta el nuevo contenido de configuración. /UI2/FLIA muestra qué contenido resuelve realmente el launchpad.
¿Cómo puedo ver por qué se invalidó la caché UI2?
La Cache Statistics Utility, transacción /UI2/CSU, muestra con qué frecuencia se leen datos de la caché y por qué se invalidó. Resulta útil cuando los usuarios informan de inicios lentos del launchpad tras invalidaciones frecuentes.
Fuentes
- SAP Help Portal: Resolving Caching Problems and Invalidating Client Caches
- SAP Help Portal: Server-Side Cache (SAP Fiori launchpad)
- SAP Help Portal: Cache Buster for SAP Fiori Launchpad and SAP Fiori Apps
- SAP Help Portal: New App in Catalog Does Not Appear on the SAP Fiori Launchpad (SAP S/4HANA)
- Se aplica a
- SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition
- Última revisión