activities
latest
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.
Activités de workflow
Last updated 4 oct. 2024

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

Windows, configuration multiplate-forme

  • 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 ne sont pas prises en charge dans les projets Windows et multiplate-forme. Les chaînes doivent toujours être placées entre guillemets.
  • Arguments : option par défaut. Ouvre le dictionnaire d'arguments, où vous pouvez voir les arguments du workflow invoqué. Vous pouvez également définir une variable pour contenir un dictionnaire d'arguments en sélectionnant Utiliser une expression (Use an expression) à droite du champ. Cela convertit le champ Arguments en variable 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.

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.

  • Importer des arguments : si le workflow invoqué comporte des arguments, la sélection de ce bouton les importe automatiquement dans le Dictionnaire. Pour afficher les arguments importés, cliquez sur dans le champ Arguments .

    Le bouton doit être désactivé lorsque :

    • Vous avez utilisé une variable Argument pour la collection d'arguments

    • La valeur de la propriété Nom du fichier de workflow est nulle ou une variable

  • Ouvrir le workflow (Open Workflow ) : ouvre le workflow invoqué dans un onglet différent du même projet.

    Le bouton doit être désactivé lorsque la valeur de la propriété Nom du fichier de workflow (Workflow file name ) est nulle ou une variable.

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.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.