UiPath Documentation
studio
latest
false
Guide de l'utilisateur de Studio
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Gestion des dépendances

Gérer les dépendances d’un projet dans Studio, notamment en ajoutant, en mettant à jour et en supprimant des packages d’activités liés à un projet d’automatisation.

Les dépendances de projet dans Studio font référence à des packages liés dans un projet spécifique. Ces packages contiennent des activités, soit par défaut, soit personnalisées.

Les dépendances sont contextuelles et représentent:

  • Activités utilisées par le projet
  • Variables de projet
  • Arguments d'entrée et de sortie

Une dépendance n'est définie que si elle possède au moins une référence dans la définition du projet.

Dépendances par défaut et personnalisées​

Les dépendances par défaut d’un projet diffèrent en fonction du type de projet, de la compatibilité ou du modèle utilisé pour créer le projet.

Si d'autres doivent être ajoutés, cliquez sur le bouton Gérer des paquets (Manage Packages) et installez-les. Les dépendances installées sont disponibles uniquement pour le projet actuel, et la liste de dépendances par projet est visible dans le fichier project.json.

The Explorer panel displays the activities packages installed in the automation project, together with their sub dependencies, runtime rules, requested, and resolved versions. The project compatibility is displayed in the Dependencies node.

Pointez sur une dépendance pour voir les versions demandées et résolues. Les actions contextuelles, telles que Gérer (Manage), Réparer (Repair) ou Supprimer la dépendance (Remove Dependency) sont disponibles uniquement pour les dépendances, et non pour leurs sous-packages.

Le statut des dépendances dans l’arborescence est codé par couleur comme suit :

  • Rouge : la dépendance est introuvable.
  • Orange : un sous-package est introuvable.
  • Gris : la dépendance n’est pas résolue.
  • Bleu pâle : la version résolue est supérieure à la version demandée.
  • Bleu foncé : il y a une correspondance exacte entre la version demandée et la version résolue.

Ajout et mise à jour de dépendances​

Pour ajouter des dépendances à un projet, installez-les à partir de la fenêtre Gérer les packages.Veuillez noter que les packages disponibles diffèrent en fonction de la compatibilité du projet. Vous pouvez également installer un package en ajoutant l'une des activités qu'il contient à un projet depuis la catégorie Disponible du panneau Activités ou la barre de recherche Ajouter une activité.

Chaque fois que de nouvelles versions sont disponibles pour les dépendances du projet actuel, le bouton Gérer les paquets (Manage Packages) du ruban obtient une icône de mise à jour docs image.

  1. To manage dependencies in a project, open the context menu for the Dependencies category in the Explorer panel, and then select Manage. This opens the Manage Packages window, with the Project Dependencies category. The docs image icon shows which packages are currently installed.

  2. Default dependencies are displayed, together with the versions that are currently linked to the project. To update a package, select the update icon icône de mise à jour, next to the available version number. The icône du package d’installation icon is shown next to the package, meaning that dependencies are ready to be installed.

  3. Les dépendances ne sont installées dans le projet qu'une fois que vous avez sélectionné Enregistrer. Simultanément, les versions des dépendances sont mises à jour dans le fichier project.json appartenant au projet.

Résultat​

Les dépendances sélectionnées sont ajoutées ou mises à jour dans le projet. Les versions du package sont mises à jour dans le fichier project.json .

Suppression de dépendances​

  • To remove a project dependency, right-click the dependency in the Explorer panel, and then select Remove Dependency. The dependency is removed from the Explorer panel and project.json file. Alternatively, you can go to Manage Packages > Project Dependencies, select the dependency to remove, and then click Uninstall.
  • To remove all unused dependencies in the project, select Remove Unused > Dependencies in the Studio ribbon, or use the Ctrl + Shift + R keyboard shortcut. All the installed packages that have no references in the current project are removed from the Explorer panel and project.json file.

Réparation de dépendances​

If a workflow opened in Studio has references to packages with versions that aren’t available in current Studio feeds, said dependencies are marked as broken in the Explorer panel and details are made available in the Output panel.

Réparation de dépendances​

Studio allows for all dependencies to be repaired in bulk or individually. To repair all broken dependencies, right-click on the Dependency node in the Explorer panel, and click on Repair Dependencies.

Cliquez avec le bouton droit sur une dépendance endommagée et sélectionnez Résoudre la dépendance (Resolve Dependency) pour la réparer individuellement. Vous pouvez également sélectionner Gérer (Manage) pour ouvrir la fenêtre Gérer des paquets (Manage Packages) et mettre à jour les paquets.

NuGet résout les dépendances endommagées en appliquant la règle de runtime Version applicable la plus ancienne (Lowest Applicable Version) docs image. Cela implique qu'il recherche la première version applicable, supérieure à celle définie précédemment.

Remarque :

Les activités manquantes ou non valides sont marquées dans le panneau Concepteur (Designer), tandis qu'une bannière d'erreur fournit des informations concernant le workflow et ses conflits de dépendances non résolus.

Définition des règles de dépendances​

Les paquets d'activités sont disponibles dans plusieurs versions. C'est la raison pour laquelle leur installation ou mise à jour à l'aide de la fenêtre Gérer des paquets (Manage Packages) permet de définir des règles de runtime de dépendances pour chacun d'entre eux.

La Règle de runtime (Runtime Rule) spécifie quelle version de paquet installer au runtime. Elle présente deux options disponibles.

The Strict runtime rule is the default state for dependencies added upon process creation, and for activities packages installed from the Manage Packages window. It means that only the specified version of the package is used at runtime to execute the parent process. The Strict rule is marked in the Explorer panel, under Dependencies by the docs image sign next to the package version.

The Lowest Applicable Version runtime rule means that if the target package isn’t found, the next higher version is searched in order to resolve dependencies. The Lowest Applicable Version rule is marked in the Explorer panel, under Dependencies by the docs image sign next to the package version.

Exécuter avec des règles de dépendance​

Lorsqu'un projet d'automatisation est exécuté à partir de Studio, le Robot télécharge la version de paquet spécifiée requise pour exécuter le projet, conformément aux règles de runtime définies précédemment pour chaque projet. Si la dépendance utilisée lors de l'exécution possède une règle de runtime Strict (Strict) et que la version de paquet exacte est introuvable, une erreur est générée. Pour plus d'informations sur la définition des règles de runtime pour les dépendances du projet, consultez la page Gestion des dépendances.

Résolution des conflits de dépendances​

L'installation des packages d'activités prend en compte les règles de runtime de dépendances précédemment définies. Cependant, des conflits entre les versions peuvent survenir lors de l'automatisation de projets.

Le projet d'automatisation et ses bibliothèques peuvent contenir le même package d'activités avec des versions et des règles de runtime différentes. Lors de la phase de conception, NuGet résout ces conflits en choisissant la dépendance de niveau supérieur, celui qui est le plus proche du projet dans la hiérarchie.

La résolution des conflits qui peut se produire est expliquée ci-dessous :

Le projet contient un paquet d'activités avec la version 1.0. La bibliothèque est référencée vers le projet et utilise le même pack, mais avec une version supérieure. La dépendance de niveau supérieur v1.0 est utilisée au runtime. Un avertissement s'affiche, mentionnant ainsi qu'une rétrogradation a été détectée.

La résolution de ce scénario est applicable, indépendamment de la règle de runtime (Strict (Strict) docs image ou Version applicable la plus ancienne (Lowest Applicable Version) docs image) auparavant définie pour les paquets d'activités.

  • Si vous choisissez Oui, le package d’activités référencé dans le projet est mis à niveau vers la version utilisée dans la bibliothèque.

  • Si vous choisissez Non (No), la fenêtre Gérer des paquets (Manage Package) s'ouvre avec la fenêtre Dépendances du projet (Project Dependencies).

Le projet contient un paquet d'activités avec la version 2.0. La bibliothèque utilise le même pack, mais avec une version antérieure et la règle de runtime Strict (Strict) docs image. La dépendance de niveau supérieur utilisé dans ce cas est la version v2.0 et un avertissement s'affiche lorsque le paquet est installé dans le projet.

Le projet contient un paquet d'activités avec la version 2.0. La bibliothèque utilise le même pack, mais avec une version antérieure et la règle de runtime Version applicable la plus ancienne (Lowest Applicable Version) docs image. La dépendance de niveau supérieur utilisé dans ce cas est la version v2.0 et un avertissement s'affiche lorsque le paquet est installé dans le projet.

Le projet référence une bibliothèque avec une version 1.0 du paquet d'activités et une règle de runtime Strict (Strict) docs image. Le projet référence une autre bibliothèque, mais avec une version 2.0 du paquet d'activités. La dépendance de niveau supérieur utilisé dans ce cas est v2.0 et elle possède la version supérieure. Un avertissement s'affiche lorsque le paquet d'activités est installé.

Dans ce conflit, le projet référence deux bibliothèques, dont les dépendances Strict (Strict) docs image sont référencées tour à tour entre elles. Ce scénario n'est pas pris en charge. Pour obtenir des informations détaillées, consultez la page Résolution des dépendances (Dependency Resolution).

Les cycles de dépendance sont des types de conflits qui se produisent lorsqu'un paquet se référence lui-même. Si vous nommez votre projet UiPath, Studio détecte un conflit de dépendances. Cela se produit, car le paquet UiPath existe déjà et est une dépendance à UiPath.UIAutomation.Activities. Il est recommandé d'éviter de nommer votre projet avec le nom d'un paquet déjà existant que vous prévoyez d'ajouter comme dépendance.

Le même cycle de dépendances se produit si vous ouvrez un fichier .xaml d'un dossier nommé UiPath ou tout nom d'un paquet existant que vous prévoyez d'ajouter comme dépendance. Ce dossier ne contient pas de project.json. Lorsque vous ouvrez un fichier .xaml qui ne possède pas de fichier project.json associé, Studio en crée un, et la balise "name" est renseignée avec le nom du dossier parent.

Ouverture de projets créés avec des versions précédentes​

Important :

L’ouverture de projets créés avec Studio v2016.2 directement dans v2020.4 ou des versions plus récentes n'est pas prise en charge. Tout d’abord, ouvrez ces projets avec Studio v2018.4, puis avec v2020.4 ou plus récent.

Lorsque vous ouvrez un projet avec ou sans dépendances conçues avec une version antérieure à v2018.3 (sauf pour la version v2016.2), Studio vous demande si une migration automatique doit être effectuée, afin qu'elle puisse tenter de récupérer des dépendances manquantes ou d'en ajouter par défaut.

Upon confirmation, Studio attempts to retrieve missing dependencies and sets the Strictdocs image runtime rule for the packages that it finds. When using the Repair Dependency option in the Explorer panel, Studio attempts to install the next best package version. If the package version is not found, alerts are shown in the Output panel and you should check the configured feeds in the Manage Packages window.

Dépendances pour les anciens projets​

Les processus contenant des dépendances et qui ont été créés avec des versions de Studio antérieures à v2018.3 continuent d’être exécutés à l’aide de Robot v2018.3. La règle de runtime pour de tels projets est définie sur Version applicable la plus anciennedocs image (Lowest Applicable Version).

Les projets créés avec des versions antérieures à la version v2018.3, qui n’ont jamais été publiés, n’ont pas de dépendances répertoriées dans le fichier project.json. Lors de l'ouverture de ces projets, une alerte dans le panneau Sortie (Output) vous informe des dépendances manquantes. Les packages UiPath® transmis localement avec Studio sont ajoutés en tant que dépendances avec la règle de runtime Strictruntime rule. La dernière version de ces packages est définie automatiquement.

Si ces projets contiennent des paquets autres que ceux fournis avec Studio localement, nous recommandons les actions suivantes :

  • Publication du projet à l'aide de la version Studio dans laquelle il a été créé, facilitant ainsi le processus de migration en ajoutant des dépendances dans le fichier project.json ;
  • Installation manuelle du package manquant à partir de la fenêtre Gérer les packages après avoir configuré le flux requis ;
  • Utilisation de l'outil Mise à jour groupée des dépendances du projet pour ajouter la dépendance manquante à un grand nombre de projets.
    Remarque :

    Impossible d'enregistrer des workflows contenant des activités non valides. Installez la dépendance requise et enregistrez le projet.

Les paquets d'activités UiPath.V7.Activities, UiPath.Platform.Activities, UiPath.Framework.Activities ont été désapprouvés. Lors de l'ouverture des projets avec les paquets UiPath.Platform.Activities et UiPath.Framework.Activities, Studio v2018.3 ou versions ultérieures tente d'effectuer une migration automatique pour remplacer les anciennes versions des activités par de nouvelles.

Remarque :

Les workflows contenant l'élément activités du paquet UiPath.V7.Activities ne peuvent pas être migrés.

Une solution est disponible pour certains cas dans lesquels la migration n'est pas effectuée automatiquement.

  1. Ouvrez le fichier project.json avec Notepad++.
  2. Supprimez le paramètre "schemaVersion": "3.2".
  3. Remplacez "studioVersion" par "toolVersion".
  4. Passez la valeur "toolVersion" de "18.3.xxx" à une version précédente. Par exemple, passez la valeur de "18.3.0.958" à "18.2.958". Enregistrez le fichier.
  5. Open the .xaml file with Studio v2018.3 or above for the migration to be performed. The deprecated activities packages are replaced with new ones, as illustrated in the Dependencies section of the Explorer panel.
    Remarque :

    Dans certains cas, les fichiers .xaml contenant les paquets UiPath.Platform.Activities et UiPath.Framework.Activities ne peuvent pas être automatiquement migrés. La solution de contournement n'est pas applicable. Pour ces situations, il est recommandé d'ouvrir les projets dans Studio v2018.2 ou versions inférieures, et de remplacer les activités appartenant aux paquets susmentionnés par des activités contenus dans le paquet UiPath.Core.Activities. La même opération peut être effectuée pour les workflows contenant des activités provenant du paquet UiPath.V7.Activities.

À partir de Studio v2018.4.1, Microsoft.Activities v.1.0.1 et Microsoft.Activities.Extensions v2.0.6.9 ne sont plus intégrés au programme d'installation UiPathStudio.msi.

Au cas où une réparation serait nécessaire lors de la migration de projets contenant ces packs en tant que dépendances, installez les deux paquets à partir du flux Officiel (Official) ou d'un flux local. Avant d'exécuter de tels projets créés à l'aide de versions antérieures à v2018.4.1, assurez-vous que les paquets susmentionnés sont disponibles dans un flux accessible par le Robot.

Si vous effectuez la mise à niveau à partir d'une version antérieure à v2018.4.1, les deux paquets d'activités demeurent dans le flux Local (Local).

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour