UiPath Documentation
studiox
2023.10
false

Guia do usuário do StudioX

Última atualização 30 de abr de 2026

Automação do Excel

Sobre a Automação do Excel

O StudioX oferece uma integração profunda com o Microsoft Excel e fornece uma variedade de atividades para automatizar as tarefas que você executa no Excel. Para obter informações sobre como instalar o suplemento do Excel, consulte o Guia do Studio.

You start by adding the Excel file you want to automate as a resource to the automation project, and then add the activities to perform in the file. When configuring the activities that use the file, you can select sheets, tables, named ranges, and named cells directly from the Plus docs image menu in StudioX. You can also seamlessly switch from StudioX to Excel to indicate the data to use directly from the file.

If you click Indicate in Excel in the Plus docs image menu when configuring an activity to select data directly from the file, your spreadsheet is opened in Excel and a UiPath tab appears in the Excel ribbon. Select the data you want to use, for example a cell or a range of cells, and then click Confirm in the UiPath tab to confirm the selection.

You can also manually indicate the Excel data to use by selecting the Custom Input option in the Plus docs image menu. This option enables you to enter cell and range references, table names, or sheet names, which can be useful when you are working with Excel files with dynamic names, or with files that don't exist at design time and no template file is available.

Se você quiser repetir as mesmas atividades para cada linha de um intervalo, adicione uma atividade For Each Excel Row e, em seguida, adicione as atividades a serem repetidas dentro dela.

Para saber como automatizar tarefas do Excel, consulte os seguintes tutoriais:

As seguintes atividades estão disponíveis no StudioX:

Observação:

Há algumas maneiras diferentes de iniciar e visualizar os arquivos do Excel, tanto na execução quanto na elaboração. Para saber mais, consulte Configurações do projeto.

Como adicionar um Arquivo do Excel a uma Automação

A maneira como você adiciona um arquivo a uma automação determina quais atividades no projeto podem acessar e modificar o arquivo do Excel e por quanto tempo o arquivo permanece aberto durante a execução. Há duas maneiras de adicionar um arquivo do Excel a uma automação:

  • Adicione uma atividade de recurso Use Excel File. Usando essa opção, os dados no arquivo só podem ser acessados pelas atividades adicionadas dentro da atividade do recurso. Após todas as atividades dentro do Use Excel File serem executadas, o arquivo será fechado. Isso é útil quando o arquivo for criado no runtime (por exemplo, baixado ou salvo de um anexo de e-mail) ou se o arquivo precisar ser enviado para outro local (por exemplo, enviado à nuvem ou anexado a um e-mail).
  • Conectar o projeto ao arquivo do Excel a partir do Data Manager para adicioná-lo como um recurso do projeto. Usando essa opção, você pode configurar o escopo em que o arquivo estará disponível e defini-lo para todo o fluxo de trabalho ou apenas para uma determinada atividade do contêiner. Por padrão, o escopo é definido como o contêiner principal (o projeto inteiro), o que significa que ele pode ser acessado e modificado por todas as atividades no projeto, e o arquivo permanece aberto até que todo o projeto seja executado. Se você não precisar que o recurso do Excel esteja disponível em todo o projeto, você poderá definir o escopo mais próximo das atividades em que ele é usado. Isso garante que o arquivo seja aberto apenas quando necessário, o que pode acelerar a execução. Por exemplo, você pode adicionar todas as atividades que interagem com um arquivo do Excel dentro de uma atividade do contêiner do Grupo e definir o escopo para o contêiner do grupo. A conexão do projeto a um arquivo do Excel é útil quando o nome e o local do arquivo não são alterados e o arquivo não precisa ser usado para outros fins, como upload ou envio como um anexo de email.

Sobre o Notebook do Projeto

O Notebook do projeto é uma pasta de trabalho do Excel que você pode usar como um bloco de notas para armazenar fórmulas e manipular dados. Seu propósito é ser usado para fazer cálculos e armazenar dados temporários durante a execução do projeto. Por padrão, as alterações feitas no Notebook do Projeto não são salvas quando a execução da automação for concluída.

The default Project Notebook is a file named Project_Notebook.xlsx that is created by StudioX in the project folder. The file comes with a predefined set of formulas that you can use in any automation project. The formulas are split on several sheets based on the area they apply to. Each sheet contains cells where you can add input data and formulas that manipulate that data. The formulas are in easy to identify named cells that you can select for use in your automations directly from the Plus docs image menu.

Configurar o Notebook do Projeto

Selecionar Notebook > Configurar notebook na faixa de opções do StudioX. Você pode fazer as seguintes configurações:

  • Arquivo do Notebook - Selecione outro arquivo do Excel para usar como Notebook do Projeto.

  • E dê a ele um nome para depois - Insira um nome que será usado como referencia do arquivo do Excel no projeto quando uma atividade interagir com ele. O nome padrão é Notes.

  • Senha de acesso - Se aplicável, insira a senha necessária para abrir o arquivo.

  • Senha de edição - Se aplicável, insira a senha necessária para editar o arquivo.

  • Autosave file - Select this option if you want the file to be saved at the end of the automation. Otherwise, the file is returned to the initial state after project execution. This option is not selected by default. When the option to save changes is disabled, the message Save changes: off is displayed next to the Project Notebook entries in the Plus docs image menu and in the Data Manager panel.

  • Somente leitura - Selecione esta opção se você quiser abrir o arquivo no modo somente leitura. Isso possibilita operações de extração de dados em um arquivo bloqueado para edições ou que exija senha para ser editado. Esta opção não está selecionada por padrão.

Formulas do Notebook do projeto

As fórmulas disponíveis do Notebook do projeto são detalhadas abaixo. Para saber como adicionar fórmulas ao Notebook do Projeto, consulte o Tutorial: Como Adicionar suas Próprias Fórmulas ao Notebook do Projeto.

Data

Insira uma data de base (por padrão, a data de hoje) na célula B4 (Date_Input) e um número de dias (por padrão, 7) na célula B6 (Days) a ser adicionado à data na célula B4 posteriormente na planilha. As seguintes fórmulas estão disponíveis:

  • Data mais um número de dias (DatePlusDays) - retorna a data resultante da adição do número de dias na célula B6 à data inserida na célula B4.
  • Data mais um número de dias úteis (DatePlusWorkingDays) - retorna a data resultante da adição do número de dias na célula B6 à data inserida na célula B4, sem incluir fins de semana.
  • Formato da data (YYYYMMDD) - retorna a data inserida na célula B4 convertida em um texto com o formato YYYYMMDD.
  • Hoje (Today) - retorna a data de hoje.
  • Datas da semana passada (Segunda/Sexta/Domingo) - retorna as datas de Segunda (LastWeekMonday), Sexta (LastWeekFriday) e Domingo (LastWeekSunday) da semana passada.
  • (Primeira/Última) data do mês passado - retorna as datas do primeiro dia (LastMonthStartDate)e do último dia (LastMonthEndDate). do mês anterior.
  • Primeiro/Último dia útil do mês - retorna as datas do primeiro dia útil (ThisMonthFirstWorkingDay) e do último dia útil (ThisMonthLastWorkingDay) do mês atual.
Converter Texto em uma Data de Maneira Independente do Local

Insira uma data na célula B18 (DateText) que contém caracteres japoneses para o ano, mês e o dia inserido após os numeros. A data é convertida para o formato MM/DD/YYYY e retorna para a célula B29 (ReformattedDate).

Para um exemplo de como usar as fórmulas na planilha de dados, consulte o Tutorial: Trabalhar com Arquivos e Pastas.

Texto

Insira um texto na célula B4 (Text_Input). Para pesquisar um texto específico dentro da célula B4, insira o texto a ser pesquisado na célula B10 (Search). Para substituir o texto pesquisado por outro texto, insira o texto de substituição na célula B11 (Replace). As seguintes fórmulas estão disponíveis:

  • Trimmed - retorna o texto da célula B4 com qualquer espaço extra removido.
  • Length - retorna o número de caracteres do texto da célula B4.
  • Upper case - retorna o texto da célula B4 com todos os caracteres maiúsculos.
  • Lower case - retorna o texto da célula B4 com todos os caracteres minúsculos.
  • Result - retorna o texto à célula B4 modificada, substituindo o texto adicionado na célula B10 pelo texto adicionado na célula B11.
  • Contains - confere se o texto adicionado na célula B10 aparece no texto da célula B4, e retorna TRUE se o texto for encontrado ou FALSE se o texto não for encontrado.
  • First Name - retorna o texto anterior ao último caractere de espaço do texto da célula B4.
  • Last Name - retorna o texto posterior ao último caractere de espaço do texto da célula B4.
Extrair Valores de um Texto

Para extrair um valor específico do texto adicionado na célula B4 à F5, adicione texto à esquerda do valor na célula D5 e/ou o texto à direita do valor na célula E5. Para extrair vários valores, use as células das mesmas colunas das linhas 6-9. Você pode usar isso em automações para extrair valores de variáveis de blocos do texto que seguem o mesmo modelo. Por exemplo, você pode extrair valores como números e valores de faturas de notificações automatizadas de e-mail, onde forem precedidos pelos mesmos rótulos.

Para um exemplo de como usar as fórmulas na planilha de Texto, consulte o Tutorial: extrair dados de e-mails automatizados e movê-los para um aplicativo da área de trabalho.

Número

Insira um número na célula B4 (Number_Input). As seguintes fórmulas estão disponíveis para manipular o número:

  • Limpo (CleanNumber) - retorna o número adicionado na célula B4 com todas as quebras de linha e espaços inquebráveis removidos.
  • Int - retorna a parte integral do número da célula B4.
  • Dois decimais (TwoDecimals) - retorna o número adicionado na célula B4 com duas casas decimais.
Converter texto em um número de modo independente da localidade

Insira um número que não tem separador de grupos ou um ponto (.) como separador de grupos e tem vírgula (,) como separador de decimais na célula B11 (NumberText_Input). O número retorna à célula B15 (ReformattedNumber) convertido ao formato com vírgula (,) como separador de grupos e ponto (.) como separador de decimais.

de transações

Insira o caminho completo para um arquivo, incluindo a extensão do arquivo na célula B6 (FullFileName_Input). As seguintes fórmulas estão disponíveis:

  • Nome do arquivo (FileName) - retorna o nome do arquivo incluindo a extensão do caminho do arquivo adicionado na célula B6.
  • Extensão do arquivo (FileExtension) - retorna a extensão do arquivo do caminho do arquivo adicionado na célula B6.
  • Nome de arquivo sem extensão (FileNameNoExtension) - retorna o nome do arquivo sem extensão do caminho do arquivo adicionado na célula B6.
  • Pasta (Folder) - retorna o caminho para a pasta que contém o arquivo cujo caminho foi adicionado na célula B6.
  • Reformatar o Nome do Arquivo (ReformattedFileName) - retorna os valores nas células B9 e B10 separados por .(ponto). O resultado é o nome do arquivo com extensão.

Para um exemplo de como usar as fórmulas na planilha de Arquivo, consulte o Tutorial: salvar, renomear e mover anexos.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades