Limpieza de la caché de metadatos de Gateway

SAP Gateway almacena en caché los metadatos de cada servicio OData para no reconstruir el modelo en cada solicitud:

• En el hub, almacena el modelo de metadatos, el modelo de anotaciones y los textos de las anotaciones.
• En el back-end, almacena el modelo de metadatos y el modelo de anotaciones.
• En una implementación embedded, hub y back-end son un único sistema, y el almacenamiento en caché se produce una sola vez.

Para los servicios construidos con el modelo OData Channel, una clase model provider modificada desencadena una actualización automática: en cada solicitud del documento de servicio o del documento $metadata, la caché compara timestamps y recarga los metadatos obsoletos. Por eso, la caché de metadatos de SAP Gateway se actualiza sola en el caso habitual y solo necesita una limpieza manual cuando esa comprobación no puede detectar el cambio.

Borre la caché cuando:

• un cambio en el ABAP Dictionary, como un nuevo tipo de campo en una estructura, altera el modelo sin modificar la clase model provider, porque ningún mecanismo lo detecta;
• se importó una clase model provider modificada en un sistema productivo, donde SAP recomienda una limpieza tras cada importación de ese tipo;
• se importaron support packages, algo que SAP incluye entre las correcciones de caché del launchpad;
• una app SAP Fiori muestra propiedades, etiquetas o anotaciones antiguas aunque el servicio en el back-end es correcto.

En los sistemas de desarrollo, la caché del hub está desactivada de forma predeterminada, por lo que allí los metadatos obsoletos suelen proceder del navegador o de la caché del back-end. La limpieza de la caché de metadatos de Gateway es una corrección puntual para los cambios de modelo que la comprobación automática no detecta.

Alder Manufacturing transporta un campo nuevo a su servicio de proveedores, y la app sigue sin mostrarlo:

1. En el sistema hub, ejecute /IWFND/CACHE_CLEANUP. Seleccione Cleanup Cache for all Models, o limítela al modelo afectado, y ejecute.
2. En el sistema back-end, ejecute /IWBEP/CACHE_CLEANUP de la misma forma. En una implementación embedded, ambas se ejecutan en el mismo sistema.
3. Como alternativa, abra /IWFND/GW_CLIENT, llame al servicio y use el menú Metadata para limpiar el hub, el back-end o ambos, o para reconstruir la caché del servicio actual.
4. Solicite $metadata en SAP Gateway Client y confirme que el campo nuevo aparece.
5. Recargue la app; si el navegador sigue mostrando el modelo antiguo, borre la caché del navegador.

Ambas limpiezas también están disponibles como actividades IMG en SPRO. Verificar $metadata antes de probar la app distingue un problema de la caché de metadatos de Gateway de un problema de la caché del navegador.

El SAP Fiori launchpad también almacena en caché los metadatos y las anotaciones OData en el navegador web, protegidos por tokens de cache buster. El front-end server recopila estos tokens de los hubs de SAP Gateway mediante el report /UI5/UPD_ODATA_METADATA_CACHE, que SAP recomienda programar periódicamente en producción, pero no en los sistemas de desarrollo. Cuando los tokens cambian, los navegadores cargan los nuevos metadatos.

Si ese report no se ha ejecutado desde un cambio, los usuarios pueden seguir viendo metadatos antiguos después de una limpieza de Gateway. /UI2/INVALIDATE_GLOBAL_CACHES borra las cachés del launchpad, no los metadatos OData, por lo que no sustituye este paso. La limpieza de la caché de metadatos de Gateway y la actualización de los tokens en el navegador, en conjunto, hacen visible un cambio de modelo de extremo a extremo.