Ir al contenido

Troubleshooting in Power BI

Risoluzione di conflitti di permessi globali e corruzione del routing ('La chiave non corrisponde') in Power Query.

0letture

Mentre la pulizia della "cache dello schema" (documentata nella sezione 02) risolve i problemi con le colonne modificate, a volte ci troviamo di fronte a cadute complete di connettività che impediscono persino di visualizzare gli ambienti di Business Central.

Questo documento descrive in dettaglio come diagnosticare e risolvere la corruzione delle credenziali globali in Power BI Desktop.

Incidente: “La chiave non corrisponde a nessuna riga della tabella”

Sección titulada «Incidente: “La clave no coincidió con ninguna fila de la tabla”»

Al provare a connettere per la prima volta il connettore visuale nativo di Business Central in Power BI, o al provare a cambiare ambiente (ad es. spostare un report da Sandbox a Production), compare il seguente errore critico prima di poter distribuire le cartelle delle API:

Error: La clave no coincidió con ninguna fila de la tabla.
(En inglés: The key didn't match any rows in the table)

Questo errore non è un problema di codice AL né un'interruzione dell'API. È una corruzione interna del motore di routing di Power Query (Navigation Path).

Power BI salva nel nostro sistema operativo una cache di navigazione fortemente legata al nostro token OAuth di Azure AD. Se il nostro token scade, se cambiamo utente in Windows, o se tentiamo di forzare un aggiornamento in un ambiente in cui la nostra firma di sicurezza locale non corrisponde più al percorso di Business Central salvato nella cache, Power BI non sa come costruire l'albero delle cartelle e lancia l'eccezione “La chiave non corrisponde”.

Soluzione DevSecOps: Reset dei Permessi dell'Origine Dati

Sección titulada «Solución DevSecOps: Reset de Permisos de Origen de Datos»

Non basta riavviare Power BI; dobbiamo distruggere manualmente i diritti di accesso memorizzati a livello globale sulla nostra macchina locale.

  1. In Power BI Desktop, andiamo alla scheda File.
  2. Selezioniamo Opzioni e impostazioni -> Impostazioni origine dati (Data source settings).
  3. Nella finestra popup, è fondamentale assicurarsi di trovarsi nella scheda Autorizzazioni globali (Global permissions) e NON in “Origini dati nel file corrente”.
  4. Cerchiamo nella lista qualsiasi voce che contenga:
    • Dynamics 365 Business Central
    • Percorsi che iniziano con https://api.businesscentral.dynamics.com...
    • Riferimenti a OData relativi al nostro tenant.
  5. Selezioniamo ciascuna di queste voci e premiamo il pulsante Cancella autorizzazioni (Clear permissions) in basso.
  6. Confermiamo l'eliminazione nella finestra di dialogo.
  7. Chiudiamo la finestra delle impostazioni.

Una volta ripulita la sicurezza globale, clicchiamo nuovamente su Ottieni dati e selezioniamo la nostra connessione a Business Central.

Il sistema riconoscerà che non ci sono autorizzazioni salvate e aprirà la finestra pop-up di autenticazione di Microsoft (OAuth2). Effettuando nuovamente l'accesso, verrà generato un token pulito e la navigazione attraverso le cartelle delle API tornerà a funzionare perfettamente.

Checklist per la Risoluzione dei Problemi in Power BI

Sección titulada «Checklist de Resolución de Problemas en Power BI»
  • ✓ Depurazione delle credenziali: Purga della configurazione dei “Permessi Globali” per escludere token OAuth corrotti o scaduti.
  • ✓ Autenticazione pulita: Chiusura forzata e riavvio della sessione di Microsoft Entra ID per rigenerare i token di lettura.
  • ✓ Validazione: Verifica del corretto dispiegamento visivo delle cartelle analitiche in Power BI Desktop dopo la riconnessione.