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 des éditeurs de texte : les fichiers PBIP sont des fichiers texte formatés contenant des métadonnées de modèle sémantique et de rapport. 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.

• Transparence de la structure des dossiers - Séparez les dossiers pour le modèle sémantique et le rapport, ce qui permet des tâches puissantes et simples, telles que la copie de tables de modèles sémantiques entre des projets ou la réutilisation de pages de rapport. Un excellent choix pour créer et réutiliser des modèles de développement.

• Contrôle de code source prêt : ouvrez des fichiers texte, conçus pour une intégration transparente avec Git, en activant l’historique des versions et la collaboration d’équipe. Pour plus d’informations, consultez Contrôle de version dans Git.

• Prise en charge de l’intégration continue et de la livraison continue (CI/CD) : appliquez des pratiques CI/CD sur vos systèmes de contrôle de code source existants à l’aide de fichiers PBIP, incorporant des portes de qualité et automatisant le déploiement dans les environnements de production. Pour en savoir plus sur CI/CD dans Fabric, consultez flux de travail CI/CD Fabric.

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

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 si vous avez ouvert un fichier Power BI Desktop existant (pbix), vous pouvez enregistrer votre travail en tant que fichier 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 :

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

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/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

Accéder aux fichiers

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.

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 TMDL dans le dossier /definition à l’aide de VS Code ou d’un autre outil externe.

Toutes les métadonnées de modèle sémantique sont accessibles en lecture. Les opérations d’écriture sont entièrement prises en charge, cependant, sachez que la modification des métadonnées en dehors de Power BI Desktop peut entraîner un comportement inattendu ou, dans de rares cas, entraîner des incohérences dans le modèle. Soyez prudent lorsque vous apportez des modifications par le biais d’outils externes.

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.

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

• Si la fonctionnalité date/heure automatique est activée pour le modèle sémantique et que vous créez une colonne datetime en dehors de Power BI Desktop, la table de dates locale n’est pas générée automatiquement.

• Les modèles sémantiques, tels que les modèles composites ou Direct Lake , peuvent inclure des objets et des propriétés provenant d’autres modèles ou sources de données. Lors de la personnalisation de ces propriétés ou de la suppression d’objets synchronisés, Power BI nécessite la définition de la changedProperties propriété et de l’annotation PBI_RemovedChildren . Ces indicateurs marquent les modifications en tant que personnalisations utilisateur, ce qui garantit qu’elles sont conservées lors de la prochaine synchronisation de schéma avec la source de données. Pour plus d'informations, consultez balises de lignée pour les modèles sémantiques Power BI.

• Toutes les modifications d’expression en dehors de Power BI Desktop dans un projet avec unappliedChanges.json sont perdues lorsque ces modifications sont appliquées.

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 référentiel Git json-schemas.

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 d’un PBIP, sachez que la longueur maximale du chemin d’accès pour les fichiers projet est limitée à 260 caractères par défaut sur Windows. Étant donné que les fichiers PBIP sont stockés en tant que sous-dossiers et fichiers, les noms d’objets longs tels que les noms de tables peuvent entraîner la longueur totale du chemin d’accès au-delà de cette limite, ce qui entraîne des erreurs pendant les opérations d’enregistrement. Pour atténuer ce risque, utilisez un chemin de dossier court comme emplacement racine de votre PBIP.
• 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 synchronisation de fichiers, ce qui peut entraîner l’é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.
• Le schéma linguistique de rapport (synonymes de page de rapport) 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.
• Il n’est pas possible d’obtenir et de définir des membres de rôle de sécurité au niveau des lignes à l’aide de l’API REST Fabric
• Il n’est pas possible d’obtenir et de définir des partitions d’actualisation incrémentielle à l’aide de l’API REST Fabric. Toutefois, il exporte une seule partition à l’aide de la requête définie dans la stratégie d’actualisation.

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