Configuration de l’intégration de Git Dataverse

L’intégration Git est initiée à partir de Power Platform dans la zone Solutions dans Power Apps, Copilot Studio, Power Automate et Power Pages. Cet article traite de la connexion d’environnements et de solutions à un référentiel Git Azure DevOps.

Au fur et à mesure que l’équipe se développe, les personnalisations au sein d’un environnement peuvent être validées dans Git et les modifications apportées dans Git peuvent être extraites dans des environnements connectés.

Conditions préalables à l’intégration de Git avec Dataverse

• L’intégration de Dataverse Git est une fonctionnalité des Environnements gérés. Les environnements de développement et cibles doivent être activés en tant qu’environnements gérés.

• Un abonnement Azure DevOps et des licences pour les utilisateurs qui interagissent avec le contrôle de code source sont requis lors de la connexion de votre environnement Dataverse à Git.

  Note

  Un nombre limité de licences est disponible dans Azure DevOps dans le plan de base du service. Accédez aux Services Azure DevOps pour plus d’informations sur les licences et la tarification pour Azure DevOps.

• L’autorisation Azure DevOps Services pour effectuer des validations et lire les fichiers sources est requise. Les membres du groupe de sécurité Contributeurs ont l’autorisation.

• Un environnement Power Platform avec Dataverse et le rôle de sécurité Administrateur système est requis pour se connecter à Git, ce qui termine la liaison initiale de votre environnement ou de votre solution à un projet dans Azure DevOps.

Configuration d’Azure DevOps

Pour démarrer, vous avez besoin d’un projet et d’un référentiel Azure DevOps pour connecter votre environnement Dataverse. Si vous n’avez pas configuré de projet et de référentiel Azure DevOps, procédez comme suit pour créer un projet et un référentiel dans Azure DevOps.

1. Connectez-vous à Azure DevOps et sélectionnez votre organisation.
2. Sélectionnez Nouveau projet, entrez un nom et assurez-vous que votre contrôle de version est défini sur Git pour votre projet, puis sélectionnez Créer.
3. Dans le nouveau projet, sélectionnez Référentiels, puis sélectionnez Initialiser en bas de la page pour initialiser le référentiel par défaut.

Assurez-vous que tous les utilisateurs qui apportent des modifications dans votre environnement ont accès à votre référentiel et peuvent valider les modifications. Passez en revue votre configuration de licences et vos groupes de sécurité Azure DevOps pour vous assurer qu’ils peuvent utiliser le panneau de contrôle de code source de la solution.

Se connecter à Git

La connexion à Git lie les solutions de votre environnement à un emplacement et à une branche spécifiques dans le référentiel Azure DevOps. Vous pouvez lier votre environnement à un projet à l’aide d’une liaison d’environnement ou de solution. Pour en savoir plus sur les différences entre la liaison d’environnement et la liaison de solution, accédez à Comment choisir entre la liaison d’environnement et la liaison de solution.

1. Activez tous les environnements de développement et cibles en tant qu’environnements gérés dans le centre d’administration Power Platform.

2. Connectez-vous à Power Apps (ou Copilot Studio, Power Automate, Power Pages), puis accédez à Solutions.

3. Sur la page Solutions ou sur la page Contrôle de code source dans une solution personnalisée non gérée, sélectionnez Se connecter à Git.

4. Sélectionnez Environnement ou Solution depuis les options du type de connexion, et sélectionnez votre organisation et votre projet Azure DevOps. Pour plus d’informations sur les différences entre la liaison d’environnement et la liaison de solution, accédez à Comment choisir entre la liaison d’environnement et la liaison de solution.

5. En fonction de votre type de liaison, vous pouvez sélectionner un projet, un référentiel ou une branche et entrer un dossier auquel lier l’environnement ou la solution.

6. En option, créez une branche.

7. Sélectionnez Se connecter.

   Note

   Par conception, la solution par défaut et la solution par défaut Common Data Service ne peuvent pas être connectées à Git. Utilisez une solution personnalisée pour le développement d’applications et de solutions.

Comment choisir entre la liaison d’environnement et la liaison de solution

Si vous ne savez pas quelle stratégie de liaison utiliser, la liaison d’environnement est l’approche recommandée pour commencer à intégrer Git dans Dataverse. Voici quelques différences clés entre la liaison d’environnement et la liaison de solution pour vous aider à choisir l’approche qui vous convient le mieux.

Liaison d’environnement

La liaison d’environnement est un processus unique permettant de lier l’ensemble de votre environnement Dataverse et toutes les solutions et tous les objets non gérés de l’environnement dans un référentiel et un dossier uniques. Lorsque vous choisissez de lier l’ensemble de l’environnement, toutes les personnalisations non gérées effectuées dans toute solution personnalisée non gérée sont stockées dans un seul dossier et une seule branche Git, et vous n’avez pas besoin de configurer d’autres solutions une fois sélectionnées. Le système permet à plusieurs solutions d’utiliser un seul emplacement de dossier racine et garde une trace des objets appartenant à chaque solution dans un fichier séparé. Il n’est plus nécessaire d’utiliser un dossier racine unique pour chaque solution. Si vous utilisez la liaison d’environnement, vous pouvez sélectionner le référentiel, la branche et le dossier auxquels lier l’environnement lors de la configuration initiale.

Liaison de solution

La liaison de solution peut être utilisée pour la gestion de version de plusieurs solutions au sein du même environnement afin de séparer les référentiels ou les dossiers. La liaison de solution offre une flexibilité supplémentaire dans l’organisation de vos fichiers sources, mais nécessite plus de gestion de la part des créateurs pour intégrer de nouvelles solutions au contrôle de code source. Le système exige qu’il n’y ait qu’un seul emplacement dans le contrôle de code source pour chaque objet de solution, ce qui signifie que si vous choisissez de lier des solutions à différents emplacements source, le système ne vous permet pas d’avoir le même objet dans plusieurs solutions. La liaison de solution ne nécessite pas la sélection d’un référentiel ou d’une solution lors de la configuration initiale. Au lieu de cela, vous sélectionnez le référentiel et le dossier auxquels lier chaque solution lorsque vous êtes prêt à lier la solution au contrôle de code source.

Autres considérations

Si vous sélectionnez la liaison d’environnement, toutes les nouvelles solutions non gérées sont automatiquement synchronisées avec le code source sans autre action, et si vous sélectionnez par liaison de solution, la création ultérieure d’une solution nécessite que la solution soit également configurée pour le contrôle de code source avant d’être synchronisée avec le contrôle de code source. Pensez à la sécurité de la synchronisation de toutes les solutions par rapport à la flexibilité d’avoir différents dossiers et liens de code source pour chaque solution.

Liaison d’une solution à un référentiel et à un dossier (lors de l’utilisation de la stratégie de liaison de solution)

Une fois que vous avez connecté votre environnement à Git à l’aide de la stratégie de liaison de solution, vous pouvez lier une solution à un référentiel et à un dossier dans le même projet Azure DevOps.

1. Dans la zone Solutions, sélectionnez les trois points verticaux en regard de la solution que vous souhaitez associer à la gestion de versions, puis sélectionnez Connecter à Git.
2. Sélectionnez une branche existante ou créez-en une, entrez un dossier Git auquel lier la solution, puis sélectionnez Connecter.

Valider votre connexion

Pour valider votre connexion à Git, créez une solution ou apportez des modifications à une solution existante et affichez les modifications en procédant comme suit :

1. Sur la page Solutions, ouvrez la solution dans laquelle vous souhaitez afficher les modifications.
2. Dans le volet de gauche, sélectionnez Contrôle de code source pour afficher les modifications apportées à la solution.

Vous pouvez maintenant afficher les modifications apportées à la solution et valider et pousser les modifications vers le référentiel, ainsi qu’afficher la branche actuelle à laquelle votre solution est liée.

Déconnecter de Git

Les environnements et les solutions peuvent être déconnectés, puis reconnectés à différents emplacements Git. Avec la liaison d’environnement ou de solution, toutes les solutions peuvent être déconnectées. Avec la liaison de solution, vous pouvez également déconnecter une solution spécifique.

Déconnecter toutes les solutions

1. Sur la page Solutions, sélectionnez Connexion à Git (liaison d’environnement) ou Se connecter à Git.
2. Sélectionnez Déconnecter toutes les solutions de Git.
3. Sélectionnez Continuer sur la boîte de dialogue de confirmation.

Déconnecter une solution spécifique

1. Sur la page Solutions ou Contrôle de code source, sélectionnez Connexion Git.
2. Sélectionnez Déconnecter la solution de Git.
3. Sélectionnez Continuer sur la boîte de dialogue de confirmation.

Connecter plusieurs environnements de développement à Git

Plusieurs environnements de développement peuvent être connectés au même emplacement Git. Cette fonctionnalité offre une isolation des développeurs avec la possibilité d’envoyer rapidement vos modifications vers Git et d’extraire les modifications des autres dans votre environnement.

Important

Chaque environnement doit être connecté avec le même type de liaison, le même référentiel, la même branche et le même dossier Git.

1. Exportez les solutions souhaitées en tant que solutions non gérées à partir de l’environnement de développement d’origine, puis importez-les dans le second environnement.
2. Vous pouvez également créer une solution dans le second environnement avec le même nom et le même éditeur.
3. Dans les autres environnements, répétez les étapes de Se connecter à Git décrites précédemment. Utilisez le même type de connexion (liaison), organisation, projet, référentiel, branche et dossier Git.

Vous pouvez désormais synchroniser les modifications dans plusieurs environnements.

Étapes suivantes

Une fois vos environnements et solutions connectés à Git, vous pouvez commencer à apporter des modifications à vos solutions et à valider ces modifications dans le référentiel. Pour plus d’informations sur les opérations de contrôle de code source, accédez aux opérations de référentiel de contrôle de code source.