Trabalhando com argumentos de entrada e saída

Aprenda como lidar com eficiência com argumentos de entrada e saída em automações codificadas, incluindo sua integração quando invocada em fluxos de trabalho de pouco código.

Adição de argumentos a automações codificadas

Ao projetar automações codificadas, você pode adicionar argumentos de entrada, saída e entrada/saída junto com o método de Entry Point Execute. Independentemente de sua ordem de definição, os argumentos In/Out são colocados no final da lista de argumentos do método.

Confira os cenários abaixo para entender como adicionar argumentos às suas automações codificadas.

Adicionando parâmetros de entrada

1. Para adicionar parâmetros de entrada, defina-os após o nome do método de Entry Point.
2. Por exemplo, você tem uma automação codificada que representa um pedido de empréstimo que aceita apenas argumentos de entrada. Os argumentos de entrada necessários são o customerNameloanAmount, loanRatee loanTerm. Confira o fragmento de código abaixo:

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

Adicionando parâmetros de saída

1. Para adicionar parâmetros de saída, defina-os antes do nome do método de Entry Point.
   Observação: se o método retornar um único parâmetro, ele será nomeado automaticamente Output por padrão, e você não poderá renomeá-lo.
2. Por exemplo, você tem uma automação codificada que aprova ou nega um pedido de empréstimo com base na taxa do empréstimo. Esta automação requer um argumento de entrada para a taxa de empréstimo (loanRate) e um argumento de saída que mostra se o pedido de empréstimo foi aprovado ou negado (loanApproved). Confira o fragmento de código abaixo:

   public bool Execute (int loanRate)

3. Vejamos outro exemplo que gera dois parâmetros. Suponha que você tenha uma automação codificada que retorna o valor do empréstimo aprovado (LoanAmountApproved) e se o empréstimo foi aprovado (IsLoanApproved), com base na taxa de empréstimo (LoanRate). Confira o fragmento de código abaixo:

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

Adicionando parâmetros de In/Out

1. Para adicionar um argumento do tipo In/Out, defina o mesmo argumento antes e depois do nome do método de Entry Point.
2. Por exemplo, você tem uma automação codificada que recebe um valor inicial do empréstimo () e uma interestRatetaxa de juros (loanAmount) como entrada e, em seguida, calcula o valor atualizado do empréstimo após aplicar a taxa de juros e o retorna.Além disso, ele retorna um argumento informando o tipo de necessidade financeira que esse valor do empréstimo exigiria.
   Confira o fragmento de código abaixo:

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

Observação: se um argumento de entrada for nomeado Output, ele será tratado como um argumento In/Out. A nomeação de qualquer argumento como Output trata-o como um argumento In/Out, mesmo que seja declarado apenas uma vez no método.

Importação de argumentos de automações codificadas em fluxos de trabalho de pouco código

1. Crie uma automação codificada que recebe um valor inicial do empréstimo () e uma interestRatetaxa de juros (loanAmount) como entrada e, em seguida, calcule o valor atualizado do empréstimo após aplicar a taxa de juros e o retorne.
   Para esta automação codificada, você deve declarar o método de Entry Point como public double Execute (double interestRate, double loanAmount)
2. Adicione uma atividade Invoke Workflow File em uma automação de pouco código e ofereça o caminho para a automação codificada que você criou anteriormente.
3. Clique em Importar argumentos e verifique os argumentos importados.

   Para a automação codificada oferecida como exemplo, você deverá ter os seguintes argumentos importados:

   Name	Direction	Tipo	Valor
   loanAmount	In/Out	Double	10,000
   interestRate	Em	Double	5

   Adicione manualmente os argumentos que não aparecem como argumentos importados.

Dica: com o System.Activities 24.10 e superior, os argumentos que você adiciona a uma automação codificada são importados automaticamente em uma automação de pouco código quando você os invoca usando a atividade Invoke Workflow File.

Observação: o uso de classes aninhadas como argumentos de fluxo de trabalho não é compatível. As classes usadas como argumentos devem ser definidas diretamente dentro de um namespace.