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 en utilisant des fournisseurs externes si vous êtes un utilisateur régulier, dans UiPath Cloud via Studio Web si vous êtes un administrateur d'organisation. Combiné avec la fonctionnalité Contrôle de code source (Source Control) disponible dans Studio et StudioX, vous permet de mieux contrôler 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. 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™ > Contrôle de code source (Source Control), puis cliquez sur Se connecter à GitHub ( Connect to GitHub ) ou Se connecter à Azure ( Connect to 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 SSO, vous devez d'abord vous connecter à GitHub. Après cela, vous pouvez installer l'application GitHub via le contrôle de code source. Vous pouvez procéder 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 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.

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.
• 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 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 Politique (Policy) sous Sécurité (Security). 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 cliqué sur «Accepter», vous êtes redirigé vers Automation Ops™ où la liste des projets disponibles est renseignée.

Pour créer des Azure Service Hooks, les autorisations Modifier les abonnements (Edit Subscriptions) et Afficher les abonnements (View Subscriptions) 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 Azure CLI 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 (User settings ) du côté Azure et supprimer l'application autorisée à partir de là. Ensuite, 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 des projets est renseignée.

Pour chaque projet, vous pouvez voir 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, cliquez sur le bouton Bouton Synchroniser (Sync) 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, cela peut prendre un certain temps pour que tous les projets soient affichés dans Automation Ops™ - Source Control.

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 Configuration des pipelines (Pipelines Configuration), à 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.