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 réalisé à l'aide de fournisseurs externes si vous êtes un utilisateur régulier, dans UiPath Cloud via Studio Web si vous êtes un administrateur de l'organisation. Avec la fonctionnalité de contrôle de code source disponible dans Studio et StudioX, vous permet d'avoir plus de contrôle sur la gestion du code.

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. Cela se fait en installant l'application UiPath-AutomationOps côté GitHub ou Azure. Un guide étape par étape est également disponible dans l'interface utilisateur.

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

Accédez à Automation Ops > Contrôle de code source, puis cliquez sur 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.

Selon votre choix, les référentiels suivants 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 des référentiels GitHub peut toujours être mise à jour ultérieurement.

Important :

• La connexion à GitHub nécessite une authentification d'administrateur GitHub, ce qui signifie que l'utilisateur qui initie la connexion à partir d'Automation Ops - Contrôle de code source doit également être un administrateur de l'organisation GitHub.
• 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.

Si vous devez vous connecter à une autre organisation GitHub ou sélectionner des dépôts différents, vous devez supprimer la connexion existante et redémarrer la configuration. Cette opération s'effectue dans le menu Paramètres de connexion (Connection settings) > Supprimer (Remove).

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 les référentiels Azure

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.

To sync your projects, you must enable the Third-party application access via OAuth at your Azure Organization settings level. For this, you have to access the Policy tab under Security. Enabling the option must be done before the authorization to your Azure Repos account. If you have already established the authorization, you need to resync the connection.

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 cliqué sur « Accepter», vous êtes redirigé vers Automation Ops, où la liste des projets disponibles est remplie.

In order to create Azure Service Hooks, Edit subscriptions and View subscriptions permissions are needed for the service-account that authorizes the application. By default, only Project Administrators have these permissions. To grant other users these permissions, you can use the Azure CLI or the Azure Security REST API.

Pour supprimer l'intégration entre UiPath Automation Ops et Azure Repos, vous devez accéder à l'onglet Autorisation (Authorization) sous Paramètres utilisateur (User settings ) côté Azure et supprimer l'application autorisée à partir de là. Par la suite, vous pouvez supprimer l'intégration de l'onglet Gérer les connexions (Manage Connections) 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 de projets est renseignée.

Pour chaque projet, vous pouvez voir les champs suivants en fonction des métadonnées du projet dans GitHub :

• Project Name
• Brève description (Short description)
• Dernière mise à jour
• Version
• Référentiel

Pour obtenir les dernières mises à jour de GitHub, cliquez sur le bouton bouton Synchroniser sous le bouton Gérer les connexions (Manage connections) ou dans le menu Gérer les connexions (Manage connections).

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, l'affichage de tous les projets dans Automation Ops - Contrôle de code source peut prendre un certain temps.

Affichage de l'historique des validations d'un projet

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

À partir de là, vous pouvez créer un pipeline à l'aide du bouton Nouveau pipeline (New Pipeline ). Vous êtes redirigé vers la page Création du premier flux de pipeline ( Creating the first pipeline flow) de la section Pipelines. Dans ce cas, les informations requises pour définir le pipeline sont déjà renseignées en fonction du projet à partir duquel le processus de création du 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 (New Pipeline ), une nouvelle option s'affiche : Configurez vos pipelines ( Set-up your pipelines). Cela vous redirige vers la configuration des pipelines, à partir duquel 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.
• Cliquer sur Variables (Variables), Arguments (Arguments) ou Importations (Imports) fournit des détails sur chacun d'eux.
  
  

  

  
  

Comparaison des validations

Les fichiers qui ont été modifiés par la dernière validation sont surlignés en jaune. Pour voir les modifications, cliquez sur 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.
• Dans l'angle supérieur droit, vous pouvez parcourir chaque modification et sélectionner le type de modification que vous souhaitez voir.
  
  

  

  
  

Navigation dans les fichiers de workflow

Pour les workflows complexes, vous pouvez utiliser les commandes de navigation pour modifier la vue et parcourir le workflow. Un clic sur l'activité ouvre le panneau Propriétés (Properties) tandis qu'un double-clic permet de développer 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 :

• Toutdévelopper : développe tous les sous-workflows de la vue actuelle.
• Zoom arrière: réduit la taille visuelle du workflow.
• Réinitialiser: renvoie la vue à 100 % de largeur.
• Zoom avant: augmente la taille visuelle du workflow.