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 supports a large number of argument types, which coincide with the types of variables. Therefore, you can create Generic Value, String, Boolean, Object, Array, or DataTable arguments and you can also browse for .Net types, just as you do in the case of variables.

Additionally, arguments have specific directions (In, Out, In/Out, Property) that tell the application where the information stored in them is supposed to go.

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.

Please take into consideration that if you create an In/Out argument with an In value when used in the Invoke Workflow activity, and then change the value to Out, you may notice that an error is thrown when executing the project. This is because the Invoke Workflow activity did not return the values by reference. Use a Global Handler in your project to get access to the exact values the arguments had inside the invoked workflow.

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

Argument names should be in upper CamelCase with a prefix stating the argument direction, such as in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. You can check out our Workflow Design Naming Conventions recommendations for more details.

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 créés de ces manières 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é Écrire une plage, 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

Pour supprimer un argument dans le panneau Arguments, faites un clic droit sur l'argument et sélectionnez Supprimer (Delete),ou sélectionnez l'argument et appuyez sur la touche Supprimer.

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.