Gestion des projets avec GIT

L'intégration de GIT dans Studio nécessite Microsoft  Visual C++ Redistributable pour Visual Studio 2015, 2017, 2019 et 2022. Consultez la page Prérequis logiciels.

Authentification auprès de GIT

Les méthodes d'authentification dans Studio diffèrent selon les méthodes utilisées pour cloner un référentiel GIT, HTTPS ou SSH. Consultez cette page pour voir lequel vous devez utiliser si vous travaillez avec GitHub.

Remarque :

• Les informations d’identification GIT que vous fournissez dans Studio sont stockées dans le gestionnaire des informations d’identification Windows.
• L'intégration GIT à Studio prend actuellement en charge l'authentification à deux facteurs seulement pour GitHub lorsque vous vous authentifiez en vous connectant au service. Pour les autres outils, utilisez la méthode d'authentification unique (SSO) avec un jeton personnel ou la méthode d'authentification d'accès de base.

Le guide actuel détaille les étapes d'authentification auprès d'un référentiel GitHub, mais l'intégration de Git dans Studio ne se limite pas à ce seul service.

Sur HTTPS

Lorsque vous clonez un référentiel GIT distant ou copiez le projet en cours dans un référentiel GIT existant à l'aide de HTTPS pour la première fois, vous devez fournir vos identifiants de GIT. Vous devez les entrer dans les champs Utiliser les identifiants (Use Credentials) :

Vous pouvez vous authentifier à l'aide des options suivantes :

• Se connecter avec GitHub - Connectez-vous via votre compte GitHub.
• Nom d'utilisateur/Mot de passe - Saisissez votre nom d'utilisateur et votre mot de passe.

• Jeton - Saisissez votre nom d'utilisateur et votre jeton d'accès personnel.

  Suivez les étapes détaillées sur cette page pour générer un jeton GIT pour votre référentiel GitHub.

  Attention: l'option Se connecter avec GitHub (Sign in with GitHub) est disponible uniquement pour les référentiels hébergés sur github.com et nécessite l'installation de l'application UiPath GitHub dans votre organisation ou votre compte.

Sur SSH

Lorsque vous clonez un référentiel ou copiez le projet en cours dans un référentiel GIT existant à l'aide de SSH pour la première fois, vous avez la possibilité d'utiliser une clé privée :

Ajoutez le chemin de clé privée et le mot de passe, puis cliquez sur Ouvrir pour cloner votre référentiel GIT distant. Consultez les étapes détaillées ici pour générer une clé SSH pour votre référentiel GitHub.

Échec de l'authentification

Sur HTTPS

Lors du clonage d'un référentiel GIT, la fenêtre Entrer les identifiants (Enter Credentials) s'affiche avec le message Échec de l'authentification (Authentication failed) si les informations d'identification fournies sont incorrectes :

Entrez les informations d'identification correctes et réessayez. Vous pouvez également utiliser Git Bash, par exemple, pour cloner votre dépôt à distance et ainsi vérifier si le nom d'utilisateur et/ou le mot de passe sont corrects.

Sur l’image suivante, nous avons essayé de cloner un référentiel sur HTTPS, mais avons entré un mot de passe incorrect. La fenêtre Git Bash signale que les informations d’identification n'étaient pas les bonnes.

Sur SSH

La fenêtre Saisir les informations d’identification suivante s’affiche lorsque l’authentification échoue sur SSH :

Entrez la clé privée et le mot de passe corrects et réessayez. Vous pouvez également utiliser Git Bash, par exemple, pour cloner votre dépôt à distance et ainsi vérifier si le jeton et/ou le mot de passe sont corrects.

Sur l’image suivante, nous avons essayé de cloner un référentiel sur SSH, mais n’avions pas de clés SSH publiques configurées sur notre compte.

Clonage d'un référentiel GIT distant

1. Dans l'onglet Équipe (Team), sélectionnez Cloner le référentiel (Clone Repository). La fenêtre Cloner un référentiel GIT distant (Clone a remote GIT repository) est affichée.
2. Sélectionnez Utiliser HTTPS (Use HTTPS) ou Utiliser SSH (Use SSH).
3. Entrez l'URL du référentiel (Repository URL) et choisissez un Répertoire d'extraction (Check out directory) vide.
4. Sélectionnez Utiliser les identifiants (Use Credentials) / Utiliser la clé (Use Key) et configurez l'authentification (connectez-vous via GitHub, entrez le nom d'utilisateur et le mot de passe, entrez le nome d'utilisateur et le jeton pour HTTPS, ou entrez le chemin d'accès à la clé privée et le mot de passe pour SSH).
5. Cliquez sur Ouvrir (Open), Studio ouvre le projet dans le panneau Concepteur (Designer).
6. Dans la fenêtre Ouvrir (Open), sélectionnez un fichier project.json à ouvrir dans Studio.

Après avoir cloné un référentiel GIT dans un répertoire de travail local, le sous-répertoire .git est créé et contient les métadonnées GIT nécessaires. Les métadonnées comprennent des sous-répertoires pour les objets, références et fichiers modèle. En outre, un fichier HEAD est également créé, qui désigne la validation actuellement extraite.

Ajout d'un projet à GIT

La fonctionnalité Init. de GIT (GIT Init) ajoute le projet actuel à un référentiel GIT local. Accédez à la commande de l'onglet Équipe (Team) ou à la barre d'état.

1. Créez ou ouvrez un projet dans Studio. Cliquez sur l'onglet Démarrer (Start) > Équipe (Team). L'onglet Équipe (Team) est affiché.

2. Cliquez sur le bouton Init. de GIT (GIT Init), puis sélectionnez un chemin d'accès où le référentiel doit être initialisé. L'emplacement peut être le même que le projet ou le dossier parent. La fenêtre Valider les modifications (Commit changes) s'ouvre.

   
   

   

   
   
3. La section Fichiers modifiés (Modified Files) affiche les fichiers du projet devant être ajoutés au référentiel Git. Décochez la case en regard de ceux que vous ne souhaitez pas ajouter ou utilisez Sélectionner tout (Select All), Ne rien sélectionner (Select None).

4. Cochez la case Afficher les fichiers sans version pour ajouter des fichiers sans version à la liste.

   Écrivez un Message de validation. Cliquez sur le bouton Valider pour valider les modifications dans le référentiel GIT local.

Lorsqu’un projet est ajouté à GIT, le menu contextuel du panneau Projet comprend des options spécifiques à GIT. Pour plus d’informations, voir Options de menu contextuel pour GIT.

Remarque : le dossier .local, qui contient des données mises en cache localement pour le projet, ne doit pas être ajouté à GIT.

Validation et transmission dans GIT

1. Dans la même fenêtre Valider les modifications (Commit Changes), cliquez sur le bouton Valider et transmettre (Commit and Push) pour valider les modifications et les transmettre au référentiel distant. Cette fenêtre Gérer les référentiels distants (Manage Remotes) est affichée. La fenêtre est également disponible depuis la barre d'état.

   
   

   

   
   
2. Dans la section Nom (Name), ajoutez le nom du référentiel distant.
3. Dans la section URL (URL), ajoutez l'URL distante.

Pour apporter des modifications aux référentiels ajoutés, il suffit de cliquer sur une entrée, de modifier le nom et l'URL, puis de cliquer sur le bouton Mettre à jour (Update). Lorsque vous avez terminé, cliquez sur Ajouter (Add), puis sur Enregistrer (Save). La boîte de message suivante s'ouvre. Cela implique que le référentiel local n'est pas synchronisé avec le distant.

• Cliquez sur le bouton Overwrite remote content (Remplacer le contenu du référentiel distant) pour transmettre les versions locales de fichiers au référentiel distant et remplacer les fichiers à cet emplacement.
• Cliquez sur le bouton Recevoir (rebaser) pour recevoir les fichiers distants et rebaser la branche actuelle.
• Cliquez sur le bouton Annuler (Cancel) pour ignorer toute l'opération.

Le nombre de modifications non poussées et les fichiers nouvellement ajoutés sont visibles dans la barre d'état. Cliquez sur l'icône pour ouvrir la fenêtre Valider les modifications, ou sur l'icône pour transmettre les changements.

Remarque : si vous modifiez un fichier depuis un projet ajouté au contrôle de code source d’un éditeur externe, votre modification sera visible dans le panneau Projet et dans la barre d’état uniquement après avoir cliqué sur Actualiser dans le panneau Projet.

Modification de la dernière validation

L'intégration de Studio à GIT est également fournie avec une option Modifier la validation (Amend Commit) pour modifier la dernière validation effectuée, avant que la transmission ne soit effectuée.

1. Cliquez avec le bouton droit sur un fichier modifié dans le panneau Projet (Project) et sélectionnez Valider (Commit). La fenêtre Valider les modifications (Commit Changes) est affichée.

   
   

   

   
   
2. Sélectionnez la case Modifier la validation. Le dernier message de validation s’affiche, ainsi que les fichiers validés. Pour afficher les modifications entre le fichier actuel et la dernière validation, utilisez l’option Afficher les modifications.
3. Modifiez le message de validation et sélectionnez les fichiers à inclure. Cliquez sur le bouton Valider et transmettre (Commit and Push) ou sur Valider (Commit).

Annulation des modifications en attente

Studio est fourni avec l'option d'annulation des modifications qui ont été apportées aux fichiers avec version, avant de les valider et de les transmettre au référentiel distant.

Après avoir effectué des modifications dans le fichier d'un référentiel local, cliquez sur Annuler (Undo) dans le menu contextuel de GIT pour ouvrir la fenêtre Annuler les modifications en attente (Undo Pending Changes).

Cochez la case en regard des fichiers et cliquez sur Annuler (Undo). Les fichiers sont désormais revenus à l'état avant que les modifications n'aient été effectuées.

Remarque : l'annulation ne couvre pas les fichiers non versionnés. Si vous créez des fichiers, puis sélectionnez Annuler (Undo), les fichiers ne sont pas supprimés du projet. Une fois ajoutés à l'arborescence du projet, les nouveaux fichiers y restent, sauf s'ils sont supprimés manuellement.

Copie d'un projet dans GIT

Le bouton Copier dans GIT (Copy to GIT) en mode Studio Backstage et dans la barre d'état permet de copier le projet actuel dans un référentiel GIT existant.

Pour ce faire, ouvrez ou créez d'abord un projet dans Studio. Dans l'onglet Équipe (Team), sélectionnez Copier dans GIT (Copy to GIT) et choisissez un dossier de référentiel GIT existant sur votre machine. Le projet est ajouté au référentiel GIT local et la boîte de message Copier dans GIT (Copy to GIT) s'ouvre.

• Sélectionnez Oui (Yes) pour ouvrir le projet depuis le nouvel emplacement. La fenêtre Valider les modifications (Commit changes) s'ouvre. Écrivez un Message de validation (Commit message) et cliquez sur Valider et transmettre (Commit and Push) ou simplement sur Valider (Commit).
• Sélectionnez Non (No) pour revenir à l'interface utilisateur de Studio.

Création et gestion de branches

Ajoutez et gérez les branches depuis la fenêtre Gérer les branches (Manage Branches). Pour y accéder, faites un clic droit sur le nœud du projet ou un fichier dans le panneau Projet (Project) et sélectionnez Gérer les branches (Manage Branches) ou utilisez le menu de branche dans la barre d’état.

• Pour ajouter une branche :

  1. Sélectionnez une branche dans la table, puis cliquez sur Plus en haut de la fenêtre.

  2. Entrez un nom pour la branche, cliquez sur Créer la branche depuis (Create branch from) branch_name, puis cliquez sur Enregistrer (Save).

     La branche est ajoutée à la liste.

• Pour actualiser la liste des branches, cliquez sur Actualiser (Refresh) en haut de la fenêtre.
• Pour supprimer une branche locale, sélectionnez-la, puis cliquez sur Supprimer (Delete) en haut de la fenêtre.

• Pour gérer les branches, faites un clic droit sur n’importe quelle branche et sélectionnez l’une des options du menu :

  • L'option Extraire la branche (Checkout branch) bascule vers la branche sélectionnée.
  • L'option Rebaser (Rebase) rebase la branche actuelle sur la branche sélectionnée.

  • L'option Fusionner (Merge) fusionne la branche sélectionnée sur la branche actuelle.

    Pour fusionner une branche dans le maître d'un référentiel distant GIT, la branche maîtresse doit être extraite dans Studio. Ensuite, vous devez fusionner la branche modifiée dans le maître.

• Pour passer d’une branche à une autre, ouvrez le menu de branche dans la barre d’état, puis sélectionnez la branche sur laquelle vous souhaitez passer depuis la liste des branches récemment vérifiées.

Remarque : les branches doivent être ajoutées localement dans Studio à partir de la fenêtre Gérer les branches ( Manage Branches ). L'ajout de branches à partir du référentiel GIT distant peut causer des problèmes lors de la tentative de basculement entre les branches.

Afficher l'historique de validation

Pour afficher l'historique de validation d'un projet, ou bien d'un fichier ou d'un dossier spécifique au sein d'un projet, cliquez avec le bouton droit sur le nœud d'un projet, sur un fichier ou sur un dossier dans le panneau Projet (Project), puis sélectionnez Afficher l'historique (Show History). Cela ouvre la fenêtre Historique (History), qui affiche la liste des révisions existantes pour le fichier, le dossier ou le projet sélectionné. Pour chaque validation, le hachage, le message, l'auteur et la date de la validation sont affichés au sein d'un tableau dans la partie supérieure de la fenêtre. Vous pouvez afficher davantage d'informations sur une validation donnée dans les onglets Détails (Details) et Modifications (Changes) dans la partie inférieure de la fenêtre.

Comparer deux versions d'un fichier

Pour comparer deux versions d'un même fichier :

• Si vous avez ouvert l'historique d'un fichier, cliquez avec le bouton droit sur une validation dans la fenêtre de l'historique, puis sélectionnez Comparer avec la précédente (Compare with Previous), Comparer avec la locale (Compare with Local) ou Comparer avec la plus récente (Compare with Latest).
• Si vous avez ouvert l'historique d'un dossier ou d'un projet, sélectionnez une validation dans la fenêtre de l'historique, puis, dans l'onglet Modifications (Changes), double-cliquez sur un fichier pour le comparer avec sa version précédente.

Créer une branche à partir d'une validation précédente

Pour créer une branche à partir d'une validation spécifique :

1. Cliquez avec le bouton droit sur une validation dans la fenêtre de l'historique, puis sélectionnez Créer une branche (Create Branch).

2. Dans la fenêtre Créer une branche (Create Branch) :

   • Saisissez un nom pour la nouvelle branche.
   • Si vous voulez aussi extraire la nouvelle branche, assurez-vous que l'option Extraire après la création (Checkout after create) est sélectionnée.
3. Cliquez sur OK.

Résolution des conflits

L'intégration de GIT à Studio est fournie avec une fonctionnalité de résolution des conflits qui peuvent survenir lors de l'exécution de la commande Rebase ou Push, disponible dans la fenêtre Valider les modifications (Commit Changes).

Chaque fois que Studio détecte un conflit entre le fichier local et celui trouvé dans le référentiel distant, la fenêtre Résoudre les conflits (Solve conflicts) est affichée.

La fenêtre est similaire à Diff de workflow et indique les différences entre la version Distante du fichier et la version Locale.

Le tableau suivant décrit les options disponibles dans la fenêtre Résoudre les conflits.

Option	Description
Choisir celui de gauche	Sélectionnez le fichier de gauche représentant celui du référentiel distant à transmettre.
Choisir celui de droite	Sélectionnez le fichier de droite représentant celui du référentiel local à transmettre.
Enregistrer	Cliquez sur Enregistrer après avoir choisi le fichier de gauche ou de droite.
Annuler (Cancel)	Annulez l'opération et quittez la fenêtre Résoudre les conflits (Solve conflicts).
Précédent	Accède à la modification précédente dans les fichiers comparés.
Suivant	Accède à la modification suivante dans les fichiers comparés.
Tout réduire	Réduit tous les nœuds dans les fichiers .xaml.
Tout développer	Développe tous les nœuds dans les fichiers .xaml.

Déconnexion de GIT

Option Déconnecter (Disconnect) du mode Studio Backstage. > L'onglet Équipe (Team) est disponible pour les fichiers avec version dans les deux cas suivants :

1. Un processus est initialisé en tant que référentiel GIT local. Créez un processus, utilisez Initialisation de GIT (GIT Init) pour l'ajouter à un référentiel GIT local, puis utilisez Déconnecter (Disconnect) pour supprimer la balise de sous-version.
2. Vous pouvez supprimer celle-ci en cliquant sur Déconnecter (Disconnect) pour un référentiel GIT qui comprend les projets parent et enfants.
3. Si vous déconnectez un projet enfant, le référentiel GIT entier qui contient le projet ouvert est déconnecté du contrôle de code source. Une boîte de message est affichée dans Studio et nécessite votre confirmation avant que l'action de connexion ne soit effectuée.

Modification de la signature

La modification de la signature de validation dans GIT peut être effectuée depuis l’onglet Équipe > Modifier la signature. Remplissez votre nom et votre adresse e-mail, puis cliquez sur OK.

Modifier les identifiants

Pour mettre à jour identifiants utilisés pour se connecter à un référentiel distant :

1. Dans le menu de la branche de la barre d'état, sélectionnez Gérer les référentiels distants (Manage Remotes).
2. Dans la boîte de dialogue « Gérer les référentiels distants », cliquez avec le bouton droit sur un référentiel distant et sélectionnez Modifier les identifiants (Change Credentials).

3. Selon la façon dont le référentiel a été cloné (via HTTPS ou SSH), connectez-vous à un compte GitHub (pour les référentiels hébergés sur github.com uniquement), saisissez les informations nom d'utilisateur/mot de passe ou nom d'utilisateur/jeton, ou bien indiquez une nouvelle clé privée et cliquez sur OK.

   Les identifiants sont mis à jour dans Windows Credential Manager.

Utilisation de GIT avec un serveur proxy

L'intégration de GIT dans Studio prend en charge la modification des commandes pour accéder aux référentiels distants si l'accès à Internet se fait via un serveur proxy. Cela peut être fait de deux manières : soit configurée au niveau de la machine dans la fenêtre Paramètres du proxy (Proxy Settings), soit en modifiant les commandes git.

Les détails proxy configurés dans la fenêtre Paramètres Proxy sont pris en compte, sans qu’il soit nécessaire de les saisir dans le fichier .gitconfig.

Pour configurer les détails proxy avec les commandesgit, ajoutez-les aux fichiers de configuration GIT sous la forme suivante :

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

Les fichiers de configuration GIT se trouvent aux emplacements suivants :

• Fichier config : %ProgramData%\Git
• Fichier .gitconfig : %UserProfile%
• Fichier config local au niveau du projet, par exemple : %UserProfile%\Desktop estproject\.git.