Projets Power BI Desktop (PRÉVERSION)

Power BI Desktop introduit une nouvelle façon de créer et d’enregistrer vos projets et de collaborer dessus. Lorsque vous enregistrez votre travail en tant que Projet Power BI (PBIP), les définitions d’élément des rapports et des modèles sémantiques sont enregistrées sous forme de fichiers individuels en texte brut dans une structure de dossiers simple et intuitive.

L’enregistrement de votre travail en tant que projet a les avantages suivants :

• Prise en charge de l’éditeur de texte : les fichiers de définition d’élément sont des fichiers de texte mis en forme contenant les métadonnées des modèles sémantiques et des rapports. Ces fichiers sont documentés publiquement et peuvent être lus par l’homme. Bien que les fichiers de projet prennent en charge des outils d’édition de texte simples comme le Bloc-notes, il est préférable d’utiliser un éditeur de code comme Visual Studio Code (VS Code), qui offre une expérience d’édition riche, avec notamment des fonctions d’IntelliSense, de validation et d’intégration de Git.

• Génération programmatique et modification des définitions d’éléments : par programmation, vous pouvez générer et modifier des fichiers texte de définition d’élément, ce qui permet de mettre à jour tous les visuels de pages de rapport ou d’ajouter un ensemble de mesures à chaque table. Pour les modèles sémantiques, vous pouvez utiliser la bibliothèque cliente Modèle objet tabulaire (TOM) pour désérialiser les métadonnées du modèle sémantique, apporter des modifications programmatiques et le sérialiser dans les fichiers.

• Contrôle de code source : les définitions d’élément des modèles sémantiques et des rapports Power BI peuvent être stockées dans un système de contrôle de code source, comme Git. Avec Git, vous pouvez suivre l’historique des versions, comparer les révisions (diff) et revenir aux versions précédentes. Le contrôle de code source peut également débloquer la collaboration lors de l’utilisation de Power BI Desktop en utilisant des mécanismes de collaboration familiers pour résoudre les conflits (fusion) et examiner les modifications (demandes de tirage). Pour plus d’informations, consultez Contrôle de version dans Git.

• Intégration continue et livraison continue (CI/CD) : vous pouvez utiliser des systèmes dans lesquels les développeurs de votre organisation soumettent une proposition de modification au système CI/CD. Le système valide ensuite la modification avec une série de contrôles de qualité avant de l’appliquer au système de production. Ces barrières de qualité peuvent inclure des évaluations de code par d’autres développeurs, des tests automatisés et une construction automatisée pour valider l’intégrité des modifications. Les systèmes CI/CD sont généralement basés sur des systèmes de contrôle de code source existants. Pour plus d’informations, consultez DevOps : Intégration continue et DevOps : Livraison continue.

Activer les fonctionnalités en préversion

L’enregistrement en tant que projet Power BI dans Power BI Desktop est actuellement en préversion, et vous devez l’activer dans les Fonctionnalités en préversion.

Accédez à Fichier > Options et paramètres > Options > Fonctionnalités en préversion, et cochez la case à côté de l’option d’enregistrement en tant que projet Power BI (.pbip).

Enregistrer en tant que projet

Si vous travaillez sur un nouveau projet ou que vous avez ouvert un fichier Power BI Desktop ( pbix ) existant, vous pouvez enregistrer votre travail en tant que fichier de projet Power BI (pbip) :

Quand vous enregistrez en tant que projet, Power BI Desktop enregistre les éléments des rapports et des modèles sémantiques dans des dossiers, chacun contenant des fichiers texte qui définissent l’élément :

Quand vous enregistrez votre travail en tant que projet, la barre de titre indique que vous travaillez sur un projet :

Si vous sélectionnez la barre de titre, un menu volant propre au projet Power BI s’affiche. Ce menu volant vous permet de localiser les fichiers du projet ainsi que les paramètres de nom d’affichage pour le rapport et le modèle sémantique. Vous pouvez également ouvrir le dossier dans l’Explorateur de fichiers en cliquant sur les chemins.

Examinons de plus près ce que vous voyez dans le dossier racine de votre projet :

<nom projet>.SemanticModel

Collection de fichiers et de dossiers qui représentent un modèle sémantique Power BI. Pour en savoir plus sur les fichiers, les sous-dossiers et les fichiers contenus dans ce dossier, consultez Dossier de modèle sémantique de projet.

<nom du projet>.Report

Collection de fichiers et dossiers qui représentent un jeu de données Power BI. Pour en savoir plus sur les fichiers, les sous-dossiers et les fichiers contenus dans ce dossier, consultez Dossier de rapport de projet.

.gitIgnore

Spécifie intentionnellement les fichiers non suivis que Git doit ignorer pour les fichiers de projet Power BI, comme cache.abf et localSettings.json.

Power BI Desktop crée le fichier .gitignore uniquement s’il n’existe pas déjà dans le dossier d’enregistrement choisi ou le dépôt Git parent.

Contenu par défaut du fichier .gitignore lors de l’enregistrement en tant que PBIP :

**/.pbi/localSettings.json
**/.pbi/cache.abf

<nom du projet>.pbip

Le fichier PBIP contient un pointeur vers un dossier de rapport. L’ouverture d’un PBIP permet d’ouvrir le rapport et le modèle ciblés pour la création.

Pour plus d’informations, consultez le document sur le schéma pbip.

Ouvrir un projet Power BI

Vous pouvez ouvrir Power BI Desktop à partir du dossier de projet Power BI en ouvrant le fichier pbip ou le fichier pbir dans le dossier de rapport. Les deux options ouvrent le rapport pour modification, et le modèle sémantique s’il existe une référence relative à un modèle sémantique.

Vous pouvez enregistrer plusieurs rapports et modèles sémantiques dans le même dossier. Vous n’avez pas besoin d’avoir un fichier pbip distinct pour chaque rapport, car vous pouvez ouvrir chaque rapport directement à partir du fichier .pbir dans le dossier de rapport.

├── project
│   ├── AdventureWorks-Sales.Report
│   │   └── definition.pbir
│   ├── AdventureWorks-Stocks.Report
│   │   └── definition.pbir
│   ├── AdventureWorks.SemanticModel
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

Changements en dehors de Power BI Desktop

Une fois ces éléments enregistrés en tant que projet, vous n’êtes pas obligé d’utiliser uniquement Power BI Desktop pour changer vos définitions de modèle sémantique et de rapport. Vous pouvez utiliser d’autres outils comme VS Code, des outils de la communauté open source comme l’éditeur tabulaire ou même le Bloc-notes. Toutefois, tous les fichiers ou modifications ne prennent pas en charge la modification par des outils open source externes.

Les modifications apportées aux fichiers ou aux propriétés en dehors de Power BI Desktop peuvent provoquer des erreurs inattendues ou même empêcher l’ouverture de Power BI Desktop. Dans ces cas, vous devez résoudre les problèmes dans les fichiers avant d’essayer d’ouvrir à nouveau le projet dans Power BI Desktop.

Si possible, Power BI Desktop indique le fichier et l’emplacement de l’erreur :

Les détails du schéma pour les fichiers suivants ne sont pas documentés. Durant la préversion, les changements effectués sur ces fichiers en dehors de Power BI Desktop ne sont pas pris en charge :

• Report\
  • report.json
  • mobileState.json
  • semanticModelDiagramLayout.json
• SemanticModel\
  • diagramLayout.json

Déployer sur l’espace de travail Fabric

Lorsque vous utilisez des fichiers projet Power BI, vous pouvez déployer votre contenu sur un espace de travail Fabric à l’aide des mécanismes de publication suivants :

• Utilisez l’intégration Git Fabric.
• Utiliser les API Fabric.
• Utiliser l’option Publier depuis Power BI Desktop.

Création de modèle

Vous pouvez changer la définition du modèle sémantique en utilisant des outils externes de deux manières :

• En vous connectant à l’instance Analysis Service (AS) de Power BI Desktop avec des outils externes.
• En modifiant les métadonnées JSON dans le fichier model.bim à l’aide de VS Code ou d’un autre outil externe.

Les objets de modèle ne prennent pas tous en charge les opérations d’écriture. L’application de changements en dehors de celles prises en charge peut entraîner des résultats inattendus.

Objets qui prennent en charge les opérations d’écriture :

N’oubliez pas :

• Tout changement effectué dans des fichiers ouverts en dehors de Power BI Desktop nécessite un redémarrage pour que le changement s’affiche dans Power BI Desktop. Power BI Desktop ne peut pas identifier les modifications apportées aux fichiers de projet par d’autres outils.

• Power BI Desktop ne prend pas en charge les tableaux comportant plusieurs partitions. Seule une partition unique pour chaque table est prise en charge. La création de tables avec des partitions vides ou plus d’une partition entraîne une erreur lors de l’ouverture du rapport.

• Les tables de dates automatiques créées par Power BI Desktop ne doivent pas être changées avec des outils externes.

• Quand vous changez un modèle qui utilise Direct Query pour se connecter un modèle sémantique Power BI ou un modèle Analysis Services, vous devez mettre à jour les collections ChangedProperties et PBI_RemovedChildren pour l’objet modifié afin d’y inclure les propriétés modifiées ou supprimées. Si ChangedProperties et/ou PBI_RemovedChildren ne sont pas mis à jour, Power BI Desktop risque de remplacer les changements la prochaine fois que la requête est modifiée ou que le modèle est actualisé dans Power BI Desktop.

• 1 : le changement du type de données d’une colonne est pris en charge. Toutefois, le renommage des colonnes n’est pas pris en charge quand vous êtes connecté à l’instance AS.

• 2 : si le modèle sémantique a la fonctionnalité Date/heure automatique activée et que vous créez une colonne DateHeure en dehors de Power BI Desktop, la table de dates locale n’est pas générée automatiquement.

• 3 : la partition SourceType doit être Calculated, M, Entity ou CalculationGroup. Le mode de partition doit être Import, DirectQuery ou Dual.

• 4 : toutes les modifications d’expression en dehors de Power BI Desktop dans un projet avec unappliedChanges.json sont perdues lorsque ces changements sont appliqués.

• La modification d’expressions de requête de table en dehors de Power BI Desktop entraîne la suppression des données de la table lors du redémarrage de Power BI Desktop.

Schémas de fichier JSON

La plupart des fichiers de projet contiennent des métadonnées au format JSON. Les schémas JSON correspondants peuvent être utilisés pour la validation et la documentation.

Avec les schémas JSON, vous pouvez :

• En savoir plus sur les propriétés configurables.
• Utiliser la validation JSON en ligne fournie par l’éditeur de code.
• Améliorer la création grâce à la mise en surbrillance de la syntaxe, aux infobulles et à l’autocomplétion.
• Utiliser des outils externes en connaissant les propriétés prises en charge dans les métadonnées du projet.

Utiliser VS Code pour faire correspondre les schémas JSON aux fichiers en cours de création. Les schémas JSON pour les fichiers projet sont fournis dans le dépôt Git d’exemples Power BI Desktop.

Considérations et limitations

• Power BI Desktop ne peut pas identifier les changements effectués avec d’autres outils ou applications. Les modifications apportées à l’aide d’outils externes nécessitent le redémarrage de Power BI Desktop avant d’être affichées.
• Les étiquettes de confidentialité ne sont pas prises en charge avec les projets Power BI.
• La vue Diagramme est ignorée pendant la modification de modèles dans le service.
• Lors de l’enregistrement en tant que projet Power BI, la longueur maximale du chemin des fichiers du projet est de 260 caractères.
• Dans Power BI Desktop, vous ne pouvez pas enregistrer au format PBIP directement dans OneDrive et SharePoint. Vous pouvez utiliser enregistrer sous pour enregistrer des fichiers dans un dossier OneDrive synchronisé localement ; Toutefois, cela peut entraîner des problèmes de verrouillage de fichier, ce qui peut entraîner un échec des opérations d’enregistrement dans Power BI Desktop.
• Lors de la modification de fichiers PBIP en dehors de Power BI Desktop, vous devez les enregistrer au format UTF-8 sans encodage BOM.
• Report Linguistic Schema n’est pas pris en charge avec les projets Power BI.
• Power BI Desktop utilise CRLF comme fin de ligne. Pour éviter les problèmes dans vos diffs, configurez Git pour gérer les fins de ligne en activant autocrlf.
• Projets Power BI n’est actuellement pas pris en charge dans la version de Microsoft Power BI Desktop optimisée pour Power BI Report Server.

Forum Aux Questions

Question : Dans les définitions de dossier d’éléments de modèles sémantiques et de rapports, seuls quelques fichiers sont marqués comme étant obligatoires. Que se passe-t-il si je les supprime ?

Réponse : Power BI Desktop les crée automatiquement lorsque vous enregistrez en tant que projet (PBIP).

Question : Power BI Desktop peut-il identifier les changements effectués dans les fichiers de projet Power BI à partir d’un outil ou d’une application externe ?

Réponse : Non. Tout changement dans les fichiers nécessite que Power BI Desktop soit redémarré pour refléter ce changement.

Question : Si je convertis un PBIX en PBIP, puis-je le reconvertir en PBIX ?

Réponse : Oui. Vous pouvez enregistrer un PBIX en tant que PBIP ou un PBIP en tant que PBIX.

Question : Puis-je convertir PBIX en PBIP et vice versa programmatiquement ?

Réponse : Non. Vous pouvez convertir un PBIX en PBIP et vice-versa uniquement en utilisant Fichier>Enregistrer sous dans Power BI Desktop.

Question : Puis-je déployer un projet Power BI Desktop sur Azure Analysis Services (AAS) ou SQL Server Analysis Services (SSAS) ?

Réponse : Non. Les définitions de rapport de projet de Power BI Desktop ne sont pas prises en charge dans AAS et SSAS. De plus, les définitions de modèles utilisent des métadonnées améliorées propres à Power BI. Pour les projets AAS et SSAS, utilisez Microsoft Visual Studio pour la création de modèles, Git et l’intégration Azure DevOps.

Question : Pourquoi n’y a-t-il pas de fichier *.pbip quand je connecte mon espace de travail Fabric à Git ? Comment puis-je modifier mon rapport et mon modèle sémantique dans Power BI Desktop ?

Réponse : le fichier PBIP est facultatif et sert simplement de raccourci vers le dossier du rapport. Vous pouvez ouvrir le rapport et le modèle sémantique pour les modifier dans Power BI Desktop en ouvrant le fichier definition.pbir situé dans le dossier du rapport.

Contenu associé

• Dossier de modèle sémantique de projet Power BI Desktop
• Dossier de rapport de projet Power BI Desktop
• intégration de Git aux projets Power BI Desktop
• Intégration d’Azure DevOps et des projets Power BI Desktop
• Outils externes dans Power BI Desktop