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 para seu OneDrive. Esta planilha contém uma lista de produtos recebidos e sempre tem a mesma estrutura, com as seguintes colunas: Código do produto, Produto, Qtde, Preço/Kg, Preço total, Data de envio. No final de cada dia, você precisa ler o conteúdo desse arquivo e gravá-lo em uma nova planilha.

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

Exemplo

1. Adicione uma atividade For Each File/Folder ao seu fluxo de trabalho.
   • Lista de produtos é a pasta em seu OneDrive na qual um arquivo .XLSX é carregado diariamente às 11h: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 da atividade For each .

• Use o exemplo de 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 colunas:

3. Adicione uma atividade Create Workbook .

4. Adicione uma atividade Write Range .
   • Para Workbook, selecione a variável de saída da atividade Create Workbook .
   • Para O que escrever, selecione a variável de saída da atividade Read Range . Isso preenche a nova pasta de trabalho com conteúdo lido dos arquivos carregados diariamente para seu OneDrive:

Erros

Se os dados disponíveis no arquivo de modelo não corresponderem aos dados encontrados nos arquivos lidos, 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.