Čištění cache (Excel & Power BI)
Operační protokol pro řešení konfliktů metadat a mezkasých schémat po nasazení nových API v Business Central.
V rámci naší kontinuální integrace (CI/CD) je běžné, že upravujeme API v jazyce AL pro přidání nových sloupců nebo přejmenování stávajících (např. změna z numDocumento na Num_Documento).
I když je nasazení v Business Central úspěšné, klientské nástroje Microsoftu (Excel a Power BI Desktop) používají systém extrémně agresivní mezkasé (cache) metadat k šetření šířky pásma. To způsobuje, že se pokoušejí číst API na základě staré „fotky“ schématu, což vede k úplnému výpadku ingestování dat.
1. Klasická chyba: „Property does not exist“
Sección titulada «1. El Error Clásico: “Property does not exist”»Jednoznačným příznakem tohoto konfliktu je následující chyba v Power Query:
Detalles: "OData: The property 'numDocumento' does not exist on type 'Microsoft.NAV.comercialAlbaranCompra'. Make sure to only use property names that are defined by the type or mark the type as open type."DevSecOps diagnostika: Zdrojová databáze se změnila, ale lokální klient (Excel/Power BI) odmítá stáhnout nový dokument $metadata přes OData. Dále vyžaduje starý sloupec a server požadavek odmítá.
2. Protokol čištění v Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Když konzumujeme naše analytická API přímo z Excelu (přes Power Query), musíme vyčistit dvě různé mezipaměti, abychom vynutili aktualizaci schématu:
Krok A: Vyčištění oprávnění
Sección titulada «Paso A: Limpieza de Permisos»- Na pásu karet přejdeme na kartu Data.
- Klikneme na Získat data -> Nastavení zdroje dat (Data Source Settings).
- Vyhledáme cestu k našemu API Business Central v seznamu globálních zdrojů nebo zdrojů aktuálního sešitu.
- Klikneme na Vymazat oprávnění (Clear Permissions).
Krok B: Vyčištění mezipaměti dat
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Otevřeme editor Power Query (dvojitým kliknutím na náš dotaz v pravém panelu).
- Přejděte na Soubor -> Možnosti a nastavení -> Možnosti dotazu.
- V levém panelu v sekci „GLOBAL“ vyberte Načítání dat.
- Klikněte na tlačítko Vymazat mezipaměť (Clear Cache).
- Nakonec v samotném editoru Power Query klikněte na tlačítko Aktualizovat náhled. Systém se znovu autentizuje a nové sloupce správně načte.
3. Protokol čištění v Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Chování v Power BI je totožné s Excelem, ale možnosti jsou rozmístěny mírně odlišně.
Kompletní vyčištění lokálního modelu
Sección titulada «Purga Completa del Modelo Local»- Přejděte na Soubor -> Možnosti a nastavení -> Možnosti.
- V levém postranním menu v sekci „GLOBAL“ vyberte Načítání dat (Data Load).
- V sekci „Možnosti cache dat“ klikneme na Vymazat cache.
- (Volitelně) Pokud používáme Q&A, také klikneme na „Vymazat cache Q&A“.
- Zavřeme okno možností.
- V hlavním zobrazení (nebo v Power Query) klikneme na Aktualizovat. Protože nenajde lokální cache, Power BI provede čistý HTTP požadavek pro stažení nového JSON schématu naší API, čímž okamžitě vyřeší chybu.
4. Kontrolní seznam údržby mezipaměti
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ Ladění oprávnění: Odstranění poškozených globálních přihlašovacích údajů po reorganizacích nebo změnách UPN v Entra ID.
- ✓ Aktualizace schématu: Vyčištění lokální cache dat v Power Query pro opětovné načtení dokumentu
$metadatasystému ERP. - ✓ Finální validace: Ověření importovaných sloupců v zobrazení Power Query pro zajištění shody s aktuální definicí AL.

