À propos des bibliothèques

Une bibliothèque est un projet qui contient un ou plusieurs workflows qui peuvent être réutilisés comme activités dans d'autres projets. Les bibliothèques sont enregistrées en tant que fichiers NUPKG lors de leur publication et peuvent être installées en tant que dépendances depuis le Gestionnaire des packages.

Par exemple, vous pouvez créer une bibliothèque qui collecte des données à partir d'une feuille de calcul Excel et les ajoute à une autre, comme expliqué dans la page Création d'une bibliothèque de base. Ensuite, la bibliothèque peut être empaquetée et utilisée dans d'autres processus en tant qu'activité.

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. C:\Users\<current_user>\Documents\UiPath est l’emplacement par défaut. Ajoutez une description, sélectionnez la compatibilité et le langage du projet, puis cliquez sur Créer (Create). La nouvelle 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. * N'utilisez pas lib comme nom de bibliothèque, car cela entraînera une Error de compilation dans les projets où la bibliothèque est installée.

3. 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 en tant que dépendance. Si vous souhaitez rendre un certain fichier privé, faites un clic droit dessus et sélectionnez Rendre privé (Make Private). 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, avec la règle de runtime Version applicable la plus ancienne (Lowest Applicable Version).

   Extraction d'un projet en tant que bibliothèque

Vous pouvez extraire n'importe quel projet d'automatisation de processus ou de test en tant que bibliothèque à réutiliser dans d'autres projets. Par exemple, vous pouvez convertir un projet d'automatisation de test pour utiliser ses modèles dans d'autres projets d'automatisation.

1. Ouvrez un projet dans Studio.

2. Dans le ruban Conception (Design), sélectionnez Exporter en tant que (Export As), puis Bibliothèque (Library).

   

3. Sélectionnez les workflows que vous souhaitez exporter en tant que bibliothèque. Par défaut, l'ensemble du projet est désélectionné, ainsi que les points d'entrée (Workflow principal et Cas de test).

   

4. Configurez les options d'extraction suivantes :

   • Include Test Cases: By default, this option is enabled for a Process project and disabled for a Test Automation project. You should enable this option if you want to include test cases as part of the extracted library.

   • Publish and install the library: Automatically selected to publish the package to a shared feed and install the library as a project dependency. You can disable this option if you want to create the library without publishing it. If disabled, the remainder options are not available for configuration.

   • Modifier vos workflows après l'installation du package (Alter your workflows after the package install) : choisissez de modifier les workflows avec des activités qui ont été compilées à partir de la bibliothèque.

   • Mode de remplacement (Replacing Mode) : choisissez la méthode de remplacement du workflow.

     • Sélectionnez Remplacer le contenu des workflows appelés (Replace invoked workflows content) pour modifier les workflows appelés à partir du point d'entrée, ou les cas de test avec les activités correspondantes de la bibliothèque extraite.

     • Utilisez cette option si vous utilisez les propriétés Sessions isolées (Isolated Sessions) et Sessions cible (Target Sessions) pour que les activités Appeler le workflow (Invoke Workflow) s'exécutent dans un processus Windows distinct et démarrent dans une session différente, respectivement.

     • Sélectionnez Remplacer les activités « Invoquer le workflow » pour modifier les activités Invoquer le workflow par des activités de la bibliothèque extraite.

       Remarque :

       Ne sélectionnez pas cette option si vous utilisez les propriétés Sessions isolées (Isolated Sessions) et Sessions cibles (Target Sessions) pour les activités Appeler le workflow (Invoke Workflow).

   • Supprimer les workflows remplacés (Delete replaced workflows) : supprimez les workflows qui ont été remplacés par les activités de bibliothèque extraites.

   • Définir des modèles d'exécution depuis la bibliothèque (Set Execution Templates from library) : ajoutez des modèles d'exécution à la bibliothèque.

5. Cliquez sur Exporter (Export) pour confirmer les options de la bibliothèque.

   

6. Cliquez sur Créer (Create) pour terminer la création de la bibliothèque.

   

7. (Facultatif) Publiez la bibliothèque si vous avez sélectionné Publier et installer la bibliothèque (Publish and install the library) à l'étape 3, puis cliquez sur Publier (Publish).

   

   Remarque :

   In case you didn't enable the Publish and install the library option, you'll be prompted to open the library or continue with the current project.

   

   Important :

   Le remplacement des workflows ou des activités invoquées à partir de la bibliothèque extraite n'aura pas lieu pour les workflows où des tests simulés sont utilisés.

Configuration de la mise en page d'une activité

Les arguments que vous définissez dans la bibliothèque deviennent des propriétés d'activité dans les projets où la bibliothèque est installée en tant que dépendance.

Pour configurer l'apparence et le comportement d'une activité lorsqu'elle est utilisée dans un projet, cliquez avec le bouton droit sur le fichier de workflow dans le panneau Projet de la bibliothèque, puis sélectionnez Mise en page de l'activité (Activity Layout). La fenêtre des propriétés de l'activité s'affiche avec différentes options en fonction de la compatibilité de la bibliothèque (Windows - Héritage (Windows - Legacy), Windows ou multiplate-forme).

Options pour les bibliothèques Windows et multiplate-forme

Sélectionnez Propriétés de l'activité (Activity Properties) dans le menu de gauche et saisissez les informations suivantes :

• Display name (Nom d'affichage) : nom de l'activité affiché dans le panneau Activities (Activités). Le nom d'affichage ne doit pas être modifié lorsque vous utilisez la bibliothèque dans un projet.

• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.

• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.

• SVG Icon - The SVG icon to display next to the activity name.

  Remarque :

  L'icône n'est pas visible dans Gérer les packages si un fichier local est utilisé pour une bibliothèque publiée dans Orchestrator ou dans un flux qui ne prend pas en charge les icônes intégrées.Dans ce cas, spécifiez l'icône à l'aide d'une URL.

• Color - The highlight color displayed for the activity in the Designer panel.

Les arguments définis dans le fichier de workflow s'affichent sous Propriétés de l'activité (Activity Properties) dans le menu de gauche.

• Pour personnaliser la propriété générée, sélectionnez-la et configurez les éléments suivants :

  • Nom complet (Display name) : libellé qui apparaît dans l'activité pour la propriété.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • Input Type - The type of input for the property. You can use the default input for the property type or select an input option depending on the type:
    • Booléen (Boolean) : utilisez Par défaut, Activer/désactiver (par défaut), Générateur de conditions, Bouton radio.
    • Numérique (Numeric) (int, double, décimal, long, short, sbyte, byte, ulong, ushort, unit, float) : utilisez Par défaut, Éditeur de nombres, Liste déroulante. Pour Liste déroulante, dans le champ Valeurs (Values), saisissez chaque valeur séparément en appuyant sur la touche Entrée de votre clavier.
    • Chaîne (String) : utilisez Par défaut, Éditeur de texte (par défaut), Éditeur de texte enrichi, Liste déroulante, Remplissage automatique, Bouton radio. Pour Liste déroulante, Remplissage automatique et Bouton radio, dans le champ Valeurs (Values), saisissez chaque valeur séparément en appuyant sur la touche Entrée de votre clavier.
    • String[] : utilisez Par défaut, Tableau de chaînes.
    • Date et heure (Date Time) : utilisez Par défaut, Date et heure.
    • Période (Time Span) : utilisez Par défaut, Période.
    • Dictionnaire : utilisez Par défaut, Dictionnaire.
    • Tous les autres types : utilisez Par défaut, Entrée.
  • Espace réservé (Placeholder) : texte de l'espace réservé à afficher pour l'entrée lorsqu'aucune valeur n'est sélectionnée.
  • Obligatoire (Required) : indique si la propriété est requise.
  • Avancé uniquement (Advanced Only) : indique si la propriété doit uniquement être affichée dans la section des options avancées de l'activité. Les propriétés de la section des options avancées peuvent également être organisées en catégories.

• Pour ajouter une catégorie sous laquelle regrouper plusieurs propriétés associées, sélectionnez Nouvelle catégorie (New Category) dans le coin inférieur gauche de la fenêtre. Les catégories ne sont disponibles que dans la section des options avancées de l'activité générée et peuvent être développées ou réduites. Si une catégorie est vide, elle est supprimée lorsque vous cliquez sur Enregistrer (Save) pour fermer la fenêtre.

• Pour modifier l'ordre des propriétés et des catégories, ou ajouter des propriétés aux catégories, faites glisser les éléments pour les déplacer dans la liste.

  

• Si votre bibliothèque inclut des activités Integration Service ou invoque des workflows contenant des activités Integration Service, les connexions utilisées dans ces activités, ainsi que d’autres propriétés d’activité, apparaissent en tant qu’entités distinctes lors de la configuration de la mise en page de l’activité. Vous pouvez réorganiser et catégoriser les connexions et les propriétés d’Integration Service, ainsi que modifier le Nom complet et l’Info-bulle d’une propriété.

  Remarque :

  • La configuration des connexions et des propriétés peut ne pas fonctionner lors de l'invocation de workflows qui invoquent des workflows codés. * Dans les Processes qui incluent une activité de bibliothèque qui utilise des connexions, si une activité qui ne fait pas partie de cette bibliothèque et qui utilise la même connexion est ajoutée au processus, la deuxième activité écrasera les paramètres de l'activité de bibliothèque.

  Options pour les bibliothèques Windows héritées

Select Activity Properties in the left-side menu and enter the following:

• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.

Les arguments définis dans le fichier de workflow s'affichent sous Propriétés de l'activité (Activity Properties) dans le menu de gauche.

• Pour personnaliser la propriété générée, sélectionnez-la et configurez les éléments suivants :

  • Nom complet (Display name) : libellé qui apparaît dans l'activité pour la propriété.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • Obligatoire (Required) : indique si la propriété est requise.
  • Avancé uniquement (Advanced Only) : indique si la propriété doit être affichée uniquement dans le panneau Propriétés (Properties). Si elle est sélectionnée, la propriété ne s'affiche pas dans le panneau Concepteur (Designer) de l'activité générée.

• Pour modifier l'ordre dans lequel les propriétés sont affichées dans l'activité, faites-les glisser pour les déplacer dans la liste.

  Remarque :

  • Dans l'incident des bibliothèques, il est recommandé d'utiliser Nothing pour attribuer une valeur nulle à une variable plutôt que "".Cela est fait pour éviter toute incohérence lors de l'utilisation de la bibliothèque packagée en tant que dépendance d'un projet.* La propriété ImplementationVersion de l'Object System.Activities.ActivityBuilder n'est pas prise en charge.La définition d'une valeur pour cette propriété entraîne le non-enregistrement des arguments.Cet Object 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.
• Balises du projet (Project tags) : vous permet d'ajouter une ou plusieurs balises au projet, soit en créant de nouvelles balises, soit en réutilisant des balises déjà définies dans Orchestrator. Il existe deux types de balises : libellés et propriétés (paires clé-valeur). Les balises sont incluses dans le package publié et aident à décrire et catégoriser les projets. Pour plus d'informations, consultez la section À propos des projets d'automatisation.
• URL Automation Hub : URL d'une idée Automation Hub liée au projet. Pour plus d'informations, consultez Lier un projet à une idée dans Automation Hub.
• Icône de package (Package Icon) : en option, définissez une icône personnalisée pour le projet. Vous pouvez parcourir et sélectionner un fichier, ou entrer un chemin ou une URL publique vers un fichier ico, jpeg, jpgou png d'une taille pouvant aller jusqu’à 1 Mo. Une fois le projet publié, l’icône est affichée à côté du paquet dans la fenêtre Gérer les paquets (Manage Packages) dans Studio.
• Compiler les expressions des activités (Compile activities expressions) : sélectionnez Oui (Yes) pour compiler et empaqueter toutes les expressions d'activités avec la bibliothèque. Vous réduisez ainsi le temps d'exécution. Disponible pour Windows - bibliothèques héritées uniquement.
• 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. Disponible pour Windows - bibliothèques héritées uniquement.
• Séparer les dépendances Runtime (Separate Runtime Dependencies) : permet d'augmenter les performances du Robot et réduire la taille des packages publiés, les bibliothèques sont séparées en packages de conception et de runtime. Le package de conception est utilisé par Studio et le package d’exécution plus léger est utilisé par le Robot.
• Inclure des sources : définissez sur Oui pour regrouper toutes les sources .xaml dans le package publié, y compris les workflows rendus précédemment privés. Pour les bibliothèques Windows - Héritage (Windows-Legacy), les fichiers sont enregistrés dans le fichier de l'assembly généré et dans le dossier lib\net45 dans le fichier .nupkg. Pour les bibliothèques et processus Windows et multiplate-formes, les fichiers sont enregistrés dans le dossier content dans le fichier .nupkg.

Publication d'une bibliothèque

La publication de bibliothèques est semblable à la publication de processus. Pour plus d'informations, consultez À propos de la publication des projets d'automatisation.Contrairement aux processus, la publication d'une bibliothèque crée deux fichiers NUPKG : un package de phase de conception et un package de runtime. Cela s'applique uniquement aux bibliothèques Windows et multiplate-forme si l'option Séparer les dépendances du runtime (Separate Runtime Dependencies) de Paramètres du projet (Project Settings) est activée.

Remarque :

• En raison de la séparation entre les packages de phase de conception et de runtime, la compatibilité des bibliothèques personnalisées publiées dans Studio 2023.4 n’est pas garantie avec les versions antérieures de Studio.
• Vous ne pouvez installer dans un projet que le package pour la phase de conception, car il est remplacé par le package de runtime lors de la publication. L’installation du package de runtime uniquement provoquera des problèmes inattendus dans Studio.
• À partir de Studio 2023.10.0, la séparation entre les packages de phase de conception et de runtime ne se produit que dans les cas suivant :
  • Un fichier ViewModels.dll est généré lors du processus de compilation. Le fichier ViewModels.dll est généré pour les bibliothèques Windows et multiplate-forme lors de la configuration des propriétés de l’activité affichermodèle (viewmodel) pour au moins un fichier de workflow de la bibliothèque.
  • L’option Séparer les dépendances Runtime (Separate Runtime Dependencies) est activée.

Limitations lors l'utilisation des bibliothèques

Lors de l'utilisation 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.

• Si une bibliothèque contient un fichier .xaml et un argument portant le même nom, la bibliothèque ne pourra pas être publiée.

• Les projets de bibliothèque avec la compatibilité Windows - Legacy ne peuvent pas être publiés s'ils contiennent des activités Invoquer le fichier de workflow avec l'option Isolé sélectionnée.Un message d'erreur s'affiche dans le panneau Sortie lorsque vous essayez de publier. Cette limitation ne s'applique pas aux bibliothèques qui utilisent la compatibilité Windows ou inter-plateformes.

• 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.

• Si une bibliothèque contient une activité qui accepte un chemin de fichier comme entrée, pour vous assurer que le chemin est résolu correctement dans les projets où la bibliothèque est installée, ajoutez la constante globale UiPath.Emplacement.Projet.Constantes (UiPath.Constants.Project.Location) lors du référencement du chemin (utilisez cette casse exacte). Cette action désactive le remplacement de Environment.CurrentDirectory par le dossier de bibliothèque au début de l'exécution d'une activité de bibliothèque et utilise la constante à la place.

  Par exemple, si un fichier nommé Employé.txt (Employee.txt) situé dans le sous-dossier DonnéesEntrée (InputData) du projet de bibliothèque est utilisé dans une activité Lire le fichier (Read File), indiquez le chemin d'accès comme suit :

  UiPath.Constants.Project.Location+"InputData\Employee.txt"

  Remarque :

  La constante ne doit pas être utilisée dans les activités Invoquer le fichier de workflow à l'intérieur des bibliothèques.

• Pour référencer un emplacement dans le dossier du projet où une bibliothèque est installée, indiquez en tant qu'argument le chemin d'accès à la bibliothèque.

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

Considérations relatives à l'installation de bibliothèques dans les projets

• Les bibliothèques avec la compatibilité multiplate-forme peuvent être installées dans des projets multiplate-forme et Windows. Les bibliothèques Windows - Legacy et Windows ne peuvent être installées que dans les Processes qui ont la même compatibilité.
• 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.
• Lorsque vous utilisez Importer des workflows (Import Workflows) pour ajouter un workflow qui contient une bibliothèque dans un projet de bibliothèque, les dépendances référencées dans la bibliothèque ne seront pas importées.
• Lors de l’importation de deux versions d’une même bibliothèque personnalisée dans un projet, les activités personnalisées supplémentaires contenues uniquement dans la deuxième bibliothèque ne sont pas visibles dans le panneau Activités (Activities), sauf si vous supprimez la première bibliothèque importée.
• L'utilisation de points (.) dans le nom de la bibliothèque permet de séparer la bibliothèque en différents groupes imbriqués lorsque vous l'afficher dans le panneau Activités.
• Lorsque vous utilisez des activités personnalisées provenant d'une bibliothèque, les valeurs par défaut définies pour les arguments sont automatiquement préremplies dans le panneau Propriétés de l'activité lorsque l'activité est ajoutée au workflow. Si vous effacez la valeur d'un champ de propriété du workflow, la valeur par défaut correspondante n'est pas utilisée lors de l'exécution. Dans ce cas, une valeur vide est transmise explicitement. En revanche, lorsque vous utilisez l'activité Invoke Workflow, si vous laissez une entrée vide dans le panneau Importer des arguments, la valeur par défaut définie dans le workflow invoqué sera utilisée lors de l'exécution.