Ir al contenido

Pulizia della cache (Excel & Power BI)

Protocollo operativo per risolvere i conflitti di metadati e schemi in cache dopo il deployment di nuove API in Business Central.

0letture

Nella nostra operatività di integrazione continua (CI/CD), è comune che modifichiamo le API nel linguaggio AL per aggiungere nuove colonne o rinominare quelle esistenti (ad es. passare da numDocumento a Num_Documento).

Anche se il deployment in Business Central ha successo, gli strumenti client di Microsoft (Excel e Power BI Desktop) utilizzano un sistema di cache dei metadati estremamente aggressivo per risparmiare larghezza di banda. Ciò provoca tentativi di lettura dell'API basati su una "foto" obsoleta dello schema, con conseguente fallimento totale dell'ingestione dei dati.

1. L'Errore Classico: “Property does not exist”

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

Il sintomo inequivocabile di questo conflitto è il seguente errore 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."

Diagnosi DevSecOps: Il database di origine è cambiato, ma il client locale (Excel/Power BI) si rifiuta di scaricare il nuovo documento $metadata da OData. Continua a richiedere la vecchia colonna e il server rifiuta la richiesta.

Quando consumiamo le nostre API analitiche direttamente da Excel (tramite Power Query), dobbiamo svuotare due cache diverse per forzare l'aggiornamento dello schema:

  1. Nella barra multifunzione, andiamo alla scheda Dati.
  2. Facciamo clic su Recupera dati -> Impostazioni origine dati (Data Source Settings).
  3. Cerchiamo il percorso della nostra API di Business Central nell'elenco delle origini globali o della cartella di lavoro corrente.
  4. Facciamo clic su Cancella autorizzazioni (Clear Permissions).
  1. Apriamo l'editor di Power Query (facendo doppio clic sulla nostra query nel pannello di destra).
  2. Andiamo su File -> Opzioni e impostazioni -> Opzioni query.
  3. Nel pannello di sinistra, sotto la sezione “GLOBAL”, selezioniamo Caricamento dati.
  4. Facciamo clic sul pulsante Svuota cache (Clear Cache).
  5. Infine, nell'editor di Power Query stesso, facciamo clic sul pulsante Aggiorna anteprima. Il sistema si autenticherà nuovamente e leggerà correttamente le nuove colonne.

3. Protocollo di Pulizia in Power BI Desktop

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

Il comportamento in Power BI è identico a quello di Excel, ma le opzioni sono distribuite in modo leggermente diverso.

  1. Andiamo su File -> Opzioni e impostazioni -> Opzioni.
  2. Nel menu laterale sinistro, sotto la voce “GLOBAL”, selezioniamo Caricamento dati (Data Load).
  3. Nella sezione “Opzioni cache dati”, facciamo clic su Svuota cache.
  4. (Facoltativo) Se utilizziamo Q&A, facciamo anche clic su “Cancellare la cache di Q&A”.
  5. Chiudiamo la finestra delle opzioni.
  6. Nella vista principale (o in Power Query), facciamo clic su Aggiorna. Non trovando una cache locale, Power BI eseguirà una chiamata HTTP pulita per scaricare il nuovo schema JSON della nostra API, risolvendo istantaneamente l'errore.
  • ✓ Debug dei permessi: Cancellazione delle credenziali globali corrotte a seguito di riorganizzazioni o modifiche dell'UPN di Entra ID.
  • ✓ Aggiornamento dello schema: Pulizia della cache dei dati locali in Power Query per ricaricare il documento $metadata dell'ERP.
  • ✓ Validazione finale: Verifica delle colonne importate nella vista di Power Query per garantire che corrispondano all'attuale definizione di AL.