Gestion des arguments

Les arguments servent à transmettre des données d'un projet à un autre. D'une façon générale, ils sont comparables à des variables, car ils peuvent stocker et transmettre des données dynamiquement. Les variables transmettent des données entre activités, tandis que les arguments peuvent transmettre des données entre automatisations, ce qui permet de réutiliser certains projets à volonté.

Studio prend en charge un grand nombre de types d'arguments, qui coïncident avec les types de variables. Par conséquent, vous pouvez créer des arguments Generic Value, String, Boolean, Object, Array ou DataTable et vous pouvez également rechercher des types .Net, comme vous le faites pour variables.

De plus, les arguments disposent de directions spécifiques : Entrée (In), Sortie (Out), In/Out et Propriété (Property) pour indiquer à l'application la destination des informations stockées.

Important :

• S'il existe une variable et un argument portant le même nom, la variable est toujours utilisée par défaut lors du runtime.
• La transmission d’arguments d’entrée complexes (de type System.Data.DataTable, par exemple), à une activité Appeler le fichier de flux de travail (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 types d’arguments intégrés (Booléen, par exemple) sont toujours transmis en tant que valeurs.

Veuillez prendre en considération que si vous créez un argument In/Out avec une valeur In lorsqu'il est utilisé dans l'activité Invoquer le workflow , puis modifiez la valeur en Out, vous remarquerez peut-être qu'une erreur est générée lors de l'exécution du projet. En effet, l’activité Invoquer le workflow (Invoke Workflow) n’a pas renvoyé les valeurs par référence. Utilisez un gestionnaire global dans votre projet pour accéder aux valeurs exactes des arguments dans le workflow invoqué.

Enfin, ces arguments peuvent être utilisés pour s'intégrer à d'autres outils de votre entreprise, car ils sont également exposés dans Orchestrator. Cela implique que tout processus que vous créez peut à présent recevoir des arguments d'entrée via l'API ou l'interface d'Orchestrator, ainsi que renvoyer une sortie à tous les éléments susmentionnés. Plus d’informations sont disponibles ici.

Créer des arguments

Les arguments doivent être en casse mixte avec un préfixe indiquant le type d'argument, tel que in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. Vous pouvez consulter nos recommandations Conventions d’affectation de noms de conception de workflow (Workflow Design Naming Conventions) .

À partir du gestionnaire de données

1. Ouvrez le Gestionnaire de données, puis sélectionnez Nouveau (New) > Nouvel argument (New Argument).
2. Un nouvel élément portant le nom par défaut argument est ajouté sous Arguments.

3. Configurez l'argument créé :

   • Cliquez sur le nom de l'argument pour modifier son nom.
   • Développez l'argument à l'aide de la flèche à sa gauche et définissez la Direction, le Type de données (Data Type), s'il est Obligatoire (Required), et éventuellement la Valeur par défaut (Default Value).

À partir du gestionnaire de données, vous pouvez également créer des arguments en bloc en cliquant avec le bouton droit sur le nœud Arguments, puis en sélectionnant Créer des arguments en bloc (Bulk Create Arguments). Une nouvelle fenêtre s'affiche, dans laquelle vous pouvez ajouter et configurer plusieurs arguments.

Depuis le corps d'une activité

1. Depuis le panneau Activités (Activities), faites glisser une activité vers le panneau Concepteur (Designer). Cliquez avec le bouton droit sur un champ et sélectionnez Créer un argument d'entrée (Create In Argument) ou Créer un argument de sortie (Create Out Argument) dans le menu contextuel. Vous pouvez également appuyer sur Ctrl+M ou Ctrl+Maj+M. Le champ Définir Arg (Set Arg) est affiché.
2. Renseignez le nom et appuyez sur Entrée. L'argument est créé et est visible dans le champ. Vérifiez sa direction et entrez-le dans le panneau Arguments (Arguments).

À partir d’expressions

Alternativement, les arguments peuvent être créés à partir d’expressions directement dans un champ d’entrée d’activité ou dans l’éditeur d’expression :

1. Sélectionnez une partie de l’expression et appuyez sur Ctrl+M ou Ctrl+Shift+M. Le champ Set Arg s'affiche.

2. Renseignez le nom et appuyez sur Entrée. L'argument est créé. Vérifiez son type et sa direction dans le panneau Arguments.

   
   

   

   
   

Les arguments ainsi créés reçoivent automatiquement le type en fonction de l'activité. Par exemple, si vous créez un argument dans le champ Data Table d'une activité Write Range, le type de l'argument est défini sur DataTable. Si vous créez un argument dans le champ Text d'une activité Write Line, le type de l'argument est défini sur String.

Depuis le panneau Propriétés

1. Depuis le panneau Propriétés (Properties) de toute activité, cliquez avec le bouton droit sur un champ modifiable et sélectionnez Créer un argument d'entrée (Create In Argument) ou Créer un argument de sortie (Create Out Argument) dans le menu contextuel. Vous pouvez également appuyer sur Ctrl+M ou Ctrl+Maj+M. Le champ Définir Arg (Set Arg) est affiché.
2. Renseignez le nom et appuyez sur Entrée. L'argument est créé et est visible dans le champ. Vérifiez sa direction et entrez-le dans le panneau Arguments (Arguments).

Le type d'argument est généré automatiquement en fonction de la propriété sélectionnée.

Depuis le panneau Arguments (Arguments)

1. Rendez-vous dans le module Concepteur (Designer) et cliquez sur Arguments (Arguments) pour ouvrir le module Arguments (Arguments).

2. Cliquez sur la ligne Créer un argument (Create Argument) et renseignez le nom. Un argument est créé.

   Remarque : par défaut, tous les arguments créées sont de type String avec une direction Entrée (In).

Supprimer des arguments

Vous pouvez supprimer des variables du gestionnaire de données ou du panneau Variables.

À partir du gestionnaire de données

1. Ouvrez le gestionnaire de données, puis développez le nœud *Variables.
2. Cliquez avec le bouton droit sur un argument, puis sélectionnez Supprimer (Delete). Vous pouvez également la sélectionner et appuyer sur la touche Suppr.

Depuis le panneau Arguments (Arguments)

1. Ouvrez le panneau Arguments (Arguments).

2. Cliquez avec le bouton droit sur un argument, puis sélectionnez Supprimer (Delete). Vous pouvez également la sélectionner et appuyer sur la touche Suppr.

   
   

   

   
   

Suppression de tous les arguments inutilisés

Pour supprimer tous les arguments qui ne sont utilisés nulle part dans le fichier actuel, sélectionnez Supprimer les éléments inutilisés (Remove Unused) > Arguments dans le ruban Studio, puis sélectionnez Oui (Yes) lorsque vous êtes invité à confirmer.

Configuration des propriétés de l’argument

La fenêtre Propriétés d’argument (Argument Properties) centralise les arguments utilisés tout au long de votre projet, ainsi que leurs propriétés. Après la publication du projet, ces informations sont visibles dans Orchestrator, Assistant et Automation Ops - Pipelines.

Pour configurer les propriétés des arguments, ouvrez le panneau Projet (Project), cliquez avec le bouton droit sur un fichier XAML défini comme principal ou marqué comme point d’entrée du projet, puis sélectionnez l’option Propriétés de l’argument (Argument Properties). Vous pouvez réorganiser les arguments répertoriés dans la fenêtre en les faisant glisser et en les déposant dans le menu de gauche.

Sélectionnez un argument dans le menu de gauche et saisissez les informations suivantes :

• Nom complet (Display name) : le libellé qui s’affiche pour l’argument.
• Info-bulle (Tooltip) : info-bulle visible lorsque vous survolez l’argument.
• Obligatoire (Required) : indique si l’argument est requis.