Trabalho com modelos de planilhas

Os modelos de planilhas estão disponíveis para uso nas seguintes atividades que envolvem o trabalho com planilhas ou pastas de trabalho:

• Microsoft 365:

  • Read Range
  • Write Range
  • Para cada linha da pasta de trabalho

• Google Workspace:

  • Read Range
  • Write Range
  • Para cada linha na planilha

Por que usar modelos?

Quando você precisa de modelos? Por exemplo, se a pasta de trabalho ou planilha que você precisa em sua automação ainda não estiver disponível no momento do design. Em vez de selecionar uma planilha específica em uma atividade, você seleciona a variável de saída de uma atividade anterior e usa um modelo para indicar quais dados procurar.

Considere o seguinte exemplo:

Todos os dias às 11h, um arquivo .XLSX é carregado em seu OneDrive. Esta planilha contém uma lista de produtos recebidos e tem sempre a mesma estrutura, com as seguintes colunas: Código do Produto, Produto, Quantidade, Preço/Kg, Preço Total, Data de Envio. Ao final de cada dia, você precisa ler o conteúdo desse arquivo e escrevê-lo em uma nova planilha.

O desafio? No momento do design, você não tem o arquivo .XLSX de que precisa, porque ainda não está disponível. É aqui que os modelos são úteis. Você pode usar um arquivo .XLSX de modelo como espaço reservado para arquivos futuros, porque ele tem a mesma estrutura dos arquivos que você processa com sua automação: mesmos nomes de planilhas, mesmos nomes de colunas etc.

Exemplo

1. Adicione uma atividade For Each File/Folder ao seu fluxo de trabalho.

   • A lista de produtos é a pasta em seu OneDrive onde um arquivo .XLSX é carregado diariamente às 11:00:

     
     

     

     
     

2. No Corpo da atividade For Each , adicione uma atividade Read Range .

   • Para o campo Pasta de trabalho , adicione a variável CurrentItem . Isso representa cada item (arquivo) identificado por meio do Para cada atividade.

     
     

     

     
     

   • Use a amostra da pasta de trabalho para adicionar um arquivo de modelo que tenha a mesma estrutura dos arquivos que você precisa processar diariamente. Neste exemplo, os seguintes nomes de coluna:

     
     

     

     
     

3. Adicione uma atividade Create Workbook .

   
   

   

   
   

4. Adicione uma atividade Write Range .

   • Para Pasta de trabalho, selecione a variável de saída da atividade Criar pasta de trabalho .

   • Para What to write, selecione a variável de saída da atividade Read Range . Isso preenche a nova pasta de trabalho com o conteúdo lido dos arquivos carregados diariamente em seu OneDrive:

     
     

     

     
     

Erros

Se os dados disponíveis no modelo de arquivo não corresponderem aos dados encontrados nos arquivos de leitura, uma mensagem de erro indicará o que deu errado. Por exemplo: Error: UiPath.MicrosoftOffice365.Excel.ExcelException: Column names or order do not match. Individual errors: at index 3: expected: Product ID but got: ID.