Ir al contenido

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.

0lecturas

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:

  1. Na páse kariet prejdeme na záložku Dáta.
  2. Klikneme na Získať dáta -> Nastavenia zdroja dát (Data Source Settings).
  3. Vyhľadáme cestu k nášmu rozhraniu API Business Central v zozname globálnych zdrojov alebo aktuálneho zošita.
  4. Klikneme na Vymazať povolenia (Clear Permissions).
  1. Otvoríme editor Power Query (dvojitým kliknutím na našu dotaz v pravom paneli).
  2. Prejdeme na Súbor -> Možnosti a nastavenia -> Možnosti dopytu.
  3. V ľavom paneli, pod sekciou „GLOBÁLNE“, vyberieme Načítanie dát.
  4. Klikneme na tlačidlo Vymazať cache (Clear Cache).
  5. 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.

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»
  1. Prejdeme na Súbor -> Možnosti a nastavenia -> Možnosti.
  2. V ľavom menu, pod nadpisom „GLOBÁLNE“, vyberieme Načítanie dát (Data Load).
  3. V časti „Možnosti cache dát“ klikneme na Vymazať cache.
  4. (Voliteľné) Ak používame Q&A, klikneme aj na „Vymazať vyrovnávaciu pamäť Q&A“.
  5. Zavrieme okno možností.
  6. 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.
  • ✓ 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 $metadata z 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.