Teilen über


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

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.

Kunden in Government-Cloudumgebungen (GCC, GCC-H, DoD) müssen den Connector mit einem lokalen Datengateway installieren, um die Kompatibilität mit dem Power BI-Dienst zu gewährleisten. Ohne ein lokales Gateway können Government-Cloudkunden nur den Microsoft-Anrufqualitätsconnector in Power BI Desktop verwenden.

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) und dann Verbinden aus.

    Microsoft-Anrufqualität im Power BI-Connector.

  3. Verwenden Sie in der Anmeldeaufforderung dieselben Anmeldeinformationen wie für das Anrufqualitätsdashboard. arabische Ziffer

  4. Die nächste Eingabeaufforderung bietet Ihnen die Option zwischen zwei Datenkonnektivitätsmodi. Wählen Sie DirectQuery und dann OK aus.

  5. Die letzte Eingabeaufforderung zeigt das gesamte Datenmodell für das Anrufqualitätsdashboard an. An diesem Punkt 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 die rechte Seite des Fensters. Die Seite bleibt andernfalls leer, und standardmäßig werden keine Abfragen geladen. Informationen zum Erstellen einer Abfrage und zum Zurückgeben von Daten finden Sie unter Erstellen von Abfragen.

Wenn einer der Schritte während dieses Setupvorgangs nicht klar ist, 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 durch ihren Namen) Sie für Ihre Abfrage verwenden möchten. Wählen Sie dann diese Dimensionen und Measures 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.

    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 Anrufqualitätsdashboard unterstützt keine Filterung nach Top N.

    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 eingeschlossen 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.

Beste Praxis

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 sind auf diese Weise als Beispiel konzipiert.

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 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, erstellt eine neue 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 Datum-Uhrzeit-Objekt 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 kann der Microsoft Call Quality-Connector aus Gründen der Kompatibilität mit Power BI-Dienst mit einem lokalen Datengateway verwendet werden. Befolgen Sie einfach die Anleitung zum Installieren benutzerdefinierter Connectors mit einem lokalen Datengateway mithilfe der neuesten Version des Microsoft-Anrufqualitätsconnectors, um den Zugriff zu ermöglichen. 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, in der 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?

Trotz der Bezeichnung "Beta" im Microsoft Call Quality-Connector befindet sich der Connector im Release status. Es handelt sich nicht um eine Betaversion. Zum Zeitpunkt der ersten Veröffentlichung des Connectors war das Power BI-Team nicht in der Lage, Support und eine umfassendere Zertifizierung (und somit das "Beta"-Tag) bereitzustellen, aber es war weiterhin bereit, die Sicherheit, Authentizität und allgemeine Funktionalität des Microsoft Call Quality-Connectors zu bestätigen. Seitdem investiert das CQD-Team unabhängig weiter in die Weiterentwicklung des Connectors, um seine Funktionalität zu verbessern und zu überarbeiten. Die Bezeichnung "Beta" sollte Kunden nicht davon abhalten, den Connector zu verwenden. Die Bezeichnung ist nur ein Nebeneffekt unseres unabhängigen Ansatzes bei der Connectorentwicklung.

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