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

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

Depuis le corps d'une activité

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é.
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 :

Sélectionnez une partie de l’expression et appuyez sur Ctrl+M ou Ctrl+Shift+M. Le champ Set Arg s'affiche.
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

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é.
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)

Rendez-vous dans le module Concepteur (Designer) et cliquez sur Arguments (Arguments) pour ouvrir le module Arguments (Arguments).
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.

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 :