Como gerenciar variáveis

No Studio, variáveis são utilizadas para armazenar vários tipos de dados. Outro aspecto chave das variáveis é que o seu pode ser alterado para que seja possível, por exemplo, controlar quantas vezes o corpo de um loop é executado.

Observação:

• Variables need to be created with different names, even if used in different scopes. If two variables share the same name but are in different scopes, the variable in the inner scope takes precedence. You can check out our Workflow Design Naming Conventions recommendations.
• Os nomes das variáveis devem começar com uma letra ou sublinhado _.
• O uso de certas palavras-chave (por exemplo, "Replace") para nomear variáveis pode causar erros inesperados.

Da perspectiva do Studio, o nome da variável é sua ID exclusiva e define a forma como será exibida e utilizada. Se ela for alterada ou excluída, o Studio não será capaz de interpretar os arquivos .xaml com base nas atividades carregadas. Todas as strings têm que ser colocadas entre aspas.

Importante:

If there are both a variable and an argument with the same name, the variable is always defaulted to and used at runtime.

You can manage variables in multiple ways. To benefit from the best experience and flexibility, we recommend using the Data Manager.

Tipo de Variável

Os dados armazenados dentro de uma variável são chamados de valor e podem ser de vários tipos. Quando você cria uma variável. As seguintes opções estão disponíveis:

• Booleano - Este tipo tem apenas dois valores possíveis: true ou false. Essas variáveis permitem que você tome decisões e, portanto, tenha melhor controle sobre seu fluxo de trabalho.

• Int32 - Esse tipo é usado para armazenar informações numéricas. Algumas de suas utilizações são para executar equações, comparações e passar dados importantes.

• String - Armazena informações de texto. Este tipo de variável pode ser usado para armazenar qualquer informação baseada em texto, como nomes de funcionários, nomes de usuários ou quaisquer outras strings.

• Objeto - Pode ser usado para armazenar diferentes tipos de dados. É possível usar este tipo de variável em situações nas quais você precisa de flexibilidade para o tipo de dados que você armazena em uma variável. Certifique-se de que o tipo de dados usado nas variáveis Objeto seja compatível com as atividades que usam a variável.

• System.Data.DataTable - Esse tipo pode armazenar grandes partes de informações e atuar como um banco de dados ou uma planilha simples, com linhas e colunas. Pode ser útil para migrar dados específicos de um banco de dados para outro e extrair informações de um site e armazená-la localmente em uma planilha, entre outros casos de uso.

• Matriz de [T] - Habilita você a armazenar vários valores do mesmo tipo.

• Browse for Types - Allows you to explore more types that can be relevant to your task.

  Observação:

  Uso de variáveis de tipos definidos pela linguagem usada no projeto como resultados estáticos em um erro de compilação no Windows e projetos multiplataforma.

Escopo das variáveis

A propriedade Escopo dá às variáveis um contexto bem definido no qual elas podem ser usadas. O escopo pode ser definido como global (disponível em todo o projeto), o arquivo do fluxo de trabalho atual ou qualquer atividade de contêiner dentro do arquivo de fluxo de trabalho.

Você só pode criar variáveis globais a partir do Data Manager.

Observação:

• As variáveis globais não são serializáveis e, portanto, são incompatíveis com atividades de persistência de longa duração.
• As variáveis globais não são suportadas em projetos de biblioteca.

Criando Variáveis

Do Data Manager

1. Abra o Data Manager e, então, selecione Nova > Nova variável.
2. Configure o nome, o tipo de dados, o escopo e o valor padrão para a variável.

A partir do Corpo de uma Atividade

1. From the Activities panel, drag an activity to the Designer panel. Either right-click a field and select Create Variable from the context menu, press Ctrl+K, or select Create Variable from the Plus menu on the right side of the field. The Set Var field is displayed.
2. Digite o nome e pressione Enter. A variável será criada e estará visível no campo. Verifique seu escopo e tipo no Data Manager.

A partir de Expressões

Alternativamente, variáveis podem ser criadas a partir 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 Ctrl+K. O campo Def Var será exibido.

2. Digite o nome e pressione Enter. A variável será criada. Verifique seu escopo e tipo no Data Manager.

   

As variáveis criadas dessas duas formas recebem automaticamente o tipo de acordo com a atividade. Por exemplo, se você criar uma variável no campo Data Table de uma atividade Write Range, o tipo da variável será definido como DataTable. Se você criar uma variável no campo Text de uma atividade Write Line, o tipo da variável será definido como String.

O escopo dessas variáveis será o menor contêiner da qual façam parte. O tipo é gerado automaticamente dependendo da propriedade selecionada.

A partir do Painel Propriedades

1. In the Properties panel of any activity, either right-click a field and select Create Variable from the context menu, press Ctrl+K, or select Create Variable from the Plus menu on the right side of the field. The Set Var field is displayed.
2. Digite o nome e pressione Enter. A variável será criada e estará visível no campo. Verifique seu escopo e tipo no Data Manager.

O escopo de uma variável criada dessa maneira será o menor contêiner do qual ela faz parte. O tipo é gerado automaticamente dependendo da propriedade selecionada.

No painel Variáveis

1. No painel Designer, clique em Variáveis. O painel Variáveis será exibido.
2. Clique na linha Criar Variável e preencha o nome. Uma nova variável será criada.

O tipo padrão das variáveis criadas dessa maneira é String.

Remover Variáveis

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 uma variável e, então, selecione Excluir variável. Ou então, selecione-a e pressione a tecla Delete.

No painel Variáveis

1. Abra o painel Variáveis.

2. Clique com o botão direito do mouse em uma variável e, então, selecione Excluir. Ou então, selecione-a e pressione a tecla Delete.

   

Remoção de todas as variáveis não utilizadas

Para remover todas as variáveis definidas mas não utilizadas em qualquer parte do arquivo atual, selecione Remover não utilizadas > Variáveis na faixa de opções do Studio e, então, selecione Sim quando solicitada a confirmação. Isso também remove variáveis que não foram usadas, mas foram mencionadas em anotações.

Observação:

Se você remover ou atualizar um pacote que cause uma variável ou argumento a ficar indefinido, um Tipo Desconhecido será adicionado em vez dele de forma que o arquivo possa ser aberto e editado no Studio.

Navegando através dos Tipos de Variável .Net

Para pesquisar tipos de variáveis que não são exibidos por padrão na lista Tipo de Variável faça o seguinte:

1. No Data Manager, no menu suspenso Tipo de dados para uma variável, selecione Procurar tipos. Você também pode acessar o menu a partir do menu suspenso Tipo de variável no painel Variáveis. A janela Procurar e Selecionar um Tipo .Net é mostrada.

2. No campo Nome do Tipo digite uma palavra-chave para a variável que você está procurando, como excel. Note que a seção de resultado é atualizada, exibindo todos os tipos de variáveis .Net que contêm sua palavra-chave.

3. Selecione uma e clique em OK. Uma nova variável é criada com o tipo selecionado e é exibida no painel Variáveis.

   

   Observação:

   Após usar um tipo de variável pela primeira vez na janela Procurar e Selecionar um Tipo .Net, ele será exibido na lista suspensa Tipo de Variável, no painel Variáveis.

Variable and argument types part of assemblies proprietary to Studio or Robot are hidden. Workflows that reference types from such assemblies should not be affected at runtime. To use a type from a non-.Net framework assembly, add it as a dependency to your project with the help of the Manage Packages window.