Contrôle de code source

Le contrôle de code source vous permet d'afficher les mises à jour du code source des projets d'automatisation. Cela peut être fait à l'aide de fournisseurs externes si vous êtes un utilisateur régulier, ou dans UiPath Cloud via Studio Web si vous êtes un administrateur de l'organisation. Avec la fonctionnalité Contrôle de code source disponible dans Studio et StudioX, vous pouvez obtenir plus de contrôle sur la gestion du code.

Remarque :

L'accès aux politiques de contrôle de code source dépend de l'offre Automation Cloud que vous utilisez. Pour de plus amples informations, consultez la section Disponibilité des fonctionnalités Automation Ops.

Prérequis pour les référentiels externes

• Un compte GitHub ou Azure DevOps avec au moins une organisation et un référentiel.
• Droits permettant de fournir un accès à l'application UiPath-AutomationOps sur le référentiel. Vous devez être l'administrateur de l'organisation GitHub ou l'administrateur d'au moins un référentiel. Pour Azure, les référentiels auxquels l'utilisateur a accès seront connectés.

Remarque :

L'intégration d'Azure Repos est actuellement en préversion, ce qui signifie que certaines fonctionnalités peuvent ne pas être disponibles.

Configuration

Automation Ops™ doit se connecter à l'organisation GitHub ou Azure pour gérer les informations. Pour ce faire, installez l'application UiPath-AutomationOps côté GitHub ou Azure. Un guide étape par étape est également disponible dans l'interface utilisateur.

Étape 1 : lancer la connexion à partir d'Automation Ops™

Accédez à Automation Ops™, puis sélectionnez Contrôle de code, puis sélectionnez Se connecter à GitHub ou Se connecter à Azure.

Étape 2.a : Installer et autoriser l'application Automation Ops™ pour GitHub

Lorsque vous choisissez de vous connecter à GitHub, vous êtes redirigé vers GitHub pour sélectionner l'organisation et les référentiels auxquels vous souhaitez qu'Automation Ops™ ait accès.

Remarque :

Si votre organisation GitHub utilise la connexion via authentification unique, vous devez d'abord vous connecter à GitHub. Ensuite, vous devez installer l'application GitHub via le contrôle de code source en procédant comme suit :

• Utilisateurs gérés par l'Enterprise : doivent se connecter à GitHub via leur IdP.
• Les utilisateurs peuvent configurer une session de connexion SSO à partir de : https://github.com/orgs/<OrganizationName>/sso

Selon votre choix, les référentiels présentés dans le tableau suivant apparaissent dans Automation Ops™ - Contrôle de code source :

Rôle GitHub	Sélection	Résultat
Administrateur de l'organisation GitHub	Tous les référentiels	Tous les référentiels publics et privés.
Administrateur de l'organisation GitHub	Sélectionner uniquement les référentiels	Seuls les référentiels sélectionnés apparaissent (pas tous les référentiels publics par défaut).
Administrateur de référentiel uniquement	Sélectionner uniquement les référentiels	Vous ne pouvez sélectionner que les référentiels que vous administrez.

Remarque :

La liste du référentiel GitHub peut toujours être mise à jour ultérieurement.

Lors de la connexion d'Automation Ops™ - Contrôle de code source (Source Control) à GitHub, vous êtes invité à accorder les autorisations nécessaires pour utiliser pleinement le Contrôle de code source et les Pipelines. Les autorisations requises sont les suivantes :

• Accès en lecture au code et aux métadonnées
• Accès en lecture et en écriture aux webhooks de référentiel

Important :

• La connexion à GitHub nécessite l'authentification de l'administrateur GitHub, ce qui signifie que l'utilisateur qui initie la connexion à partir d'Automation Ops™ - Contrôle de code source (Automation Ops™ - Source Control) doit également être un administrateur de l'organisation GitHub.
• L'authentification via clés API ou jetons PAT n'est pas prise en charge. Un administrateur d'organisation GitHub doit se connecter via GitHub OAuth pour configurer la connexion. Si l’utilisateur d’Automation Ops n’est pas un administrateur de l’organisation GitHub, une solution de contournement courante consiste à attribuer temporairement le rôle d’administrateur Automation Ops à un administrateur de l’organisation GitHub, de lui permettre de terminer la configuration, puis de révoquer le rôle par la suite.
• Si vous choisissez de sélectionner manuellement les référentiels, vous devez également sélectionner explicitement les référentiels publics car il n'y a pas de sélection implicite pour eux.
• Automation Ops - Contrôle de code source synchronise uniquement les projets RPA sur la branche par défaut de chaque référentiel.

Si vous devez vous connecter à une autre organisation GitHub ou sélectionner des dépôts différents, sélectionnez les référentiels nécessaires dans GitHub et resync la connexion dans le contrôle de code source.

Vous pouvez supprimer la connexion existante depuis le menu Paramètres de connexion > Supprimer.

Lors de la suppression de la connexion dans UiPath, l'application installée côté GitHub est également supprimée.

Étape 2.b : Installer et autoriser l'application Automation Ops™ pour Azure Repos

Lorsque vous choisissez de vous connecter à Azure, vous êtes redirigé vers Azure pour fournir les informations d'identification et confirmer que vous autorisez UiPath à lire les référentiels auxquels vous avez accès.

Il est recommandé de créer et d'utiliser un compte de service distinct pour fournir l'accès à l'application UiPath côté Azure. En effet, l'accès est accordé au nom du compte d'utilisateur, ce qui signifie que si un utilisateur fait partie de plusieurs organisations Azure compatibles OAuth, elles seront toutes reflétées dans Automation Ops™.

Pour synchroniser vos projets, vous devez activer l’ Accès aux applications tierces via OAuth au niveau des paramètres de votre organisation Azure. Pour cela, vous devez accéder à l'onglet Policy sous Sécurité. L'activation de l'option doit être effectuée avant l'autorisation sur votre compte Azure Repos. Si vous avez déjà établi l'autorisation, vous devez resynchroniser la connexion.

Si l'utilisateur qui a autorisé la connexion à Azure fait partie de plusieurs organisations et que vous souhaitez éviter que le contenu d'un référentiel spécifique s'affiche dans Automation Ops™, vous devez vous assurer que les intégrations de produits tiers sont désactivées côté Azure pour cette organisation .

Une fois que vous avez sélectionné Accepter, vous êtes redirigé vers Automation Ops™ où la liste des projets disponibles est renseignée.

Afin de créer des hooks de service Azure, les autorisations Modifier les abonnements et Afficher les abonnements sont nécessaires pour le compte de service qui autorise l'application. Par défaut, seuls les administrateurs de projet disposent de ces autorisations. Pour accorder ces autorisations à d’autres utilisateurs, vous pouvez utiliser la CLI Azure ou l’ API REST de sécurité Azure.

Pour supprimer l’intégration entre UiPath Automation Ops™ et Azure Repos, vous devez accéder à l’onglet Autorisation sous Paramètres utilisateur côté Azure et supprimer l’application autorisée à partir de là, vous pouvez ensuite supprimer l’intégration depuis l’onglet Gérer les connexions dans Automation Ops ™ : Contrôle de code source.

Étape 3 : afficher les projets dans Automation Ops™

Une fois l'application autorisée, vous êtes redirigé vers Automation Ops™ et la liste des projets est renseignée.

Pour chaque projet, vous pouvez remarquer les champs suivants en fonction des métadonnées du projet dans votre référentiel externe :

• Project Name
• Brève description (Short description)
• Compatibilité
• Saisie de texte
• Référentiel
• Dernière modification

Pour obtenir les dernières mises à jour de votre référentiel externe, sélectionnez le bouton Sync sous le bouton Gérer les connexions ou dans le menu Gérer les connexions.

Vous pouvez synchroniser la liste des projets chaque fois que nécessaire afin d'obtenir les derniers projets ajoutés. Une fois la synchronisation terminée, la liste de projets mise à jour est disponible pour tous les utilisateurs du contrôle de code source.

Après la synchronisation initiale, les synchronisations suivantes seront plus rapides car elles sont basées sur les différences par rapport à la dernière synchronisation.

Remarque :

Selon la taille de votre référentiel, cela peut prendre un certain temps pour que tous les projets soient affichés dans Automation Ops™ - Contrôle de code source.

Affichage de l'historique des validations d'un projet

Lorsque vous accédez à un projet, vous pouvez consulter l'historique de validation du projet, qui contient une brève description de la modification, le nom de la personne qui a effectué la validation et l'horodatage.

Vous pouvez créer un pipeline à l'aide du bouton Nouveau pipeline . Vous êtes redirigé vers la page Création du premier flux de pipeline à partir de la section Pipelines. Dans ce cas, les informations nécessaires pour définir le pipeline sont déjà renseignées en fonction du projet à partir duquel le processus de création de pipeline a été déclenché.

Remarque :

Dans la section Pipelines, si vous modifiez le référentiel/organisation, puis que vous résélectionnez celui initial, les paramètres préconfigurés du pipeline seront effacés.

Si aucun environnement de runtime de pipeline n'est disponible, au lieu du bouton Nouveau pipeline , une nouvelle option s'affiche : Configurer vos pipelines. Cela vous redirige vers la configuration des pipelines, à partir de laquelle vous pouvez configurer l'environnement d'exécution.

Afficher les détails d'une validation

L'ouverture d'une validation vous permet d'afficher plus en détail les fichiers qui font partie du projet.

• Pour les fichiers de workflow, une vue de type Studio est disponible.

• Pour les autres types de fichiers, une vue de contenu s'affiche en fonction du type de fichier.

• La sélection de Variables, d'Arguments ou d'Imports fournit des détails sur chacun d'eux.

  

Comparaison des validations

Les fichiers modifiés par la dernière validation sont surlignés en jaune. Pour vérifier les modifications, sélectionnez le bouton Comparer avec la validation précédente .

Dans la fenêtre de comparaison :

• L'ancienne version du fichier se trouve à gauche et la nouvelle version du fichier se trouve à droite.

• Le nom du fichier et les identificateurs de validation comparés s'affichent dans le coin supérieur gauche.

• En haut à droite, vous pouvez parcourir chaque modification et sélectionner le type de modification que vous souhaitez vérifier.

  

Navigation dans les fichiers de workflow

Pour les workflows complexes, vous pouvez utiliser les commandes de navigation pour modifier la vue et naviguer dans le workflow. La sélection de l'activité ouvre le panneau Propriétés (Properties), tandis que sa sélection développe deux fois cette activité spécifique.

Vous pouvez revenir d'un niveau en arrière à partir de l'activité à l'aide du menu fil d'Ariane en haut.

Les commandes de navigation suivantes sont disponibles :

• Développer tout: développe tous les sous-workflows affichés.

• Zoom arrière: réduit la taille visuelle du workflow.

• Réinitialiser: renvoie l'affichage à une largeur de 100 %.

• Zoom avant: augmente la taille visuelle du workflow.