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:

• As variáveis precisam ser criadas com nomes diferentes, mesmo se usadas em escopos diferentes. Se duas variáveis compartilharem o mesmo nome, mas estiverem em escopos diferentes, a variável no escopo interno terá precedência. Você pode verificar nossas recomendações de Convenções de Nomenclatura de Fluxo de Trabalho.
• 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: Se houver uma variável e um argumento com o mesmo nome, a variável é sempre padronizada e usada em tempo de execução.

Você pode gerenciar variáveis de várias maneiras. Para se beneficiar da melhor experiência e flexibilidade, recomendamos o uso do 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.

• Pesquisar por tipos — permite que você explore mais tipos que podem ser relevantes para sua tarefa.

  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.
• Em projetos C#, o uso de uma variável global ou uma constante global em atividades requer seguir o formato: GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME. Em projetos VB, você pode fazer referência à variável global ou constante global por seu nome diretamente.

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. Arraste uma atividade do painel Atividades para o painel Projeto. Clique com o botão direito do mouse em um campo e selecione Criar variável a partir do menu de contexto, pressione Ctrl+K ou selecione Criar variável a partir do menu Plus no lado direito do campo. O campo Def Var será exibido.
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 é definido como DataTable.Se você criar uma variável no campo Text de uma atividade Write Line, o tipo de variável é 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. No painel Propriedades de qualquer atividade, clique com o botão direito do mouse em um campo e selecione Criar variável a partir do menu de contexto, pressione Ctrl+K ou selecione Criar variável a partir do menu Plus no lado direito do campo. O campo Def Var será exibido.
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.

Variáveis geradas automaticamente a partir de saídas de atividades (somente para projetos Windows e multiplataforma)

Se a configuração de design Gerar saídas de atividades automaticamente estiver habilitada, o Studio preencherá automaticamente cada campo Saída de atividades que geram uma saída com uma variável. Você pode usar a variável gerada em outras atividades selecionando o menu Mais no lado direito dos campos de entrada da atividade e, em seguida, Usar variável.

Se preferir criar manualmente uma variável de saída, você pode fazê-lo dentro do campo de saída. Isso substituirá a variável gerada pela variável que você criou. Se você selecionar a opção Limpar valor após criar manualmente uma variável, a variável gerada padrão será restaurada.

A variável gerada está disponível no painel Variáveis e no Data Manager (caso a variável seja utilizada em outra atividade). Como em qualquer outra variável, você pode alterar o nome, o tipo de dados, o escopo e o valor padrão da variável gerada.

O escopo da variável gerada é baseado na localização da atividade no fluxo de trabalho (por exemplo, o escopo é diferente se a atividade estiver na sequência principal ou dentro de uma atividade For each). O escopo da variável gerada é atualizado se você copiar, recortar ou colar a atividade. Renomear uma atividade não afeta a variável gerada. Excluir uma atividade, no entanto:

• Limpa o valor da variável se a variável não for usada.
• Exclui a variável se a variável for usada e um aviso for exibido nas atividades que usaram a variável como entrada.

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 pode levar a uma variável ou argumento indefinido, um tipo Unknown é adicionado em seu lugar para 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 o primeiro uso de um tipo de variável na janela Procurar e selecionar um tipo .Net, ela é exibida na lista suspensa Tipo de variável, no painel Variáveis.

Tipos de variáveis e argumentos que fazem parte de assemblies proprietários do Studio ou do Robô são ocultados. Fluxos de trabalho que referenciem tipos de tais assemblies não devem ser afetados no runtime. Para usar um tipo proveniente de uma assembly que não a .Net Framework, adicione-o como uma dependência ao seu projeto através da janela Gerenciar Pacotes.

Observação: atribuir um número de vírgula flutuante literal (por exemplo, 10,5) a uma variável ou argumento do tipo float (System.Single) resulta em um erro de compilação ao executar o fluxo de trabalho. Para atribuir o valor com sucesso, você pode:

• Usar o sufixo f ou F (1.5f ou 1.5F)
• Usar operadores de cast ( (float)1.5para C# ou CSng(1.5) para VB)