UiPath Documentation
studio
2022.4
false
Guide de l’utilisateur de Studio
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

À propos des projets d'automatisation

UiPath 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.
  • Library - Design workflows as reusable components and publish the project as a library that can be added as a dependency to multiple processes. For more information, see About Libraries.
  • Test Automation - Design a test automation project. For more information about test automation, check the Studio testing section.
  • Template - Design a process and publish it as a template that other processes which share common characteristics can then be based on. For more information, see Project Templates.

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.

  • Select the compatibility and language.

    Remarque :

    The compatibility and language cannot be changed after you create a project.

Par défaut, le dossier du projet comprend les fichiers et sous-dossiers suivants :

  • Fichiers
    • Main.xaml - Créé par défaut pour conserver votre workflow principal.En outre, tous les autres fichiers XAML d'automatisation que vous ajoutez au projet sont stockés dans le dossier de projet. Vous pouvez éventuellement définir un autre fichier comme principal.Tous les fichiers doivent être liés via l'activité Invoquer le fichier de workflow au fichier défini comme principal ou à un fichier marqué comme point d'entrée du projet.Pour les projets d'automatisation de test, un TestCase.xaml fichier est créé par défaut au lieu de Main.xaml.
    • 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.
    • .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 les versions plus anciennes de Studio. 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.

Important :

L'exécution des Processes Studio sur les robots Automation Cloud™ - VM et les robots Automation Cloud™ - Serverless n'est pas destinée à des fins de développement.

Configurer la compatibilité du projet

Lorsque vous créez un nouveau projet dans le profil Studio, sélectionnez la compatibilité en fonction de l'environnement sur lequel le projet sera exécuté :

  • Windows - Legacy - Utilise l'infrastructure .NET 4.6.1. la compatibilité utilisée dans les versions antérieures à 2021.10. Il s'agit de l'option par défaut.

  • Windows : utilise .NET 6 avec prise en charge Windows.

  • Multiplate-forme (Cross-platform) : utilise .NET 6 avec prise en charge multiplate-forme.

    Important :

    Les processus Windows et multiplate-forme nécessitent Orchestrator 2021.10 ou une version supérieure pour fonctionner.

Pour en savoir plus sur les différences entre les compatibilités, consultez le tableau suivant.

Windows - HéritageWindowsMultiplateforme
Exécution du processus32 bits64 bits64 bits
Plateformes prises en charge pour l'exécutionWindows (32 bits et 64 bits)Windows (64 bits)Windows, Linux et macOS (64 bits)
Les processus sont compilés lorsqu'ils sont publiésNon. 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.

The design experience is the same for all compatibilities, but only the activities packages that support the selected compatibility can be installed from the package manager.

La compatibilité de chaque projet s'affiche sur le côté droit de la barre de statut de Studio et dans le panneau Projet > nœud Dépendances.La compatibilité s'affiche également dans l'entrée de chaque projet de la liste Ouvrir récents, dans Accueil (vue Backstage de Studio) > onglet Démarrer.

Remarque :

La copie et le collage d’activités entre des projets disposant des compatibilités différentes ne sont pas pris en charge.

Concevoir des projets multiplateformes

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 :

  1. Dans Studio, créez un nouveau projet et sélectionnez l'option de compatibilité Multiplateforme. Cette option est disponible pour tous les types de projets.
  2. 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 limitée de packages est disponible dans le gestionnaire des packages. Les dépendances par défaut d'un projet multiplate-forme sont UiPath.Activités.Système (UiPath.System.Activities) et UiPath.Activités.AutomatisationIU (UiPath.UIAutomation.Activities).
  3. Test the automation. We recommend testing automations on the machines where they will run using remote debugging which works with both Windows and Linux robots.
  4. After testing the automation, publish the project to Orchestrator. The procedure for running unattended jobs is the same for Windows, macOS, and Linux.

Définition du langage du projet

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.

Limitations C#

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

Définition de la version du projet

Contrôle de version sémantique

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.

Lors de la création d'un processus ou d'une bibliothèque, le schéma de version par défaut est sémantique. Vous pouvez le modifier dans la fenêtre Publier (Publish) en ajoutant simplement un chiffre supplémentaire au numéro de version. Vous pouvez également modifier la version sémantique du projet dans le fichier project.json. Le numéro de correctif 0 est automatiquement ajouté aux projets avec le numéro de version major.minor.

Contrôle de version héritée

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.

Les versions majeures et mineures peuvent être également modifiées dans le fichier 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.

Gérer des projets

Le panneau Projet (Project) permet d'afficher 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.

Copiez-collez des fichiers depuis l’Explorateur de fichiers directement dans le panneau Projet (Project). Cela s’applique également aux opérations de glisser-déposer d’un ou plusieurs fichiers, y compris les workflows .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.

Option Description

Tout développerdocs image

Développe tous les nœuds dans le projet d'automatisation.

Tout réduiredocs image

Réduit tous les nœuds dans le projet d'automatisation.

Actualiserdocs image

Actualise le projet.

Afficher tous les fichiersdocs image

Affiche tous les fichiers appartenant au projet d'automatisation, y compris project.json.

Explorateur de fichiersdocs image

Ouvre l'emplacement du projet sur la machine.

Paramètres du projetdocs image

Ouvre la fenêtre Paramètres du projet (Project Settings) des processus ou des bibliothèques.

Menu contextuel des projets

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)

Opens a list of items that can be added to the project: folder, sequence, flowchart, state machine, global handler, workflow, or, in test automation projects, test case.

Use workflow to create a workflow file based on built-in templates (sequence, flowchart, state machine) or local file templates.

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

  • The icon docs image indicates a missing dependency that should be installed.
  • The icon docs image indicates a newer version used in the source project that you should update to.
  • The icon docs image is displayed if a missing dependency is not available for the current project, or if the available version is different than the one in the source project.

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.

Ajouter au contrôle de code source

Adds the current project to source control using Git Init, Copy to Git, Add to TFS, or Add to SVN options. Please note that this option is only visible when right-clicking the project node.

When a project is added to source control, additional options are available in the context menu. See the options for GIT and the options for SVN and 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é et ouvre la fenêtre Renommer l'élément (Rename Item). L'élément est renommé dans toutes les occurrences.

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

Compares the current file with the previously selected file using Compare Files.

Rechercher des références

Finds all references to the file in the project. The results are displayed in the Find References panel.

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.

Propriétés

Ouvrez la fenêtre Propriétés (Properties) de la bibliothèque pour ajouter une info-bulle et un Lien d'aide (Help Link).

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 Gestionnaire global d'exceptions (Global Exception Handler) du fichier .xaml.

Activer le point d'entrée

Marks the selected workflow file as an entry point for the process, making it possible to select it as the workflow to run first when using the Invoke Process and Run Parallel Process activities in other processes, or when starting a job from Orchestrator.

  • When a file is marked as an entry point, an arrow is displayed on the icon next to the file name docs image.
  • Activer un fichier ignoré lors de la publication en tant que point d'entrée a pour effet de le définir comme publiable.
  • Cette option n'est pas disponible pour les fichiers de scénario de test.
  • Cette option n'est pas disponible dans les projets de la bibliothèque.

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.

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.

  • When a file is ignored from publishing, the icon next to the file name turns gray docs image.
  • Ignorer un fichier marqué comme point d'entrée lors de la publication a pour effet de désactiver le point d'entrée.
  • Ces options ne sont pas disponibles pour les fichiers de workflow dans les projets de bibliothèque.
  • Pour les projets où les fichiers XAML sont compilés lors de la publication, les fichiers de workflow et de cas de test qui sont exclus de la publication ne sont pas compilés.

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.

  • When a file is marked as private, the icon next to the file name turns gray docs image.
  • Cette option n'est pas disponible pour les fichiers de cas de test.

Créer un cas de test

Creates a test case that invokes the selected workflow file.

Convertir en cas de test (Convert to Test Case) / Convertir en workflow (Convert to Workflow)

Converts the selected workflows to test cases or the selected test cases to 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

Opens the Import Data Variation Source window that enables you to add test data to the project. This option is only available for test cases.

Lier à Test Manager

Opens the Link to Test Manager window that enables you to link the selected test cases to 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 :

image des documents Le fichier est synchronisé avec le référentiel.

image des documents Le fichier a été modifié.

image des documents Le fichier a été ajouté.

image des documents Le fichier a été supprimé.

Right-click a file or project node in the Project panel to open the GIT-specific context menu for Managing Projects with GIT.

OptionDescription
ValiderValide les modifications actuelles dans le référentiel GIT local.
TransmettreTransmet la version actuelle dans le référentiel distant.
Recevoir (rebaser)Reçoit les fichiers distants et rebase la branche actuelle.
Gérer les branchesOuvre la fenêtre GIT contenant les options de gestion des branches actuellement ajoutées.
Afficher les modificationsOuvre la fenêtre Diff de fichiers (File Diff) pour comparer les modifications entre la version locale et la version distante du fichier.
Afficher l'historiqueOuvre 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érentielCopie 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 :

image des documents Le fichier n’est pas extrait pour être édité.

image des documents Le fichier est pas extrait pour être édité.

image des documents Le fichier a été édité.

image des documents Le fichier a été ajouté.

Right-click a file or project node in the Project panel to open the context menu with options specific to managing projects with TFS or SVN.

OptionDescription
OuvrirOuvre 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.
RenommerPermet de renommer le fichier ou le dossier sélectionné et ouvre la fenêtre Renommer l'élément (Rename Item). Lorsque vous archivez le fichier .xaml renommé, la version auparavant 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'éditionArchive 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)Affiche la fenêtre Archiver les modifications (Check In Changes) et permet de télécharger l'élément sélectionné sur le serveur en tant que nouvelle version. Le fichier .xaml doit être enregistré avant de le télécharger. Une fois qu'il est 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érentielCopie l'URL du référentiel du projet dans le presse-papiers.

Ajuster les paramètres du projet

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 image des documents dans le panneau Projet (Project).

Description des champs de la fenêtre Paramètres (Settings)

The following table describes the project settings for process, test automation, and template projects. For information about the settings available for libraries, see About Libraries.

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 of an Automation Hub idea linked to the project. For more information, see Linking a Project to an Idea in Automation Hub.

Icône de package

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.

Après la publication du projet, l’icône s’affiche comme suit :

  • Pour les processus, dans l’Assistant à côté du nom du processus, ce qui facilite son identification dans la liste des processus.
  • Pour les modèles, à côté du modèle dans Accueil (Home) (mode Backstage de Studio) > Modèles (Templates).
  • Pour les bibliothèques, à côté du paquet dans la fenêtre Gérer les paquets (Manage Packages) dans Studio.
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

Set to Yes to turn the project into a Background Process and allow it to run in the background concurrently with other processes, as long as it does not use UI interaction.

Prend en charge la persistance

Set to Yes to turn the project into an Orchestration Process.

Prêt pour l’incrustation d’image

Set to Yes to indicate that the project was tested using Picture in Picture. If set to No, when the process is run in PiP from the Assistant, a dialog informs the user it was not tested using this feature and prompts for confirmation before proceeding.

Commence en incrustation d’image

Configurez sur Oui pour indiquer que le processus doit être exécuté par défaut à l’aide de la fonctionnalité Incrustation d'image.

Modern Design Experience

Set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

This setting also enables / disables a modern design experience for Excel if the Excel Design Experience option is set to UseGlobalSetting in the Excel activities project settings.

Cliquez sur OK (OK) et les modifications s'affichent dans le panneau Projet (Project) et le fichier project.json.

Check out the Configuring Activity Project Settings page to read about how to adjust activity properties at project level.

Remarque :

Prenez en compte que chaque fois que vous souhaitez copier un grand nombre d'activités d'une séquence à une autre, il est recommandé de faire défiler d'abord la liste vers le bas jusqu'au bas du panneau Concepteur (Designer). Cela est dû à une restriction de Windows Workflow Foundation.

Suppression des ressources de projet inutilisées

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.

À propos du fichier Project.Json

Project.json est un fichier généré automatiquement qui est créé pour chaque fichier .xaml marqué comme Principal (Main) dans le dossier de projet.

The file holds varied information, including project dependencies, or web services loaded in libraries. For more information about web services in libraries, check out the Loading Web Services in Libraries page.

Remarque :

Manually editing the project.json file should be attempted for troubleshooting scenarios only, as it may lead to severe consequences and loss of support.

À partir de la version 2018.2, vous devez spécifier un fichier project.json lors de l'exécution de votre projet à partir du client UiRobot.exe (ligne de commande).

Vous trouverez dans la table suivante une description des paramètres contenus dans le fichier Project.json.

Paramètre Description

name

Titre du projet d'automatisation. Il est fourni dans Studio lors de la création d'un processus ou d'une bibliothèque.

description

Il s'agit de la description du projet, renseignée dans le champ Description de Studio lorsqu'un nouveau projet est créé.

main

Le point d’entrée du projet d’automatisation. Il se compose d’un fichier .xaml. Le nom par défaut est « Main.xaml ». Il s'affiche à la fois comme le titre du panneau Designer et dans le panneau Propriétés dans Studio. Si vous souhaitez d’abord exécuter un projet différent, modifiez la valeur de ce paramètre et donnez-lui le nom du fichier.xaml à traiter.

If your automation project contains multiple files, each of them should be linked to the Main.xaml file through the Invoke Workflow File activity. This is especially useful when the project is published to Orchestrator and sent to a Robot, as the Robot executes only the file provided in this parameter.

dependencies

Les packages d'activités utilisés pour créer le projet d'automatisation et leurs versions. La liste est mise à jour chaque fois qu'une dépendance est ajoutée au projet ou supprimée, ou lorsqu'une version de package change.

Les numéros de version sont composés des parties suivantes dans l'ordre : majeure, mineure, build et révision.La valeur du build est le nombre de jours qui se sont écoulés depuis le 01.01.2000.La valeur de la révision est le nombre de secondes qui se sont écoulées le jour de la publication à partir de 5 heures GMT.

webServices

  • namespace : le nom du service fourni dans la fenêtre Ajouter un nouveau service (Add new service) pour les bibliothèques.
  • serviceDocument : Chemin d'accès au fichier .xml ou .json contenant des métadonnées du service SOAP ou Swagger. Le fichier est utilisé lorsque le service est réparé, et doit être sous version dans le cadre du projet.
  • webDocumentUri : chemin d'accès au fichier ou lien vers la ressource Swagger ou SOAP (fourni lors de la création du service dans la fenêtre Ajouter un nouveau service (Add new service)).
  • uniqueReference : une référence nécessaire au contrôle de version du service.

entitiesStores

  • serviceDocument : le chemin d'accès au fichier d'entités locales.
  • tenantName : le locataire où réside le service de données.
  • namespace : l'espace de noms sous lequel les entités sont importées (l'espace de noms du projet).
  • uniqueReference : une référence nécessaire au contrôle de version du service.

schemaVersion

La version du fichier project.json.

studioVersion

Il s'agit de la version de Studio utilisée pour créer le projet d'automatisation.

projectVersion

La version utilisée lors de la publication de ce projet dans un flux. Représente celle définie dans la fenêtre Publier (Publish).

runtimeOptions

  • isPausable : indique si la pause est activée pour le processus
  • requiresUserInteraction : indique si le processus est de longue durée.
  • supportsPersistence : indique si le processus est de longue durée.
  • excludedLoggedData - Contains keywords that can be added to the name of an activity to prevent variable and argument values from being logged at the Verbose level. That can also be achieved by selecting the Private checkbox of any activity. Read more about the protection of sensitive information here.
  • readyForPiP : indique si le processus est marqué comme prêt pour l'incrustation d'image.
  • startsInPiP : indique si le processus est configuré pour démarrer dans PiP.

designOptions

  • projectProfile : le profil Studio utilisé lors de la création du projet, soit Entreprise (StudioX), soit Développement.
  • outputType Affiche le type de projet, soit Processus, Bibliothèque ou Tests.
  • libraryOptions

    • includeOriginalXaml : Pour inclure ou non les fichiers de workflow d'origine dans le fichier .nupkg obtenu.
    • privateWorkflows : Le nom complet des fichiers .xaml privés contenus dans la bibliothèque.
  • processOptions

    • ignoredFiles : Liste des fichiers de workflow RPA ignorés lors de la publication.
  • fileInfoCollection : contient les informations suivantes pour chaque fichier de scénario de test dans le processus : editingStatus (Publishable ou InProgress), testCaseId et fileName.
  • modernBehavior : indique si le processus est configuré pour utiliser Modern Design Experience.

arguments

Contient les informations suivantes pour chaque argument input et output défini dans le fichier de flux de travail comme principal : name, type, s'il s'agit de required et s'il présente une valeur par défaut (hasDefault

Les informations d'arguments sont ajoutées uniquement au fichier dans le package .nupkg après la publication.

expressionLanguage

Language défini pour le processus (VisualBasic ou CSharp).

entryPoints

Contient les informations suivantes pour chaque fichier marqué comme point d'entrée du processus filePath,

uniqueId. et les informations suivantes de chaque argument input et output dans le fichier : name, type, s'il s'agit de required et s'il a une valeur par défaut (hasDefault).

Les informations d'arguments sont ajoutées uniquement au fichier dans le package .nupkg après la publication.

isTemplate

Si le projet est un modèle.

templateProjectData

Contient les informations suivantes pour les projets modèles :

  • defaultProjectDescription : la description de projet par défaut des processus basés sur le modèle.
  • defaultProjectName : le nom de projet par défaut des processus basés sur le modèle.

targetFramework

L'infrastructure cible définie pour le projet (Legacy, Windows ou Portable).

Voici un exemple du contenu d'un fichier project.json inclus dans un package publié depuis Studio.

{
  "name": "UI-40028",
  "description": "Blank Process",
  "main": "Flowchart.xaml",
  "dependencies": {
    "UiPath.Excel.Activities": "[2.9.3]",
    "UiPath.Mail.Activities": "[1.9.3]",
    "UiPath.System.Activities": "[20.10.1]",
    "UiPath.UIAutomation.Activities": "[20.10.6]"
  },
  "webServices": [],
  "entitiesStores": [],
  "schemaVersion": "4.0",
  "studioVersion": "20.10.2.0",
  "projectVersion": "1.0.1",
  "runtimeOptions": {
    "autoDispose": false,
    "isPausable": true,
    "requiresUserInteraction": true,
    "supportsPersistence": false,
    "excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],
    "executionType": "Workflow",
    "readyForPiP": false,
    "startsInPiP": false
  },
  "designOptions": {
    "projectProfile": "Developement",
    "outputType": "Process",
    "libraryOptions": {
      "includeOriginalXaml": false,
      "privateWorkflows": []
    },
    "processOptions": {
      "ignoredFiles": []
    },
    "fileInfoCollection": [],
    "modernBehavior": false
  },
  "arguments": {
    "input": [
      {
        "name": "argument1",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      },
      {
        "name": "argument2",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      }
    ],
    "output": []
  },
  "expressionLanguage": "VisualBasic",
  "entryPoints": [
    {
      "filePath": "Main.xaml",
      "uniqueId": "5289efb0-f8bc-42f3-8cf4-0caa3a7d1915",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    },
    {
      "filePath": "Flowchart.xaml",
      "uniqueId": "d0904ba0-506e-437d-979c-b9da4325faad",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    }
  ],
  "isTemplate": false,
  "templateProjectData": {},
  "publishData": {}
}
{
  "name": "UI-40028",
  "description": "Blank Process",
  "main": "Flowchart.xaml",
  "dependencies": {
    "UiPath.Excel.Activities": "[2.9.3]",
    "UiPath.Mail.Activities": "[1.9.3]",
    "UiPath.System.Activities": "[20.10.1]",
    "UiPath.UIAutomation.Activities": "[20.10.6]"
  },
  "webServices": [],
  "entitiesStores": [],
  "schemaVersion": "4.0",
  "studioVersion": "20.10.2.0",
  "projectVersion": "1.0.1",
  "runtimeOptions": {
    "autoDispose": false,
    "isPausable": true,
    "requiresUserInteraction": true,
    "supportsPersistence": false,
    "excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],
    "executionType": "Workflow",
    "readyForPiP": false,
    "startsInPiP": false
  },
  "designOptions": {
    "projectProfile": "Developement",
    "outputType": "Process",
    "libraryOptions": {
      "includeOriginalXaml": false,
      "privateWorkflows": []
    },
    "processOptions": {
      "ignoredFiles": []
    },
    "fileInfoCollection": [],
    "modernBehavior": false
  },
  "arguments": {
    "input": [
      {
        "name": "argument1",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      },
      {
        "name": "argument2",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      }
    ],
    "output": []
  },
  "expressionLanguage": "VisualBasic",
  "entryPoints": [
    {
      "filePath": "Main.xaml",
      "uniqueId": "5289efb0-f8bc-42f3-8cf4-0caa3a7d1915",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    },
    {
      "filePath": "Flowchart.xaml",
      "uniqueId": "d0904ba0-506e-437d-979c-b9da4325faad",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    }
  ],
  "isTemplate": false,
  "templateProjectData": {},
  "publishData": {}
}

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour