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

UiPath.Core.Activities.InvokeWorkflowFile

Description

Invoque un workflow spécifié de manière synchrone, en lui transmettant en option une liste d'arguments d'entrée. Les arguments peuvent être importés à partir d'un workflow spécifié avec cette activité en utilisant le bouton Importer les arguments dans le corps de l'activité.

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 multiplateformes. Cela déclenchera une notification d’erreur Les expressions ne sont actuellement pas prises en charge.
• 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

Configuration multiplateforme

• Nom de fichier de workflow (WorkflowFileName) - Le chemin d'accès du fichier .xaml à 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înes ne sont pas prise en charge dans Windows et les projets multiplate-forme. Toutes les variables de chaîne doivent être placées entre guillemets.
• Ouvrir le workflow (Open Workflow ) : ouvre le workflow invoqué dans un onglet différent du même projet.

Options avancées

Options

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

Journal (Log)

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

Windows - Héritage, configuration Windows

Module Designer

Les options suivantes sont disponibles dans le corps de l'activité.

Importer des arguments

Cliquer sur le bouton Importer les arguments dans le corps de l'activité ouvre un panneau Arguments qui présente tous les arguments du workflow référencé dans la propriété CheminWorkflow.

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 flux de travail

Le bouton Ouvrir le workflow dans le corps de l'activité vous permet d'ouvrir le workflow invoqué dans un autre onglet du même projet.

Panneau propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• 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.
• 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 de fichier de workflow (WorkflowFileName) - Le chemin d'accès du fichier .xaml à 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înes ne sont pas prise en charge dans Windows et les projets multiplate-forme. Toutes les variables de chaîne doivent ê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 en tant qu'exceptions système.

Journal (Log)

• Entrée du journal : le type d’informations à consigner automatiquement lors de l'ouverture de la ressource invoquée.
• Sortie du journal : le type d’informations à consigner automatiquement lors de la fermeture de la ressource invoquée.
• NiveauJournalisation : 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 : 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. 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.

    Remarque :Lors de la configuration de Target Session pour l'activité Invoke Workflow, le paramètre Isolated doit être activé.