Installare Microsoft Call Quality Connector per Power BI per usare i modelli di query di Call Quality Dashboard

Prima di usare i modelli di query Power BI (file PBIX) per Call Quality Dashboard (CQD) di Microsoft Teams, è necessario installare il connettore Microsoft Call Quality per Power BI, usando il file MicrosoftCallQuality.pqx incluso nel download.

Per informazioni su questi modelli, vedere Usare Power BI per analizzare i dati di Call Quality Dashboard per Teams .

Assicurarsi di avere il ruolo di accesso corretto a Call Quality Dashboard per accedere ai report di Power BI.

Installazione

Il processo per l'installazione di un connettore personalizzato e la regolazione della sicurezza per consentire l'uso del connettore è descritto in dettaglio nella documentazione di Power BI. Per semplicità, ecco una breve spiegazione:

1. Verificare che il computer abbia già una cartella [Documenti]\Power BI Desktop\Connettori personalizzati. In caso contrario, creare questa cartella. ¹

2. Scaricare il file del connettore (file *.mez o *.pqx ) e inserirlo nella directory Custom Connectors .

3. Se il file del connettore è un file *.mez , è necessario modificare anche le impostazioni di sicurezza come descritto nella documentazione personalizzata sulla configurazione del connettore.

Se viene rilasciata una nuova versione del connettore Microsoft Call Quality, sostituire il vecchio file del connettore nella directory Custom Connectors con il nuovo file.

I clienti negli ambienti cloud per enti pubblici (GCC, GCC-H, DoD) devono installare il connettore con un gateway dati locale per garantire la compatibilità con il servizio Power BI. Senza un gateway locale, i clienti del cloud government possono usare il connettore Microsoft Call Quality solo in Power BI Desktop.

Apparecchio

Per creare un report ed eseguire query, è necessario prima di tutto connettersi all'origine dati di Call Quality Dashboard. Per connettersi, eseguire le operazioni seguenti:

1. Nella scheda Home di Power BI Desktop selezionare Recupera dati.

   

2. A questo punto dovrebbe comparire la finestra Recupera dati . Passa a Servizi online, quindi seleziona Qualità chiamata Microsoft (Beta) e seleziona Connetti.

   

3. Nel prompt di accesso usare le stesse credenziali usate per Call Quality Dashboard. ^{numero arabo}

4. Il prompt successivo consente di scegliere tra due modalità di connettività dei dati. Selezionare DirectQuery, quindi scegliere OK.

5. La richiesta finale mostra l'intero modello di dati per Call Quality Dashboard. A questo punto non sono visibili dati, ma solo il modello di dati per Call Quality Dashboard. Selezionare Carica per completare il processo di configurazione.

6. A questo punto, Power BI carica il modello di dati sul lato destro della finestra. In caso contrario, la pagina rimane vuota e per impostazione predefinita non viene caricata alcuna query. Per creare una query e restituire dati, vedere Creazione di query.

Se uno dei passaggi descritti durante questo processo di configurazione non è chiaro, è possibile trovare una spiegazione più dettagliata del processo in Avvio rapido: Connettersi ai dati in Power BI Desktop.

Creazione di query

Al termine dell'installazione, nel riquadro Campi dovrebbero essere visualizzati i nomi di diverse centinaia di dimensioni e misure. Creare query effettive da qui è semplice, basta selezionare le dimensioni e le misure desiderate per la query, quindi trascinarle nella pagina. Ecco una spiegazione più dettagliata, con un semplice esempio:

1. Selezionare la visualizzazione da usare nel riquadro Visualizzazioni . Nella pagina dovrebbe essere visualizzata una versione vuota della visualizzazione. Ai fini di questo esempio, si usa la visualizzazione Tabella .

   

2. Determinare le dimensioni e le misure da usare per la query, contrassegnate da un simbolo di aggregazione con il relativo nome. Selezionare quindi manualmente queste dimensioni e misure e trascinarle nella visualizzazione nera. In alternativa, trascinarli nel campo Valori sotto le opzioni di visualizzazione.

   

   Importante

   Call Quality Dashboard richiede una misura per l'esecuzione di qualsiasi query. Se non si aggiunge una misura a una query, la query avrà esito negativo.

3. Selezionare quindi le dimensioni da filtrare e trascinarle nel campo Filtri in questo campo visivo nel riquadro Filtri . Il connettore Microsoft Call Quality attualmente supporta il filtro di base (selezionare valori da un elenco di valori di dimensione possibili), il filtro avanzato (specificare manualmente i valori e gli operandi in base a cui filtrare, in modo simile a Call Quality Dashboard) e il filtro data relativo (disponibile solo per le dimensioni Ora fine e Ora inizio ). Call Quality Dashboard non supporta il filtro in base a Top N.

   

   Importante

   I filtri sono supportati solo se applicati alle dimensioni. Il filtro dei valori di Misure non è supportato in Call Quality Dashboard.

4. Infine, selezionare la scheda Formato nel riquadro Visualizzazioni per applicare stili e formattare la query.

   Nota

   Le query di Call Quality Dashboard richiedono almeno una misura per l'esecuzione. Se la query non viene caricata, verificare di aver incluso una misura nella query.

Creazione di un report drill-through

Il drill-through in Power BI consente di creare report evidenziati che è possibile filtrare rapidamente usando i valori di altri report come contesto. Dopo aver capito come creare la prima query con il connettore Microsoft Call Quality, creare un drill-through è ancora più semplice.

1. Creare un'altra pagina per il report con lo stato attivo e quindi aggiungere le query a tale pagina.

2. Selezionare la dimensione da usare come filtro drill-through e trascinarla nel campo Drill-through sotto nel riquadro Visualizzazioni .

   

3. Questo è tutto! Qualsiasi altra query in un'altra pagina che usa tale dimensione può ora eseguire il drill-through alla pagina, applicando automaticamente il valore della dimensione drill-through come filtro.

   

A differenza di Call Quality Dashboard, Power BI supporta il drill-through non sequenziale. Se una query include la dimensione necessaria, può eseguire il drill-down fino a qualsiasi altra pagina.

Procedure consigliate

È consigliabile progettare le query dei connettori Microsoft Call Quality tenendo presente la funzionalità drill-through. Invece di provare a caricare tutti i dati contemporaneamente e quindi a scendere con i filtri, iniziare con query più ampie a bassa cardinalità ed eseguire il drill-down fino a query con cardinalità elevata. Ad esempio, quando si tenta di diagnosticare quali subnet contribuiscono maggiormente ai problemi di qualità, è utile prima identificare le aree geografiche e i paesi che contribuiscono al problema, quindi eseguire il drill-down fino alle subnet di tale area geografica o paese. I modelli di connettore Qualità chiamata sono progettati in questo modo per fungere da esempio.

Limitazioni

Non tutte le funzionalità di Power BI sono supportate dal connettore Microsoft Call Quality, a causa di limitazioni nel modello di dati di Call Quality Dashboard o sui connettori DirectQuery in generale. Nell'elenco seguente vengono annota alcune delle limitazioni più degne di nota di Connector, ma l'elenco non è esaustivo:

1. Colonne calcolate – I connettori DirectQuery in generale hanno un supporto limitato per le colonne calcolate in Power BI. Alcune colonne calcolate potrebbero funzionare con Il connettore, in quanto tali colonne sono eccezioni. Come regola generale, le colonne calcolate non funzionano.

2. Aggregazioni– Il modello di dati Call Quality Dashboard è basato su un modello cubo, ovvero le aggregazioni sono già supportate sotto forma di misure. Il tentativo di aggiungere manualmente aggregazioni a dimensioni diverse o la modifica del tipo di aggregazione di una misura non funziona con Il connettore e in genere genera un errore.

3. Oggetti visivi personalizzati : Anche se il connettore Microsoft Call Quality funziona con una gamma di oggetti visivi personalizzati, non siamo in grado di garantire la compatibilità con tutti gli oggetti visivi personalizzati. Molti oggetti visivi personalizzati si basano sull'uso di colonne calcolate o dati importati, nessuno dei quali è supportato dai connettori DirectQuery.

4. Riferimento ai dati memorizzati nella cache - Power BI attualmente non supporta il riferimento ai dati memorizzati nella cache da un connettore DirectQuery in alcun modo. Qualsiasi tentativo di fare riferimento ai risultati di una query creerà una nuova query.

5. Filtro dei dati relativi - È supportato nel connettore Microsoft Call Quality, ma solo con le dimensioni Ora inizio e Ora fine . Anche se la dimensione Data potrebbe essere la scelta ovvia per il filtro delle date relative, La data non viene archiviata come oggetto data e quindi non supporta il filtro delle date relative in Power BI.

6. Query solo dimensioni o solo misurazione - Al momento non sono supportati nel connettore Microsoft Call Quality. Se si crea una visualizzazione con tre o più misure e nessuna dimensione o tre o più dimensioni e nessuna misura, i dati della colonna verranno trasposti. Includere sempre almeno una dimensione(ad esempio Mese Anno) e una misura (ad esempio Total Call Count) nelle visualizzazioni.

7. Supporto per Government Community Cloud (GCC, GCC-High e DoD) - Per i clienti negli ambienti cloud per enti pubblici, il connettore Microsoft Call Quality può essere usato con un gateway dati locale per garantire la compatibilità con servizio Power BI. Seguire semplicemente la guida per installare connettori personalizzati con un gateway dati locale usando la versione più recente del connettore Microsoft Call Quality per abilitare l'accesso. Inoltre, è necessaria una licenza appropriata di Power BI per il governo degli Stati Uniti per il cloud per enti pubblici. Per altre informazioni sulle licenze, vedere le linee guida più recenti per Power BI per i clienti del governo degli Stati Uniti.

La maggior parte di questi problemi sono le restrizioni alla progettazione del connettore DirectQuery in Power BI o fondamentali per la progettazione del modello di dati di Call Quality Dashboard.

Risoluzione dei problemi

Si sta provando a usare la colonna Data come filtro dei dati Data. Non appena converti il tipo di dati di questa colonna in Data, viene visualizzato questo errore

Non è stato possibile caricare i dati per questo oggetto visivo: errore OLE DB o ODBC: [Expression.Error] Non è stato possibile piegare l'espressione all'origine dati. Prova un'espressione più semplice.

I filtri dei dati data non sono supportati con il connettore Microsoft Call Quality. Per specificare un intervallo di date, applicare due filtri al report, specificando una data minore e maggiore di.

In alternativa, se le date da visualizzare sono recenti, applicare un filtro relativo per visualizzare solo i dati relativi agli ultimi N giorni/settimane/mesi.

Quando si aggiungono determinate dimensioni ai report, l'oggetto visivo restituisce immediatamente "Impossibile caricare i dati per questo oggetto visivo". La rimozione della dimensione corregge l'oggetto visivo: cosa succede?

Si tratta di un problema noto nel connettore Microsoft Call Quality. Qualsiasi dimensione esposta come numero intero viene visualizzata in Power BI come colonna di aggregazione, dove Power BI prova un'azione di riepilogo predefinita (in genere 'Somma'). In alcuni casi, questo comportamento riesce a sommare i valori anche se il risultato non è utile, poiché la "somma" di una dimensione come Second WiFi Channel è priva di significato. In altri casi, l'azione di riepilogo non riesce e causa errori nell'oggetto visivo.

Per ovviare a questo problema, iniziare rimuovendo la dimensione dall'oggetto visivo. Selezionare la dimensione dall'elenco Campi , passare alla scheda Strumenti colonna sulla barra multifunzione, selezionare il menu a discesa Riepilogo e selezionare Non riepilogare. Ora è possibile aggiungere di nuovo la dimensione all'oggetto visivo.

Codici di errore

Poiché il connettore Microsoft Call Quality per Power BI è meno limitato rispetto all'app del browser in termini di tipi di query che è possibile creare, a volte possono verificarsi errori durante la creazione delle query. Se viene visualizzato un messaggio di errore di tipo "CQDError. RunQuery - Errore di esecuzione query", fare riferimento all'elenco seguente con il numero ErrorType fornito per risolvere il possibile problema con la query. Di seguito sono elencati i codici di tipo di errore più comuni che possono verificarsi con il connettore power BI di Call Quality Dashboard:

• ErrorType 1 - Errore struttura query: Un errore di struttura della query è in genere causato dal connettore che non riesce a creare una query formattata correttamente. Questa situazione si verifica più spesso quando si usano funzionalità non supportate, come specificato nelle limitazioni precedenti. Verificare di non usare colonne calcolate o oggetti visivi personalizzati per la query.

  • ErrorType 2 - Errore di creazione query: Un errore di creazione di una query è causato dal fatto che il connettore Microsoft Call Quality non è in grado di analizzare correttamente la query che si sta tentando di creare. Questo errore si verifica più spesso quando si usano funzionalità non supportate, come specificato nelle Limitazioni precedenti. Verificare di non usare colonne calcolate o oggetti visivi personalizzati per la query.

  • ErrorType 5 - Timeout esecuzione: La query ha raggiunto il runtime massimo possibile prima del timeout. Provare ad aggiungere altri filtri alla query per limitarne l'ambito. Limitare l'intervallo di dati è spesso il modo più efficace per ottenere questo risultato.

  • ErrorType 7 - Nessun errore di misura: Le query di Call Quality Dashboard richiedono una misura per funzionare. Verificare che la query includa una misura. Le misure nel connettore Microsoft Call Quality sono indicate dal simbolo di aggregazione (somma) prima del nome.

Se si verificano altri errori al di fuori di questo ambito, informare il team di Call Quality Dashboard in modo da poter risolvere il problema e aggiornare la documentazione in base alle esigenze.

Note

¹ Alcuni processi e app (ad esempio, OneDrive) potrebbero causare la modifica della cartella radice Documenti; verificare che la directory Power BI Desktop\Custom Connectors sia inserita nella cartella Documenti della cartella radice corrente.

² Le credenziali di accesso usate per Call Quality Dashboard non devono necessariamente corrispondere a quelle usate per accedere all'app Power BI Desktop stessa.

Domande frequenti

Quando verrà aggiornato il connettore Power BI dallo stato "Beta"?

Nonostante l'etichetta "beta" nel connettore Microsoft Call Quality, il connettore è in stato di rilascio; non è una versione beta. Al momento del rilascio iniziale del connettore, il team di Power BI non è stato in grado di fornire supporto e certificazione più ampia (e quindi il tag "beta"), ma era ancora pronto a attestare la sicurezza, l'autenticità e la funzionalità generale del connettore Microsoft Call Quality. Da allora, il team CQD in modo indipendente continua a investire ulteriori sviluppi nel connettore per migliorarne e rivederne le funzionalità. L'etichetta "beta" non dovrebbe dissuadere i clienti dall'usare il connettore. L'etichettatura è solo un effetto collaterale del nostro approccio indipendente allo sviluppo dei connettori.

Perché il connettore sembra più lento rispetto a Call Quality Dashboard nel browser? Cosa posso fare per migliorare le prestazioni?

Le prestazioni delle query per i vari modelli sono in realtà le stesse sia nel browser che nel connettore. Come qualsiasi altra app autonoma, Power BI ne aggiunge l'autenticazione e il tempo di rendering alle prestazioni. Inoltre, la differenza riguarda il numero di query simultanee da eseguire. Poiché la versione nel browser di Call Quality Dashboard aveva opzioni di visualizzazione meno sviluppate e con densità di informazioni, la maggior parte dei report era limitata al caricamento di 2-3 query alla volta. D'altra parte, i modelli di connettore spesso visualizzano più di 20 query simultanee. Se si vogliono creare report reattivi quanto quelli meno recenti, provare a creare report con non più di 2-3 query per scheda.

Per altre informazioni, vedere gli articoli seguenti:

• Guida all'ottimizzazione per Power BI
• Linee guida del modello DirectQuery

Il limite di 10.000 righe durante l'esecuzione di query viene regolarmente gestito. Come si fa a fare in modo che il connettore restituisca più di 10.000 righe?

Il limite di 10.000 righe è specificato sul lato API ed è progettato per migliorare significativamente le prestazioni e ridurre il rischio di errori di esecuzione delle query derivanti da condizioni di memoria insufficienti.

Invece di tentare di aumentare il numero di righe dei risultati, è consigliabile ristrutturare i report in base alle procedure consigliate per i connettori. I modelli inclusi sono progettati per dimostrare queste procedure consigliate. Dove possibile, iniziare osservando gli indicatori KPI usando dimensioni più ampie e con una cardinalità inferiore, ad esempio Mese, Anno, Data, Area geografica, Paese e così via. Da qui è possibile eseguire il drill-down per visualizzare dimensioni di cardinalità sempre più elevate. L'helpdesk e i report di Location-Enhanced offrono entrambi ottimi esempi di questo flusso di lavoro di drill-down.

Articoli correlati

Usare Power BI per analizzare i dati di Call Quality Dashboard per Teams