Como gerenciar argumentos

Os argumentos são usados para passar dados de um projeto para outro. Em um sentido global, eles se parecem com variáveis, pois armazenam dados dinamicamente e os passam. As variáveis passam dados entre atividades, enquanto os argumentos passam dados entre automações. Como resultado, permitem que você reutilize um determinado projeto indefinidamente.

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.

Importante:

• Se houver uma variável quanto um argumento com o mesmo nome, a variável sempre é definida como padrão e usada no tempo de execução.
• Passagem de argumentos In complexos (por exemplo, do tipo System.Data.Data.Table) para uma atividade Invoke Workflow File que não está isolada atua como se uma referência fosse passada, o que significa que quaisquer alterações no objeto dentro do fluxo de trabalho invocado alteram o objeto no fluxo de trabalho principal. Os tipos de argumentos integrados (por exemplo, booleano) são sempre transmitidos como valores.

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.

Por fim, esses argumentos podem ser usados para integração com outras ferramentas da sua empresa, pois também estão expostos no Orchestrator.Isso significa que qualquer processo que você criar agora pode receber parâmetros de entrada por meio da API ou interface do Orchestrator, bem como retornar uma saída para todos os mencionados acima. Mais informações disponíveis aqui.

Criando Argumentos

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.

Do Data Manager

1. Abra o Data Manager e, então, selecione Novo > Novo argumento.
2. Um novo item com o nome padrão argument é adicionado em Argumentos.
3. Configure o argumento criado:
   • Clique no nome do argumento para editar seu nome.
   • Expanda o argumento usando a seta para a esquerda e defina a Direção, Tipo de dados, se ela é Necessária e, opcionalmente, o Valor padrão.

No Data Manager, você também pode criar argumentos em massa clicando com o botão direito do mouse no nó Argumentos e, então, selecionando Criar argumentos em massa. É exibida uma nova janela, na qual você pode adicionar e configurar vários argumentos.

A partir do Corpo de uma Atividade

1. Arraste uma atividade do painel Atividades para o painel Projeto. Clique com o botão direito do mouse em um campo e selecione Criar Argumento de Entrada ou Criar Argumento de Saída no menu de contexto. Alternativamente, pressione Ctrl+M ou Ctrl+Shift+M. O campo Def Arg é exibido.
2. Preencha o nome e pressione Enter. O argumento é criado e fica visível no campo. Verifique sua direção e digite-a no painel Argumentos.

A partir de Expressões

Alternativamente, argumentos podem ser criados de expressões, diretamente em um campo de entrada de atividade ou no Editor de Expressões:

1. Selecione uma parte da expressão e pressione Trocto+M ou Trocto+Hifens+M. O campo Set Ag é exibido.

2. Digite o nome e pressione Enter. O argumento é criado. Verifique seu tipo e direção no painel Argumentos.

   

Argumentos criados dessas maneiras recebem automaticamente o tipo de acordo com a atividade. Por exemplo, se você criar um argumento no campo Data Table de uma atividade Write Range, o tipo do argumento será definido como DataTable. Se você criar um argumento no campo Text de uma atividade Write Line, o tipo do argumento será definido como String.

A partir do Painel Propriedades

1. No painel Propriedades de qualquer atividade, clique com o botão direito do mouse em um campo editável e selecione Criar Argumento de Entrada ou Criar Argumento de Saída no menu de contexto. Alternativamente, pressione Ctrl+M ou Ctrl+Shift+M. O campo Def Arg é exibido.
2. Preencha o nome e pressione Enter. O argumento é criado e fica visível no campo. Verifique sua direção e digite-a no painel Argumentos.

O argumento será gerado automaticamente dependendo da propriedade selecionada.

A partir do Painel Argumentos

1. No painel Designer, clique em Argumentos. O painel Argumentos é exibido.

2. Clique na linha Criar Argumento e preencha o nome. Um novo argumento é criado.

   Observação:

   Por padrão, todos os argumentos são do tipo String e apresentam a direção Entrada.

Removendo Argumentos

Você pode remover variáveis do Data Manager ou do painel Variáveis.

Do Data Manager

1. Abra o Data Manager e expanda o nó *Variáveis.
2. Clique com o botão direito do mouse em um argumento e, então, selecione Excluir.Ou então, selecione-a e pressione a tecla Delete.

A partir do Painel Argumentos

1. Abra o painel Argumentos.

2. Clique com o botão direito do mouse em um argumento e, então, selecione Excluir.Ou então, selecione-a e pressione a tecla Delete.

   

Remoção de todos os argumentos não utilizados

Para remover todos os argumentos que não são usados em nenhum lugar no arquivo atual, selecione Remover não utilizados > Argumentos na faixa de opções do Studio e, então, selecione Sim quando for solicitada a confirmação.