Czyszczenie pamięci podręcznej (Excel i Power BI)
Protocolo operativo para resolver conflictos de metadatos y esquemas cacheados tras el despliegue de nuevas APIs en Business Central.
W naszej operacji ciągłej integracji (CI/CD) często modyfikujemy API w języku AL, aby dodać nowe kolumny lub przemianować istniejące (np. z numDocumento na Num_Documento).
Chociaż wdrożenie w Business Central jest udane, narzędzia klienckie Microsoft (Excel i Power BI Desktop) używają systemu agresywnej pamięci podręcznej metadanych w celu zaoszczędzenia pasma. Powoduje to, że próbują odczytać API na podstawie „starej fotografii” schematu, co skutkuje całkowitym awarią pobierania danych.
1. El Error Clásico: “Property does not exist”
Sección titulada «1. El Error Clásico: “Property does not exist”»Niepowtarzalny objaw tego konfliktu to następujący błąd w 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."Diagnoza DevSecOps: Baza danych źródłowa uległa zmianie, ale klient lokalny (Excel/Power BI) odmawia pobrania nowego dokumentu $metadata z OData. Nadal żąda starej kolumny, a serwer odrzuca żądanie.
2. Protocolo de Limpieza en Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Kiedy konsumujemy nasze API analityczne bezpośrednio z Excela (przez Power Query), musimy wyczyścić dwie różne pamięci podręczne, aby wymusić aktualizację schematu:
Paso A: Limpieza de Permisos
Sección titulada «Paso A: Limpieza de Permisos»- Na wstążce opcji przechodzimy do zakładki Dane.
- Klikamy Pobierz dane -> Ustawienia źródła danych (Data Source Settings).
- Szukamy ścieżki naszej API Business Central na liście źródeł globalnych lub w bieżącej księdze.
- Klikamy Wyczyść uprawnienia (Clear Permissions).
Paso B: Limpieza de la Caché de Datos
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Abrimos el editor de Power Query (haciendo doble clic en nuestra consulta en el panel derecho).
- Przechodzimy do Pliku -> Opcje i konfiguracja -> Opcje zapytania.
- W lewym panelu, w sekcji „GLOBAL”, wybieramy Ładowanie danych.
- Klikamy przycisk Wyczyść pamięć podręczną (Clear Cache).
- Na końcu, w samym edytorze Power Query, klikamy przycisk Odśwież podgląd. System ponownie uwierzytelnia się i poprawnie odczyta nowe kolumny.
3. Protocolo de Limpieza en Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Zachowanie w Power BI jest identyczne jak w Excelu, ale opcje są rozmieszczone nieco inaczej.
Purga Completa del Modelo Local
Sección titulada «Purga Completa del Modelo Local»- Idziemy do Pliku -> Opcji i konfiguracji -> Opcji.
- W lewym menu bocznym, pod nagłówkiem „GLOBAL”, wybieramy Ładowanie danych (Data Load).
- W sekcji „Opcje pamięci podręcznej danych” klikamy Wyczyść pamięć podręczną.
- (Opcional) Si usamos Q&A, también hacemos clic en “Borrar caché de Q&A”.
- Zamykamy okno opcji.
- W głównym widoku (lub w Power Query) klikamy Odśwież. Ponieważ nie ma lokalnej pamięci podręcznej, Power BI wykona czyste połączenie HTTP, aby pobrać nowy schemat JSON z naszego API, rozwiązując błąd natychmiast.
4. Lista kontrolna konserwacji pamięci podręcznej
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ Czyszczenie uprawnień: Usuwanie uszkodzonych poświadczeń globalnych po reorganizacji lub zmianie UPN Entra ID.
- ✓ Actualizacja schematu: Czyszczenie lokalnej pamięci podręcznej danych w Power Query, aby ponownie załadować dokument
$metadataz ERP. - ✓ Ostateczna weryfikacja: Sprawdzenie zaimportowanych kolumn w widoku Power Query, aby upewnić się, że odpowiadają one bieżącej definicji AL.

