Ir al contenido

Cache-opschoning (Excel & Power BI)

Operationeel protocol voor het oplossen van metadata- en gecachte schema-conflicten na de implementatie van nieuwe API's in Business Central.

0lecturas

In onze CI/CD-workflow is het gebruikelijk dat we de API's in de taal AL wijzigen om nieuwe kolommen toe te voegen of bestaande te hernoemen (bijv. van numDocumento naar Num_Documento).

Hoewel de implementatie in Business Central succesvol is, gebruiken Microsoft-clienttools (Excel en Power BI Desktop) een systeem met een extreem agressieve metadata-cache om bandbreedte te besparen. Dit zorgt ervoor dat ze proberen de API te lezen op basis van een oude "foto" van het schema, wat leidt tot een volledige uitval van de gegevensinname.

1. De Klassieke Fout: “Property does not exist”

Sección titulada «1. El Error Clásico: “Property does not exist”»

Het onmiskenbare symptoom van dit conflict is de volgende fout in 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-diagnose: De bron-database is gewijzigd, maar de lokale client (Excel/Power BI) weigert het nieuwe OData-document $metadata te downloaden. Het blijft de oude kolom opvragen en de server wijst het verzoek af.

Wanneer we onze analytische API's rechtstreeks vanuit Excel (via Power Query) consumeren, moeten we twee verschillende caches zuiveren om de schema-update af te dwingen:

  1. Ga in het lint naar het tabblad Gegevens.
  2. Klik op Gegevens ophalen -> Gegevensbroninstellingen (Data Source Settings).
  3. We zoeken het pad van onze Business Central API in de lijst met globale bronnen of die van de huidige werkmap.
  4. Klik op Machtigingen wissen (Clear Permissions).
  1. We openen de Power Query-editor (door te dubbelklikken op onze query in het rechterdeelvenster).
  2. Ga naar Bestand -> Opties en instellingen -> Query-opties.
  3. Selecteer in het linkerpaneel, onder de sectie “GLOBAL”, Gegevens laden.
  4. Klik op de knop Cache wissen (Clear Cache).
  5. Klik tot slot in de Power Query-editor zelf op de knop Preview vernieuwen. Het systeem zal opnieuw authenticeren en de nieuwe kolommen correct inlezen.

Het gedrag in Power BI is identiek aan dat van Excel, maar de opties zijn net iets anders verdeeld.

Volledige Zuivering van het Lokale Model

Sección titulada «Purga Completa del Modelo Local»
  1. Ga naar Bestand -> Opties en instellingen -> Opties.
  2. Selecteer in het linkermenu, onder het kopje “GLOBAL”, Gegevens laden (Data Load).
  3. Klik in de sectie “Gegevenscache-opties” op Cache wissen.
  4. (Optional) If we use Q&A, we also click on 'Clear Q&A cache'.
  5. We sluiten het optievenster.
  6. Klik in het hoofdscherm (of in Power Query) op Vernieuwen. Omdat er geen lokale cache wordt gevonden, voert Power BI een schone HTTP-aanroep uit om het nieuwe JSON-schema van onze API te downloaden, waardoor de fout onmiddellijk wordt opgelost.
  • ✓ Rechten opschonen: Verwijderen van corrupte globale inloggegevens na reorganisaties of wijzigingen in Entra ID UPN's.
  • ✓ Schema-update: Leegmaken van de lokale datacache in Power Query om het $metadata ERP-document opnieuw te laden.
  • ✓ Eindvalidatie: Controle van geïmporteerde kolommen in de Power Query-weergave om te garanderen dat ze overeenkomen met de huidige AL-definitie.