- Notes de publication
- Démarrage
- Paramétrage et configuration
- Projets d'automatisation
- À propos de la publication de projets d'automatisation
- Conception d'automatisations
- Gérer les package d’activités
- Configuration des paramètres du projet d'activité
- Signature de paquets
- Gouvernance
- Import des entités
- Modern Design Experience
- Lier un projet à une idée dans Automation Hub
- Utilisation du gestionnaire de données
- Dépendances
- Types de workflows
- Flux de contrôle
- Comparaison de fichiers
- Meilleures pratiques d'automatisation
- Intégration du contrôle de code source
- À propos du contrôle de version
- Gestion de projets à l'aide de TFS
- Gestion de projets à l'aide de SVN
- Diff de workflow
- Débogage
- Journalisation
- L'outil de diagnostic (Diagnostic Tool)
- Analyseur de workflow
- À propos de l'analyseur de workflow
- ST-NMG-001 - Convention d'affectation de noms des variables
- ST-NMG-002 - Convention d'affectation de noms des arguments
- ST-NMG-004 - Duplication du nom complet
- ST-NMG-005 - La variable remplace une autre
- ST-NMG-006 - La variable remplace l'argument
- ST-NMG-008 - Longueur de variable dépassée
- ST-NMG-009 - Ajouter un préfixe aux variables DataTable
- ST-NMG-011 - Ajouter un préfixe aux arguments Datatable
- ST-NMG-012 - Valeurs par défaut de l'argument
- ST-NMG-016 : longueur d'argument dépassée
- ST-NMG-017 : le nom de la classe correspond à l’espace de noms par défaut
- ST-DBP-002 - Nombre élevé d'arguments
- ST-DBP-003 - Bloc d'interception vide
- ST-DBP-007 - Plusieurs couches de l'organigramme
- ST-DPB-010 : plusieurs instances de [workflow] ou [cas de test]
- ST-DBP-020 - Propriétés de sortie non définies
- ST-DBP-021 - Délai d'expiration codé en dur
- ST-DBP-023 : Workflow vide
- ST-DBP-024 - Vérification de l’activité de persistance
- ST-DBP-025 - Condition préalable à la sérialisation des variables
- ST-DBP-026 - Utilisation de l’activité Délai
- ST-DBP-027 - Pratiques exemplaires de persistance
- ST-DBP-028 - Condition préalable à la sérialisation des arguments
- ST-MRD-002 - Valeurs par défaut des noms d'activités
- ST-MRD-004 - Activités inaccessibles
- ST-MRD-005 - Séquences redondantes
- ST-MRD-007 - Clauses If imbriquées
- ST-MRD-008 - Séquence vide
- ST-MRD-009 - Activités profondément imbriquées
- ST-MRD-011 - Utilisation de la ligne d'écriture
- ST-MRD-017 - Incomplet si (Incomplete If)
- ST-USG-005 - Arguments d'activité codée en dur
- ST-USG-009 - Variables inutilisées
- ST-USG-010 - Dépendances inutilisées
- ST-USG-014 - Restrictions sur les paquets (Package Restriction)
- ST-USG-020 - Nombre minimum de messages consignés
- ST-USG-024 - Non utilisé, sauvegardé pour plus tard (Unused Saved for Later)
- ST-USG-025 - Utilisation abusive de la valeur enregistrée (Saved Value Misuse)
- ST-USG-026 - Restrictions d'activité (Activity Restrictions)
- ST-USG-027 - Packages requis
- ST-USG-028 - Restreindre l'invocation des modèles de fichier
- ST-USG-027 - Balises requises
- ST-USG-034 – URL Automation Hub
- Variables
- Arguments
- Noms d'espace importés
- Automatisations codées
- Introduction
- Enregistrement de services personnalisés
- Contextes Avant (Before) et Après (After)
- Génération du code
- Génération de cas de test codé à partir de cas de test manuels
- Automatisation Attended basée sur déclencheur
- Enregistrement
- Éléments de l'interface utilisateur
- À propos des éléments d'interface utilisateur
- Propriétés des activités de l'interface utilisateur
- Exemple d'utilisation des méthodes de saisie
- Méthodes de sortie ou de capture de données d'écran
- Exemple d'utilisation de méthodes de sortie ou de capture de données d'écran
- Génération de tables à partir de données non structurées
- Capture relative de données
- Sélecteurs
- Réf. d’objets
- Capture de données
- Automatisation des images et des textes
- À propos de l'automatisation des images et des textes
- Activités liées à la souris et au clavier
- Exemple d'utilisation de l'automatisation de la souris et du clavier
- Les activités de type texte
- Exemple d'utilisation d'automatisation de texte
- Activités de type OCR
- Activités de type image
- Exemple d'utilisation de l'automatisation d'image et d'OCR
- Citrix Technologies Automation
- Automatisation de RDP
- Automatisation VMware Horizon
- Automatisation de Salesforce
- Automatisation SAP
- macOS UI Automation
- Outil ScreenScrapeJavaSupport
- Protocole Webdriver
- Extensions
- À propos des extensions
- Outil SetupExtensions
- UiPathRemoteRuntime.exe n'est pas en cours d'exécution dans la session distante
- UiPath Remote Runtime bloque la fermeture de la session Citrix
- UiPath Remote Runtime provoque une fuite de mémoire
- UiPath.UIAutomation.Activities package and UiPath Remote Runtime versions mismatch
- L'extension UiPath requise n'est pas installée sur la machine distante
- Paramètres de résolution d’écran
- Group Policies
- Impossible de communiquer avec le navigateur
- L’extension Chrome est automatiquement supprimée
- L'extension a peut-être été corrompue
- Vérification de l'installation et de l'activation de l'extension pour Chrome
- Vérifiez si ChromeNativeMessaging.exe est en cours d’exécution
- Vérifier si la variable ComSpec est correctement définie
- Activez l’accès aux URL de fichiers et au mode navigation privée
- Profils de navigateur multiples
- Group Policy conflict
- Problèmes connus spécifiques aux extensions MV3
- Liste des extensions pour Chrome
- Extension Chrome sur Mac
- Group Policies
- Impossible de communiquer avec le navigateur
- L’extension Edge est automatiquement supprimée
- L'extension a peut-être été corrompue
- Vérification si l'extension pour Microsoft Edge est installée et activée
- Vérifiez si ChromeNativeMessaging.exe est en cours d’exécution
- Vérifier si la variable ComSpec est correctement définie
- Activation de l'accès aux URL de fichiers et au mode navigation privée
- Profils de navigateur multiples
- Group Policy conflict
- Problèmes connus spécifiques aux extensions MV3
- Liste des extensions pour Edge
- Extension pour Safari
- Extension pour VMware Horizon
- Extension pour Amazon WorkSpaces
- Plug-in du gestionnaire de solution SAP
- Complément Excel
- Suite de tests - Studio
- Résolution des problèmes
- À propos de la résolution des problèmes
- Prise en charge et limitations de Microsoft App-V
- Résolution des problèmes rencontrés avec Internet Explorer x64
- Problèmes rencontrés avec Microsoft Office
- Identification des éléments d'IU dans PDF avec options d'accessibilité
- Réparation de la prise en charge d'Active Accessibility
- La validation des projets volumineux hérités depuis Windows prend plus de temps que prévu
À 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é.
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.
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).
Sélectionnez Propriétés de l'activité (Activity Properties) dans le menu de gauche et saisissez les informations suivantes :
- Nom affiché (Display name) : le nom de l'activité affiché dans le panneau Activités (Activities).
- Info-bulle (Tooltip) : info-bulle visible lorsque vous survolez l'activité dans les panneaux Activités (Activities) et Concepteur (Designer) des projets dans lesquels la bibliothèque est installée.
- Lien d'aide (Help Link) : le lien d'aide qui s'ouvre lorsque vous sélectionnez l'activité dans le panneau Concepteur (Designer) et appuyez sur la touche F1 de votre clavier.
- Icône SVG (SVG Icon) : icône SVG à afficher à côté du nom de l’activité.
- Couleur (Color) : la couleur de surbrillance affichée pour l'activité dans le panneau Concepteur (Designer).
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é.
- Info-bulle (Tooltip) : info-bulle visible lorsque vous survolez la propriété de l'activité.
-
Type d'entrée (Input Type) : type d'entrée pour la propriété. Vous pouvez utiliser l'entrée par défaut pour le type de propriété ou sélectionner une option d'entrée en fonction du 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’appel de workflows qui invoquent des workflows codés.
-
Dans les processus 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 seconde activité écrasera les paramètres de l’activité de bibliothèque.
Sélectionnez Propriétés de l'activité (Activity Properties) dans le menu de gauche et saisissez les informations suivantes :
- Info-bulle (Tooltip) : info-bulle visible lorsque vous survolez l'activité dans les panneaux Activités (Activities) et Concepteur (Designer) des projets dans lesquels la bibliothèque est installée.
- Lien d'aide (Help Link) : le lien d'aide qui s'ouvre lorsque vous sélectionnez l'activité dans le panneau Concepteur (Designer) et appuyez sur la touche F1 de votre clavier.
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é.
- Info-bulle (Tooltip) : info-bulle visible lorsque vous survolez la propriété de l'activité.
- 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 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 .
- Dans le cas de bibliothèques, il est recommandé d'utiliser
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 saisir un chemin d'accès ou une URL publique vers un fichier
ico
,jpeg
,jpg
, oupng
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 dossierlib\net45
dans le fichier.nupkg
. Pour les bibliothèques et processus Windows et multiplate-formes, les fichiers sont enregistrés dans le dossiercontent
dans le fichier.nupkg
.
- 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 fichierViewModels.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.
- Un fichier
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 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 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 Appeler le fichier de workflow (Invoke Workflow File) à 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.
- Ouvrez et créez un projet.
- 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.
- Sélectionnez OK, et le paquet est ajouté à la définition du projet.
- 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 - Héritage (Windows - Legacy) et Windows ne peuvent être installées que dans des processus ayant 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.
- Création d'une bibliothèque
- Extraction d'un projet en tant que bibliothèque
- Configuration de la mise en page d'une activité
- Options pour les bibliothèques Windows et multiplate-forme
- Options pour les bibliothèques Windows héritées
- Ajuster les paramètres de la bibliothèque
- Publication d'une bibliothèque
- Limitations lors de l'utilisation des bibliothèques
- Ajout de composants réutilisables aux projets d'automatisation