Cache-Bereinigung (Excel & Power BI)
Betriebsprotokoll zur Lösung von Metadatenkonflikten und gecachten Schemata nach dem Deployment neuer APIs in Business Central.
In unseren CI/CD-Prozessen (Continuous Integration/Continuous Deployment) ist es üblich, dass wir die APIs in der Sprache AL modifizieren, um neue Spalten hinzuzufügen oder bestehende umzubenennen (z. B. von numDocumento zu Num_Documento).
Auch wenn das Deployment in Business Central erfolgreich ist, nutzen die Microsoft-Client-Tools (Excel und Power BI Desktop) ein extrem aggressives Metadaten-Caching-System, um Bandbreite zu sparen. Dies führt dazu, dass versucht wird, die API basierend auf einem veralteten „Snapshot“ des Schemas zu lesen, was zu einem vollständigen Ausfall der Datenaufnahme führt.
1. Der klassische Fehler: „Property does not exist“
Sección titulada «1. El Error Clásico: “Property does not exist”»Das eindeutige Symptom dieses Konflikts ist der folgende Fehler 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: Die Quelldatenbank wurde geändert, aber der lokale Client (Excel/Power BI) weigert sich, das neue OData-Dokument $metadata herunterzuladen. Er fordert weiterhin die alte Spalte an, und der Server lehnt die Anfrage ab.
2. Bereinigungsprotokoll in Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Wenn wir unsere analytischen APIs direkt aus Excel (über Power Query) konsumieren, müssen wir zwei verschiedene Caches leeren, um die Aktualisierung des Schemas zu erzwingen:
Schritt A: Berechtigungen bereinigen
Sección titulada «Paso A: Limpieza de Permisos»- Gehen Sie im Menüband auf die Registerkarte Daten.
- Klicken Sie auf Daten abrufen -> Datenquelleneinstellungen (Data Source Settings).
- Wir suchen den Pfad unserer Business Central-API in der Liste der globalen Quellen oder der Quellen der aktuellen Arbeitsmappe.
- Wir klicken auf Berechtigungen löschen (Clear Permissions).
Schritt B: Daten-Cache leeren
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Wir öffnen den Power Query-Editor (durch Doppelklick auf unsere Abfrage im rechten Bereich).
- Wir gehen zu Datei -> Optionen und Konfiguration -> Abfrageoptionen.
- Im linken Bereich wählen wir unter dem Abschnitt 'GLOBAL' Datenladen.
- Wir klicken auf die Schaltfläche Caches löschen (Clear Cache).
- Schließlich klicken wir im eigenen Power Query-Editor auf die Schaltfläche Vorschau aktualisieren. Das System wird sich erneut authentifizieren und die neuen Spalten korrekt lesen.
3. Bereinigungsprotokoll in Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Das Verhalten in Power BI ist identisch mit dem in Excel, aber die Optionen sind etwas anders verteilt.
Vollständige Bereinigung des lokalen Modells
Sección titulada «Purga Completa del Modelo Local»- Gehen Sie zu Datei -> Optionen und Einstellungen -> Optionen.
- Im linken Seitenmenü wählen wir unter der Überschrift „GLOBAL“ Daten laden (Data Load) aus.
- Im Abschnitt „Datencache-Optionen“ klicken wir auf Cache leeren.
- (Optional) Wenn wir Q&A verwenden, klicken wir auch auf 'Q&A-Cache löschen'.
- Wir schließen das Optionsfenster.
- In der Hauptansicht (oder in Power Query) klicken wir auf Aktualisieren. Da kein lokaler Cache gefunden wird, führt Power BI einen sauberen HTTP-Aufruf aus, um das neue JSON-Schema unserer API herunterzuladen, wodurch der Fehler sofort behoben wird.
4. Checkliste zur Cache-Wartung
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ Bereinigung der Berechtigungen: Löschen korrupter globaler Anmeldedaten nach Umstrukturierungen oder UPN-Änderungen in Entra ID.
- ✓ Schema-Aktualisierung: Bereinigung des lokalen Daten-Caches in Power Query, um das ERP-Dokument
$metadataneu zu laden. - ✓ Abschlussvalidierung: Überprüfung der importierten Spalten in der Power Query-Ansicht, um sicherzustellen, dass sie mit der aktuellen AL-Definition übereinstimmen.

