studiox

2022.10

false

Guia do usuário do StudioX

Last updated 7 de ago de 2024

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.

Observação: se você estiver usando o Microsoft Excel 2010, não indique colunas inteiras no arquivo do Excel (por exemplo, B:G); sempre indique intervalos finitos (por exemplo, B1:G100). Devido a limitações nas versões do Excel mais antigas, indicar colunas completas pode resultar em um erro quando o projeto é executado.

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

Há duas maneiras para você poder adicionar um arquivo do Excel como um recurso a uma automação. A principal diferença entre elas é qual das atividades do projeto podem acessar e modificar os dados do arquivo do Excel:

Adicione uma atividade de recurso Use Excel File. Usando essa opção, os dados do arquivo só podem ser extraídos ou modificados pelas atividades adicionadas dentro da atividade de 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. Usando essa opção, o arquivo é adicionado como um recurso global, o que significa que ele pode ser acessado e modificado por todas as atividades do projeto. A conexão com o arquivo é fechada apenas após a execução da automação ser concluída. Isso se destina a casos em que o nome e o local do arquivo não serão alterados e o arquivo não precisa ser usado para outros fins, como ser carregado ou enviado à nuvem como um anexo de e-mail.

Como conectar um Projeto a um Arquivo do Excel

Para conectar a um arquivo do Excel e adicioná-lo como um recurso global:

Clique em Conecte ao Recurso no painel Gerenciador de Dados e selecione Conetar a um novo arquivo do Excel.
Na janela Gerenciador de Recursos, forneça as seguintes informações e clique em OK:
- Selecione o arquivo do Excel - Clique em Procurar próximo ao campo e busque e selecione o arquivo do Excel a ser adicionado à automação.
- E forneça um nome para depois - Insira um nome pelo qual você deve se referir ao arquivo no projeto de automação.
- Save changes (Salvar Alterações) - Selecione esta opção se você quiser que o arquivo seja salvo no fim da automação. Caso contrário, o arquivo retornará ao estado inicial após a execução do projeto. Esta opção é selecionada por padrão.
  
  Quando a opção de salvar alterações estiver desabilitada, a mensagem salvamento desabilitado será exibida próximo às entradas de recurso do Excel 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.

Gerenciar recursos do Excel

Você pode gerenciar recursos do Excel no painel Gerenciador de Dados, independentemente do modo na qual eles foram adicionados à automação. Clique com o botão direito do mouse em um recurso do Excel e selecione uma das opções do menu de contexto:

Abrir arquivo do Excel - Abre o arquivo no Excel.
Abrir local do arquivo do Excel - Abre a pasta contendo o arquivo do Excel.
Editar - Abre a janela Gerenciar recurso, onde você pode editar as propriedades do recurso.
Excluir - Remove o recurso do projeto.

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