• Enregistrer un rapport en projet Power BI (PBIP) ; créer un dépôt Git et lire une différence dans Visual Studio Code ; connecter un espace de travail Fabric à Git ; organiser le travail en branches et choisir une méthode de mise en production.
• Prérequis : page Les formats de fichiers : PBIX, PBIT, PBIP, PBIR, TMDL (partie 0) ; Git et Visual Studio Code installés.
• Licence requise : aucune pour Git sur le poste ; espace de travail sur une capacité Fabric (F), Premium ou Premium par utilisateur pour l'intégration Git.

PBIP_PBIR_TMDL_et_Git▶ Présenter

123456789101112

• Projet Power BI (PBIP) : le rapport est enregistré au format PBIR (un fichier JSON par page, visuel et signet), le modèle au format TMDL (un fichier par table, rôle, culture).
• Dépôt Git local : sur le poste, il enregistre l'historique des validations.
• Dépôt distant : Azure DevOps (Azure Repos) ou GitHub, référence partagée de l'équipe.
• Intégration Git de l'espace de travail : un espace de travail Fabric est relié à une branche et à un dossier du dépôt et se synchronise dans les deux sens.
• Pipelines de déploiement : promotion du contenu de l'espace de développement vers le test puis la production.

Ventes/
├── Ventes.Report/            # définition du rapport (PBIR)
├── Ventes.SemanticModel/     # définition du modèle (dossier definition en TMDL)
├── .gitignore
└── Ventes.pbip

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

1. Dans Power BI Desktop, Fichier > Enregistrer sous > type Projet Power BI (*.pbip), dans un dossier dédié au chemin court.

2. Dans VS Code, Fichier > Ouvrir le dossier, puis volet Contrôle de code source > Initialiser le dépôt. Saisissez un message (Version initiale du rapport Ventes) et Validez.

3. Publiez la branche : VS Code propose de créer le dépôt sur GitHub ; pour Azure DevOps, créez d'abord le dépôt dans Repos > Files, puis Clone > Clone in VS Code.

cd C:\Projets\Ventes
git init
git add .
git commit -m "Version initiale du rapport Ventes"
git remote add origin https://dev.azure.com/<organisation>/<projet>/_git/<depot>
git push -u origin main

4. Modifiez une mesure dans Desktop et enregistrez : VS Code signale definition/tables/Ventes.tmdl. Un clic affiche la comparaison ligne à ligne ; l'extension Git Graph visualise l'historique.

• Ouvrez le dépôt sur GitHub : la page Quick setup s'affiche.
• Cliquez sur creating a new file (ou Add file > Create new file).
• Nommez le fichier README.md, saisissez une ligne de texte, puis Commit changes : cette première validation crée la branche main. Source
• Dans Fabric, fermez puis rouvrez Paramètres de l'espace de travail > Intégration Git : main apparaît dans la liste Branche.
• Pour créer d'autres branches : sur GitHub, menu des branches au-dessus de la liste des fichiers > saisir le nom > Create branch ... from main (GitHub Docs : Source) ; ou dans Fabric, liste Branche > + Nouvelle branche, possible dès que main existe (Microsoft Learn : Source).
• Si main n'apparaît toujours pas, vérifiez que le jeton d'accès personnel a l'autorisation Contents : Read and write sur ce dépôt.

1. Paramètres de l'espace de travail > Intégration Git : choisissez le fournisseur, renseignez l'organisation, le projet, le dépôt, la branche et le dossier, puis Connecter et synchroniser. À la première synchronisation, le contenu est copié du côté non vide vers le côté vide.
2. Au quotidien, le volet Contrôle de code source de l'espace de travail affiche les éléments Non validé, Mise à jour requise ou en Conflit :

1. Créer feature/mesures-marge depuis main.
2. Faire des validations petites et fréquentes, avec un message « verbe + objet » (Ajoute la mesure Marge %).
3. Mettre régulièrement sa branche à jour depuis main.
4. Ouvrir une demande de tirage (pull request) vers main ; le référent relit les différences et approuve.
5. Dans l'espace de travail d'équipe connecté à main, Mettre à jour.

• Un espace de travail n'est connecté qu'à une seule branche à la fois.
• Fermez Power BI Desktop avant de modifier les fichiers avec un autre outil : il ne détecte pas les modifications externes.
• N'enregistrez pas un projet dans un dossier OneDrive ou SharePoint synchronisé ; utilisez un dossier local versionné.
• Les fichiers sont en UTF-8 sans BOM et Desktop écrit des fins de ligne CRLF : configurez core.autocrlf pour éviter des différences parasites.
• Évitez les images lourdes dans le rapport.
• Conflit : choisissez la version de l'espace de travail ou celle de Git dans l'interface, ou résolvez dans Git puis mettez à jour l'espace.
• Retour arrière : Annuler pour ce qui n'est pas validé ; git revert <commit> pour une validation, puis Mettre à jour l'espace et actualiser le modèle.
• Une demande de tirage peut déclencher un pipeline Azure DevOps qui contrôle le modèle (Best Practice Analyzer de Tabular Editor) et le rapport (PBI Inspector).

• PBIP = rapport en PBIR + modèle en TMDL, en fichiers texte comparables.
• Les données (cache.abf) ne vont jamais dans Git.
• L'intégration Git relie un espace de travail Fabric à une branche, dans les deux sens.
• Une branche par évolution, une demande de tirage pour fusionner, un pipeline pour déployer.

• Projets Power BI Desktop (PBIP). Source
• Intégration Git des projets Power BI. Source
• Prise en main de l'intégration Git. Source
• Gérer les branches. Source
• Bonnes pratiques CI/CD dans Fabric. Source
• Tutoriel de bout en bout : Git et pipelines de déploiement. Source

1. Enregistrez le fichier du fil rouge en PBIP, ouvrez le dossier dans VS Code, initialisez le dépôt et validez la version initiale.
2. Ajoutez une mesure dans Desktop, enregistrez, observez la différence dans VS Code, validez.
3. Créez une branche feature/page-synthese, modifiez une page, validez, revenez sur main et rouvrez le PBIP pour constater que la page n'a pas changé.
4. Fusionnez la branche dans main.
5. Avec une capacité Fabric (l'essai suffit) : connectez un espace de travail à main, modifiez un visuel dans le service, Validez, puis récupérez la modification avec git pull.
6. Annulez la dernière validation avec git revert et Mettez à jour l'espace de travail.