Limpeza do cache de metadados do Gateway

O SAP Gateway armazena em cache os metadados de cada serviço OData para não reconstruir o modelo a cada requisição:

• No hub, ele armazena o modelo de metadados, o modelo de anotações e os textos das anotações.
• No back-end, ele armazena o modelo de metadados e o modelo de anotações.
• Em uma implantação embedded, hub e back-end são um único sistema, e o cache acontece uma só vez.

Para serviços construídos com o modelo OData Channel, uma model provider class alterada dispara uma atualização automática: a cada requisição do service document ou do documento $metadata, o cache compara timestamps e recarrega os metadados desatualizados. Por isso, o cache de metadados do SAP Gateway se atualiza sozinho no caso comum e só precisa de limpeza manual quando essa verificação não consegue enxergar a alteração.

Limpe o cache quando:

• uma alteração no ABAP Dictionary, como um novo tipo de campo em uma estrutura, altera o modelo sem alterar a model provider class, porque nenhum mecanismo a detecta;
• uma model provider class alterada foi importada em um sistema de produção, onde a SAP recomenda uma limpeza após cada importação desse tipo;
• support packages foram importados, o que a SAP lista entre as correções de cache do launchpad;
• um app SAP Fiori mostra propriedades, rótulos ou anotações antigos, embora o serviço no back-end esteja correto.

Em sistemas de desenvolvimento, o cache do hub vem desativado por padrão, então metadados desatualizados ali normalmente vêm do navegador ou do cache do back-end. A limpeza do cache de metadados do Gateway é uma correção pontual para alterações de modelo que a verificação automática não detecta.

A Alder Manufacturing transporta um novo campo para o seu serviço de fornecedores, e o app ainda não o mostra:

1. No sistema hub, execute a /IWFND/CACHE_CLEANUP. Selecione Cleanup Cache for all Models, ou restrinja ao modelo afetado, e execute.
2. No sistema back-end, execute a /IWBEP/CACHE_CLEANUP da mesma forma. Em uma implantação embedded, as duas são executadas no mesmo sistema.
3. Como alternativa, abra a /IWFND/GW_CLIENT, chame o serviço e use o menu Metadata para limpar o hub, o back-end ou ambos, ou para reconstruir o cache do serviço atual.
4. Solicite o $metadata no SAP Gateway Client e confirme que o novo campo está lá.
5. Recarregue o app; se o navegador ainda mostrar o modelo antigo, limpe o cache do navegador.

As duas limpezas também estão disponíveis como atividades IMG na SPRO. Verificar o $metadata antes de testar o app separa um problema de cache de metadados do Gateway de um problema de cache do navegador.

O SAP Fiori launchpad também armazena metadados e anotações OData em cache no navegador, protegidos por tokens de cache buster. O front-end server coleta esses tokens dos hubs do SAP Gateway pelo report /UI5/UPD_ODATA_METADATA_CACHE, que a SAP recomenda agendar periodicamente em produção, mas não em sistemas de desenvolvimento. Quando os tokens mudam, os navegadores carregam os novos metadados.

Se esse report não foi executado desde uma alteração, os usuários ainda podem ver metadados antigos após uma limpeza no Gateway. O /UI2/INVALIDATE_GLOBAL_CACHES limpa os caches do launchpad, não os metadados OData, portanto não substitui esse passo. A limpeza do cache de metadados do Gateway e a atualização de tokens no lado do navegador, juntas, tornam uma alteração de modelo visível de ponta a ponta.