Administración y resolución de problemas

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 ▾
Dónde se ubica: L2 · Contenido, navegación y accesoCapa: Contenido, navegación y acceso.L1L2L3L4L5L6BTP

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:

  1. 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.
  2. Ejecute /UI2/INVALIDATE_GLOBAL_CACHES en SE38, o la transacción /UI2/INVAL_CACHES, para invalidar todas las cachés UI2.
  3. 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.
  4. Ejecute /UI2/DELETE_CACHE_AFTER_IMP después de la importación si la guía de upgrade de su release lo indica.
  5. Limpie la caché de metadatos de SAP Gateway si cambiaron servicios OData.
  6. 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 servidorCaché del cliente (navegador)Caché de metadatos de SAP Gateway
ContieneDatos de los servicios del launchpad en el front-end serverRecursos SAPUI5, target mappings, metadatos ODataModelos 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 conCambios en roles, catálogos, LPD_CUST, appsTokens de cache busterIntercambio de timestamps del modelo
Motivo típico para borrarlaContenido transportado no visibleVersión antigua de la app tras un despliegueModelo 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

Se aplica a
SAP S/4HANA on-premise · SAP S/4HANA Cloud Private Edition
Última revisión

SAP, SAP Fiori, SAPUI5, SAP S/4HANA, SAP BTP y los demás productos y servicios de SAP mencionados son marcas comerciales o marcas registradas de SAP SE (o de una empresa afiliada de SAP) en Alemania y otros países. Esta guía es independiente y no está afiliada, patrocinada ni respaldada por SAP SE.