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.

O Studio oferece suporte para vários tipos de argumentos, correspondentes aos tipos de variáveis. Portanto, é possível criar argumentos de Valor Genérico, String, Booleano, Object, Array, ou TabelaDeDados. Além disso, você também pode pesquisar tipos .Net da mesma maneira que faz no caso das variáveis.

Além disso, os argumentos têm direções específicas (Entrada, Saída, Entrada/Saída, Propriedade) que indicam para o aplicativo para onde as informações armazenadas neles devem ir.

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.
• Passar argumentos In para uma atividade Invoke Workflow File que não está isolada age como se fosse passada uma referência, o que significa que quaisquer alterações feitas no objeto dentro do fluxo de trabalho invocado alteram o objeto no fluxo de trabalho principal.

Leve em consideração que ao criar um argumento Entrada/Saída com um valor de Entrada dentro da atividade Invocar Fluxo de Trabalho e alterá-lo para Saída, você notará que será exibido um erro ao se executar o projeto. Isso ocorre porque a atividade Invocar Fluxo de Trabalho não devolveu os valores via referência. Use um Operador Global no seu projeto para obter acesso aos valores exatos que os argumentos tiveram dentro do fluxo de trabalho invocado.

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 estão disponíveis aqui.

Criando Argumentos

Os nomes de argumento devem estar em CamelCase maiúscula e apresentar um prefixo demonstrando a direção do argumento, como , in_DefaultTimeout, in_FileName, out_TextResult, io_RetryNumber. Você pode conferir nossas recomendações de convenções de nomenclatura de design de fluxo de trabalho para obter mais detalhes.

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 têm uma direção de 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, em seguida, selecione Excluir. Ou então, selecione-o 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, em seguida, selecione Excluir. Ou então, selecione-o 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.

Configuração de propriedades de argumento

A janela Propriedades de argumento centraliza os argumentos usados em todo seu projeto, bem como suas propriedades. Após publicar o projeto, essas informações ficam visíveis no Orchestrator, Assistant e Automation Ops - Pipelines.

Para configurar propriedades de argumento, abra o painel Projeto, clique com o botão direito em um arquivo XAML definido como principal ou marcado como um ponto de entrada para o projeto e selecione a opção Propriedades do argumento. Você pode reorganizar os argumentos listados na janela arrastando e soltando-os no menu do lado esquerdo.

Selecione um argumento no menu do lado esquerdo e insira o seguinte:

• Nome de exibição - O rótulo que aparece para o argumento.
• Dica de ferramenta - a dica de ferramenta que é visível quando você passa o mouse sobre o argumento.
• Necessário - Se o argumento é necessário.