Ir al contenido

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.

0odwiedzin

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.

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:

  1. Na wstążce opcji przechodzimy do zakładki Dane.
  2. Klikamy Pobierz dane -> Ustawienia źródła danych (Data Source Settings).
  3. Szukamy ścieżki naszej API Business Central na liście źródeł globalnych lub w bieżącej księdze.
  4. Klikamy Wyczyść uprawnienia (Clear Permissions).
  1. Abrimos el editor de Power Query (haciendo doble clic en nuestra consulta en el panel derecho).
  2. Przechodzimy do Pliku -> Opcje i konfiguracja -> Opcje zapytania.
  3. W lewym panelu, w sekcji „GLOBAL”, wybieramy Ładowanie danych.
  4. Klikamy przycisk Wyczyść pamięć podręczną (Clear Cache).
  5. 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.

  1. Idziemy do Pliku -> Opcji i konfiguracji -> Opcji.
  2. W lewym menu bocznym, pod nagłówkiem „GLOBAL”, wybieramy Ładowanie danych (Data Load).
  3. W sekcji „Opcje pamięci podręcznej danych” klikamy Wyczyść pamięć podręczną.
  4. (Opcional) Si usamos Q&A, también hacemos clic en “Borrar caché de Q&A”.
  5. Zamykamy okno opcji.
  6. 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 $metadata z ERP.
  • ✓ Ostateczna weryfikacja: Sprawdzenie zaimportowanych kolumn w widoku Power Query, aby upewnić się, że odpowiadają one bieżącej definicji AL.