Utilisation d'arguments d'entrée et de sortie

Découvrez comment gérer efficacement les arguments d'entrée et de sortie dans les automatisations codées, y compris leur intégration lorsqu'elles sont appelées dans des workflows low-code.

Ajout d'arguments aux automatisations codées

Lors de la conception d’automatisations codées, vous pouvez ajouter des arguments d’entrée, de sortie et In/Out avec la méthode de point d’entrée Execute. Quel que soit leur ordre de définition, les arguments In/Out sont placés à la fin de la liste d’arguments de la méthode.

Consultez les scénarios ci-dessous pour comprendre comment ajouter des arguments à vos automatisations codées.

Ajout de paramètres d'entrée

1. Pour ajouter des paramètres d'entrée, définissez-les après le nom de la méthode de point d'entrée.
2. Par exemple, vous avez une automatisation codée qui représente une demande de prêt n'utilisant que des arguments d'entrée. Les arguments d'entrée nécessaires sont customerName, loanAmount, loanRate et loanTerm. Consultez l'extrait de code ci-dessous :

   public void Execute (string customerName, decimal loanAmount, double loanRate, int loanTerm)

Ajout de paramètres de sortie

1. Pour ajouter des paramètres de sortie, définissez-les avant le nom de la méthode de point d'entrée.
   Remarque : si la méthode renvoie un seul paramètre, elle sera automatiquement nommée Output par défaut et vous ne pourrez pas la renommer.
2. Par exemple, vous disposez d'une automatisation codée qui approuve ou refuse une demande de prêt en fonction du taux d'emprunt. Cette automatisation nécessite un argument d'entrée pour le taux de prêt (loanRate) et un argument de sortie indiquant si la demande de prêt a été approuvée ou refusée (loanApproved). Consultez l'extrait de code ci-dessous :

   public bool Execute (int loanRate)

3. Prenons un autre exemple qui génère deux paramètres. Supposons que vous disposiez d'une automatisation codée qui renvoie le montant du prêt approuvé (LoanAmountApproved) et si le prêt a été approuvé (IsLoanApproved), en fonction du taux d'emprunt (LoanRate). Consultez l'extrait de code ci-dessous :

   public (int LoanAmountApproved, bool IsLoanApproved) Execute(int LoanRate)

Ajout de paramètres d'entrée/sortie

1. Pour ajouter un argument de type In/Out, définissez le même argument avant et après le nom de la méthode de point d'entrée.
2. Par exemple, vous avez une automatisation codée qui considère un montant de prêt initial (loanAmount) et un taux d'intérêt (interestRate) en tant qu'entrées, puis calcule le montant du prêt mis à jour après avoir appliqué le taux d'intérêt et le renvoie. En outre, elle renvoie un argument indiquant le type de besoin financier requis par ce montant de prêt.
   Consultez l'extrait de code ci-dessous :

   public (double loanAmount, string financialNeed) Execute (double interestRate, double loanAmount)

Remarque : si un argument d’entrée est nommé Output, il est considéré comme un argument In/Out. Le fait de nommer un argument Output le considère comme un argument In/Out, même s’il n’est déclaré qu’une seule fois dans la méthode.

Importation d'arguments d'automatisations codées dans les workflows low-code

1. Créez une automatisation codée qui considère un montant de prêt initial (loanAmount) et un taux d'intérêt (interestRate) en tant qu'entrées, puis calcule le montant du prêt mis à jour après application du taux d'intérêt et le renvoie.
   Pour cette automatisation codée, vous devez déclarer la méthode de point d'entrée comme public double Execute (double interestRate, double loanAmount)
2. Ajoutez une activité Appeler le fichier de flux de travail (Invoke Workflow File) dans une automatisation à faible code et proposez le chemin d'accès à l'automatisation codée que vous avez créée précédemment.
3. Cliquez sur Importer des arguments (Import Arguments) et vérifiez les arguments importés.

   Pour l'automatisation codée proposée en exemple, vous devriez avoir les arguments importés suivants :

   Nom	Direction	Saisie de texte	Valeur (Value)
   loanAmount	Entrée/Sortie	Double	10,000
   interestRate	dans	Double	5

   Ajoutez manuellement les arguments qui n'apparaissent pas comme des arguments importés.

Astuce : avec System.Activities 24.10 et versions supérieures, les arguments que vous ajoutez à une automatisation codée sont automatiquement importés dans une automatisation low-code lorsque vous les appelez en utilisant l’activité Appeler le fichier de workflow (Invoke Workflow File).

Remarque : il n’est pas possible d’utiliser des classes imbriquées en tant qu’arguments de workflow. Les classes utilisées en tant qu’arguments doivent être directement définies dans un espace de noms.