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 na atividade Input Dialog.

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çãoSubstring() para encontrar o primeiro caractere da string adicionada pelo usuário no Diálogo de Entrada.

10. Adicione uma atividade Write Line na atividade Atribuir.

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 Flow Decision ao painel Designer e conecte-a ao segundo Input Dialog.

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 Atribuir.

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 Atribuir no 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 Caixa de Mensagem na atividade Atribuir.

10. No painel Propriedades, no campo Text, digite "Parabéns!" Você tem " + Age.ToString + ".".

    :::note
    The `.ToString` method converts the integer stored in the `Age` variable to a string and displays it as such.
    :::
    

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

    

11. Pressione F5. A automação é 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. Fill in the Dialog Title and Input Label fields to ask for the user’s first name.

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. Fill in the Dialog Title and Input Label fields to ask for the user’s age.

12. No campo Valor inserido, digite a variável Age. Essa variável armazena a idade do usuário.

    :::note
    We use a string variable and not an integer to store the age, so that we do not have to convert it later on, when we add it to the string array variable.
    :::
    

13. Adicione uma atividade Atribuir no último Input Dialog.

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 Gravar arquivo de texto na 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".

    :::note
    If the file does not exist at the provided path, it is created.
    :::
    

18. No campo Texto, digite NameAge(0) + " " + NameAge(1) + " " + NameAge(2)+ ".".

    :::note
    By adding the index number of the array items you can access their values and write them, in this example, to a text file.
    :::
    

    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 maiores 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ávelSpan segue o formato dia.hh:mm:ss .

4. Adicione uma atividade Atribuir no 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 na última atividade Atribuir.Essa atividade abre ou reutiliza processos do Excel, carrega as configurações do projeto Excel e as aplica ao arquivo do Excel associado.

11. Adicione uma atividade Use Excel File dentro da atividade Excel Process Scope.

    :::note
    Use the [Manage Packages](https://docs.uipath.com/studio/standalone/2024.10/user-guide/managing-activities-packages#managing-packages) feature to download the Excel activities, if you do not already have them installed.
    :::
    

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".

    :::note
    If the file does not exist at the provided path, it is going to be created.
    :::
    

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:

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/2024-10-docs-image-166740-814a08a0.webp)

17. Pressione F5. A automação é executada. 18. Navegue até o 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.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/2024-10-docs-image-167045-874ea11d.webp)

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 maiores 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 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 tiver instalado as atividades do Excel na sua versão do UiPath, use a funcionalidade Gerenciar Pacotes para recebê-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, dentro do campo CaminhoDaPasta, digite entre aspas o caminho do arquivo inicial do Excel a ser usado.

6. Adicione duas atividades Intervalo de leitura 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 Intervalo de leitura. 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 Intervalo de leitura. 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, no segundo Use Excel File. Essa atividade é usada para escrever as informações armazenadas em outro arquivo do Excel.

    :::note
    The file used with the **Write Range** activity has to be closed when you run the project. If it is not closed, an error is displayed and the automation execution stops.
    :::
    

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. Add another Write DataTable to Excel activity and place it under the first one.

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