Installer le connecteur Power BI pour utiliser des modèles de requête bordInstall Power BI Connector to use CQD query templates

Pour pouvoir utiliser les modèles de requête Power BI (fichiers PBIX) pour le tableau de bord de qualité des appels de Microsoft Teams (bord), vous devez installer Power BI Connector pour Microsoft bord, à l’aide du fichier MicrosoftCallQuality. pqx inclus dans le Téléchargement.Before you can use the Power BI query templates (PBIX files) for Microsoft Teams Call Quality Dashboard (CQD), you'll need to install the Power BI Connector for Microsoft CQD, using the MicrosoftCallQuality.pqx file included in the download.

Lire Utilisez Power bi pour analyser les données de bord pour les équipes et en savoir plus sur ces modèles.Read Use Power BI to analyze CQD data for Teams to learn about these templates.

Vérifiez que vous avez le rôle d’accès bord approprié pour accéder aux rapports Power bi.Make sure you have the right CQD access role to access the Power BI reports.

InstallationInstallation

Pour plus d’informations sur l’installation d’un connecteur personnalisé et sur l’ajustement de la sécurité afin d’activer l’utilisation du connecteur, voir la documentation relative à Power bi.The process for installing a custom connector and adjusting security to enable use of the connector is described in detail in the Power BI documentation. Par souci de simplicité, voici une explication rapide :For the sake of simplicity, here's a quick explanation:

  1. Vérifiez si votre ordinateur possède déjà un dossier de * [ ] \ connecteurs de \ connecteurs personnalisés pour le bureau Power bi*   .Check to see if your computer already has a [Documents]\Power BI Desktop\Custom Connectors folder. Si ce n’est pas le cas, créez ce dossier. 1If not, create this folder.1

  2. Téléchargez le fichier de connecteur (fichier * * . Mez* ou * * . pqx* ) et placez-le dans le répertoire de connecteurs personnalisés .Download the connector file (either a *.mez or *.pqx file) and place it in the Custom Connectors directory.

  3. Si le fichier de connecteur est un fichier * * . Mez ,* vous devrez également régler vos paramètres de sécurité comme décrit dans la documentation de configuration du connecteur personnalisé.If the connector file is a *.mez file, you will also need to adjust your security settings as described in the custom connector setup documentation.

Si une nouvelle version de ce connecteur Power BI pour Microsoft teams est publiée, remplacez simplement l’ancien fichier de connecteur dans le répertoire de connecteurs personnalisés par le nouveau fichier.If a new version of this Power BI Connector for Microsoft Teams is released, simply replace the old connector file in the Custom Connectors directory with the new file.

InstallationSetup

Pour créer un rapport et exécuter des requêtes, vous devez d’abord vous connecter à la source de données bord.In order to build a report and run queries, you will first need to connect to the CQD data source. Pour vous connecter, suivez les étapes ci-dessous :Follow the steps below in order to connect:

  1. Dans l’onglet Accueil de Power BI Desktop, cliquez sur obtenir des données.In the Home tab of Power BI Desktop, click on Get Data.

    Capture d’écran : Power BI Connector

  2. La fenêtre obtenir des données doit apparaître à ce stade.The Get Data window should appear at this point. Accédez aux services en ligne, puis sélectionnez qualité d’appel Microsoft (Beta) et appuyez sur connexion.Navigate to Online Services, then select Microsoft Call Quality (Beta) and hit Connect.

    Capture d’écran : Power BI Connector

  3. Vous serez invité à vous connecter à l’étape suivante.You will be prompted to login next. Utilisez les mêmes informations d’identification que celles que vous utilisez dans bord. 2Use the same credentials that you use for CQD.2

  4. L’invite suivante vous donne l’option entre deux modes de connexion de données.The next prompt will give you the option between two Data Connectivity modes. Sélectionnez DirectQuery , puis cliquez sur OK.Select DirectQuery and hit OK.

  5. Enfin, vous recevez un message final vous indiquant le modèle de données entier pour bord.Finally, you will be given a final prompt showing you the entire data model for CQD. Aucune donnée n’est visible à ce stade, uniquement le modèle de données pour bord.No data will be visible at this point, only the data model for CQD. Sélectionnez charger pour terminer le processus d’installation.Select Load to complete the setup process.

  6. À ce stade, Power BI chargera le modèle de données sur le côté droit de la fenêtre.At this point, Power BI will load the data model onto the right side of the window. Le reste de la page est vide et aucune requête n’est chargée par défaut.The page will remain otherwise blank, and no queries will be loaded by default. Passez à la création de requêtes ci-dessous afin de générer une requête et de renvoyer les données.Proceed to Building Queries below in order to build a query and return data.

Si l’une des étapes de ce processus de configuration n’a pas été entièrement claire, une explication plus détaillée du processus est disponible ici.If any of the steps during this setup process were not completely clear, a more detailed explanation of the process can be found here.

Création de requêtesBuilding Queries

Une fois l’installation terminée, vous devez voir les noms de plusieurs centaines de dimensions et de mesures dans le volet champs .Once setup is complete, you should see the names of several hundred dimensions and measures load in the Fields pane. La création de requêtes réelles à partir de cet emplacement est simple, il suffit de sélectionner les dimensions et les mesures souhaitées pour votre requête, puis de les faire glisser sur la page.Constructing actual queries from here is simple, just select the dimensions and measures you want for your query, then drag and drop them onto the page. Vous trouverez ci-dessous une explication plus détaillée, en Voici un exemple simple :Here's a more detailed explanation, with a simple example:

  1. Sélectionnez la visualisation que vous souhaitez utiliser dans le volet visualisations .Select the visualization you want to use from the Visualizations pane. Une version vide de cette visualisation doit apparaître sur la page.A blank version of that visualization should appear on the page. Dans le cadre de cet exemple, nous allons utiliser la visualisation de table .For the purposes of this example, we will be using the Table visualization.

    Capture d’écran : Power BI Connector

  2. Déterminez les dimensions et mesures (représentées par un symbole d’agrégation en fonction de leur nom) que vous voulez utiliser pour votre requête, puis sélectionnez-les manuellement et faites-les glisser vers la visualisation noire.Determine which dimensions and measures (denoted by an aggregation symbol by their name) you wish to use for your query, then manually select them and drag them onto the black visualization. Vous pouvez également les faire glisser sur le champ valeurs sous les options de visualisation.Alternately, drag them onto the Values field beneath the visualization options.

    Capture d’écran : Power BI Connector

    Important

    Le tableau de bord de qualité des appels nécessite une mesure pour s’exécuter sur n’importe quelle requête.Call Quality Dashboard requires a measure for any query to run. L’échec de l’ajout d’une mesure à une requête entraînera l’échec de la requête.Failure to add a measure to a query will cause that query to fail.

  3. Sélectionnez ensuite les dimensions sur lesquelles vous voulez filtrer et faites-les glisser vers les filtres de ce champ visuel dans le volet de filtres .Next, select any dimensions you want to filter on and drag them to the Filters on this visual field in the Filters pane. Le bord Power BI Connector prend actuellement en charge les filtres de base (sélectionnez des valeurs dans une liste de valeurs de dimension possibles), le filtrage avancé (spécifier manuellement des valeurs et des opérandes pour le filtrage, similaire à l’option avancée bord) et le filtrage de date relatif (disponible uniquement pour les dimensions heure de fin et heure de début ).The CQD Power BI Connector currently supports Basic filtering (select values from a list of possible dimension values), Advanced filtering (manually specify values and operands to filter on, similar to Advanced CQD), and Relative date filtering (only available for the End Time and Start Time dimensions). Le filtrage en fonction de Top N n’est pas pris en charge par bord.Filtering according to Top N is not supported by CQD.

    Capture d’écran : Power BI Connector

  4. Enfin, sélectionnez l’onglet mise en forme dans le volet de visualisations pour appliquer un style et une mise en forme à votre requête.Finally, select the Format tab within the Visualizations pane to style and format your query.

    Notes

    Les requêtes bord requièrent au moins une mesure pour pouvoir s’exécuter.CQD queries require at least one measure in order to run. Si votre requête ne se charge pas, assurez-vous d’avoir inclus une mesure dans la requête.If your query does not load, double check that you have included a measure in the query.

Création d’un rapport d’extractionCreating a Drillthrough Report

L' extraction dans Power bi vous permet de créer des rapports ciblés que vous pouvez rapidement filtrer en utilisant les valeurs d’autres rapports en tant que contexte.Drillthrough in Power BI allows you to create focused reports that you can quickly filter using the values of other reports as context. Lorsque vous savez créer votre première requête avec le connecteur bord, la création d’une extraction est encore plus simple.Once you know how to create your first query with the CQD Connector, creating a drillthrough is even simpler.

  1. Créez une autre page pour le rapport prioritaire, puis ajoutez vos requêtes à cette page.Create another page for the focused report, and then add your queries to that page.

  2. Sélectionnez la dimension que vous souhaitez utiliser comme filtre d’extraction et faites-la glisser vers le champ Drillthrough sous dans le volet de visualisations .Select the dimension you want to use as a drillthrough filter and drag them onto the Drillthrough field under on the Visualizations pane.

    Capture d’écran : Power BI Connector

  3. Voilà!That's it! Toute autre requête dans une autre page qui utilise cette dimension peut désormais être réappliquée à cette page, en appliquant automatiquement la valeur de la dimension d’extraction comme filtre.Any other query on another page that uses that dimension can now drillthrough to that page, automatically applying the drillthrough dimension's value as a filter.

    Capture d’écran : Power BI Connector

Contrairement à bord avancée, Power BI prend en charge l’extraction non séquentielle.Unlike Advanced CQD, Power BI supports non-sequential drillthrough. Tant qu’une requête inclut la dimension nécessaire, elle peut procéder à une extraction vers une autre page.So long as a query includes the necessary dimension, it can drillthrough to any other page.

Meilleure pratiqueBest practice

Les requêtes de connecteur de qualité d’appel doivent être conçues avec la fonctionnalité d’extraction à l’esprit.Call Quality connector queries should be designed with drillthrough functionality in mind. Au lieu d’essayer de charger toutes les données en une seule fois, puis de les découper à l’aide de filtres, commencez par des requêtes plus larges et à faible taux de cardinalité.Instead of trying to load all the data at once, and then slicing down with filters, start with broader, low-cardinality queries and drill down to high-cardinality queries. Par exemple, lorsque vous tentez de diagnostiquer quels sous-réseaux contribuent à la plupart des problèmes de qualité, nous vous conseillons d’identifier ces régions et pays qui contribuent au problème, puis d’explorer les sous-réseaux dans cette région ou ce pays.For instance, when attempting to diagnose which subnets contribute most to quality issues, it's helpful to first identify those regions and countries which contribute to the problem, then drill down to the subnets in that region or country. Les modèles de connecteur de qualité d’appel ont été conçus de cette manière pour servir d’exemple.The Call Quality connector templates have been designed in this manner in order to act as an example.

ConditionsLimitations

Malgré une utilisation de Power BI, toutes les fonctionnalités de Power BI ne sont pas prises en charge par le connecteur bord, soit en raison de limitations sur le modèle de données bord ou sur les connecteurs DirectQuery en général.Despite making use of Power BI, not all Power BI functionality is support by the CQD Connector, either as a result of limitations on CQD data model or on DirectQuery connectors in general. La liste ci-dessous répertorie quelques-unes des limitations de connecteur plus remarquables, mais cette liste ne doit pas être considérée comme exhaustive :The list below notes some of the Connector's more noteworthy limitations, but this list should not be considered exhaustive:

  1. Colonnes calculées – En général, les connecteurs DirectQuery disposent d’une prise en charge limitée des colonnes calculées dans Power BI.Calculated Columns – DirectQuery connectors in general have limited support for calculated columns in Power BI. Même si certaines colonnes calculées peuvent être utilisées avec le connecteur, celles-ci doivent être considérées comme des exceptions.While some calculated columns may work with the Connector, these should be considered exceptions. En règle générale, les colonnes calculées ne fonctionneront pas.As a general rule, calculated columns will not function.

  2. Agrégations : Le modèle de données bord est bâti sur un modèle de cube, ce qui signifie que les agrégations sont déjà prises en charge sous la forme de mesures.Aggregations – The CQD data model is built on a cube model, meaning that aggregations are already supported in the form of measures. L’ajout d’agrégations manuellement à des dimensions différentes ou la modification du type d’agrégation d’une mesure ne fonctionne pas avec le connecteur, et génère généralement une erreur.Attempting to manually add aggregations to different dimensions or changing the aggregation type of a measure will not work with the Connector, and it will generally result in an error.

  3. Visuels personnalisés : Même si le connecteur bord fonctionne avec une gamme de visuels personnalisés, nous ne sommes pas en mesure de garantir la compatibilité avec les éléments visuels personnalisés.Custom Visuals – While the CQD Connector does work with a range of custom visuals, we are unable to guarantee compatibility with all custom visuals. De nombreux visuels personnalisés font appel à l’utilisation de colonnes calculées ou de données importées, ni ou qui sont prises en charge par les connecteurs DirectQuery.Many custom visuals rely on the use of calculated columns or imported data, neither or which are supported by DirectQuery connectors.

  4. Référencement des données mises en cache : Pour le moment, Power BI ne prend pas en charge le référencement des données mises en cache à partir d’un connecteur DirectQuery.Referencing Cached Data – Power BI currently does not support referencing cached data from a DirectQuery connector in any way. Toute tentative de référencer les résultats d’une requête générera une nouvelle requête.Any attempt to reference the results of a query will result in a new query.

  5. Filtrage de données relatif – Est pris en charge dans le connecteur bord, mais uniquement avec les dimensions heure de début et heure de fin .Relative Data Filtering – Is supported in the CQD Connector, but only with the Start Time and End Time dimensions. Même si la dimension de Date peut être le choix évident pour le filtrage relatif aux dates relatives, la Date n’est pas stockée en tant qu’objet date et par conséquent ne prend pas en charge le filtrage relatif de la date sur Power bi.Although the Date dimension may be the obvious choice for relative date filtering, Date is not stored as a date time object and thus does not support relative date filtering in Power BI.

  6. Prise en charge de la communauté gouvernementale Dans le cadre de l’utilisation de l’environnement GCC, l’application Power BI bord Connector fonctionne lors de l’utilisation de Power BI Desktop.Government Community Cloud (GCC) Support – For customers in the GCC environment, the CQD Power BI Connector will work when using Power BI Desktop. Le connecteur Power BI bord n’est actuellement pas compatible avec le service Power BI pour les clients GCC.The CQD Power BI connector is not currently compatible with the Power BI service for GCC customers.

La plupart de ces problèmes sont des restrictions à la conception de connecteurs DirectQuery dans Power BI ou à la conception du modèle de données bord.Most of these issues are either restrictions to DirectQuery connector design in Power BI or fundamental to the design of the CQD data model.

Résolution des problèmesTroubleshooting

J’essaie d’utiliser la colonne Date en tant que segment de date.I'm trying to use the Date column as a Date slicer. Dès que je convertis le type de données de cette colonne à ce jour, j’obtiens une erreurAs soon as I convert the data type of this column to Date, I get this error

Nous n’avons pas pu charger les données pour cet élément visuel: OLE DB ou ODBC : [expression. erreur] nous n’avons pas pu plier l’expression à la source de données.Couldn't load the data for this visual: OLE DB or ODBC error: [Expression.Error] We couldn't fold the expression to the data source. Veuillez essayer une expression plus simple.Please try a simpler expression.

Les segments de date ne sont pas pris en charge par Power BI Connector.Date slicers aren't supported with the Power BI Connector. Pour spécifier une plage de dates, appliquez deux filtres au rapport, en spécifiant une valeur inférieure ou supérieure à.To specify a date range, apply two filters to the report, specifying a less than and greater than date.

Par ailleurs, si les dates que vous souhaitez afficher sont récentes, appliquez un filtre de dates relatives pour afficher uniquement les données relatives aux N derniers jours/semaines/mois.Alternatively, if the dates you want to view are recent, apply a relative date filter to show only data for the last N days/weeks/months.

Codes d’erreurError Codes

Dans la mesure où l’application Power BI bord est moins limitée que l’application du navigateur en termes de types de requêtes que vous pouvez créer, vous risquez de rencontrer un certain nombre d’erreurs lors de la création de vos requêtes.Because the CQD Power BI Connector is less restricted than the browser app in terms of kinds of queries you can construct, you may occasionally encounter a number of errors while building your queries. Dans le cas où vous recevez un message d’erreur du type «CQDError.In the event that you receive an error message of the type "CQDError. RunQuery – erreur d’exécution de requête ", référencez la liste ci-dessous avec le numéro ErrorType fourni pour résoudre le problème potentiel de la requête.RunQuery – Query Execution Error", reference the list below with the ErrorType number provided in order to troubleshoot the possible issue with the query. Vous trouverez ci-après les codes d’erreur les plus courants que vous pouvez rencontrer avec le bord Power BI Connector :The following are the most common Error Type codes you may encounter with the CQD Power BI Connector:

  • ErrorType 1-erreur de structure de requête : Une erreur de structure de requête est généralement provoquée par un échec de la création d’une requête mise en forme correcte par le connecteur.ErrorType 1 - Query Structure Error: A query structure error is typically caused by the Connector failing to build a properly formatted query. Ce problème survient le plus souvent lors de l’utilisation de fonctionnalités non prises en charge, comme indiqué dans les limites ci-dessus.This happens most often when using unsupported functionality, as specified in the Limitations above. Vérifiez que vous n’utilisez pas de colonnes calculées ni de visuels personnalisés pour cette requête.Double check that you are not using any calculated columns or custom visuals for that query.

    • ErrorType 2-erreur de création de requête : Une erreur de génération de requête est provoquée par le lien bord qui ne parvient pas à analyser correctement la requête que vous essayez de générer.ErrorType 2 - Query Building Error: A query building error is caused by the CQD Connector being unable to properly parse the query you are attempting to build. Ce problème survient le plus souvent lors de l’utilisation de fonctionnalités non prises en charge, comme indiqué dans les limites ci-dessus.This happens most often when using unsupported functionality, as specified in the Limitations above. Vérifiez que vous n’utilisez pas de colonnes calculées ni de visuels personnalisés pour cette requête.Double check that you are not using any calculated columns or custom visuals for that query.

    • ErrorType 5 : délai d’exécution : La requête a atteint le nombre maximal d’exécution possibles avant le délai d’expiration. Tentez d’ajouter d’autres filtres à la requête afin de limiter l’étendue.ErrorType 5 - Execution Timeout: The query has reached the maximum possible runtime before timing out. Try adding more filters to the query in order to limit its scope. Pour cela, le plus simple est de limiter la plage de données.Narrowing the data range is often the most effective way to achieve this.

    • ErrorType 7-aucune erreur de mesure : Les requêtes bord requièrent une mesure pour fonctionner.ErrorType 7 - No Measurements Error: CQD queries require a measure in order to function. Vérifiez que votre requête inclut Measure.Double check that your query includes measure. Les mesures du connecteur bord sont représentées par le symbole Aggregate (somme) avant leur nom.Measures in the CQD Connector are denoted by the aggregation (sum) symbol before their name.

Si vous rencontrez des erreurs supplémentaires en dehors de cette zone, contactez l’équipe bord pour pouvoir résoudre le problème et mettre à jour la documentation selon vos besoins.If you encounter any additional errors outside of this scope, please notify the CQD team so that we can help troubleshoot the issue and update the documentation as appropriate.

Notes de finFootnotes

1 certains processus et applications (par exemple, OneDrive) peuvent entraîner le changement du dossier racine de votre document. Assurez-vous que le répertoire de * \ connecteurs personnalisés de Power bi* est placé à l’intérieur du dossier documents du dossier racine actuel.1 Certain processes and apps (e.g., OneDrive) may cause your Documents root folder to change; make sure that the Power BI Desktop\Custom Connectors directory is placed inside of the current root folder Documents folder.

2 les informations d’identification que vous utilisez pour bord n’ont pas besoin d’être identiques aux informations d’identification utilisées pour la connexion à l’application de bureau Power bi.2 The login credentials you use for CQD do not need to be the same credentials you use for logging into the Power BI Desktop app itself.

Questions fréquemment poséesFrequently asked questions

Lors de la mise à jour de Power BI Connector à partir du statut « beta »When will the Power BI Connector be updated from "Beta" status

Malgré la balise bêta, le connecteur de qualité d’appel pour Power BI est la version de connecteur, officiellement sécurisée par l’équipe Power BI pour refléter cela.Despite the Beta tag, the Call Quality Connector for Power BI is the release version of the connector and has been officially security signed by the Power BI team to reflect this. Le processus de certification permettant de supprimer cette balise bêta est un processus complet et nécessite un engagement de l’équipe Power BI pour fournir également une assistance directe au connecteur.The certification process to remove that Beta tag is an extensive one and requires a commitment from the Power BI team to provide direct support to the connector as well. En raison de contraintes de temps, l’équipe Power BI ne peut actuellement pas fournir le support technique et la certification plus large, mais elle reste préoccupée à attester de la sécurité, de l’authenticité et des fonctionnalités générales du connecteur de qualité d’appel Microsoft.Due to time constraints, the Power BI team is currently unable to provide that support and broader certification, but is still prepared to attest to the security, authenticity, and general functionality of the Microsoft Call Quality connector.

Pourquoi le connecteur semble-t-il plus lent par rapport aux fonctions avancées bord dans le navigateur ?Why does the connector seem slower compared to Advanced CQD in the browser? Que faire pour améliorer les performancesWhat can I do to improve performance

La performance des requêtes pour les différents modèles est en fait identique dans le navigateur et dans le connecteur.Query performance for the various templates is actually the same in both the browser and in the connector. À l’instar des autres applications autonomes, Power BI ajoute son authentification et le temps de rendu à nos performances.Just like any other standalone app, Power BI adds its authentication and rendering time to our performance. Par ailleurs, la différence intervient dans le nombre de requêtes simultanées en cours d’exécution.In addition, the difference comes in the number of concurrent queries being run. Dans la mesure où la version dans le navigateur de bord avait des options de visualisation moins bien développées et à forte densité d’information, la plupart de nos rapports étaient limités au chargement de requêtes 2-3 à la fois.Because the in-browser version of CQD had less well-developed and information-dense visualization options, most of our reports were limited to loading 2-3 queries at a time. En revanche, les modèles de connecteur affichent souvent 20 requêtes simultanées.On the other hand, the connector templates often display 20+ concurrent queries. Si vous souhaitez générer des rapports qui sont aussi réactifs que les plus anciens, essayez de créer des rapports sans utiliser les requêtes 2-3 par onglet.If you wish to build reports that are just as responsive as the older ones you were used to, try creating reports with no more than 2-3 queries per tab.

Pour plus d’informations, consultez les articles suivants :For more information, see the following articles:

Je trouve qu’il s’agit de la limite de 10 000 lignes lors de l’exécution de requêtes.I find that I routinely run into the 10,000-row limit when running queries. Comment puis-je faire en sorte que le connecteur renvoie plus de 10 000 lignesHow can I get the connector to return more than 10,000 rows

La limite de 10 000 ligne est en fait spécifiée à la fin de l’API, et elle est conçue pour améliorer sensiblement les performances et limiter le risque d’erreurs d’exécution de requête résultant de la faible quantité de mémoire.The 10,000-row limit is actually specified on the API end, and it is designed to help significantly improve performance and reduce the risk of query execution errors resulting from low memory conditions.

Au lieu d’essayer d’augmenter le nombre de lignes de résultats, il est préférable de restructurer vos rapports conformément aux meilleures pratiques en matière de connecteurs.Instead of attempting to increase the result row count, it is best to restructure your reports according to connector best practices. Les modèles que nous avons inclus sont conçus pour illustrer ces bonnes pratiques.The templates we have included are designed to demonstrate these best practices. Dans la mesure du possible, commencez par examiner vos indicateurs de performance clés à l’aide de dimensions plus grandes et de cardinalité, telles que le mois, l’année, la date, la région, le pays, etc. À partir de là, vous pouvez effectuer des recherches dans les dimensions de plus en plus élevées.Where possible, start by looking at your KPIs using broader, lower-cardinality dimensions, such as Month, Year, Date, Region, Country, etc. From there, you can drill down into increasingly higher-cardinality dimensions. Les rapports d’assistance technique et de localisation sont des exemples de bon déroulement du flux de travail exploration.The Helpdesk and Location-Enhanced Reports both provide good examples of this drill down workflow.

Utiliser Power BI pour analyser des données bord pour teamsUse Power BI to analyze CQD data for Teams