- 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 projets d'automatisation
Studio vous permet de créer les types de projets suivants :
- Processus (Process) - Concevez un processus d'automatisation et publiez-le afin qu'il puisse être exécuté par des robots.
- Bibliothèque (Library) - Concevez des workflow en tant que composants réutilisables et publiez le projet en tant que bibliothèque pouvant être ajoutée en tant que dépendance à plusieurs processus. Pour plus d'informations, consultez À propos des bibliothèques.
- Automatisation des tests - Concevez un projet d'automatisation de test. Pour plus d'informations sur l'automatisation de test, consultez la section Suite de tests.
- Modèle : concevez un processus et publiez-le en tant que modèle à partir duquel d'autres processus possédant des caractéristiques en commun pourront ensuite se baser. Pour plus d'informations, voir Modèles de projet.
Pour créer un nouveau projet vierge, rendez-vous dans Accueil (Accueil) (mode Backstage de Studio) > Démarrer (Start) et sélectionnez le type de projet à créer en tant que Nouveau projet. Vous pouvez également commencer par l'un des modèles par défaut disponibles sous Nouveau modèle source (New from Template) ou accéder à l'onglet Modèles (Templates) pour rechercher d'autres modèles provenant de diverses sources.
Dans la fenêtre du nouveau projet, configurez les éléments suivants pour chaque projet :
- Entrez le nom du nouveau projet (jusqu'à 128 caractères) ainsi qu'une description résumant ce que vous souhaitez faire avec ce projet d'automatisation (jusqu'à 500 caractères).
- Sélectionnez l'emplacement où créer le projet. L'emplacement par défaut où les projets sont créés est
%USERPROFILE%\Documents\UiPath
. -
Sélectionnez la compatibilité et le langage.
Remarque : La compatibilité et le langage ne peuvent pas être modifiés après la création d'un projet. Vous pouvez convertir vos projets hérités depuis Windows vers la compatibilité Windows.
Par défaut, le dossier du projet comprend les fichiers et sous-dossiers suivants :
-
Fichiers
Main.xaml
- Créé par défaut pour contenir votre workflow principal. De plus, tous les autres fichiers XAML d'automatisation que vous ajoutez au projet sont stockés dans le dossier du projet. En option, vous pouvez définir un fichier différent en tant que fichier principal. Tous les fichiers doivent être liés au fichier défini comme principal ou à un fichier marqué comme point d'entrée du projet à l'aide de l'activité Appeler le fichier de flux de travail (Invoke Workflow File). Pour les projets d'automatisation de test, un fichierTestCase.xaml
est créé par défaut en lieu et place deMain.xaml
.Remarque :- Vous ne pouvez pas exécuter de projets Windows contenant un fichier XAML nommé
Init.xaml
. - Un fichier XAML placé dans le dossier racine d'un projet ne peut pas avoir le même nom qu'un sous-dossier contenant d'autres fichiers XAML.
- Vous ne pouvez pas exécuter de projets Windows contenant un fichier XAML nommé
project.json
- Contient des informations relatives à votre projet d'automatisation.
-
Sous-dossiers
.entities
- Contient les données sur les entités importées du Data Service, si celles-ci sont utilisées dans le projet.-
.local
- Contient les données mises en cache localement pour le projet.Remarque :- Le dossier
.local
est masqué. Vous pouvez activer l'affichage des éléments masqués à partir des paramètres de l'explorateur de fichiers Windows. - Le dossier
.local
ne doit pas être commun à plusieurs projets.
- Le dossier
.objects
- Contient les données relatives aux éléments ajoutés au référentiel d'objets, si ceux-ci sont utilisés dans le projet..project
: contient les balises ajoutées au projet..screenshots
- Contient des captures d'écran informatives générées dans les activités d'automatisation de l'interface utilisateur, si celles-ci sont utilisées dans le projet..settings
- Contient les paramètres du projet d'activité utilisés lors du runtime..templates
: contient les modèles de fichiers ajoutés au projet.-
.tmh
- Contient des données relatives aux cas de test, si ceux-ci sont utilisées dans le projet.Remarque : les projets créés avec des versions plus récentes de Studio peuvent ne pas fonctionner avec des Robots plus anciens. En savoir plus sur la compatibilité ascendante et descendante.Vous ne pouvez pas utiliser les caractères suivants dans les noms de fichiers :", <, >, |, :, *, ?, \, /,;
. Ces caractères proviennent des restrictions Microsoft Windows et d'autres restrictions de caractères spéciaux.
Lorsque vous créez un nouveau projet, sélectionnez la compatibilité en fonction de l'environnement sur lequel le projet sera exécuté :
- Windows : utilise .NET 8 avec prise en charge Windows. Il s'agit de l'option par défaut.
- Multiplate-forme (Cross-platform) : utilise .NET 8 avec prise en charge multiplate-forme.
-
Windows - Legacy - Utilise l'infrastructure .NET 4.6.1. la compatibilité utilisée dans les versions antérieures à 2021.10.
Important :- Les processus Windows et multiplate-forme nécessitent Orchestrator 2021.10 ou une version supérieure pour fonctionner.
- L’option Windows - Héritage (Windows - Legacy) n’est plus disponible pour les nouveaux projets. Nous vous recommandons de sélectionner Windows ou Multiplate-forme (Cross-platform) lors de la création d’un nouveau projet. Vous pouvez convertir vos projets hérités depuis Windows vers la compatibilité Windows ou utiliser des politiques de gouvernance pour restaurer l’option de création de projets hérités depuis Windows.
Pour en savoir plus sur les différences entre les compatibilités, consultez le tableau suivant. Pour en savoir plus sur l'expérience de conception dans chaque compatibilité, consultez Conception d'automatisations ( Designing Automations).
Windows - Héritage |
Windows |
Multiplateforme | |
---|---|---|---|
Exécution du processus |
32 bits |
64 bits |
64 bits |
Plateformes prises en charge pour l'exécution |
Windows (64 bits) |
Windows (64 bits) |
Windows, Linux et macOS (64 bits) |
Les processus sont compilés lorsqu'ils sont publiés |
Non. Les packages publiés contiennent les fichiers source du projet. |
Oui. Les packages publiés contiennent des fichiers DLL compilés. |
Oui. Les packages publiés contiennent des fichiers DLL compilés. |
Seuls les packages d'activités qui prennent en charge la compatibilité sélectionnée peuvent être installés à partir du gestionnaire des packages.
La compatibilité de chaque projet est affichée sur le côté droit de la barre d'état de Studio et dans le panneau Projet (Project) > nœud Dépendances (Dependencies). La compatibilité est également affichée dans l'entrée de chaque projet dans la liste Ouvrir les éléments récents (Open Recent) dans Accueil (Home) (mode Backstage de Studio) > onglet Démarrer (Start).
- La copie et le collage d’activités entre des projets disposant des compatibilités différentes ne sont pas pris en charge.
- Si Studio trouve des erreurs de validation lors de la réouverture ou du rechargement d’un projet Windows ou multiplateforme, vous serez invité à importer automatiquement les références manquantes.
Les projets multiplate-forme vous permettent de créer des automatisations qui ne nécessitent pas d'interaction de l'utilisateur, ainsi que des automatisations de navigateur Web à l'aide de Chrome. Les automatisations multiplate-forme peuvent être exécutées sur les systèmes d'exploitation Windows et de type Unix tels que Linux et macOS.
Pour créer des projets non assistés avec prise en charge multiplateforme :
- Dans Studio, créez un nouveau projet et sélectionnez l'option de compatibilité Multiplate-forme (Cross-platform). Cette option est disponible pour tous les types de projets. Pour les processus qui utilisent le langage VB pour les expressions, vous avez la possibilité de travailler à la fois dans Studio et dans Studio Web.
-
Concevez l'automatisation. Veuillez noter que tous les packages d'activités ne sont pas compatibles avec les projets multiplate-forme. Par conséquent, seule une sélection de packages est disponible dans le gestionnaire des packages. En savoir plus sur l'expérience de conception dans les projets multiplate-forme.
Les dépendances par défaut pour un projet multiplate-forme sont :
- Dans le profil Studio : Activités.Système.UiPath (UiPath.System.Activities), UiPath.Activités.Test (UiPath.Testing.Activities), UiPath.Activités.ApiWeb (UiPath.WebApi.Activities) et UiPath.Activités.AutomatisationIU (UiPath.UIAutomation.Activities).
- Dans le profil StudioX : UiPath.Activités.Système (UiPath.System.Activities), Microsoft Office 365, Espace de travail Google (Google Workspace) et UiPath.Activités.AutomatisationIU (UiPath.UIAutomation.Activities).
- Testez l'automatisation. Nous vous recommandons de tester les automatisations sur les machines sur lesquelles elles s'exécuteront via le débogage à distance, qui fonctionne à la fois avec les robots Windows, Linux et macOS.
-
Après avoir testé l'automatisation, publiez le projet sur Orchestrator. La procédure d'exécution des tâches non assistées est la même pour Windows, macOS et Linux.
Attention : cette version de Studio n'est pas compatible avec les anciennes versions de packages d'activités multiplate-forme qui étaient disponibles dans Studio 2022.4 ou une version antérieure. Si vous avez créé des projets multiplate-forme dans des versions de Studio antérieures à 2022.10, mettez à jour les packages installés vers les dernières versions. Certaines propriétés peuvent ne plus être modifiables.
Ouverture d'un projet dans Studio Web
Si vous souhaitez concevoir vos projets multiplate-forme à tout moment depuis n’importe quel appareil et directement depuis votre navigateur, vous pouvez ajouter des projets au cloud et les modifier dans Studio Web, le concepteur d’automatisation dans Automation Cloud™. Lorsque vous ajoutez un projet au cloud, les modifications sont toujours synchronisées, ce qui vous permet de basculer facilement entre le bureau et le Web et de reprendre là où vous vous êtes arrêté.
- Les projets multiplate-forme qui utilisent le langage C# pour les expressions, ainsi que les projets Windows qui utilisent n’importe quel langage (VB ou C#) ne sont pas pris en charge dans Studio Web. Vous pouvez enregistrer des projets multiplate-forme C# ou des projets Windows dans le cloud, mais vous ne pourrez pas les modifier dans Studio Web.
- Les projets contenant des workflows d'organigramme ne peuvent pas être ouverts dans Studio Web.
Gérer un projet cloud dans Studio
Pour être compatible avec Studio Web, un projet multiplate-forme doit répondre aux exigences suivantes :
- Le type de projet est un processus.
- Le langage des expressions est VB.
Pour enregistrer un projet local dans le cloud, sélectionnez Enregistrer (Save) dans le ruban Studio, puis Enregistrer dans Cloud (Save to Cloud). Une fois qu’un projet est enregistré dans Studio Web, le libellé dans la barre d’état devient Projet Cloud (Cloud Project). Cliquez sur le libellé pour ouvrir un menu déroulant contenant des options vous permettant de gérer le projet :
- Ouvrir dans Studio Web (Open in Studio Web) : permet d'ouvrir le projet dans Studio Web. Si le projet est verrouillé par Studio Web, une erreur s'affiche et le projet est ouvert dans un nouvel onglet en mode lecture seule.
-
Synchroniser avec Cloud (Sync to Cloud) : permet de récupérer les dernières modifications que vous avez apportées dans Studio Web. S’il existe des différences entre le projet distant et le projet local, vous devez d’abord confirmer que vous souhaitez écraser la version locale.
- Enregistrer sous (Save As) : enregistre le fichier de workflow actuel.
- Enregistrer tout (Save All) : enregistre toutes les modifications apportées au projet.
- Synchroniser avec Cloud (Sync to Cloud) : permet d’enregistrer les dernières modifications que vous avez apportées dans Studio Desktop au projet dans Studio Web. Si le projet distant comporte des modifications, vous devez d’abord confirmer que vous souhaitez les écraser. Vous ne pouvez pas synchroniser avec Cloud si le projet est verrouillé par Studio Web.
Remarque : une erreur Échec de l’enregistrement dans Cloud (Save to Cloud failed) s’affiche lorsque vous tentez d’utiliser l’option Ouvrir dans Studio Web (Open in Studio Web) dans un projet déjà ouvert dans Studio Web.
- Enregistrer une copie (Save a Copy) : permet d'enregistrer le projet actuel localement en tant que nouveau projet. Vous pouvez modifier le nom, sélectionner l'emplacement d'enregistrement et saisir une description du projet.
Vous pouvez afficher tous les fichiers et dossiers du projet dans l' explorateur de projets de Studio Web, mais vous ne pouvez modifier que les workflows de la séquence de types.
De même, lorsque vous créez un projet dans Studio Web, vous avez la possibilité de continuer à travailler dans Studio. Sur la page Projets de Studio Web, ouvrez le menu sur le côté droit d'un projet, puis sélectionnez Ouvrir dans Studio Desktop.
Mode de synchronisation des modifications entre Studio et Studio Web
Lorsque vous enregistrez et fermez un projet cloud dans Studio, les modifications sont également enregistrées dans le projet distant si le projet n'est pas verrouillé par Studio Web. Lorsque vous ouvrez ensuite le projet dans Studio Web, le projet est mis à jour avec toutes les modifications que vous avez enregistrées dans le cloud dans Studio.
Lorsque vous ouvrez un projet cloud dans Studio, le projet est mis à jour avec toutes les modifications que vous avez apportées dans Studio Web. Pour mettre à jour un projet déjà ouvert dans Studio avec les dernières modifications de Studio Web, sélectionnez Projet Cloud (Cloud Project) > Obtenir la dernière version ( Get Latest Version ) dans la barre d'état de Studio.
Conversion d'un projet multiplate-forme vers Windows
La conversion d'un projet multiplate-forme vers la compatibilité Windows vous permet de profiter d'activités qui ne sont disponibles que dans les projets Windows (par exemple, les activités UI Automation, Excel ou Form), ce qui facilite l'amélioration d'un projet Studio Web avec l'automatisation du poste de travail dans Studio. Pour convertir un projet multiplate-forme vers Windows, vous pouvez soit :
- Dans Studio, cliquer avec le bouton droit sur le projet dans le module Projet (Project) et sélectionner Convertir vers Windows (Convert to Windows) dans le menu. Dans StudioX, sélectionner Projet (Project) > Convertir vers Windows (Convert to Windows) dans le ruban qui se trouve en haut de la fenêtre StudioX.
- Ajoutez à votre projet une activité disponible uniquement dans les projets Windows. La catégorie du panneau Activités Windows répertorie les activités installables qui ne sont disponibles que dans les projets Windows. Lorsque vous ajoutez ce type d'activité à votre projet depuis le panneau Activités ou la barre de recherche Ajouter une activité, vous êtes invité à convertir le projet vers Windows.
- Sélectionner Créer un nouveau projet (Create a new project) pour créer une copie du projet actuel à l'aide de la compatibilité Windows et conserver le projet multiplate-forme d'origine.
- Décocher la case Créer un nouveau projet (Create a new project) pour mettre à jour le projet existant et le convertir vers la compatibilité Windows (cette action est irréversible).
Lorsque vous créez un nouveau projet dans le profil Studio, vous pouvez sélectionner le langage à utiliser pour les expressions (soit VB, soit C#). VB est le langage sélectionné par défaut, mais vous pouvez définir C# comme langage par défaut des nouveaux projets en accédant à Accueil (Home) (mode Backstage de Studio) > Paramètres (Settings) > Conception (Design). Les projets créés dans les profils StudioX utilisent le langage VB.NET pour les expressions.
L’utilisation d’expressions VB et C# dans le même projet n’est pas prise en charge. L’utilisation d’expressions VB dans les flux de travail C# et vice versa non plus. Lorsque vous copiez et collez des activités à partir d'autres projets, invoquez ou importez des flux de travail, assurez-vous qu'ils utilisent le même langage que votre projet.
Vous pouvez installer des bibliothèques C# en tant que dépendances dans des projets VB et vice versa. Cependant, les valeurs par défaut des arguments du projet de bibliothèque à l'aide d'expressions spécifiques au langage ne sont pas accessibles depuis le projet sur lequel la bibliothèque est installée.
- L'implémentation actuelle de C# est basée sur le compilateur C# qui utilise la version 5 du langage C#. Par conséquent, l'accès aux nouvelles fonctionnalités telles que l'affectation de fusion, l'opérateur conditionnel nul, l'opérateur de fusion nul, l'interpolation de chaîne et autres est limité.
- Les projets contenant des expressions avec des incréments ne sont pas valides.
- Les expressions contenant l'opérateur
nameof()
sont marquées comme non valides et ne sont pas autorisées avec l'implémentation actuelle de C#. - Les expressions contenant des appels à méthodes avec arguments facultatifs doivent inclure des valeurs pour les arguments facultatifs.
- Le temps de conception et les performances d'exécution des projets C# sont inférieurs à ceux de VB.NET. Lorsque les performances d'exécution sont essentielles, nous vous recommandons d'utiliser VB.NET au lieu de C#.
-
Chaque exécution d'un projet Windows - Héritage (Windows - Legacy) avec C# crée un fichier DLL compilé dans le dossier
%appdata%\Temp
qui n'est pas automatiquement supprimé après l'exécution du projet. Si le stockage est un problème, vous pouvez :- utiliser des projets Windows ou multiplate-formes avec C#.
- utiliser des projets Windows - Héritage (Windows - Legacy) avec VB.
- supprimer manuellement les fichiers inutiles après l'exécution.
Le format du schéma de contrôle de version sémantique est Major.Minor.Patch[-Suffix], où :
- Major est la version majeure.
- Minor est la version mineure.
- Patch est la version de correctif.
- -Suffix (facultatif) est un trait d'union suivi d'une série d'identificateurs séparés par des points immédiatement après la version de correctif. Cela permet de décrire une version préliminaire.
Les identificateurs doivent être uniquement composés de caractères alphanumériques ASCII et d'un trait d'union. Ils ne doivent pas être vides. Les identificateurs numériques ne doivent pas inclure de zéros de tête. En outre, les métadonnées de build peuvent être décrites en ajoutant un signe plus et une série d'identificateurs séparés par des points immédiatement après la version de correctif ou préliminaire, par exemple 1.0.0-alpha+1.
project.json
. Le correctif numéro 0 est automatiquement ajouté aux projets portant le numéro de version major.minor
.
Le format du numéro de version hérité du projet est M.m.bbbb.rrrrr, où :
- M correspond à la version principale.
- m correspond à la version secondaire.
- bbbb correspond à la version du build.
- rrrrr correspond à la version de révision.
project.json
, tandis que les versions de build et de révision sont générées selon un algorithme. La valeur de build est le nombre de jours qui s'est écoulé depuis 01.01.2000. La valeur de révision est le nombre de secondes qui s'est écoulé depuis le jour en cours, jusqu'au moment de la publication. Le résultat est divisé par 2, pour que le numéro de révision maximum ne dépasse pas 65 535.
Le numéro de version suggéré dans la fenêtre Publier (Publish) est généré en fonction du schéma de version précédent du projet, tandis que la date et l'heure actuelles sont prises en compte pour les projets utilisant le schéma de contrôle de version à 4 chiffres.
Le panneau Projet (Project) permet d'afficher et de filtrer le contenu du projet actuel, d'ajouter des dossiers, d'ouvrir l'emplacement des fichiers, de gérer des dépendances et d'ajuster les paramètres du projet.
.xaml
. Vous pouvez également utiliser les raccourcis Ctrl + C et Ctrl + V ou bien les options Copier et Coller dans le menu contextuel pour copier et dupliquer des fichiers ou des dossiers à l'intérieur du panneau.
Vous pouvez double-cliquer sur les fichiers TXT, CS, VB, JSON (à l'exception du fichier project.json) et XML de moins de 10 Mo pour les modifier dans Studio dans un éditeur de texte avec mise en surbrillance de la syntaxe.
Option |
Description |
---|---|
Tout développer |
Développe tous les nœuds dans le projet d'automatisation. |
Tout réduire |
Réduit tous les nœuds dans le projet d'automatisation. |
Actualiser |
Actualise le projet. |
Synchroniser avec le document actif | Se concentre sur un élément de projet actif dans le module Designer. |
Afficher tous les fichiers |
Affiche tous les fichiers appartenant au projet d'automatisation, y compris
project.json .
|
Explorateur de fichiers |
Ouvre l'emplacement du projet sur la machine. |
Paramètres du projet |
Ouvre la fenêtre Paramètres du projet (Project Settings) des processus ou des bibliothèques. |
Filtrer par type de fichier |
Filtre les fichiers du projet actuel qui peuvent être modifiés dans Studio par type de fichier : Workflows, Cas de test (Test Cases), Formulaires (Forms), Code, Texte (Text), Objets (Objects) (désactivé par défaut), Afficher les dossiers masqués (Show caché dossiers) (désactivé par défaut). Pour afficher tous les fichiers du dossier du projet, sélectionnez Autre (Other) (désactivé par défaut). |
Faites un clic droit n’importe où dans le panneau Projet pour ouvrir le menu contextuel avec les options décrites dans le tableau suivant. Un sous-ensemble d’options différent est disponible en fonction de l’endroit où vous réalisez le clic droit dans le panneau, du type de projet et de l’ajout du projet au contrôle de code source.
Option |
Description |
---|---|
Ouvrir le dossier Projet (Open Project Folder) |
Ouvre le dossier local contenant le projet. |
Paramètres du projet |
Ouvre la fenêtre Paramètres du projet (Project Settings) pour ajuster les préférences du projet. |
Ajouter (Add) |
Ouvre une liste d'éléments qui peuvent être ajoutés au projet : dossier, fichier, séquence, flowchart, automate, formulaire, workflow, gestionnaire global, ou, dans les projets d'automatisation de test, cas de test. Utilisez le workflow pour créer un fichier de workflow basé sur des modèles intégrés (séquence, flowchart, machine d'état) ou des modèles de fichiers locaux. |
Import Files |
Ouvre la fenêtre de l'explorateur de fichiers pour importer des fichiers dans votre projet. Par défaut, le filtre
*.xaml est appliqué pour répertorier uniquement les fichiers de workflow, mais vous pouvez le remplacer par tous les fichiers pour importer d'autres types de fichiers. Importé (Imported) est ajouté au nom du fichier importé s'il coïncide avec le nom d'un workflow du projet actuel.
Vous ne pouvez importer que des fichiers de workflow qui utilisent le même langage pour les expressions que le projet en cours. Lorsque vous importez un fichier de workflow, les dépendances du projet actuel sont comparées à celles du fichier de projet source, si celui-ci est disponible. En cas de divergence, la fenêtre Importer un workflow ((Import Workflow) s'affiche avec des informations sur les modifications nécessaires pour éviter les activités non résolues. Les mises à jour des dépendances disponibles sont sélectionnées par défaut et sont installées lorsque vous sélectionnez Importer (Import).
Vous pouvez éventuellement indiquer un fichier project.json à utiliser comme référence et choisir de rechercher ou non dans les versions préliminaires du package. |
Convertir vers Windows |
Dans les projets hérités depuis Windows et multiplate-forme, ouvre la fenêtre Convertir vers Windows (Convert to Windows) dans laquelle vous pouvez convertir le projet vers la compatibilité Windows. |
Ajouter au contrôle de code source |
Ajoute le projet actuel au contrôle de code source à l'aide des options Init. de Git (Git Init), Copier dans Git (Copy to Git), Ajouter à TFS (Add to TFS) ou Ajouter à SVN (Add to SVN). Notez que cette option n'est visible que lorsque vous cliquez avec le bouton droit sur le nœud du projet. Lorsqu’un projet est ajouté au contrôle de code source, des options supplémentaires sont disponibles dans le menu contextuel. Voir les options pour GIT et les options pour SVN et TFS. |
Ouvrir |
Ouvre les fichiers sélectionnés à l'aide du programme par défaut. |
Ouvrir l'emplacement du fichier |
Ouvre le dossier local contenant le fichier. |
Renommer |
Permet de renommer le fichier ou le dossier sélectionné en ouvrant la fenêtre Renommer l'élément (Rename Item). L'élément est renommé dans toutes les occurrences. Remarque : le chemin d'accès complet au nouveau fichier ne doit pas dépasser 258 caractères. |
Copier |
Copie les fichiers ou dossiers sélectionnés dans le presse-papiers. Vous pouvez ensuite les coller dans le panneau du projet ou dans l'explorateur de fichiers Windows. |
Coller |
Colle dans le presse-papiers les fichiers ou dossiers qui ont été copiés. |
Supprimer (Delete) |
Supprime l'élément sélectionné uniquement de votre machine locale. |
Sélectionner pour comparer |
Sélectionne le fichier actuel à des fins de comparaison. |
Comparer avec la sélection |
Compare le fichier actuel avec celui précédemment sélectionné en utilisant l'option Comparer les fichiers (Compare Files). |
Rechercher des références |
Trouve toutes les références au fichier dans le projet. Les résultats sont affichés dans le panneau Rechercher des références. |
Ouvrir dans l'éditeur de texte |
Ouvre le fichier texte sélectionné dans un éditeur de texte dans Studio en mode lecture seule. Pour ouvrir un fichier texte en mode d'édition, double-cliquez dessus. Vous pouvez double-cliquer sur les fichiers TXT, CS, VB, JSON (à l'exception du fichier project.json) et XML de moins de 10 Mo pour les modifier dans Studio dans un éditeur de texte avec mise en surbrillance de la syntaxe. |
Déboguer le fichier |
Débogue le fichier
.xaml sélectionné.
|
Définir comme principal (Set as Main) |
Définit le fichier
.xaml comme Principal dans la définition du projet, ce qui signifie que l’exécution du projet commence avec ce fichier. Il ne peut y avoir qu’un seul fichier de projet Principal. Le nom du fichier défini comme principal apparaît en gras dans le panneau du Projet.
|
Mise en page de l’activité |
Ouvrez la fenêtre Propriétés (Properties) des fichiers dans les projets de bibliothèque, dans laquelle vous pouvez personnaliser la conception de l'activité générée. |
Définir comme gestionnaire global (Set as Global Handler) |
Définit le fichier
.xaml comme Gestionnaire global d'exceptions (Global Exception Handler) pour le projet. Cela s'applique à un workflow par projet/processus.
|
Supprimer le gestionnaire (Remove Handler) |
Supprime la balise Global Exception Handler du fichier
.xaml .
|
Activer le point d'entrée |
Marque le fichier de flux de travail sélectionné comme point d'entrée du processus, ce qui permet de le sélectionner comme flux de travail à exécuter en premier lors de l'utilisation des activités Invoquer le processus (Invoke Process) et Exécuter le processus parallèle (Run Parallel Process) dans d'autres processus, ou au lancement d'une tâche depuis Orchestrator. Remarque :
|
Désactiver le point d'entrée |
Ne marque plus le fichier de flux de travail sélectionné comme point d'entrée du processus. Cette option n'est pas disponible pour le fichier de flux de travail défini comme principal. |
Propriétés d’argument | Ouvre la fenêtre Propriétés d’arguments (Argument Properties) pour configurer les paramètres d’affichage des arguments.
Remarque : cette option est disponible uniquement pour les fichiers XAML définis comme principaux ou marqués comme point d’entrée du projet.
|
Extraire en tant que modèle |
Enregistre le workflow ou le cas de test sélectionné en tant que modèle sur lequel vous pouvez ensuite baser d'autres fichiers dans le projet. L'utilisation d'un modèle de fichier vous permet de gagner du temps lorsque vous devez créer plusieurs fichiers avec la même structure. Lorsque vous ajoutez un nouveau workflow ou cas de test, vous avez la possibilité de le baser sur n'importe quel modèle du même type existant dans le dossier de projet Modèles (Templates). |
Écarter de la publication (Ignore from Publish) / Définir comme publiable (Set as Publishable) |
Marque un ou plusieurs fichiers sélectionnés comme exclus de la publication ou publiables. Remarque :
|
Rendre privé (Make Private) / Rendre public (Make Public) |
Marque un ou plusieurs fichiers sélectionnés dans un projet de bibliothèque comme privé(s) ou public(s). Un fichier de workflow privé sera inclus dans le package publié, mais aucun composant réutilisable ne sera créé et rendu disponible dans le panneau Activités (Activities) pour les projets où la bibliothèque est installée en tant que dépendance. Remarque :
|
Créer un cas de test |
Crée un cas de test qui appelle le fichier de workflow sélectionné. |
Convertir en cas de test (Convert to Test Case) / Convertir en workflow (Convert to Workflow) |
Convertit les workflows sélectionnés en cas de test ou bien les cas de test sélectionnés en workflows. |
Importer des cas de test |
Importe les cas de test dans le projet sous forme de brouillon de cas de test. |
Ajouter des données de test |
Ouvre la fenêtre Importer la source de variation des données (Import Data Variation Source) qui vous permet d'ajouter des données de test au projet. Cette option n'est pas disponible pour les fichiers de cas de test. |
Lier à Test Manager |
Ouvre la fenêtre Lier à Test Manager (Link to Test Manager), qui vous permet de lier les cas de test sélectionnés à Test Manager. |
Exécuter les cas de test (Run Test Cases) / Déboguer les cas de test (Debug Test Cases) |
Exécute ou débogue plusieurs cas de test sélectionnés. |
Options du menu contextuel pour GIT
Dans les projets ajoutés aux référentiels GIT, une icône s’affiche à côté de chaque fichier du panneau Projet pour indiquer le statut du fichier :
Le fichier est synchronisé avec le référentiel.
Le fichier a été modifié.
Le fichier a été ajouté.
Le fichier a été supprimé.
Cliquez droit sur un fichier ou sur un nœud de projet dans le panneau Projet pour ouvrir le menu contextuel spécifique de GIT pour gérer des projets avec GIT.
Option |
Description |
---|---|
Valider |
Valide les modifications actuelles dans le référentiel GIT local. |
Transmettre |
Transmet la version actuelle dans le référentiel distant. |
Recevoir (rebaser) |
Reçoit les fichiers distants et rebase la branche actuelle. |
Gérer les branches |
Ouvre la fenêtre GIT contenant les options de gestion des branches actuellement ajoutées. |
Afficher les modifications |
Ouvre la fenêtre Diff de fichiers (File Diff) pour comparer les modifications entre la version locale et la version distante du fichier. |
Afficher l'historique |
Ouvre la fenêtre Afficher l'historique (Show History) pour comparer deux versions du même fichier. |
Annuler (Undo) |
Ouvre la fenêtre Annuler les modifications en attente (Undo Pending Changes) si le fichier n'a pas été validé ou transmis vers le référentiel distant. |
Copier l’URL du référentiel |
Copie l'URL du référentiel du projet dans le presse-papiers. |
Options du menu contextuel pour SVN et TFS
Dans les projets ajoutés aux référentiels SVN ou TFS, une icône s’affiche à côté de chaque fichier du panneau Projet pour indiquer le statut du fichier :
Le fichier n’est pas extrait pour être édité.
Le fichier est pas extrait pour être édité.
Le fichier a été édité.
Le fichier a été ajouté.
Faites un clic droit sur un fichier ou un nœud de projet dans le panneau Projet pour ouvrir le menu contextuel avec des options spécifiques à la gestion de projets avec TFS ou SVN.
Option |
Description |
---|---|
Ouvrir |
Ouvre le fichier
.xaml sélectionné dans le panneau Concepteur (Designer), en lecture seule, s'il n'a pas été extrait pour la modification du référentiel TFS/SVN.
|
Renommer |
Permet de renommer le fichier ou le dossier sélectionné en ouvrant la fenêtre Renommer l'élément (Rename Item). Lors de l'archivage du fichier
.xaml renommé, la version précédemment modifiée doit également être archivée.
|
Supprimer (Delete) |
Supprime l'élément sélectionné uniquement de votre machine locale. La dernière version archivée du fichier reste disponible dans le référentiel TFS/SVN. |
Extraire pour modification (Check Out For Edit) |
Marque le fichier ou le dossier sélectionné comme étant verrouillé pour empêcher toute modification. Cette option verrouille un fichier sur le serveur afin que personne d'autre ne puisse le modifier. |
Terminer l'édition |
Archive le fichier
project.json dans le référentiel, avec les modifications et un message de validation.
|
Ajouter (Add) |
Importe l'élément sélectionné sur le serveur TFS / SVN. Cette option n'est pas disponible si l'élément a déjà été ajouté au serveur. |
Obtenir la version la plus récente (Get Latest Version) |
Télécharge la dernière version de l'élément sélectionné à partir du référentiel TFS/SVN. |
Afficher les modifications… |
Ouvre Diff de fichiers (File Diff) pour comparer les modifications entre le fichier avec version et celui mappé localement. |
Enregistrement (Check In) |
Ouvre la fenêtre Enregistrer les modifications (Check In Changes) pour importer l'élément sélectionné sur le serveur et remplacer la version actuelle. Le fichier
.xaml doit être enregistré avant de le télécharger. Une fois archivé, le fichier passe en lecture seule dans Studio.
|
Annuler (Undo) |
Affiche la fenêtre Annuler les modifications en attente (Undo Pending Changes) et permet de rétablir les modifications apportées au projet. Rétablissez l'état précédent ou sans version des fichiers modifiés ou récupérez les fichiers supprimés de la machine locale. Une fois le fichier archivé, les modifications ne peuvent pas être rétablies. |
Exécuter (Run) |
Exécute le workflow sélectionné, même s'il n'est pas extrait ou ajouté au référentiel. |
Définir comme principal (Set as Main) |
Définit le fichier
.xaml sélectionné comme principal dans le projet. Le premier .xaml créé est défini comme principal par défaut.
|
Copier l’URL du référentiel |
Copie l'URL du référentiel du projet dans le presse-papiers. |
Vous pouvez établir un ensemble de paramètres individuels pour chaque projet d'automatisation sur lequel vous travaillez. De tels paramètres sont disponibles dans la fenêtre Paramètres du projet (Project Settings), qui peut être ouverte en cliquant sur dans le panneau Projet (Project).
Description des champs de la fenêtre Paramètres (Settings)
Le tableau suivant décrit les paramètres de projet pour les projets de processus, d'automatisation de test et de modèle. Pour plus d'informations sur les paramètres disponibles pour les bibliothèques, consultez À propos des bibliothèques.
Champ |
Description |
---|---|
Nom |
Changez le nom du projet. Ces noms peuvent contenir des caractères d’espace blanc. Lorsque vous nommez des projets, gardez à l’esprit que les caractères d’espace blanc sont supprimés au moment de la publication. Ce champ accepte jusqu’à 128 caractères. |
Description |
Modifiez la description du projet. Ce champ accepte jusqu’à 500 caractères. |
Balises du projet |
Vous pouvez 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. Par exemple, elles peuvent faire référence à l'application automatisée (libellé
Excel ) ou au service (propriété clé-valeur department:accounting ).
Lorsque vous commencez à taper, des correspondances possibles sont suggérées à partir de balises déjà définies, et vous pouvez en réutiliser une en la sélectionnant dans la liste des correspondances. Pour une correspondance de propriété, la clé suivie du caractère
: (deux points) s'affiche en premier, et les valeurs associées s'affichent une fois que vous avez sélectionné la clé,
Pour ajouter une nouvelle balise, après avoir entré le nom, cliquez sur l'entrée avec le signe plus à côté du nom. La séparation des chaînes par le caractère
: (deux points) vous permet d'ajouter des propriétés, tandis que les entrées qui ne contiennent pas de : ajoutent des libellés.
Les étiquettes et les propriétés clé-valeur sont limitées à 256 caractères. Les noms de balise ne peuvent pas contenir ces caractères :
< , > , % , & , \ , ? , / , : .
Les balises de projet peuvent être automatiquement appliquées aux processus dans Orchestrator. Pour plus d'informations sur l'utilisation des balises, consultez la section Organisation des ressources avec des balises (Organizing resources with tags) dans le Guide Orchestrator. |
URL d’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 |
Vous pouvez si vous le souhaitez définir 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
jpeg , jpg ou png d'une taille pouvant aller jusqu’à 1 Mo.
Après la publication du projet, l’icône s’affiche comme suit :
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 sur Orchestrator ou pour 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.
|
Désactiver la pause |
Activez ou empêchez les utilisateurs de suspendre l'exécution à partir de l'assistant UiPath. Choisissez Oui (Yes) si le fait de suspendre le processus pendant son exécution entraîne son crash. Par exemple, si une activité de votre workflow utilise la propriété
Timeout , le fait de suspendre l’exécution peut provoquer son expiration, mettant ainsi fin à l’exécution.
|
Automatisation assistée |
Définissez sur Oui pour indiquer que le projet ne doit être exécuté que dans un contexte assisté. Activez ce paramètre pour les projets qui incluent des activités d' UI Automation ou d'autres activités qui nécessitent une interaction de l'utilisateur. |
Démarre en arrière-plan |
Réglez sur Oui pour transformer le projet en un processus d’arrière-plan et lui permettre de s’exécuter en arrière-plan en même temps que d’autres processus, tant qu’il n’utilise pas l’interaction d’interface utilisateur. |
Prend en charge la persistance |
Réglez sur Oui pour transformer le projet en processus d’orchestration. |
Séparer les dépendances Runtime | Pour 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 d'exécution. 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 | Réglez 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 .
|
Options d’incrustation d’image |
Indiquez si le projet a été testé en utilisant le mode Incrustation d'image (Picture in Picture) et s'il doit démarrer par défaut dans ce mode.
|
Type d’incrustation d’image |
Sélectionnez comment isoler l'automatisation de la session utilisateur lors de l'exécution du projet en mode incrustation d'image : Nouvelle session (New Session), (session enfant sur la machine) ou Nouveau poste de travail (New Desktop) (poste de travail virtuel dans la session utilisateur). |
project.json
.
Consultez la page Configuration des paramètres du projet d'activité pour en savoir plus sur l'ajustement des propriétés d'une activité au niveau du projet.
Les ressources inutiles peuvent rendre les projets plus difficiles à comprendre et peuvent avoir un impact sur les performances. Pour éviter ce problème, supprimez les ressources inutilisées de vos projets en cliquant sur Supprimer les éléments inutilisés (Remove Unused) dans le ruban Studio, puis en sélectionnant les éléments à supprimer :
- Workflows - Supprime les fichiers de workflow qui ne sont pas référencés dans le projet.
- Variables - Supprime les variables qui ne sont pas utilisées dans le fichier qui est ouvert.
- Arguments - Supprime les arguments qui ne sont pas utilisés dans le fichier qui est ouvert.
- Dépendances (Dependencies) - Supprime les packages d’activités installés dont aucune activité n’est utilisée dans le projet.
- Importations (Imports) - Supprime les espaces de noms importés qui ne sont pas utilisés dans le fichier qui est ouvert.
- Captures d’écran (Screenshots) - Supprime les captures d’écran informatives qui ne sont utilisées dans aucune activité dans le projet.
- Configurer la compatibilité du projet
- Concevoir des projets multiplateformes
- Définition du langage du projet
- Limitations C#
- Définition de la version du projet
- Contrôle de version sémantique
- Contrôle de version héritée
- Gérer des projets
- Menu contextuel des projets
- Ajuster les paramètres du projet
- Suppression des ressources de projet inutilisées