Installieren des Microsoft Call Quality-Connectors für Power BI zur Verwendung von Abfragevorlagen für das Anrufqualitätsdashboard

  • Artikel
  • Gilt für::
    Microsoft Teams

Bevor Sie die Power BI-Abfragevorlagen (PBIX-Dateien) für das Microsoft Teams Call Quality Dashboard (CQD) verwenden können, müssen Sie den Microsoft Call Quality Connector für Power BI mithilfe der im Download enthaltenen Datei MicrosoftCallQuality.pqx installieren.

Informationen zu diesen Vorlagen finden Sie unter Verwenden von Power BI zum Analysieren von CQD-Daten für Teams .

Stellen Sie sicher, dass Sie über die richtige CQD-Zugriffsrolle für den Zugriff auf die Power BI-Berichte verfügen.

Hinweis

Der Microsoft Call Quality-Connector unterstützt nur DirectQuery in Power BI. Der Importmodus wird nicht unterstützt.

Installation

Der Prozess zum Installieren eines benutzerdefinierten Connectors und zum Anpassen der Sicherheit, um die Verwendung des Connectors zu ermöglichen, wird in der Power BI-Dokumentation ausführlich beschrieben. Der Einfachheit halber finden Sie hier eine kurze Erklärung:

  1. Überprüfen Sie, ob Ihr Computer bereits über den Ordner [Dokumente]\Power BI Desktop\Benutzerdefinierte Connectors verfügt. Wenn dies nicht der Fall ist, erstellen Sie diesen Ordner. 1

  2. Laden Sie die Connectordatei (entweder eine *.mez - oder eine *.pqx-Datei ) herunter, und speichern Sie sie im Verzeichnis Benutzerdefinierte Connectors .

  3. Wenn es sich bei der Connectordatei um eine *.mez-Datei handelt, müssen Sie auch Ihre Sicherheitseinstellungen anpassen, wie in der Dokumentation zum Einrichten des benutzerdefinierten Connectors beschrieben.

Wenn eine neue Version des Microsoft Call Quality-Connectors veröffentlicht wird, ersetzen Sie die alte Connectordatei im Verzeichnis Benutzerdefinierte Connectors durch die neue Datei.

Installationsanforderungen

Um einen Bericht zu erstellen und Abfragen auszuführen, müssen Sie zunächst eine Verbindung mit der CQD-Datenquelle herstellen. Führen Sie die folgenden Schritte aus, um eine Verbindung herzustellen:

  1. Wählen Sie auf der Registerkarte Start von Power BI Desktop die Option Daten abrufen aus.

    Abrufen von Daten im Power BI-Connector.

  2. Das Fenster Daten abrufen sollte an diesem Punkt angezeigt werden. Navigieren Sie zu Onlinedienste, wählen Sie dann Microsoft-Anrufqualität (Beta) aus, und klicken Sie auf Verbinden.

    Microsoft-Anrufqualität im Power BI-Connector.

  3. Als Nächstes werden Sie aufgefordert, sich anzumelden. Verwenden Sie die gleichen Anmeldeinformationen, die Sie für das Anrufqualitätsdashboard verwenden. 2

  4. Die nächste Eingabeaufforderung gibt Ihnen die Option zwischen zwei Datenkonnektivitätsmodi. Wählen Sie DirectQuery aus, und klicken Sie auf OK.

  5. Schließlich wird eine letzte Eingabeaufforderung mit dem gesamten Datenmodell für das Anrufqualitätsdashboard angezeigt. Zu diesem Zeitpunkt sind keine Daten sichtbar, nur das Datenmodell für CQD. Wählen Sie Laden aus, um den Setupvorgang abzuschließen.

  6. An diesem Punkt lädt Power BI das Datenmodell auf der rechten Seite des Fensters. Die Seite bleibt andernfalls leer, und standardmäßig werden keine Abfragen geladen. Fahren Sie unten mit Erstellen von Abfragen fort, um eine Abfrage zu erstellen und Daten zurückzugeben.

Wenn einer der Schritte während dieses Setupvorgangs nicht klar war, finden Sie eine ausführlichere Erläuterung des Prozesses unter Schnellstart: Herstellen einer Verbindung mit Daten in Power BI Desktop.

Erstellen von Abfragen

Nach Abschluss des Setups sollten die Namen von mehreren hundert Dimensionen und Measures im Bereich Felder angezeigt werden. Das Erstellen von tatsächlichen Abfragen aus hier ist einfach. Wählen Sie einfach die Dimensionen und Measures aus, die Sie für Ihre Abfrage benötigen, und ziehen Sie sie dann auf das Zeichenblatt. Hier ist eine ausführlichere Erklärung mit einem einfachen Beispiel:

  1. Wählen Sie im Bereich Visualisierungen die gewünschte Visualisierung aus. Eine leere Version dieser Visualisierung sollte auf der Seite angezeigt werden. Für dieses Beispiel verwenden wir die Tabellenvisualisierung .

    Bereich

  2. Bestimmen Sie, welche Dimensionen und Measures (gekennzeichnet durch ein Aggregationssymbol anhand ihres Namens) für Ihre Abfrage verwendet werden sollen, und wählen Sie sie dann manuell aus, und ziehen Sie sie auf die schwarze Visualisierung. Ziehen Sie sie alternativ in das Feld Werte unterhalb der Visualisierungsoptionen.

    ! Visualisierungsabfrage im Power BI-Connector.] (medien/CQD-power-bi-connector4-resize2.png)

    Wichtig

    Das Aufrufqualitätsdashboard erfordert ein Measure, damit jede Abfrage ausgeführt werden kann. Wenn Sie einer Abfrage kein Measure hinzufügen, tritt bei dieser Abfrage ein Fehler auf.

  3. Wählen Sie als Nächstes alle Dimensionen aus, nach denen Sie filtern möchten, und ziehen Sie sie in das Feld Filter für dieses Visual im Bereich Filter . Der Microsoft-Anrufqualitätsconnector unterstützt derzeit die Standardfilterung (Auswählen von Werten aus einer Liste möglicher Dimensionswerte), erweiterte Filterung (manuelles Angeben von Werten und Operanden zum Filtern, ähnlich wie beim Anrufqualitätsdashboard) und relative Datumsfilterung (nur für die Dimensionen Endzeit und Startzeit verfügbar). Das Filtern nach Top N wird vom Anrufqualitätsdashboard nicht unterstützt.

    Visualisierungsfilter im Power BI-Connector.

    Wichtig

    Filter werden nur unterstützt, wenn sie auf Dimensionen angewendet werden. Das Filtern nach den Werten von Messungen wird im Anrufqualitätsdashboard nicht unterstützt.

  4. Wählen Sie abschließend die Registerkarte Format im Bereich Visualisierungen aus, um Ihre Abfrage zu formatieren und zu formatieren.

    Hinweis

    Aufrufqualitätsdashboard-Abfragen erfordern mindestens ein Measure, um ausgeführt zu werden. Wenn Ihre Abfrage nicht geladen wird, überprüfen Sie, ob Sie ein Measure in die Abfrage eingefügt haben.

Erstellen eines Drillthroughberichts

Mit drillthrough in Power BI können Sie fokussierte Berichte erstellen, die Sie schnell mithilfe der Werte anderer Berichte als Kontext filtern können. Sobald Sie wissen, wie Sie Ihre erste Abfrage mit dem Microsoft-Anrufqualitätsconnector erstellen, ist das Erstellen eines Drillthroughs noch einfacher.

  1. Erstellen Sie eine weitere Seite für den relevanten Bericht, und fügen Sie dann Ihre Abfragen zu dieser Seite hinzu.

  2. Wählen Sie die Dimension aus, die Sie als Drillthroughfilter verwenden möchten, und ziehen Sie sie auf das Feld Drillthrough unter im Bereich Visualisierungen .

    Drillthrough im Power BI-Connector.

  3. Das ist alles. Jede andere Abfrage auf einer anderen Seite, die diese Dimension verwendet, kann jetzt einen Drillthrough auf diese Seite ausführen, wobei der Wert der Drillthroughdimension automatisch als Filter angewendet wird.

    Drillthroughfilter im Power BI-Connector.

Im Gegensatz zum Anrufqualitätsdashboard unterstützt Power BI nicht sequenzielle Drillthroughs. Wenn eine Abfrage die erforderliche Dimension enthält, kann ein Drillthrough zu jeder anderen Seite ausgeführt werden.

Bewährte Methode

Sie sollten Microsoft Call Quality-Connectorabfragen unter Berücksichtigung von Drillthroughfunktionen entwerfen. Anstatt zu versuchen, alle Daten gleichzeitig zu laden und dann mit Filtern zu zerlegen, beginnen Sie mit umfassenderen Abfragen mit niedriger Kardinalität, und führen Sie einen Drilldown zu Abfragen mit hoher Kardinalität durch. Bei instance ist es bei dem Versuch, zu diagnostizieren, welche Subnetze am meisten zu Qualitätsproblemen beitragen, zunächst die Regionen und Länder/Regionen zu identifizieren, die zum Problem beitragen, und dann einen Drilldown zu den Subnetzen in dieser Region oder in diesem Land durchzuführen. Die Vorlagen für den Anrufqualitätsconnector wurden auf diese Weise entworfen, um als Beispiel zu dienen.

Einschränkungen

Nicht alle Power BI-Funktionen werden vom Microsoft-Anrufqualitätsconnector unterstützt, entweder aufgrund von Einschränkungen für das Datenmodell des Anrufqualitätsdashboards oder aufgrund von DirectQuery-Connectors im Allgemeinen. Die folgende Liste enthält einige der beachtenswerten Einschränkungen des Connectors, aber diese Liste ist nicht vollständig:

  1. Berechnete Spalten – DirectQuery-Connectors bieten im Allgemeinen nur eingeschränkte Unterstützung für berechnete Spalten in Power BI. Einige berechnete Spalten funktionieren möglicherweise mit dem Connector, da diese Spalten Ausnahmen sind. Im Allgemeinen funktionieren berechnete Spalten nicht.

  2. Aggregationen– Das Datenmodell des Aufrufqualitätsdashboards basiert auf einem Cubemodell, was bedeutet, dass Aggregationen bereits in Form von Measures unterstützt werden. Der Versuch, Aggregationen manuell verschiedenen Dimensionen hinzuzufügen oder den Aggregationstyp eines Measures zu ändern, funktioniert nicht mit dem Connector, und dies führt in der Regel zu einem Fehler.

  3. Benutzerdefinierte Visuals – Obwohl der Microsoft Call Quality-Connector mit einer Reihe von benutzerdefinierten Visuals funktioniert, können wir nicht die Kompatibilität mit allen benutzerdefinierten Visuals garantieren. Viele benutzerdefinierte Visuals basieren auf der Verwendung von berechneten Spalten oder importierten Daten, von denen keines von DirectQuery-Connectors unterstützt wird.

  4. Verweisen auf zwischengespeicherte Daten – Power BI unterstützt derzeit in keiner Weise das Verweisen auf zwischengespeicherte Daten von einem DirectQuery-Connector. Jeder Versuch, auf die Ergebnisse einer Abfrage zu verweisen, führt zu einer neuen Abfrage.

  5. Relative Datenfilterung – Wird im Microsoft-Anrufqualitätsconnector unterstützt, jedoch nur mit den Dimensionen Startzeit und Endzeit . Obwohl die Date-Dimension die offensichtliche Wahl für die relative Datumsfilterung ist, wird Date nicht als Datums-/Uhrzeitobjekt gespeichert und unterstützt daher keine relative Datumsfilterung in Power BI.

  6. Abfragen nur Dimension oder Nur Messung : Werden derzeit im Microsoft-Anrufqualitätsconnector nicht unterstützt. Wenn Sie eine Visualisierung mit drei oder mehr Messungen ohne Dimensionen oder drei oder mehr Dimensionen und ohne Messungen erstellen, werden die Spaltendaten transponiert. Schließen Sie immer mindestens eine Dimension (z. B. Monat Jahr) und eine Messung (z. B. Gesamtzahl der Aufrufe) in Ihre Visualisierungen ein.

  7. Government Community Cloud -Unterstützung (GCC, GCC-High und DoD) – Für Kunden in Government-Cloudumgebungen funktioniert der Microsoft Call Quality-Connector nur, wenn Power BI Desktop verwendet wird. Der Microsoft Call Quality-Connector ist derzeit nicht mit dem Power BI-Dienst für Government-Cloudkunden kompatibel. Darüber hinaus ist eine entsprechende Power BI US Government-Lizenz für die Government-Cloud erforderlich. Weitere Informationen zur Lizenzierung finden Sie im aktuellen Leitfaden für Power BI für US-Behördenkunden.

Die meisten dieser Probleme sind entweder Einschränkungen für den DirectQuery-Connectorentwurf in Power BI oder grundlegend für den Entwurf des CQD-Datenmodells.

Problembehandlung

Ich versuche, die Spalte Date als Date-Slicer zu verwenden. Sobald ich den Datentyp dieser Spalte in Date konvertiert habe, erhalte ich diesen Fehler.

Die Daten für dieses Visual konnten nicht geladen werden: OLE DB- oder ODBC-Fehler: [Expression.Error] Der Ausdruck konnte nicht in die Datenquelle gefaltet werden. Versuchen Sie es mit einem einfacheren Ausdruck.

Datumsslicer werden mit dem Microsoft-Anrufqualitätsconnector nicht unterstützt. Um einen Datumsbereich anzugeben, wenden Sie zwei Filter auf den Bericht an, wobei ein kleiner als und größer als datum angegeben wird.

Wenn die Datumsangaben, die Sie anzeigen möchten, aktuell sind, wenden Sie alternativ einen relativen Datumsfilter an, um nur Daten für die letzten N Tage/Wochen/Monate anzuzeigen.

Wenn ich meinen Berichten bestimmte Dimensionen hinzugebe, gibt das Visual sofort "Die Daten für dieses Visual konnten nicht geladen werden" zurück. Durch das Entfernen der Dimension wird das Visual korrigiert– was geschieht?

Dies ist ein bekanntes Problem im Microsoft-Anrufqualitätsconnector. Jede Dimension, die als ganze Zahl verfügbar gemacht wird, wird in Power BI als "Aggregat"-Spalte angezeigt, wobei Power BI eine standardmäßige Zusammenfassungsaktion (in der Regel "Summe") versucht. In einigen Fällen kann dieses Verhalten die Werte zusammenfassen, obwohl das Ergebnis nicht nützlich ist, da die "Summe" einer Dimension wie second WIFi Channel bedeutungslos ist. In anderen Fällen schlägt diese Zusammenfassungsaktion fehl und verursacht Fehler im Visual.

Um dieses Problem zu umgehen, entfernen Sie zunächst die Dimension aus dem Visual. Wählen Sie die Dimension aus der Liste "Felder" aus, navigieren Sie im Menüband zur Registerkarte "Spaltentools", wählen Sie das Dropdownmenü "Zusammenfassung" aus, und wählen Sie Nicht zusammenfassen aus. Sie können die Dimension jetzt erneut zum Visual hinzufügen.

Fehlercodes

Da der Microsoft Call Quality-Connector für Power BI in Bezug auf die Arten von Abfragen, die Sie erstellen können, weniger eingeschränkt ist als die Browser-App, können beim Erstellen Ihrer Abfragen gelegentlich Fehler auftreten. Wenn Sie eine Fehlermeldung vom Typ "CQDError. RunQuery – Abfrageausführungsfehler", verweisen Sie auf die folgende Liste mit der angegebenen ErrorType-Nummer, um das mögliche Problem mit der Abfrage zu beheben. Im Folgenden finden Sie die häufigsten Fehlertypcodes, die beim CQD Power BI-Connector auftreten können:

  • ErrorType 1 – Abfragestrukturfehler: Ein Abfragestrukturfehler wird in der Regel dadurch verursacht, dass der Connector keine ordnungsgemäß formatierte Abfrage erstellen kann. Dies geschieht am häufigsten, wenn nicht unterstützte Funktionen verwendet werden, wie in den einschränkungen oben angegeben. Vergewissern Sie sich, dass Sie keine berechneten Spalten oder benutzerdefinierten Visuals für diese Abfrage verwenden.

    • ErrorType 2 – Fehler beim Erstellen von Abfragen: Ein Fehler beim Erstellen von Abfragen wird dadurch verursacht, dass der Microsoft Call Quality-Connector die Abfrage, die Sie erstellen möchten, nicht ordnungsgemäß analysieren kann. Dieser Fehler tritt am häufigsten auf, wenn nicht unterstützte Funktionen verwendet werden, wie in den einschränkungen oben angegeben. Vergewissern Sie sich, dass Sie keine berechneten Spalten oder benutzerdefinierten Visuals für diese Abfrage verwenden.

    • ErrorType 5 – Ausführungstimeout: Die Abfrage hat die maximal mögliche Laufzeit vor einem Timeout erreicht. Versuchen Sie, der Abfrage weitere Filter hinzuzufügen, um deren Umfang einzuschränken. Die Eingrenzung des Datenbereichs ist häufig der effektivste Weg, dies zu erreichen.

    • ErrorType 7 – Keine Messungen Fehler: Aufrufqualitätsdashboard-Abfragen erfordern ein Measure, um zu funktionieren. Überprüfen Sie, ob Ihre Abfrage measure enthält. Measures im Microsoft Call Quality-Connector werden durch das Aggregationssymbol (Summe) vor ihrem Namen gekennzeichnet.

Wenn außerhalb dieses Bereichs weitere Fehler auftreten, benachrichtigen Sie das Anrufqualitätsdashboard-Team, damit wir Ihnen bei der Problembehandlung helfen und die Dokumentation entsprechend aktualisieren können.

Fußnoten

1 Bestimmte Prozesse und Apps (z. B. OneDrive) können dazu führen, dass sich Der Stammordner "Dokumente" ändert. Stellen Sie sicher, dass sich das Verzeichnis Power BI Desktop\Custom Connectors im aktuellen Stammordner Dokumente befindet.

2 Die Anmeldeinformationen, die Sie für das Anrufqualitätsdashboard verwenden, müssen nicht mit den Anmeldeinformationen übereinstimmen, die Sie für die Anmeldung bei der Power BI Desktop-App selbst verwenden.

Häufig gestellte Fragen

Wann wird der Power BI-Connector von "Beta" status aktualisiert?

Der Microsoft Call Quality(Beta)-Connector für Power BI ist die erste Releaseversion des Connectors und wurde offiziell vom Power BI-Team signiert, um dies widerzuspiegeln. Zum Zeitpunkt der ersten Veröffentlichung des Connectors war das Power BI-Team nicht in der Lage, Support und eine umfassendere Zertifizierung bereitzustellen, war aber dennoch bereit, die Sicherheit, Authentizität und allgemeine Funktionalität des Microsoft-Anrufqualitätsconnectors zu bestätigen. Wir planen, in Kürze in den Microsoft Call Quality Connector für Power BI zu investieren.

Warum scheint der Connector im Vergleich zum Anrufqualitätsdashboard im Browser langsamer zu sein? Was kann ich tun, um die Leistung zu verbessern?

Die Abfrageleistung für die verschiedenen Vorlagen ist sowohl im Browser als auch im Connector identisch. Wie jede andere eigenständige App fügt Power BI die Authentifizierungs- und Renderingzeit zur Leistung hinzu. Darüber hinaus besteht der Unterschied in der Anzahl der gleichzeitig ausgeführten Abfragen. Da die In-Browser-Version des Anrufqualitätsdashboards weniger gut entwickelte und informationsreiche Visualisierungsoptionen enthielt, waren die meisten unserer Berichte auf das Laden von 2-3 Abfragen gleichzeitig beschränkt. Andererseits zeigen die Connectorvorlagen häufig mehr als 20 gleichzeitige Abfragen an. Wenn Sie Berichte erstellen möchten, die so reaktionsfähig sind wie die älteren, mit denen Sie vertraut waren, versuchen Sie, Berichte mit maximal 2-3 Abfragen pro Registerkarte zu erstellen.

Weitere Informationen finden Sie in den folgenden Artikeln:

Ich finde, dass ich beim Ausführen von Abfragen routinemäßig auf den Grenzwert von 10.000 Zeilen stoßen. Wie kann ich erreichen, dass der Connector mehr als 10.000 Zeilen zurückgibt?

Der Grenzwert von 10.000 Zeilen wird am API-Ende angegeben und dient dazu, die Leistung erheblich zu verbessern und das Risiko von Abfrageausführungsfehlern aufgrund geringer Arbeitsspeicherbedingungen zu verringern.

Anstatt zu versuchen, die Anzahl der Ergebniszeilen zu erhöhen, empfiehlt es sich, Ihre Berichte gemäß den bewährten Methoden des Connectors neu zu strukturieren. Die von uns eingeschlossenen Vorlagen dienen dazu, diese bewährten Methoden zu veranschaulichen. Wenn möglich, beginnen Sie, indem Sie ihre KPIs mit umfassenderen, niedrigeren Kardinalitätsdimensionen wie Monat, Jahr, Datum, Region, Land usw. betrachten. Von dort aus können Sie einen Drilldown in immer größere Kardinalitätsdimensionen durchführen. Die Berichte Helpdesk und Location-Enhanced sind gute Beispiele für diesen Drilldownworkflow.

Verwenden von Power BI zum Analysieren von CQD-Daten für Teams