Vymazanie cache (Excel a Power BI)
Operačný protokol na riešenie konfliktov metadát a cacheovaných schém po nasadení nových API v Business Central.
V našej operácii kontinuálnej integrácie (CI/CD) je obvyklé, že my upravujeme API v jazyku AL, aby sme pridali nové stĺpce alebo premenovali existujúce (napr. z numDocumento na Num_Documento).
Aj keď nasadenie v Business Central je úspešné, klientské nástroje spoločnosti Microsoft (Excel a Power BI Desktop) používajú extrémne agresívny systém cache metadát na úsporu šírky pásma. To spôsobuje, že sa snažia čítať API na základe starej „fotografie“ schémy, čo vedie k úplnému zlyhaniu ingestie dát.
1. Klasická chyba: „Property does not exist“
Sección titulada «1. El Error Clásico: “Property does not exist”»Neodmysliteľným príznakom tohto konfliktu je nasledujúca 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."Diagnostika DevSecOps: Pôvodná databáza sa zmenila, ale lokálny klient (Excel/Power BI) odmieta stiahnuť nový dokument $metadata OData. Naďalej požaduje starý stĺpec a server žiadosť odmieta.
2. Protokol čistenia v aplikácii Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Keď spotrebúvame naše analytické rozhrania API priamo z Excelu (cez Power Query), musíme vyčistiť dve rôzne cache, aby sme vynútili aktualizáciu schémy:
Krok A: Čistenie povolení
Sección titulada «Paso A: Limpieza de Permisos»- Na páse kariet prejdeme na záložku Dáta.
- Klikneme na Získať dáta -> Nastavenia zdroja dát (Data Source Settings).
- Vyhľadáme cestu k nášmu rozhraniu API Business Central v zozname globálnych zdrojov alebo aktuálneho zošita.
- Klikneme na Vymazať povolenia (Clear Permissions).
Krok B: Čistenie cache údajov
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Otvoríme editor Power Query (dvojitým kliknutím na našu dotaz v pravom paneli).
- Prejdeme na Súbor -> Možnosti a nastavenia -> Možnosti dopytu.
- V ľavom paneli, pod sekciou „GLOBÁLNE“, vyberieme Načítanie dát.
- Klikneme na tlačidlo Vymazať cache (Clear Cache).
- Nakoniec, v samotnom editore Power Query, klikneme na tlačidlo Obnoviť náhľad. Systém sa znovu overí a správne prečíta nové stĺpce.
3. Protokol čistenia v Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Chovanie v Power BI je identické s Excelom, ale možnosti sú umiestnené trochu inak.
Kompletné vyčistenie lokálneho modelu
Sección titulada «Purga Completa del Modelo Local»- Prejdeme na Súbor -> Možnosti a nastavenia -> Možnosti.
- V ľavom menu, pod nadpisom „GLOBÁLNE“, vyberieme Načítanie dát (Data Load).
- V časti „Možnosti cache dát“ klikneme na Vymazať cache.
- (Voliteľné) Ak používame Q&A, klikneme aj na „Vymazať vyrovnávaciu pamäť Q&A“.
- Zavrieme okno možností.
- V hlavnom zobrazení (alebo v Power Query) klikneme na Obnoviť. Keďže nenájdeme lokálny cache, Power BI vykoná čistú HTTP požiadavku na stiahnutie nového JSON schémy z našej API, čím okamžite vyrieši chybu.
4. Kontrolný zoznam údržby cache
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ Odstraňovanie chýb povolení: Vymazanie poškodených globálnych poverení po reorganizácii alebo zmene UPN Entra ID.
- ✓ Aktualizácia schémy: Vyčistenie lokálneho cache dát v Power Query na opätovné načítanie dokumentu
$metadataz ERP. - ✓ Finálna validácia: Overenie importovaných stĺpcov v zobrazení Power Query, aby sa zabezpečilo, že zodpovedajú aktuálnej definícii AL.

