Automação do Excel

Sobre a Automação do Excel

StudioX offers a deep integration with Microsoft Excel and ships with a number of activities that automate the tasks you perform in Excel. For information on installing the Excel add-in, see the Studio guide.

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

If you want to repeat the same activities for each row in a range, add a For Each Excel Row activity, and then add the activities to repeat inside it.

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

• Tutorial: Criando uma Tabela Pivot
• Tutorial: Iterando através das Linhas de uma Tabela
• Tutorial: Comparar arquivos do Excel e enviar e-mails com erros de reconciliação
• Tutorial: Extrair dados de e-mails automatizados e movê-los para um aplicativo da área de trabalho.
• Tutorial: Filtrar dados no Excel
• Tutorial: Formatar células
• Tutorial: Adicionar informações sobre os arquivos de uma pasta para um arquivo do Excel
• Tutorial: Adicionando suas Próprias Fórmulas ao Project Notebook
• Tutorial: Preenchendo Formulários PDF no Acrobat Reader com Dados do Excel

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

• Use Excel File
• Append Range
• Auto Fill
• Autofit Range
• Change Pivot Data Source
• Clear Sheet/Range/Table
• Create Pivot Table
• Copy/Paste Range
• Delete Rows
• Delete Column
• Excluir Planilha
• Duplicate Sheet
• Export to CSV
• Filtro
• Fill Range
• Find First/Last Data Row
• Find/Replace Value
• Format As Table
• For Each Excel Row
• For Each Excel Sheet
• Formatar células
• Get Excel Chart
• Insert Column
• Insert Chart
• Insert Rows
• Insert Sheet
• Busca
• Match function
• Proteger Planilha
• Read Cell Formula
• Read Cell Value
• Read Range
• Refresh Pivot Table
• Refresh Excel Data Connections
• Remove Duplicates
• Renomear Folha
• Run Spreadsheet Macro
• Save Excel File
• Save Excel File As
• Save Excel File As PDF
• Sort Range
• Text To Columns
• Unprotect Sheet
• Update Excel Chart
• VLookup
• Write Cell
• Gravar DataTable no Excel

Observação:

There are a couple of different ways of launching and previewing Excel files, both at runtime and at design time. To learn more, see the Project settings.

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:

• Add a Use Excel File resource activity. Using this option, the data in the file can only be accessed by the activities added inside the resource activity. After all the activities inside Use Excel File are executed, the file is closed. This is useful when the file will be created at runtime (e.g. downloaded or saved from an email attachment) or if the file needs to sent to another location (e.g. uploaded or sent as an email attachment).
• Connect the project to the Excel file from the Data Manager to add it as a project resource. Using this option, you can configure the scope where the file is available and set it to either the entire workflow or only to a certain container activity. By default, the scope is set to the main container (the entire project), which means that it can be accessed and modified by all the activities in the project, and the file remains open until the entire project is executed. If you don't need the Excel resource to be available in the entire project, you can set the scope closer to the activities where it is used. This ensures the file is open only when it's needed, which can speed up execution. For example, you can add all the activities that interact with an Excel file inside a Group container activity and set the scope to the Group container. Connecting the project to an Excel file is useful when the file name and location won't change and the file doesn't need to be used for other purposes such as uploading or sending as an email attachment.

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

The formulas available in the Project Notebook are detailed below. To learn how you can add formulas to the Project Notebook, see Tutorial: Adding Your Own Formulas to the Project Notebook.

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

For an example of how you can use the formulas in the Date sheet, see Tutorial: Working with Files and Folders.

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.

For an example of how you can use the formulas in the Text sheet, see Tutorial: Extracting Data from Automated Emails and Moving It to a Desktop Application.

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.

For an example of how you can use the formulas in the File sheet, see Tutorial: Saving, Renaming, and Moving Attachments.