Créer des packs de contenu de modèle dans Power BIAuthor template content packs in Power BI

La création d’un pack de contenu de modèle implique l’utilisation de Power BI Desktop et PowerBI.com. Il existe quatre composants pour votre pack de contenu :Authoring a template content pack uses the Power BI Desktop and PowerBI.com. There are four components to your content pack:

Vous connaissez peut-être chacun de ces éléments en tant que fonctionnalités Power BI existantes.You may be familiar with each piece as existing Power BI features. Lors de la création d’un pack de contenu, d’autres points sont à prendre en compte pour chaque aspect. Consultez la section suivante pour plus de détails.When building a content pack, there are additional things to consider for each aspect, see each section below for more details.

RequêtesQueries

Pour les packs de contenu de modèle, les requêtes développées dans Power BI Desktop sont utilisées pour vous connecter à votre source de données et importer des données.For template content packs, queries developed in the Power BI Desktop are used to connect to your data source and import data. Ces requêtes sont nécessaires pour renvoyer un schéma cohérent, et elles sont prises en charge pour l’actualisation des données planifiée (les requêtes directes ne sont pas prises en charge).These queries are required to return a consistent schema and are supported for Scheduled Data refresh (direct query is not supported).

Les packs de contenu de modèle prennent en charge une seule source de données, aussi définissez vos requêtes avec soin.Template content packs only support one data source per content pack so define your queries carefully. Une source de données est définie en tant que source qui requiert la même authentification.A single data source is defined as a source that requires the same authentication. Vous pouvez effectuer plusieurs appels d’API dans différentes requêtes si tous les appels ont lieu vers le même point de terminaison d’API et utilisent la même authentification.You can make multiple API calls in different queries if all the calls are to the same API endpoint and use the same authentication. Les packs de contenu Power BI ne prennent pas en charge plusieurs sources qui exigent différentes authentifications.Power BI content packs do not support multiple sources that require different authentications.

Vous connecter à votre APIConnect to your API

Pour commencer, vous devez vous connecter à votre API à partir de Power BI Desktop pour commencer à créer vos requêtes.To get started, you will need to connect to your API from Power BI Desktop to start building your queries.

Vous pouvez utiliser les connecteurs de données prêts à l’emploi disponibles dans Power BI Desktop pour vous connecter à votre API.You can use the Data Connectors that are available out of the box in Power BI Desktop to connect to your API. Vous pouvez utiliser le connecteur de données web (Obtenir des données -> Web) pour vous connecter à votre API REST ou le connecteur OData (Obtenir des données -> Flux OData) pour vous connecter à votre flux OData.You can use the Web Data Connector (Get Data -> Web) to connect to your Rest API or the OData connector (Get Data -> OData feed) to connect to your OData feed. Notez que ces connecteurs fonctionnent seulement si votre API prend en charge l’authentification de base.Please note that these connectors will work out of the box only if your API supports Basic Authentication.

Note

Si votre API utilise d’autres types d’authentification, tels que OAuth 2.0 ou Clé d’API web, vous devez développer votre propre connecteur de données pour que Power BI Desktop se connecte et s’authentifie correctement auprès de votre API.If your API uses any other authentication types, like OAuth 2.0 or Web API Key, then you will need to develop your own Data Connector to allow Power BI Desktop to successfully connects and authenticates to your API. Pour plus d’informations sur la façon de développer votre propre connecteur de données pour votre pack de contenu, consultez la documentation sur les connecteurs de données disponible ici.For details on how to develop your own Data Connector for your Content Pack, check the Data Connectors documentation here.

Considérer la sourceConsider the source

Les requêtes définissent les données comprises dans le modèle de données.The queries define the data that will be included in the data model. Selon la taille de votre système, ces requêtes doivent également inclure des filtres pour garantir que vos clients manipulent des données de taille gérable pour votre scénario d’application professionnelle.Depending on the size of your system, these queries should also include filters to ensure your customers are dealing with a manageable size that fits your business scenario.

Les packs de contenu Power BI peuvent exécuter plusieurs requêtes en parallèle, et pour plusieurs utilisateurs simultanément.Power BI content packs can execute multiple queries in parallel and for multiple users concurrently. Planifiez votre stratégie de limitation et de simultanéité, et demandez-nous comment rendre votre pack de contenu résistant aux pannes.Plan ahead your throttling and concurrency strategy and ask us how to make your content pack fault tolerant.

Application du schémaSchema enforcement

Assurez-vous que vos requêtes résistent aux modifications dans votre système, car les modifications de schéma lors de l’actualisation peuvent nuire au modèle.Ensure your queries are resilient to changes in your system, changes in schema on refresh can break the model. Si la source peut renvoyer un résultat de schéma de valeur null/vide pour certaines requêtes, considérez le renvoi d’une table vide ou de messages d’erreur personnalisés, qui seront compréhensibles pour les utilisateurs.If the source could return null/missing schema result for some queries, consider returning an empty table or throw a custom error messages that is meaningful to your user.

ParamètresParameters

Les paramètres dans Power BI Desktop permettent aux utilisateurs de fournir des valeurs d’entrée qui personnalisent les données récupérées par l’utilisateur.Parameters in Power BI Desktop allow your users to provide input values that customize the data retrieved by the user. Considérez les paramètres à l’avance pour éviter d’avoir à retravailler après avoir consacré du temps à la création de requêtes ou rapports détaillés.Think of the parameters upfront to avoid rework after investing time to build detailed queries or reports.

Note

Les packs de contenu de modèle prennent uniquement en charge les paramètres texte pour le moment.Template content packs only support text parameters currently. Les autres types de paramètres peuvent être utilisés lors du développement, mais lors de la partie de test, toutes les valeurs fournies par les utilisateurs seront littérales.Other parameter types can be used during development but during the testing portion all values provided by the users will be literal.

Conseils supplémentaires pour les requêtesAdditional query tips

  • Veillez à bien saisir tous les noms de colonnesEnsure all columns are typed appropriately
  • Les colonnes doivent avoir des noms informatifs (voir Q&R)Columns have informative names (see Q&A)
  • Pour la logique partagée, considérez l’utilisation de fonctions ou de requêtesFor shared logic, consider using functions or queries
  • Les niveaux de confidentialité ne sont pas actuellement pris en charge dans le service : si vous recevez une invite de commande concernant les niveaux de confidentialité, vous pourriez avoir à réécrire la requête pour utiliser des chemins d’accès relatifsPrivacy levels are not currently supported in the service - if you get a prompt about privacy levels, you may need to re-write the query to use relative paths

Modèle de donnéesData Model

Un modèle de données bien défini garantit que vos clients peuvent facilement et intuitivement interagir avec le pack de contenu.A well-defined data model will ensure your customers can easily and intuitively interact with the content pack. Créez le modèle de données dans Power BI Desktop.Create the data model in the Power BI Desktop.

Note

Une grande partie de la modélisation de base (saisie, noms de colonnes) doit être effectuée avec des requêtes.Much of the basic modelling (typing, column names) should be done in the queries.

Questions/Réponses (Q&R)Q&A

La modélisation affecte également la façon dont les Q&R peuvent fournir des résultats pour vos clients.The modelling will also affect how well Q&A can provide results for your customers. Veillez à ajouter des synonymes pour les colonnes fréquemment utilisées et à nommer les colonnes correctement dans les requêtes.Ensure you add synonyms to commonly used columns and that your columns are properly named in the queries.

Conseils supplémentaires pour les modèles de donnéesAdditional data model tips

  • La mise en forme est appliquée à toutes les colonnes de valeurAll value columns have formatting applied >[!NOTE] >Les types doivent être appliqués dans la requête.Types should be applied in the query.
  • Toutes les mesures doivent avoir une mise en forme appliquéeAll measures have formatting applied
  • Le résumé par défaut doit être défini.Default Summarization is set. En particulier « Ne pas résumer », le cas échéant (pour les valeurs uniques, par exemple)Especially "Do Not Summarize", when applicable (for unique values for example)
  • La catégorie de données a été définie, le cas échéantData Category has been set, when applicable
  • Les relations sont définies comme nécessaireRelationships are set, as necessary

RapportsReports

Les pages du rapport offrent des informations supplémentaires sur les données incluses dans votre pack de contenu.The report pages offer additional insight into the data included in your content pack. Utilisez les pages des rapports pour répondre aux questions professionnelles essentielles auxquelles votre pack de contenu essaye de répondre.Use the pages of the reports to answer the key business questions your content pack is trying to address. Créez le rapport à l’aide de Power BI Desktop.Create the report using the Power BI Desktop.

Note

Un seul rapport peut être inclus dans un pack de contenu, exploitez les différentes pages pour appeler des sections particulières de votre scénario.Only one report may be included in a content pack, take advantage of the different pages to call out particular sections of your scenario.

Conseils supplémentaires pour les rapportsAdditional report tips

  • Utilisez plusieurs éléments visuels par page pour le filtrage croiséUse more than one visual per page for cross-filtering
  • Alignez les éléments visuels soigneusement (sans chevauchement)Align the visuals carefully (no overlapping)
  • Définissez la disposition sur 4:3 ou 16:9Page is set to "4:3" or "16:9" mode for layout
  • Toutes les agrégations présentées sont cohérentes numériquement (moyennes, valeurs uniques)All of the aggregations presented make numeric sense (averages, unique values)
  • Le découpage produit des résultats rationnelsSlicing produces rational results
  • Le logo est présent au moins sur le premier rapportLogo is present on at least the top report
  • Les éléments sont autant que possible dans le schéma de couleurs du clientElements are in the client's color scheme to the extent possible

tableau de bordDashboard

Le tableau de bord est le principal point d’interaction avec votre pack de contenu pour vos clients.The dashboard is the main point of interaction with your content pack for your customers. Il doit inclure une vue d’ensemble du contenu inclus, en particulier les mesures les plus importantes de votre scénario d’application professionnelle.It should include an overview of the content included, especially the important metrics for your business scenario.

Pour créer un tableau de bord pour votre pack de contenu de modèle, téléchargez simplement votre PBIX via Obtenir des données > Fichiers, ou publiez directement à partir de Power BI Desktop.To create a dashboard for your template content pack, simply upload your PBIX through Get Data > Files or publish directly from the Power BI Desktop.

Note

Les packs de contenu de modèle nécessitent actuellement un rapport unique et un jeu de données par pack de contenu.Template content packs currently require a single report and dataset per content pack. N’épinglez pas le contenu de plusieurs rapports/jeux de données sur le tableau de bord utilisé dans le pack de contenu.Do not pin content from multiple reports/datasets onto the dashboard used in the content pack.

Conseils supplémentaires pour le tableau de bordAdditional dashboard tips

  • Conservez le même thème lors de l’épinglage de sorte que les mosaïques sur votre tableau de bord soient cohérentesMaintain the same theme when pinning so that the tiles on your dashboard are consistent
  • Épinglez un logo au thème afin que les consommateurs sachent d’où provient le packPin a logo to the theme so consumers know where the pack is from
  • La disposition suggérée pour travailler avec la plupart des résolutions d’écran est 5-6 petites mosaïques de largeSuggested layout to work with most screen resolutions is 5-6 small tiles wide
  • Toutes les mosaïques d’un tableau de bord doivent avoir des titres/sous-titres appropriésAll dashboard tiles should have appropriate titles/subtitles
  • Considérez les regroupements dans le tableau de bord pour différents scénarios, verticalement ou horizontalementConsider groupings in the dashboard for different scenarios, either vertically or horizontally

Résumé des restrictionsSummary of restrictions

Comme indiqué dans les sections ci-dessus, seuls les packs de contenu de modèle disposent d’un ensemble de restrictions :As listed in the above sections, currently the template content packs have a set of restrictions:

Pris en chargeSupported Non pris en chargeNot Supported
Jeux de données intégrés à PBI DesktopDatasets built in PBI Desktop Jeux de données d’autres packs de contenu ou entrées comme les fichiers ExcelDatasets from other content packs or inputs such as Excel files
Source de données prise en charge pour l’actualisation planifiée des données sur cloudData source supported for cloud Scheduled Data refresh Requêtes directes et connectivité locale non prises en chargeDirect query or on-prem connecitivty is not supported
Requêtes renvoyant un schéma cohérent ou des erreurs, le cas échéantQueries returning consistent schema or errors where appropriate Schémas dynamiques ou personnalisésDynamic or custom schemas
Une source de données par jeu de donnéesOne data source per dataset Sources de données multiples, dont les mashup et URL détectées comme sources de données multiplesMultiple data sources such as mashups or URLs that are detected as mutliple data sources
Paramètres de type texteParameters of type text Autres types de paramètres (dont la date) ou « liste de valeurs autorisées »Other parameter types (such as date) or "list allowed of values"
Un tableau de bord, rapport ou jeu de donnéesOne dashboard, report and dataset Plusieurs tableaux de bord, rapports ou jeux de donnéesMultiple dashboards, reports or datasets

Étape suivanteNext step

Test et envoi du pack de contenuContent Pack Testing and Submission