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.

Você começa adicionando o arquivo do Excel que deseja automatizar como um recurso ao projeto de automação e adicione as atividades a serem executadas no arquivo. Ao configurar as atividades que usam o arquivo, você pode selecionar planilhas, tabelas, intervalos nomeados e células nomeadas diretamente do menu Mais no StudioX. Você também pode alternar perfeitamente entre o StudioX e o Excel para indicar os dados a serem usados diretamente do arquivo.

Se você clicar em Indicar no Excel no menu Mais ao configurar uma atividade para selecionar dados diretamente do arquivo, sua planilha será aberta no Excel e uma guia UiPath aparece na faixa de opções do Excel. Selecione os dados que você deseja usar, como por exemplo uma célula ou um intervalo de células, e clique em Confirmar na guia UiPath para confirmar a seleção.

Você também pode indicar manualmente os dados do Excel a serem usados selecionando a opção Entrada Personalizada no menu Mais. Essa opção permite que você insira referências de células e intervalos ou nomes de planilhas, o que pode ser útil quando você está trabalhando com arquivos do Excel com nomes dinâmicos ou com arquivos que não existem no momento da elaboração e nenhum arquivo de modelo está disponível.

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 no runtime quanto no período de design. 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:

Adicionar uma atividade do 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.

O Notebook do projeto padrão é um arquivo chamado Project_Notebook.xlsx, que é criado pelo StudioX na pasta do projeto. O arquivo vem com um conjunto predefinido de fórmulas que você pode usar em qualquer projeto de automação. As fórmulas são divididas em várias planilhas com base na área às quais são aplicáveis. Cada planilha contém células em que você pode adicionar dados e fórmulas de entrada para manipular esses dados. As fórmulas são um modo fácil para identificar células nomeadas que você pode selecionar para usar em suas automações diretamente do menu Mais .

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.
AutoRecuperar Arquivo - Selecione esta opção se você quiser que a pasta de trabalho seja salva no fim da automação. Caso contrário, o arquivo retornará ao estado inicial após a execução do projeto. Esta opção não está selecionada por padrão.

Quando a opção de save changes estiver desabilitada, a mensagem Salvamento de alterações desabilitado será exibida próximo às entradas do Projeto do Notebook no menu Mais e no painel Gerenciador de Dados.
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.

Nesta página