À propos des bibliothèques

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

Création d'une bibliothèque

1. Accédez à Mode Backstage de Studio (Studio Backstage View) > Démarrer (Start) > Bibliothèque (Library. Cela ouvre la fenêtre Nouvelle bibliothèque vierge (New Blank Library).
2. Renseignez le nom et choisissez un emplacement pour la bibliothèque. L'emplacement par défaut est C:\Users\<current_user>\Documents\UiPath. Ajoutez une description et sélectionnez Créer (Create). La bibliothèque est créée et enregistrée sur votre machine locale.

Remarque :

Le nom de la bibliothèque ne peut pas dépasser 128 caractères et la description ne peut pas dépasser 500 caractères.

1. Le panneau Projet (Project) affiche l'arborescence avec le dossier Projet (Project), les dépendances et le NewActivity.xaml qui contient le workflow réel.

   Chaque fichier de workflow dans une bibliothèque est disponible en tant qu’activité dans les projets où la bibliothèque est installée comme dépendance. Si vous souhaitez rendre un certain fichier privé, faites un clic droit dessus et sélectionnez Écarter de la publication (Ignore from Publish). Dans ce cas, le fichier est inclus dans le package de la bibliothèque, mais il n’est pas disponible en tant que composant réutilisable dans le panneau Activités (Activities).

   Remarque :

   Par défaut, les dépendances disponibles pour les nouvelles bibliothèques sont les mêmes que pour les nouveaux projets vierges, à savoir UiPath.Excel.Activities, UiPath.Mail.Activities, UiPath.System.Activities et UiPath.UIAutomation.Activities, avec la règle de runtime Version applicable la plus ancienne (Lowest Applicable Version).

Pour ajouter une info-bulle et aider à lier à une activité, faites un clic droit sur le fichier de workflow dans le panneau Projet (Project) et sélectionnez Propriétés (Properties). L’info-bulle est visible lorsque vous survolez l’activité dans les panneaux Activités (Activities) et Concepteur (Designer) dans les projets où la bibliothèque est installée. Le lien d’aide s’ouvre lorsque vous sélectionnez l’activité dans le panneau Designer et que vous appuyez sur F1.

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

Remarque :

• Dans le cas de bibliothèques, il est recommandé d'utiliser Nothing pour attribuer une valeur nulle à une variable, plutôt que "". Cela sert à éviter les incohérences lors de l'utilisation de la bibliothèque empaquetée en tant que dépendance dans un projet.
• La propriété ImplementationVersion de l'objet System.Activities.ActivityBuilder n'est pas prise en charge. Si vous définissez la valeur de cette propriété, les arguments ne seront pas enregistrés. Cet objet s'affiche dans le panneau Propriétés lorsque vous sélectionnez la zone vide du panneau Concepteur.

Ajuster les paramètres de la bibliothèque

Pour configurer les paramètres d'un projet de bibliothèque, ouvrez la fenêtre Paramètres du projet en cliquant sur Paramètres dans le panneau Projet.

Les options suivantes sont disponibles dans l'onglet Général :

• Nom : modifiez le nom du projet.
• Description : modifiez la description du projet.
• Inclure des sources : sélectionnez Oui pour regrouper toutes les sources .xaml dans le fichier de l'assembly généré, y compris les flux de travail rendus précédemment privés. Si nécessaire, vous pouvez ensuite décompiler le fichier d'assembly et extraire les workflows, ce qui peut être utile au moment du débogage.
• Compiler les expressions des activités : sélectionnez Oui pour compiler et empaqueter toutes les expressions d'activités avec la bibliothèque. Vous réduisez ainsi le temps d'exécution.
• Prêt à fonctionner (Ready to Run) - définissez sur Oui (Yes) pour optimiser les assemblys générés afin de bénéficier d'une compilation JIT plus rapide au moment de l'exécution.
• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Publication d'une bibliothèque

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

Limitations lors de la publication des bibliothèques

Lors de la publication de bibliothèques, tenez compte des limitations suivantes :

• En raison des limitations NuGet :
  • Vous ne pouvez pas publier de bibliothèques à des emplacements contenant des sous-dossiers limités par l'utilisateur à l'aide de variables du chemin d'environnement Windows.
  • Les notes de publication des bibliothèques publiées ne sont visibles que dans Orchestrator.
• Les bibliothèques dont les noms des fichiers .xaml contiennent des caractères spéciaux peuvent ne pas être publiées avec succès.
• Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
• Lorsque vous utilisez l'activité Invoke Workflow File, assurez-vous que le fichier invoqué se trouve dans le même dossier que le projet de bibliothèque.
• L'activité Launch Workflow Interactive n'est pas prise en charge pour les bibliothèques.
• L'utilisation de Invoquer le fichier de workflow à l'intérieur d'une bibliothèque pour référencer la bibliothèque elle-même n'est pas prise en charge.

Ajout de composants réutilisables aux projets d'automatisation

1. Ouvrez et créez un projet.

2. Sous la catégorie Tous les paquets (All Packages), sélectionnez le flux sous lequel la bibliothèque est enregistrée et installez le paquet.

3. Sélectionnez OK, et le paquet est ajouté à la définition du projet.

4. L'activité est disponible dans la catégorie personnalisée du panneau Activités (Activities).

   Remarque :

   • Les Bibliothèques (Libraries) sont postcompatibles, impliquant qu'elles peuvent être uniquement utilisées avec des projets créés avec Studio v2018.3 et versions ultérieures. Vous ne pouvez pas publier de bibliothèques dans des versions d'Orchestrator antérieures à 2018.3.
   • Des erreurs peuvent se produire lorsque vous exécutez un projet contenant des activités personnalisées depuis une bibliothèque créée dans une version de Studio antérieure à 2019.10.1 et publiée à partir de la version 2019.10.1 de Studio ou ultérieure. Dans ce scénario, vous devez recréer et republier la bibliothèque.

Notez que dans un projet de bibliothèque, lorsque vous utilisez Importer des workflows (Import Workflows) pour ajouter un workflow qui contient une bibliothèque, les dépendances référencées dans la bibliothèque ne sont pas importées.

Lors de l’importation de deux versions d’une même bibliothèque personnalisée dans un projet dans Studio, les activités personnalisées supplémentaires contenues uniquement dans la deuxième bibliothèque ne sont pas visibles dans le panneau Activités, sauf si vous supprimez la première bibliothèque importée.