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.

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 du package est prise en charge, mais obsolète.

• Nom du processus/Nomdu 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 (Manage processes) à droite du champ.

  Remarque :

  Basculer entre les options Nom du processus ( Process name ) et Nom du package (Package name ) 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 comporte 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 : activée par l'option Utiliser une expression (Use an expression) du champ Arguments . Vous pouvez utiliser une variable prédéfinie ou vous pouvez en créer une nouvelle en utilisant des expressions VB ou en invitant le 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 les noms statiques à droite du champ.

Propriétés supplémentaires

Commun

• Délai d'attente - indique le délai d'attente (en millisecondes) de l'exécution du workflow invoqué avant qu'une erreur soit générée et que le workflow soit abandonné. Ce champ prend uniquement en charge 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 (True), Faux (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 le champ indique au contraire Vrai (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 intercepté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 : indiquez 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 à invoquer par son nom de package.

• Point d'entrée : si votre processus comporte 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 afficher 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 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é.
• Délai d'attente - indique le délai d'attente (en millisecondes) de l'exécution du workflow invoqué avant qu'une erreur soit générée et que le workflow soit abandonné. Ce champ prend uniquement en charge les variables TimeSpan . Par défaut, ce champ est vide.

Entrée

• Arguments : une 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 voulez appeler. Ce champ accepte les valeurs String.

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 : indiquez 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 comporte 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.