Appeler le fichier de flux de travail (Invoke Workflow File)

UiPath.Core.Activities.InvokeWorkflowFile

Description

Appelle de manière synchrone un workflow spécifié, en lui transmettant éventuellement une liste d'arguments d'entrée.

Remarque :

• L'importation d'arguments à partir d'un workflow les associe automatiquement aux variables existantes s'ils partagent le même nom et le même type de données avec celles-ci.
• Les types de données non sérialisables ne peuvent pas être transmis d'un workflow isolé à un autre (par exemple : UIBrowser, UIElement, etc.).
• Les stratégies antivirus qui restreignent l'accès à PowerShell peuvent empêcher l'utilisation d'activités liées à PowerShell. Par exemple, vous ne pouvez pas utiliser Invoke Workflow File ni Invoke Power Shell lorsque l'ID de règle 6151 est activé dans McAfee Endpoint Security.
• Après avoir exécuté un workflow appelé qui ajoute des champs de journal personnalisés, les champs de journal sont restaurés dans la configuration du workflow parent.

Important :

• La transmission d'arguments d'entrée à une activité Invoke Workflow File non isolée fonctionne comme si une référence était transmise, ce qui signifie que toute modification apportée à l'objet dans le workflow invoqué va modifier l'objet dans le workflow principal.
• Les variables et les arguments ne sont pas pris en charge pour les noms de fichiers de workflow dans les projets Windows et multiplate-forme. Le fait d’ignorer cet avis déclenche une notification d’erreur « Les expressions ne sont actuellement pas prises en charge » (Expressions are currently not supported).
• Lorsque vous invoquez un workflow, assurez-vous qu'il ne contient pas d'activités de persistance. Celles-ci doivent uniquement être utilisées dans le workflow principal.

Le workflow référencé dans la propriété NomFichierWorkflow peut être ouvert dans le projet actif à l'aide du bouton Ouvrir le workflow dans le corps de l'activité.

Remarque :Pour chaque fichier appelé .xaml dont le titre contient un point (.), tout le texte situé avant le point (y compris le point) est remplacé par un trait de soulignement (_).

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Nom du fichier de workflow (Workflow file name) : le chemin d’accès du fichier .xaml à invoquer. Le chemin d’accès au fichier concerne le dossier de projet actuel. Ce champ n’accepte que les chaînes ou les variables String. Les variables de chaîne ne sont pas prises en charge dans les projets Windows et multiplate-forme. Toutes les chaînes doivent être placées entre guillemets. Pour ouvrir le workflow dans un autre onglet du même projet, sélectionnez Ouvrir le workflow (Open workflow) à droite du champ.

• Arguments : option par défaut. Ouvre le dictionnaire d’arguments, dans lequel vous pouvez voir les arguments du workflow 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 workflow, sélectionnez Actualiser les arguments (Refresh arguments) à droite du champ.

• 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. Pour ouvrir la liste des arguments et modifier leurs attributs, cochez la case du champ Arguments.

Remarque :

• Si la valeur de la variable Arguments est nulle au moment de l'exécution, l'activité revient à la propriété Arguments.

• Le basculement entre les propriétés des variables Arguments et Arguments révèle la valeur précédente.

• La valeur de la variable Arguments est perdue lors de la fermeture de l ' éditeur d'expressions.

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.

Options

• Session cible (exclusivement pour les projets Windows) : indique dans quelle session dans laquelle le workflow est lancé. Seuls les flux de travail isolés peuvent être lancés dans une session différente de celle du parent. Assurez-vous donc de définir la propriété Isolé (Isolated) sur Vrai (True). Choisissez l'une des options suivantes :

  • Actuel : le processus enfant s'ouvre dans la même session que le processus parent.
  • 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.

• Isolé (Isolated) : sélectionnez Vrai (True) pour exécuter le workflow invoqué dans un processus Windows distinct. Cela permet d'isoler un workflow défectueux du workflow principal. False par défaut.

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 fichier de workflow (Workflow file name ) - Le chemin d'accès du fichier .xaml de fichier à invoquer. Le chemin d'accès au fichier se rapporte au dossier de projet actuel. Ce champ n'accepte que les chaînes ou les variables String. Les variables de chaîne sont prises en charge. Les chaînes doivent toujours être placées entre guillemets.

• Importation d'arguments : ouvre un panneau Arguments qui présente tous les arguments du workflow référencé dans la propriété Nom du fichier de workflow .

  Ce panneau vous permet de choisir les arguments que vous souhaitez importer à partir du workflow invoqué en utilisant les commandes directionnelles, bien ou le bouton Supprimer afin de réagencer les arguments. En cliquant sur OK, vous enregistrez les modifications.

  Remarque :

  • Si vous créez des arguments dans le panneau, ceux-ci seront ignorés car ils ne correspondent pas aux données du workflow invoqué.
  • Les noms d'arguments sont sensibles à la casse dans le panneau.

  Une fois le panneau fermé, un compteur situé à côté du bouton indique le nombre d'arguments sélectionnés pour l'importation. Le compteur est codé par couleur comme suit :
  • orange : il y a une incompatibilité entre les arguments sélectionnés et ceux présents dans le workflow invoqué.
  • gris : les arguments sélectionnés sont présents dans le workflow invoqué.

• Ouvrir le workflow (Open Workflow) - Permet d'ouvrir le workflow invoqué dans un autre onglet du même projet.

Panneau propriétés

Commun

• 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 (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 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 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 de l'activité avant qu'une erreur soit générée. Ce champ prend uniquement en charge les variables TimeSpan. Par défaut, ce champ est vide.

Entrée

• Arguments : paramètres pouvant être transmis à l'application au moment de l'invocation.
• ArgumentsVariable : les paramètres pouvant être transmis dynamiquement au workflow à l'aide d'un dictionnaire.
• Isolé (Isolated) - Si cette case est cochée, le workflow invoqué s'exécute dans un processus Windows distinct. Cela permet d'isoler un workflow défectueux du workflow principal.

• Nom du fichier de workflow (Workflow file name ) - Le chemin d'accès du fichier .xaml de fichier à invoquer. Le chemin d'accès au fichier se rapporte au dossier de projet actuel. Ce champ n'accepte que les chaînes ou les variables String. Les variables de chaîne sont prises en charge. Les chaînes doivent toujours être placées entre guillemets.

  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 comme des exceptions système.

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

• 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 (uniquement pour les projets Windows) : indique dans quelle session dans laquelle le workflow est lancé. Seuls les flux de travail isolés peuvent être lancés dans une session différente de celle du parent. Assurez-vous donc de définir la propriété Isolé (Isolated) sur Vrai (True). Choisissez l'une des options suivantes :

  • Actuel : le processus enfant s'ouvre dans la même session que le processus parent.
  • 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.