Gestion des dépendances

Les dépendances du projet dans Studio font référence à des paquets liés à un projet spécifique, contenant des activités, par défaut ou personnalisées. Les dépendances sont contextuelles et prennent en compte la définition de chaque projet, y compris les activités qu'il utilise, les variables, les arguments d'entrée/de sortie. Par conséquent, une dépendance est définie uniquement si elle comprend au moins une référence dans la définition du projet.

Tous les modèles de projet disponibles dans Studio sont fournis avec leurs propres packages de dépendances par défaut.

Dans StudioX, tous les projets sont livrés avec les packages par défaut suivants : UiPath.System.Activities, UiPath.ComplexScenarios.Activities, UiPath.Excel.Activities, UiPath.Mail.Activities, UiPath.Presentations.Activities,UiPath.UIAutomation.Activitieset UiPath.Word.Activities.

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.

Le panneau Projet (Project) affiche les paquets d'activités installés dans le projet d'automatisation, avec leurs sous-dépendances, règles de runtime, versions demandées et résolues.

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-paquets. Les dépendances non résolues sont marquées en gris dans l'arborescence, les dépendances introuvables en rouge, tandis que les dépendances résolues et de correspondance exacte en bleu décoloré et vif.

Ajout et mise à jour de dépendances

Whenever new versions are available for the current project dependencies, the Manage Packages button from the ribbon gets an update icon .

1. Pour gérer des dépendances dans un projet, cliquez simplement avec le bouton droit dans la catégorie Dépendances (Dependencies) du panneau Projet (Project), puis cliquez sur Gérer (Manage). Cela ouvre la fenêtre Gérer les paquets (Manage Packages), avec la catégorie Dépendances du projet (Project Dependencies). L’icône affiche quels packages sont actuellement installés.

   

2. Default dependencies are displayed, together with the versions that are currently linked to the project. To update a package, simply click on the update icon , next to the available version number. The icon is shown next to the package, meaning that dependencies are ready to be installed.

3. Les dépendances sont installées dans le projet, uniquement après que vous cliquez sur Enregistrer (Save). Simultanément, les versions des dépendances sont mises à jour dans le fichier project.json appartenant au projet.

To add dependencies to a project, simply search and install them as you would any activity package. For more information, check the Manage Packages page.

Suppression de dépendances

1. Pour supprimer une dépendance du projet, cliquez simplement avec le bouton droit sur la dépendance dans le panneau Projet (Project).
2. Sélectionnez Supprimer la dépendance (Remove Dependency). La dépendance est supprimée du panneau Projet (Project) et du fichier project.json.

Cela peut se faire également en cliquant simplement sur le bouton Désinstaller (Uninstall) disponible pour chaque dépendance de la catégorie Gérer des paquets (Manage Packages) > Dépendances du projet (Project Dependencies).

Réparation de dépendances

Si un workflow ouvert dans Studio possède des références vers les paquets ayant des versions non disponibles dans les flux Studio actuels, les dites dépendances sont marquées comme endommagées dans le panneau Projet (Project). Des détails sont disponibles dans le panneau Sortie (Output).

Studio permet de réparer toutes les dépendances en bloc ou individuellement. Pour réparer toutes les dépendances endommagées, cliquez avec le bouton droit sur le nœud Dépendance (Dependency) dans le panneau Projet (Project), et cliquez sur Réparer les dépendances (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) . 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.

La règle de runtime Strict (Strict) est l'état par défaut des dépendances ajoutées lors de la création du processus, et pour les paquets d'activités installés depuis la fenêtre Gérer les paquets (Manage Packages). Cela implique que seule la version spécifiée du paquet est utilisée au runtime pour exécuter le processus parent. La règle Strict (Strict) est marquée dans le panneau Projet (Project), sous Dépendances (Dependencies) par le signe en regard de la version du paquet.

La règle de runtime Version applicable la plus ancienne (Lowest Applicable Version) implique que si le paquet cible est introuvable, la version supérieure suivante est recherchée afin de résoudre les dépendances. La règle Version applicable la plus ancienne (Lowest Applicable Version) est marquée dans le panneau Projet (Project), sous Dépendances (Dependencies) par le signe en regard de la version du paquet.

When executing an automation project from Studio, the Robot downloads the specified or indicated package version it needs to execute the project, in accordance to the previously set runtime rules for each project. If the dependency used during execution has a Strict runtime rule and the exact package version was not found, an error is thrown. For more information on setting runtime rules for project dependencies check the Managing Dependencies page.

Résolution des conflits de dépendances

L'installation des paquets d'activités prennent en compte les règles de runtime des dépendances auparavant définies pour les dits paquets. Toutefois, certains conflits entre les versions peuvent se produire lors de l'automatisation des projets. Le projet d'automatisation et la bibliothèque qu'il contient peuvent posséder le même paquet d'activités, mais avec des versions et des règles de runtime différentes. Au moment de la conception, NuGet résout de tels conflits en choisissant la dépendance de niveau supérieur, qui est la plus proche du projet de 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.

The resolution of this scenario is applicable regardless of the runtime rule (Strict or Lowest Applicable Version ) previously set for the activities packages.

• 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) . 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) . 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) . 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) 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 n'est pas prise en charge. Tout d’abord, ouvrez ces projets avec Studio v2018.4, puis avec v2020.4.

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 Strict runtime rule for the packages that it finds. When using the Repair Dependency option in the Project 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.

Processes containing dependencies and that were built with Studio versions prior to v2018.3 continue to execute with Robot v2018.3. The runtime rule for such projects is set to Lowest Applicable Version .

Projects created with versions prior to v2018.3 that were never published don't have dependencies listed in the project.json file. When opening such projects, an alert in the Output panel notifies you of missing dependencies. UiPath packages delivered locally with Studio are added as dependencies with the Strict runtime rule. The latest version of such packages is automatically set.

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 ;

• Manually installing the missing package from the Manage Packages window, after setting up the required feed;

• Using the Project Dependencies Mass Update tool to add the missing dependency to a bulk of projects.

  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. Ouvrez le fichier .xaml avec Studio v2018.3 ou versions ultérieures pour que la migration soit effectuée. Les paquets d'activités désapprouvés sont remplacés par de nouveaux, comme illustré dans la section Dépendances (Dependencies) du panneau Projet (Project).

   Remarque :

   In some cases, .xaml files containing the packages UiPath.Platform.Activities and UiPath.Framework.Activitiescannot be automatically migrated and the workaround isn't applicable. For these situations, it is recommended to open the projects in Studio v2018.2 or lower, and replace the activities belonging to the aforementioned packages with activities contained in the UiPath.Core.Activities package. The same can be done for workflows containing activities from UiPath.V7.Activities package.

À 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).