Ir al contenido

Nettoyage du cache (Excel & Power BI)

Protocole opérationnel pour résoudre les conflits de métadonnées et de schémas mis en cache après le déploiement de nouvelles API dans Business Central.

0vues

Dans notre processus d'intégration continue (CI/CD), il est courant de modifier les API en langage AL pour ajouter de nouvelles colonnes ou renommer les existantes (ex. passer de numDocumento à Num_Documento).

Bien que le déploiement dans Business Central soit réussi, les outils clients de Microsoft (Excel et Power BI Desktop) utilisent un système de cache de métadonnées extrêmement agressif pour économiser de la bande passante. Cela conduit à des tentatives de lecture de l'API basées sur une ancienne « photo » du schéma, entraînant des échecs complets de l'ingestion de données.

1. L'erreur classique : « Property does not exist »

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

Le symptôme indéniable de ce conflit est l'erreur suivante dans 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."

Diagnostic DevSecOps : La base de données source a changé, mais le client local (Excel/Power BI) refuse de télécharger le nouveau document $metadata d'OData. Il continue de demander l'ancienne colonne et le serveur rejette la requête.

2. Protocole de nettoyage dans Microsoft Excel

Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»

Lorsque nous consommons nos API analytiques directement depuis Excel (via Power Query), nous devons purger deux caches différents pour forcer la mise à jour du schéma :

Étape A : Nettoyage des autorisations

Sección titulada «Paso A: Limpieza de Permisos»
  1. Dans le ruban, allez sur l'onglet Données.
  2. Cliquez sur Obtenir les données -> Paramètres de la source de données (Data Source Settings).
  3. Nous cherchons le chemin de notre API Business Central dans la liste des sources globales ou du classeur actuel.
  4. Cliquez sur Effacer les autorisations (Clear Permissions).

Étape B : Nettoyage du cache de données

Sección titulada «Paso B: Limpieza de la Caché de Datos»
  1. Nous ouvrons l'éditeur Power Query (en double-cliquant sur notre requête dans le panneau de droite).
  2. Allez dans Fichier -> Options et paramètres -> Options de requête.
  3. Dans le panneau de gauche, sous la section « GLOBAL », sélectionnez Chargement des données.
  4. Cliquez sur le bouton Vider le cache (Clear Cache).
  5. Enfin, dans l'éditeur Power Query lui-même, cliquez sur le bouton Actualiser l'aperçu. Le système s'authentifiera à nouveau et lira correctement les nouvelles colonnes.

3. Protocole de nettoyage dans Power BI Desktop

Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»

Le comportement dans Power BI est identique à celui d'Excel, mais les options sont réparties de manière légèrement différente.

  1. Allez dans Fichier -> Options et paramètres -> Options.
  2. Dans le menu latéral gauche, sous la rubrique « GLOBAL », sélectionnez Chargement des données (Data Load).
  3. Dans la section « Options de mise en cache des données », cliquez sur Effacer le cache.
  4. (Facultatif) Si nous utilisons Q&A, nous cliquons également sur « Effacer le cache Q&A ».
  5. Nous fermons la fenêtre des options.
  6. Dans la vue principale (ou dans Power Query), cliquez sur Actualiser. En l'absence de cache local, Power BI effectuera un appel HTTP propre pour télécharger le nouveau schéma JSON de notre API, résolvant l'erreur instantanément.

4. Liste de contrôle de maintenance du cache

Sección titulada «4. Checklist de Mantenimiento de Caché»
  • ✓ Débogage des autorisations : Suppression des identifiants globaux corrompus suite à des réorganisations ou des changements de UPN d'Entra ID.
  • ✓ Mise à jour du schéma : Purge de la mise en cache des données locales dans Power Query pour recharger le document $metadata de l'ERP.
  • ✓ Validation finale : Vérification des colonnes importées dans la vue Power Query pour garantir qu'elles correspondent à la définition actuelle d'AL.