Manuel utilisateur de StudioX

Dernière mise à jour 7 août 2024

À propos des projets d'automatisation

Un projet d’automatisation est une séquence d’activités qu’un robot peut exécuter pour automatiser une série de tâches que vous effectuez sur votre ordinateur. Vous créez et visualisez le projet d’automatisation dans l’onglet Concepteur (Designer) de StudioX.

Lorsque vous créez un projet dans StudioX, les fichiers de projet sont enregistrés dans un dossier avec le nom du projet à un emplacement de votre choix. Par défaut, les projets sont enregistrés dans le répertoire %USERPROFILE%\Documents\UiPath.

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

Fichiers
- un fichier Main.xaml qui contient votre workflow principal ;
- Un fichier project.json contenant des informations relatives à votre projet d'automatisation.
- un fichier Excel, par défaut, Project_Notebook.xlsx, si vous n’avez pas configuré votre projet pour utiliser un bloc-notes de projet différent.
un fichier GlobalHandlerX.xaml qui contient un workflow conçu pour déterminer le comportement du projet en cas d’erreur d’exécution ;
un fichier RuntimeExecutionError_Template.html qui contient un modèle de message d’erreur à afficher en cas d’erreur d’exécution.
Sous-dossiers
- .local - Contient les données mises en cache localement pour le 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.

Configurer la compatibilité du projet

Lorsque vous créez un nouveau projet, sélectionnez la compatibilité en fonction des applications à automatiser et de l'environnement sur lequel le projet va s'exécuter :

Windows - Sélectionnez cette option pour les automatisations qui sollicitent des applications Windows telles que les versions de Microsoft Office pour ordinateur de bureau. Ces automatisations peuvent s'exécuter sur des ordinateurs Windows. Il s'agit de l'option par défaut.
Multiplate-forme (Cross-platform) - Sélectionnez cette option pour les automatisations qui impliquent des applications en ligne telles que les applications Office pour le Web dans Microsoft 365 et Google Workspace. Les automatisations peuvent s'exécuter sur des systèmes d'exploitation Windows et de type Unix, tels que Linux et macOS. Pour en savoir plus sur la conception de projets multiplate-formes, consultez Projets multiplate-formes dans le guide Studio.
Windows - Legacy - Semblable à Windows mais basé sur une technologie devenue obsolète, et progressivement supprimée. Il s'agit de la compatibilité utilisée dans les projets StudioX créés dans les versions précédentes. Pour plus d'informations sur la conversion de projets existants vers la nouvelle compatibilité Windows, voir Convertir des projets définis sur la compatibilité Windows - Legacy vers la compatibilité Windows

Projets StudioX pour une utilisation Unattended

Les projets StudioX sont conçus pour une utilisation Attended uniquement. Nous déconseillons l'utilisation de StudioX pour développer des projets destinés à une utilisation Unattended. Vous pouvez mettre à jour un projet StudioX pour une utilisation sans surveillance dans le profil Studio en supprimant le GEH. Nous vous recommandons de demander à un RPA Developer d'examiner le projet avant de le publier pour une utilisation Unattended, car il peut souhaiter ajouter une journalisation et une gestion des erreurs supplémentaires, et vérifier les valeurs codées en dur qui doivent être stockées en tant que ressources.

Ajuster les paramètres du projet

Pour configurer les paramètres de chaque projet, sélectionnez Projet > Paramètres du projet dans le ruban StudioX.

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

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 : Pour les automatisations de tâches, 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). 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.
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. Testé pour l'utilisation de l'incrustation d'image ; Démarre en incrustation d'image (Tested for PiP usage; Starting in PiP) : l'automatisation en mode incrustation d'image a été validé. Elle démarrera donc par défaut dans ce mode lors de son exécution. Testé pour l'utilisation de l'incrustation d'image ; Ne démarre pas avec l'incrustation d'image activée par défaut (Tested for PiP usage; Not starting in PiP by default) : l'automatisation en mode incrustation d'image a été validé. Lorsque le projet d'automatisation est exécuté, il démarre par défaut dans la session principale ou sur le poste de travail. Non testé pour l'utilisation de l'incrustation d'image (Not tested for PiP usage) : l'automatisation n'a pas été approuvée pour s'exécuter en mode incrustation d'image. Lorsque le projet d'automatisation est exécuté, il démarre par défaut dans la session principale ou sur le poste de travail. S'il est exécuté en mode incrustation d'image, une boîte de dialogue informe l'utilisateur qu'il n'a pas été testé à l'aide de cette fonctionnalité et lui demande confirmation avant de continuer.
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).

À propos de la publication de projets d'automatisation

La Publication d’un projet d’automatisation implique l’archivage du workflow et de tous les autres fichiers du dossier du projet pour qu’ils puissent être envoyés aux robots, puis exécutés.

Si le Robot est connecté à Orchestrator, vous pouvez publier des projets StudioX dans Orchestrator et les exécuter à partir de l'Assistant. Si le robot n’est pas connecté à Orchestrator, vous pouvez publier vos projets en utilisant les valeurs par défaut du robot et les exécuter à partir de l’assistant.

Le processus de publication de StudioX est le même que celui de Studio. Pour plus d’informations, consultez la section À propos de la publication des projets d’automatisation dans le guide de Studio.