À 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 à partir du Gestionnaire de packages (Package Manager).

Par exemple, vous pouvez créer une bibliothèque qui collecte des données à partir d'un tableur Excel et l'ajoute à une autre, comme cela est expliqué à la page Création d'une bibliothèque de base. Ensuite, vous pouvez empaqueter et utiliser la bibliothèque 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înerait une erreur de compilation dans les projets où la bibliothèque a été 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 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.

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. Les arguments marqués comme requis sont disponibles dans le corps de l'activité dans le panneau Concepteur (Designer). Les annotations que vous ajoutez à un argument dans la bibliothèque s'affichent sous forme d'info-bulle pour la propriété dans le panneau Propriétés de l'activité résultante. Pour plus d'informations sur les arguments, consultez Panneau Arguments(Arguments).

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. La définition d'une valeur pour cette propriété entraîne le non-enregistrement des arguments. 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.
• 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 projet (Project 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, jpg, ou 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.

• Inclure des sources : définissez sur Oui pour inclure toutes les sources .xaml dans le package de bibliothèque, y compris les workflows rendus précédemment privés. Pour les bibliothèques 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 Windows et multiplateformes, les fichiers sont enregistrés dans le dossier content dans le fichier .nupkg.
• 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.
• Modern Design Experience : configurez sur Oui pour activer Modern Design Experience avec UI Automation, incluant des activités nouvelles et améliorées, des enregistreurs et des assistants, ainsi que le référentiel d’objets.

Publication d'une bibliothèque

La publication de bibliothèques est similaire aux processus de publication. Pour en savoir plus, consultez la section À propos de la publication de projets d'automatisation.

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.
• 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 Appeler le fichier de flux de travail (Invoke Workflow File) avec l'option Isolé (Isolated) sélectionnée. Un message d'erreur s'affiche dans le panneau Sortie (Output) lorsque vous essayez de publier. Cette limitation ne s'applique pas aux bibliothèques qui utilisent la compatibilité Windows ou multiplateforme.
• 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 l'activité Invoke Workflow File dans 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 en tant qu'entrée, lorsque le composant est utilisé dans un projet, les chemins d'accès qui incluent des variables d'environnement sont interprétés comme des chemins d'accès relatifs au dossier de la bibliothèque. Pour contourner ce problème, utilisez la méthode Environment.GetEnvironmentVariable ou une activité Récupérer le dossier d'environnement (Get Environment Folder) pour récupérer le chemin du dossier, puis utilisez la sortie pour construire un chemin absolu à transmettre au composant réutilisable.
• Si un fichier de workflow placé dans un dossier d'une bibliothèque est utilisé comme espace de noms dans un projet, la modification du nom du dossier, la republication et l'installation de la bibliothèque mise à jour dans le projet entraînent des activités inconnues.

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 peuvent uniquement être installées dans des projets ayant la même compatibilité.
• Si une bibliothèque multiplate-forme contient un workflow avec des activités UI Automation, l'ajout de l'activité générée dans un projet multiplate-forme entraîne une erreur de validation lors de l'exécution de ce projet.
• 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.