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.
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.
2. Opschoonprotocol in Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»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:
Stap A: Rechten Opschonen
Sección titulada «Paso A: Limpieza de Permisos»- Ga in het lint naar het tabblad Gegevens.
- Klik op Gegevens ophalen -> Gegevensbroninstellingen (Data Source Settings).
- We zoeken het pad van onze Business Central API in de lijst met globale bronnen of die van de huidige werkmap.
- Klik op Machtigingen wissen (Clear Permissions).
Stap B: Gegevenscache Opschonen
Sección titulada «Paso B: Limpieza de la Caché de Datos»- We openen de Power Query-editor (door te dubbelklikken op onze query in het rechterdeelvenster).
- Ga naar Bestand -> Opties en instellingen -> Query-opties.
- Selecteer in het linkerpaneel, onder de sectie “GLOBAL”, Gegevens laden.
- Klik op de knop Cache wissen (Clear Cache).
- 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.
3. Opschoonprotocol in Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»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»- Ga naar Bestand -> Opties en instellingen -> Opties.
- Selecteer in het linkermenu, onder het kopje “GLOBAL”, Gegevens laden (Data Load).
- Klik in de sectie “Gegevenscache-opties” op Cache wissen.
- (Optional) If we use Q&A, we also click on 'Clear Q&A cache'.
- We sluiten het optievenster.
- 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.
4. Checklist voor Cache-onderhoud
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ 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
$metadataERP-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.

