Invoke Process

UiPath.Core.Activities.InvokeProcess

Description

Exécute un processus UiPath disponible pour la machine locale. Peut être utilisé pour exécuter des packages locaux ainsi que des processus dans Orchestrator, si une connexion est disponible.

Pour plus d'informations sur la façon de trouver la liste des processus disponibles sur une machine, rendez-vous ici

L'activité Invoke Process s'exécute en mode synchrone, ce qui signifie que le processus parent va attendre la fin du processus enfant avant de reprendre.

Les journaux générés par les processus enfants contiennent uniquement le résultat de l'exécution ainsi que les erreurs ; ils sont écrits au même endroit que les journaux du processus parent et peuvent être différenciés par le champ ProcessName dans les journaux locaux ou la colonne Process dans Orchestrator.

Lors de l'utilisation de l'activité Invoquer le processus ( Invoke Process ), même si le projet contient plusieurs processus, une seule tâche est créée pour les exécuter, contrairement à l'activité Exécuter des processus parallèles ( Run Parallel Process ) qui crée des tâches distinctes pour chaque processus du projet.

Si plusieurs processus sont ajoutés, la version active du dossier en cours est celle qui sera utilisée.

Remarque :

• Les types de données non sérialisables ne peuvent pas être transmis d'un workflow à l'autre (par exemple : UIBrowser, UIElement, etc).

Si un processus enfant est invoqué mais introuvable, une erreur sera consignée contenant le nom du processus enfant, le chemin où le Robot a recherché ce processus, ainsi que des détails supplémentaires tels que WindowsIdentity et machineName.

Note :Lorsque vous utilisez une version de UiPath.System.Activities supérieure à la version v20.4, l'activité Invoke Process prend en charge plusieurs points d'entrée. Si un workflow est créé avec cette version, puis que le package UiPath.System.Activities est rétrogradé vers une version plus ancienne qui ne prend en charge qu'un seul point d'entrée, les activités Invoke Process du workflow rencontreront des erreurs de validation et devront être remplacées manuellement pour fonctionner correctement.

Note : Cette activité est uniquement compatible avec Studio v19.6 et les versions supérieures.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Chemin d'accès du dossier : le chemin d'accès du dossier où se trouve le processus spécifié, s'il est différent du dossier dans lequel le processus est en cours d'exécution. Ce champ prend uniquement en charge les valeurs de chaîne, avec / comme séparateur permettant d'indiquer les sous-dossiers. Par exemple, "Finance/Accounts Payable".
  Note : Le paramètre Folder Path ne fonctionne pas pour les processus exécutés par des robots dans des dossiers classiques. Seuls les robots des dossiers modernes ont la capacité de transmettre des données à l'extérieur de leur dossier.
• Nom du processus : le nom du processus que vous souhaitez exécuter. Ce champ prend uniquement en charge les chaînes et les variables String. Le nom du processus doit contenir le nom du package tel qu'il est utilisé par le robot.

Options avancées

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ ne prend en charge que des valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.
• Délai d'attente : indique le délai d'attente (en millisecondes) de l'exécution de l'activité avant qu'une erreur soit générée. Si cette propriété est laissée vide, l'activité attendra indéfiniment sans générer d'exception. Par défaut, ce champ de propriété est vide.
• Entrée du journal : spécifie le type d’informations à consigner automatiquement lors de l'ouverture de la ressource invoquée.
• Sortie du journal : spécifie le type d’informations à consigner automatiquement lors de la fermeture de la ressource invoquée.
• Niveau (Level) : indique le niveau de journalisation appliqué aux messages générés par les options EntréeJournal (LogEntry) et SortieJournal (LogExit).
• Chemin du point d'entrée (Entry Point Path) : le chemin du fichier de workflow qui sera exécuté au début du processus, relatif à la racine du package. Si ce champ est laissé vide, le point d'entrée par défaut est Main.xaml. Ce champ ne prend en charge que les chaînes et les variables String.

• Session cible : indique dans quelle session dans laquelle le processus enfant est lancé :

  • Actuel : le processus enfant s'ouvre dans la même session que le processus parent.
  • Processus par défaut : le processus enfant utilise les paramètres de processus.
  • Principal : le processus enfant démarre dans la session principale quel que soit l'endroit où le processus parent s'exécute.
  • Incrustation d'image : le processus enfant commence dans la session Incrustation d'image, quel que soit l’endroit où le processus parent s’exécute.

Configuration Windows - Héritage

Panneau propriétés

Commun

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ ne prend en charge que des valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.
• NomAffichage (DisplayName) - Nom affiché de l'activité.

• Timeout (millisecondes) : indique le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur soit générée. Si cette propriété est laissée vide, l'activité attendra indéfiniment sans générer d'exception. Par défaut, ce champ de propriété est vide.

  Remarque : lors de l'utilisation de robots 2021.10 et plus anciens, les exceptions métier ne sont pas prises en charge dans un workflow isolé, toutes les exceptions sont renvoyées en tant qu'exceptions système.

Entrée

• Arguments : une liste d'arguments d'entrée que vous pouvez transmettre au processus que vous souhaitez exécuter à partir d'Orchestrator. Si un argument a un type inconnu, il est converti en JSON.
• VariableArguments (ArgumentsVariable) : les variables d'argument transmises au processus invoqué.
• Nom du processus : le nom du processus que vous souhaitez exécuter. Ce champ prend uniquement en charge les chaînes et les variables String. Le nom du processus doit contenir le nom du package tel qu'il est utilisé par le robot.

Journal (Log)

• Entrée du journal : spécifie le type d’informations à consigner automatiquement lors de l'ouverture de la ressource invoquée.
• Sortie du journal : spécifie le type d’informations à consigner automatiquement lors de la fermeture de la ressource invoquée.
• NiveauJournalisation : indique le niveau de journalisation appliqué aux messages générés par les options EntréeJournal et SortieJournal.

Divers

• Point d'entrée: le chemin d’accès au fichier de workflow qui sera exécuté au début du processus, relatif à la racine du package. Si ce champ est laissé vide, le point d'entrée par défaut est Main.xaml. Ce champ ne prend en charge que les chaînes et les variables String.
• Chemin d'accès du dossier : le chemin d'accès du dossier où se trouve le processus spécifié, s'il est différent du dossier dans lequel le processus est en cours d'exécution. Ce champ prend uniquement en charge les valeurs de chaîne, avec / comme séparateur permettant d'indiquer les sous-dossiers. Par exemple, "Finance/Accounts Payable".
  Note : Le paramètre Folder Path ne fonctionne pas pour les processus exécutés par des robots dans des dossiers classiques. Seuls les robots des dossiers modernes ont la capacité de transmettre des données à l'extérieur de leur dossier.
• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

• Session cible : indique dans quelle session dans laquelle le processus enfant est lancé :

  • Actuel : le processus enfant s'ouvre dans la même session que le processus parent.
  • Processus par défaut : le processus enfant utilise les paramètres de processus.
  • Principal : le processus enfant démarre dans la session principale quel que soit l'endroit où le processus parent s'exécute.
  • Incrustation d'image : le processus enfant commence dans la session Incrustation d'image, quel que soit l’endroit où le processus parent s’exécute.
• Utiliser le package : indique si le processus doit être identifié par son nom de package (sélectionné) ou son nom de processus (non sélectionné). Par défaut, cette option n'est pas sélectionnée.