Tipos de variáveis

Variáveis de texto

Uma variável de texto ou string é um tipo de variável que pode armazenar apenas strings. Esses tipos de variáveis podem ser utilizados para armazenar qualquer informação, como nomes de funcionários, nomes de usuário ou qualquer outra string.

Observação: todas as strings no UiPath devem ser colocadas entre aspas.

Exemplo de uso de uma Variável de Texto

Para exemplificar como trabalhar com variáveis de texto, vamos criar um projeto que solicita o nome do usuário, o armazena e exibe apenas a primeira letra do seu nome no painel Saída.

1. Crie uma sequência.
2. Crie duas variáveis string simples FullNamee FirstLetter.
   
   

   

   
   
3. Adicione uma atividade Input Dialog ao painel Designer.
4. No campo Rótulo de entrada, digite "Digite seu nome completo por favor.".
5. No campo Título da caixa de diálogo , digite "Qual é seu nome?".
6. No campo Valor inserido, adicione a variável FullName. Essa variável armazena o que o usuário digitar quando solicitado pela atividade Caixa de diálogo de Entrada.
7. Adicione uma atividade Atribuir sob a atividade Diálogo de Entrada.
8. No painel Propriedades, no campo Para, adicione a variável FirstLetter.
9. No campo Value, digite FullName.Substring(0,1). A variável FirstLetter recebe o novo valor criado pela expressão FullName.Substring(0,1).
   Observação: este campo usa a função Substring() para encontrar o primeiro caractere da string adicionada pelo usuário no Diálogo de entrada.
10. Adicione uma atividade Write Line sob a atividade Assign.
11. No painel Propriedades, no campo Texto, insira a variável FirstLetter . Isso significa que o painel Resultado irá exibir a primeira letra do que o usuário tiver digitado no Diálogo de Entrada. O projeto deverá ter a seguinte aparência.
    
    

    

    
    
12. Pressione F5. A janela Qual o seu nome? será exibida.
13. Digite seu nome no campo de texto e pressione OK. No painel Saída do UiPath Studio, observe que a primeira letra do seu nome será exibida.
    
    

    

    
    

Baixe o exemplo

Variáveis verdadeira ou falsa

Uma variável verdadeiro ou falso, conhecida como booleana, é um tipo de variável que tem apenas dois valores possíveis, verdadeiro ou falso. Essas variáveis permitem que você tome decisões e, assim adquirir um melhor controle de seu fluxo.

Exemplo de uso de uma Variável Verdadeiro ou Falso

Para exemplificar como trabalhar com variáveis verdadeiro ou falso, vamos criar uma automação que solicita o nome e o gênero do usuário e exibe os resultados em outra janela.

1. Crie um novo processo e adicione um Fluxograma.
2. Crie duas variáveis de string simples, Name e Gender. A primeira será usada para armazenar o nome do usuário e a segunda para armazenar o gênero do usuário.
3. Crie uma variável booleana, Male. Essa variável será usada para verificar se o usuário é do gênero masculino.
   
   

   

   
   
4. Adicione uma atividade Input Dialog ao painel Designer e conecte-a ao nó Iniciar.
5. No painel Propriedades, no campo Label, digite "Qual é o seu nome?".
6. Adicione um título e, no campo Resultado, adicione a variável Name.
7. Adicione outra atividade Input Dialog e conecte-a à anterior.
8. No painel Propriedades, no campo Rótulo, digite "Qual é o seu gênero?".
9. Adicione um título e, no campo Resultado, adicione a variável Gender.
10. Adicione uma atividade Decisão de Fluxo ao painel de Projeto e conecte-a ao segundo Diálogo de Entrada.
11. No painel Propriedades, no campo Condition, digite Gender = "Masculino" ou Gender = "masculino". Essa atividade verifica o gênero do usuário.
12. Adicione duas atividades Assign.
13. Conecte um gênero à ramificação Verdadeiro da atividade Flow Decision.
14. No painel Propriedades, no campo Para adicione a variável Male.
15. No campo Valor, digite Verdadeiro. Isso atribuirá o valor Verdadeiro à variável Malequando a condiçãoGender = "Masculino" ou Gender= "masculino" for atendida.
16. Conecte a segunda atividade Atribuir à ramificação Falso da Decisão de Fluxo.
17. No painel Propriedades, no campo Para adicione a variável Male.
18. No campo Value, digite False. Isso atribuirá o valor False à variável Male quando a condição Gender = "Masculino" ou Gender = "masculino" não for atendida.
19. Adicione uma nova Flow Decision e conecte as duas atividades Assign recém adicionadas à ela.
20. No painel Propriedades, no campo Condição, digite Male= Verdadeiro.
21. Adicione uma atividade Message Box e conecte-a à ramificação True da Flow Decision.
22. No painel Propriedades, no campo Text, digite Name + " é " + Gender+ ".". Essa mensagem exibe o nome do usuário e seu gênero caso Maleseja verdadeiro.
23. Adicione outra atividade Message Box e conecte-a à ramificação False da Flow Decision.
24. No painel Propriedades, no campo Text, digite Name + " é " + Gender+ ".". Essa mensagem exibe o nome do usuário e seu gênero, caso Male seja falso. O projeto final deve se parecer com a captura de tela abaixo.
    
    

    

    
    
25. Pressione F5. A automação é executada. Note que a Caixa de Mensagem final exibe a mensagem como esperado.
    
    

    

    
    

Baixe o exemplo

Variáveis de número

As variáveis de número são conhecidas como números inteiros ou Int32, e são usadas para armazenar informações numéricas. Elas podem ser usadas para executar equações ou comparações, passar dados importantes e muitas outras coisas.

Exemplo de Uso de uma Variável Numérica

Para exemplificar como se pode trabalhar com variáveis numéricas, criaremos uma automação que solicita do usuário o seu ano de nascimento e exibe sua idade em uma janela.

1. Crie uma nova sequência.
2. Crie duas variáveis Int32, BirthYear e Age. A primeira armazena o ano de nascimento do usuário e a segunda sua idade.
3. Adicione uma atividade Input Dialog à sequência.
4. Nos campos Título da caixa de diálogo e Rótulo de entrada, digite um título e um rótulo apropriados.
5. No campo Valor inserido, adicione a variável BirthYear.
6. Adicione uma atividade Assign sob a atividade Input Dialog.
7. No painel Propriedades, no campo Para, adicione a variável Age.
8. No campo Value, digite 2022 – BirthYear. Isso atribui o valor da subtração (2022 menos o ano de nascimento do usuário) à variável Age.
9. Adicione uma atividade Message Box sob a atividade Assign.
10. No painel Propriedades, no campo Texto, digite "Parabéns! Você tem " + Age.ToString + ".".
    Observação: o método .ToString converte o número inteiro armazenado na variável Age em uma string e a exibe como tal.

O projeto final deve parecer com a captura de tela a seguir.

11. Pressione F5. A automação será executada. Observe que a Message Box exibe a sua idade, conforme esperado.

Baixe o exemplo

Variáveis Arra

A variável array é um tipo de variável que permite que você armazene vários valores do mesmo tipo.

O UiPath Studio é compatível com tantos tipos de array quantos tipos de variáveis haja. Isso significa que é possível criar uma matriz de números, uma de strings, uma de valores booleanos e assim por diante.

Exemplo de uso de uma variável array

Para exemplificar como se pode trabalhar com variáveis array, criaremos uma automação que solicita do usuário seu primeiro e último nomes e idade, armazena as informações em uma array e a armazena em um arquivo .txt.

1. Crie uma nova sequência.
2. Crie três variáveis string, FirstName, LastName e Age nas quais armazenar as informações coletadas do usuário.
3. Crie um array de variável strings chamado NameAge.
   
   

   

   
   
4. Adicione uma atividade Input Dialog ao painel Designer.
5. Preencha os campos Título da caixa de diálogo e Rótulo de entrada para pedir o primeiro nome do usuário.
6. No campo Valor inserido, digite a variável FirstName. Essa variável armazena o primeiro nome do usuário.
7. Adicione outra atividade Diálogo de Entrada sob a anterior.
8. Preencha os campos Título da caixa de diálogo e Rótulo de entrada para pedir o sobrenome do usuário.
9. No campo Valor inserido, digite a variável LastName. Essa variável armazena o último nome do usuário.
10. Adicione outra atividade Diálogo de Entrada sob a anterior.
11. Preencha os campos Título de Diálogo e Rótulo de Entrada para perguntar a idade do usuário.
12. No campo Valor inserido, digite a variável Age. Essa variável armazena a idade do usuário.
    Observação: usamos uma variável String e não um Integer para armazenar a idade, de modo que não tenhamos que convertê-la mais tarde, quando a adicionarmos à variável array de string.
13. Adicione uma atividade Atribuir sob a última atividade Diálogo de Entrada.
14. No painel Propriedades, no campo Para adicione a variável NameAge.
15. No campo Valor, digite {FirstName,LastName,Age}. Esta atividade Atribuir possibilita o armazenamento de todos os valores das variáveis string anteriores na variável NameAge.
16. Adicione uma atividade Gerar Arquivo de Texto sob a atividade Atribuir.
17. No painel Propriedades no campo NomeDeArquivo, digite entre aspas o caminho do arquivo que você deseja gerar, por exemplo "%HOMEPATH%\Desktop\array_variable.txt".
    Observação: se o arquivo não existir no caminho fornecido, ele será criado.
18. No campo Texto, digite NameAge(0) + " " + NameAge(1) + " " + NameAge(2)+ ".".
    Observação: ao adicionar o número de índice dos itens do array você poderá acessar seus valores e armazená-los, no caso deste exemplo em um arquivo de texto.

    O projeto final deve parecer com a captura de tela a seguir.

    
    

    

    
    
19. Pressione Ctrl + F5 para executar o projeto.
20. Navegue até o arquivo fornecido na etapa 17 e clique duas vezes nele. Uma janela do Bloco de Notas será exibida com as informações adicionadas na etapa 20.
    
    

    

    
    

Baixe o exemplo

Variáveis de data e hora

A variável de data e hora é um tipo de variável que permite que você armazene informações sobre qualquer data e hora. Esse tipo de variável pode ser encontrado na janela Procurar e Selecionar um Tipo .Net, sob o System namespace System.DateTime. Para mais informações, consulte Pesquisando Tipos de Variável .Net.

Por exemplo, ela pode ser usada para acrescentar datas a faturas ou a quaisquer outros documentos com os quais você esteja trabalhando que tenham alguma especificidade de data.

Exemplo de Uso de uma Variável Data e Hora

Para exemplificar como você pode trabalhar com uma variável de data e hora, criaremos uma automação que recebe a data e hora atual, subtrai um período específico de tempo e armazena o resultado em uma planilha do Microsoft Excel.

1. Crie uma nova sequência.
2. Crie duas variáveis DateTime Todaye LastTime.
3. Crie uma variável TimeSpan, chamada Span e no tipo de campo Padrão digite 1.02:10:04.
   Observação: o valor padrão atribuído à variável Span segue o formato dia.hh:mm:ss .
4. Adicione uma atividade Assigmo ao painel Designer.
5. No painel Propriedades, no campo Para, adicione a variável Today.
6. No campo Value, digite Now. Isso gera a data e hora em que o projeto esteja sendo executado, nos formatos dd/MM/yyyye hh:mm:ss.
7. Adicione outra atividade Atribuir sob a atividade anterior.
8. No painel Propriedades, no campo Para, adicione a variável LastTime.
9. No campo Valor, digite Today.Subtract(Span). Isso irá subtrair o valor padrão da variável Span da data atual, armazenada na variável Today.
10. Adicione uma atividade Excel Process Scope sob a última Assign. Essa atividade abre ou reutiliza processos do Excel, carrega as configurações do projeto do Excel e as aplica ao arquivo do Excel associado.
11. Adicione uma atividade Use Excel File dentro da atividade Excel Process Scope.
    Observação: use a funcionalidade Gerenciar Pacotes para baixar as atividades do Excel, caso ainda não as tenha instalado.
12. No campo Caminho da pasta de trabalho, digite o caminho do arquivo do Excel no qual você deseja escrever, entre aspas. No nosso caso, "%HOMEPATH%\Desktop\urgent_invoice.xlsx".
    Observação: se o arquivo não existir no caminho fornecido, ele será criado.
13. Adicione uma atividade Write Cell na atividade Use Excel File.
14. No campo O que escrever, digite LastTime.ToString. Isso transforma o valor da variávelLastTime em uma string e o armazena nas coordenadas atribuídas anteriormente.
15. No lado direito do campo Onde escrever, selecione Mais > Excel > Indicar no Excel.
16. Dentro do arquivo do Excel, indique a célula na qual você deseja escrever (em nosso caso, "E3"). Clique em Confirmar após indicar a célula.

    O projeto final ficará parecido com a seguinte captura de tela:

    
    

    

    
    
17. Pressione F5. A automação é executada.
18. Navegue até o seu arquivo Excel e clique duas vezes na célula na qual você adicionou a data. Note que as informações de hora e data serão exibidas na célula que você selecionou.
    
    

    

    
    

Baixe o exemplo

Variáveis Catablema

As variáveis DataTable representam um tipo de variável que pode armazenar grandes quantidades de informações e funcionam como um banco de dados ou uma planilha simples com linhas e colunas. Elas podem ser encontradas na janela Procurar e Selecionar um Tipo .Net, sob o namespace System.Data (System.Data.DataTable). Para mais informações, consulte Pesquisando Tipos de Variável .Net.

Essas variáveis podem ser úteis para migrar dados específicos de um banco de dados para outro, extrair informações de um site e armazená-las localmente em uma planilha e muitos outros usos.

Exemplo de Uso de Variáveis DataTable

Para exemplificar como você pode usar variáveis DataTable, criaremos uma automação que lê apenas duas dentre várias colunas em uma planilha do Excel e as transfere para outra planilha que já contém outras informações.

O arquivo inicial é um banco de dados de pessoas, transações, datas e produtos. Neste exemplo, iremos extrair os nomes e datas de compra e os anexaremos a uma planilha do Excel que já contém informações semelhantes.

1. Crie uma nova sequência.
2. Adicione uma atividade Excel Process Scope. Essa atividade abre ou reutiliza processos do Excel, carrega as configurações do projeto do Excel e as aplica ao arquivo do Excel associado.
3. Adicione uma atividade Use Excel File à sequência. Essa atividade é necessária para a maioria das atividades relacionadas ao Excel.
   Observação: se você não possui atividades do Excel instaladas em sua versão do UiPath, use a funcionalidade Gerenciar Pacotes para obtê-las.
4. Crie duas variáveis DataTable dt_NamesListe dt_DateInfo. Elas serão usadas para armazenar informações da planilha inicial do Excel.
5. No painel Propriedades, no campo Caminho da pasta de trabalho, digite entre aspas o caminho do arquivo inicial do Excel a ser usado.
6. Adicione duas atividades Read Range e coloque-as uma sob a outra na atividade Use Excel File. Elas são usadas para obter informações da planilha inicial.
7. Selecione a primeira atividade Read Range. No lado direito do campo Intervalo, selecione Mais > Excel > Indicar no Excel.
8. Dentro do arquivo do Excel, indique as coordenadas que dizem ao UiPath Studio de onde extrair as informações (em nosso caso, "G7:G37"). Clique em Confirmar após selecionar o intervalo.
9. No campo Salvar em, digite o nome da primeira variável DataTable, dt_NamesList. Essa variável armazena todas as informações disponíveis entre as linhas G7 e G37.
10. (Opcional) Altere o valor no campo DisplayName para Read Names, para que você possa facilmente diferenciar essa atividade da segunda.
11. Selecione a segunda atividade Read Range. No lado direito do campo Intervalo, selecione Mais > Excel > Indicar no Excel.
12. Dentro do arquivo do Excel, indique as coordenadas que contêm a data da ordem que queremos extrair (em nosso caso, "C7:C37"). Clique em Confirmar após selecionar o intervalo.
13. No campo Salvar em, especifique a variável dt_DateInfo. Essa variável conterá todas as informações de data necessárias.
14. Adicione uma segunda atividade Use Excel File à sequência.
15. No painel Propriedades, no campo Caminho da pasta de trabalho, digite o caminho do arquivo do Excel a ser usado para armazenar todas as informações coletadas nas etapas anteriores.
16. Adicione uma atividade Write DataTable to Excel ao painel Designer, sob a segunda Use Excel File. Essa atividade é usada para escrever as informações armazenadas em outro arquivo do Excel.
    Observação: o arquivo usado com a atividade Write Range deve ser fechado quando você executar o projeto. Se não estiver fechado, um erro será exibido e a execução da automação será interrompida.
17. No campo O que escrever, digite a variável dt_NamesList.
18. No lado direito do campo Destino, selecione Mais > Excel > Indicar no Excel.
19. Dentro do segundo arquivo do Excel, selecione a célula inicial na qual as informações do arquivo inicial devem ser adicionadas (em nosso caso, "B7"). Clique em Confirmar.
20. Adicione outra atividade Write DataTable to Excel e coloque-a abaixo da primeira.
21. No campo O que escrever, digite a variável dt_DateInfo.
22. No lado direito do campo Destino, selecione Mais > Excel > Indicar no Excel.
23. Selecione a célula inicial (em nosso caso, "A7"). Clique em Confirmar.
    
    

    

    
    
24. Pressione F5. A automação é executada.
25. Clique duas vezes no arquivo final do Excel. Note que as informações copiadas estão disponíveis e atualizadas corretamente.
    
    

    

    
    

Baixe o exemplo