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.

Lorsque vous utilisez l'activité Invoquer le processus , même si le projet contient plusieurs processus, une seule tâche est créée pour les exécuter, par opposition à l'activité Exécuter le processus parallèle 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.

Remarque :

Lorsque vous utilisez une version de UiPath.System.Activities supérieure à la version v20.4, l'activité Invoke Process peut prendre 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.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Chemin d'accès au dossier Orchestrator : 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/AccountsPayable ».
• Invoquer par : spécifiez si vous souhaitez invoquer le processus par le nom du processus tel que configuré dans Orchestrator, ou par le nom du package. Veuillez noter que l'utilisation du nom de package est prise en charge, mais obsolète.
• Nom du processus/ Nom du package : le nom du processus ou du package que vous souhaitez appeler. La liste déroulante affiche les processus ou packages disponibles dans le dossier Orchestrator connecté. Ce champ ne prend en charge que les variables String ou String. Pour gérer la liste des processus disponibles, sélectionnez Gérer les processus à droite du champ.
  Remarque :

  Basculer entre les options Nom de processus et Nom de package ne met pas automatiquement à jour le nom. Si le nom de votre processus est différent du nom du package, assurez-vous de le mettre à jour en conséquence.

• Point d'entrée : si votre processus a plusieurs points d'entrée, spécifiez le chemin du fichier de workflow à exécuter une fois le processus démarré. Ce chemin d'accès doit être relatif au package racine. Par défaut, ce champ est laissé vide et utilise le point d'entrée configuré dans Orchestrator.
• Arguments : option par défaut. Ouvre le dictionnaire d’arguments, dans lequel vous pouvez voir les arguments du processus invoqué. Vous pouvez également définir une variable qui doit contenir un dictionnaire d’arguments en sélectionnant Utiliser une expression (Use an expression) à droite du champ. Cette action convertit le champ Arguments en variable Arguments (Arguments variable). Pour récupérer la liste la plus récente des arguments de processus, sélectionnez Actualiser les arguments (Refresh arguments) à droite du champ. Pour ouvrir la liste des arguments et modifier leurs attributs, cochez la case du champ Arguments.
• Variable Arguments (Arguments variable) : activée par l’option Utiliser une expression (Use an expression) du champ Arguments. Vous pouvez utiliser une variable prédéfinie, ou en créer une nouvelle en utilisant des expressions VB ou ben en invitant Autopilot à en générer une pour vous. Utilisez cette variable pour contenir le dictionnaire d’arguments du workflow invoqué. Revenez à l’option Arguments en sélectionnant Utiliser des noms statiques (Use Statique Names) à droite du champ.

Propriétés supplémentaires

Commun

• Délai d'attente - indique le délai d'attente de l'exécution du workflow invoqué avant qu'une erreur soit générée et que le workflow soit abandonné. Ce champ ne prend en charge que les variables TimeSpan . Par défaut, ce champ est vide.
• Continuer en cas d'erreur (Continue On Error) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai, Faux). 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 le champ indique au contraire True, l’exécution du projet se poursuit même en cas d’erreur.
  Remarque :

  Si cette activité est incluse dans Try Catch et que la valeur de la propriété ContinueOnError est True, aucune erreur n'est détectée lors de l'exécution du projet.

Exécution

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

Journal (Log)

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

Configuration Windows - Héritage

Module Designer

Vous pouvez trouver les propriétés suivantes dans le corps de l’activité :

• Nom du package : le nom du package utilisé pour créer le processus que vous souhaitez appeler. Dans les projets hérités depuis Windows, le robot identifie le processus à appeler par son nom de package.

• Point d'entrée : si votre processus a plusieurs points d'entrée, spécifiez le chemin du fichier de workflow à exécuter une fois le processus démarré. Ce chemin d'accès doit être relatif au package racine. Par défaut, ce champ est laissé vide et utilise Main.xaml comme point d’entrée.

• Modifier les arguments : ouvre la liste des arguments, dans laquelle vous pouvez voir et gérer les arguments du processus invoqué.

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 Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• Délai d'attente - indique le délai d'attente de l'exécution du workflow invoqué avant qu'une erreur soit générée et que le workflow soit abandonné. Ce champ ne prend en charge que les variables TimeSpan . Par défaut, ce champ est vide.

Entrée

• Arguments : collection 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 appeler. Ce champ accepte uniquement les valeurs Chaîne.

Journal (Log)

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

Divers

• Point d'entrée : si votre processus a plusieurs points d'entrée, spécifiez le chemin du fichier de workflow à exécuter une fois le processus démarré. Ce chemin d'accès doit être relatif au package racine. Par défaut, ce champ est laissé vide et utilise Main.xaml comme point d’entrée.

• 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/AccountsPayable ».
• 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.