Sobre o pacote de atividades Excel

O pacote UiPath.Excel.Activities ajuda a automatizar todos os aspectos do Microsoft Excel, que é uma das ferramentas mais usadas em todos os setores. Ele contém atividades que permitem que você leia informações de células, colunas, linhas ou intervalos, grave em outras planilhas ou pastas de trabalho, execute macros e, até mesmo, extraia fórmulas. Além disso, você pode classificar dados, atribuir códigos de cores ou acrescentar informações adicionais.

Importante: não oferecemos mais suporte a atividades clássicas em projetos legados a partir da versão 3.0.0. Você ainda pode usar atividades clássicas em versões anteriores à 3.0.0. Para obter mais detalhes, consulte a página Próximas remoções .

Compatibilidade

Observação: o pacote UiPath.Excel.Activities é compatível com as seguintes versões do Microsoft Excel :

• 2013
• 2016
• 2019
• 2021
• 2024
• Office 365
• Office 2024

Configuração

Você pode habilitar a experiência moderna conforme explicado em Configurações do projeto.

Atividades Modernas

As atividades agrupadas em Moderna são as atividades mais recentes que foram projetadas inicialmente para o perfil do StudioX.

A experiência de design e as atividades do Excel Modern fornecem a mesma funcionalidade das atividades de negócios do StudioX por padrão no Studio. Siga a seção de tutorial para saber mais sobre como trabalhar com atividades do Excel no Studio. Para um guia completo, consulte Automação do Excel no guia do StudioX.

Experiência de design moderno do Studio

Uma experiência de design moderna está disponível no perfil do Studio a partir do Studio v2021.10 e UiPath.Excel.Activities v2.11.0. Na experiência moderna, as atividades modernas substituem as atividades clássicas no perfil do Studio, e a experiência de design do StudioX é trazida para o Studio.

A experiência de criação moderna é habilitada por padrão. Você pode selecionar a experiência de criação para cada projeto nas configurações de projeto das atividades do Excel. Quando a experiência clássica é habilitada para um projeto, as atividades clássicas de integração de aplicativos que não são compatíveis com a interação com o Excel no menu de adição estão disponíveis no painel de Atividades no Studio em vez das atividades modernas.

Tutorial

Adicione a atividade do escopo Use Excel File para indicar o arquivo a ser automatizado e configurar suas atividades filhas selecionando Dados do Excel no menu de adição de cada propriedade sem ter que inserir expressões manualmente:

1. Use o ícone de pasta para navegar pelo conteúdo do arquivo e selecionar dados que correspondam ao tipo de cada propriedade. Por exemplo, você pode selecionar células, intervalos, tabelas, planilhas ou gráficos a partir da planilha de trabalho. Você também pode indicar a linha atual ou a planilha atual em uma iteração.
   
   
   
   
2. Se você achar mais fácil trabalhar no Excel, no campo Intervalo , selecione o menu de mais para obter mais opções, selecione Excel e, em seguida, Indicar no Excel para selecionar dados diretamente do arquivo.
   Observação: essa funcionalidade requer que você instale o suplemento do Excel.
   
   
   
   
   
3. Use a opção Entrada personalizada para especificar manualmente a entrada com base em nomes de tabelas, gráficos ou planilhas ou para inserir referências a uma célula ou intervalo.
   
   

   

   
   

Se o arquivo que você deseja automatizar ainda não existir, você ainda pode usar as opções no menu mais definindo um arquivo com a mesma estrutura que um modelo na atividade Use Excel File.

Escolhendo o tipo de atividade mais adequado

Para decidir qual o tipo de atividade você deve usar, consulte a tabela a seguir.

Observação: as atividades modernas incluem uma gama mais ampla de opções do que as clássicas.

Tipo de atividade	Compatibilidade do projeto	Instalação do Excel necessária	Desempenho	Experiência do usuário	Melhor usado quando
Usar arquivo do Excel (Moderno)	Windows, multiplataforma	Sim	Alta (memória otimizada)	Visual e guiado (menu Mais, Indicar no Excel)	Criação de fluxos de trabalho modernos, funcionando em todos os perfis.
Escopo do Aplicativo do Excel (Clássico)	Windows, Windows - Legado	Sim	Melhor para tarefas de interface do usuário grandes ou complexas.	Configuração manual necessária	Automação de fluxos de trabalho de interface do usuário do Excel legado. As atividades clássicas do Excel não são adequadas para novas automações. É recomendável usar atividades modernas.
Atividades da pasta de trabalho	Windows, multiplataforma, Windows - Legado	Não	Bom para operações leves sem periféricos.	Baseado em expressão simples	O Excel não está instalado ou a interface do usuário não é necessária.

Atividades da pasta de trabalho

As atividades de pasta de trabalho podem ser executadas mesmo que o Microsoft Excel não esteja instalado na máquina e só podem ler ou gravar dados do e para o arquivo.

Você pode indicar o arquivo a ser processado em suas atividades de duas maneiras:

• Fornecer o caminho do arquivo em cada atividade de pasta de trabalho. Quando você usa essa opção, o arquivo é carregado na memória no runtime para cada atividade que o processa. Essa opção é a mais adequada para arquivos menores.
• Conectar seu projeto do Studio ao arquivo do Excel a partir do Data Manager para adicioná-lo como um recurso, depois fazer referência ao recurso em cada atividade de pasta de trabalho selecionando-o no menu de adição. Usando essa opção, depois que o arquivo é carregado, ele permanece na memória até que todas as atividades no escopo definido sejam executadas, proporcionando o melhor desempenho de runtime ao trabalhar com arquivos maiores e um número maior de atividades. Para otimizar o desempenho, defina o escopo para o contêiner mais próximo de onde as atividades que usam o recurso são colocadas no fluxo de trabalho. Para obter mais informações, consulte Como usar o Data Manager.

Atividades de integração de aplicativos

As atividades de integração de aplicativos clássicas exigem que o aplicativo do Excel esteja instalado na máquina em que são executadas. Para planilhas grandes e complexas que abrangem um grande número de linhas e colunas, recomendamos usar as atividades de integração do aplicativo , pois essas atividades oferecem o melhor desempenho e consistência.

Todas as atividades de integração de aplicativos, exceto as atividades CSV, devem ser incluídas no Excel Application Scope para funcionar. A partir da versão 2.10.4 do pacote de atividades do Excel, essas atividades também podem ser incluídas na atividade Use Excel File .

As atividades dedicadas habilitam você para trabalhar com arquivos .csv, enquanto todas as outras trabalham com .xlsx e .xls. Aquelas que só trabalham com escopo do aplicativo Excel também podem trabalhar com arquivos .xlsm.

Solução de problemas e limitações

Observação: o pacote de atividades do Excel não é compatível com o antigo formato de arquivo binário do Excel (.XLS) específico para o Microsoft Excel 95.

• Quando você usa atividades que leem, copiam ou anexam intervalos, se uma célula contiver informações de formatação, o Excel considera essa célula como contendo dados, mesmo que ela apareça vazia.

• O Microsoft Office 2016 versão 1708 (Build 8431.2079) altera o título da janela dos arquivos que estão sendo editados e salvos de "NomeDoArquivo.xlsx - Excel" para "NomeDoArquivo.xlsx - Salvo". Depois de fechar o arquivo, o nome do arquivo volta ao normal.

  Isso pode causar alguns problemas se seu projeto de automação usar seletores que contenham o título da janela. Por exemplo, o seguinte seletor não funciona mais se sua versão do Excel for a mencionada anteriormente: <wnd app='excel.exe' cls='XLMAIN' title='FileName.xlsx - Excel' /> <wnd cls='EXCEL7' title='FileName.xlsx' />. Para evitar esse problema, recomendamos o uso de um seletor de variável dinâmico.
• Algumas versões do Excel, por exemplo, Excel 2019, sempre abrem documentos do SharePoint no modo somente leitura. Você pode verificar se um documento remoto é compatível com a edição abrindo-o manualmente no Excel em sua máquina local.