Exemplo de leitura de dados de uma planilha

Crie um bot que leia dados de uma planilha do Excel e escreva-os em outra planilha.

Pré-requisitos

Para usar o Excel avançado pacote, o Microsoft Excel deve estar instalado no dispositivo em que você executa a amostra bot.

Suponha que uma equipe de processamento de pedidos receba dados de pedidos em uma planilha como parte do processo de atendimento de pedidos. A equipe automatiza o processo de criação de uma lista de remessas prioritárias a partir da planilha e a compartilha com o departamento de Picking. O exemplo bot deste tutorial executa as seguintes tarefas:

  • Lê dados de planilha que contêm uma lista de pedidos usando Excel avançado pacote.
  • Cria uma nova planilha contendo uma lista de pedidos que precisam ser enviados como prioridade.

Para este tutorial, você pode baixar e usar um arquivo de amostra do Excel aqui.

Procedimento

  1. Crie um novo bot.
    1. No painel do lado esquerdo, clique em Automação.
    2. Clique em Criar novo > Tarefa de Bot.
    3. Na janela Criar bot de tarefa, insira Priority List no Nome.
    4. Clique em Criar e editar.
  2. Para ler os dados da planilha que contém a lista de pedidos, abra a planilha do Excel.
    1. No painel Ações, localize e adicione a ação Excel avançado > Abrir ao Editor de bot.
    2. Clique em Arquivo e selecione o arquivo de amostra do Excel que você baixou.
    3. Selecione Planilha contém um cabeçalho.
    4. Selecione Nome da planilha específica e insira order_list.
    5. Em Criar sessão do Excel, clique em Sessão local e insira orderlist como o nome da sessão.
  3. Para a lista de pedidos prioritários, crie uma nova planilha.
    1. No painel Ações, localize e adicione a ação Excel avançado > Criar pasta de trabalho ao Editor de bot.
    2. Em Caminho do arquivo, especifique um caminho de arquivo para o novo arquivo. Por exemplo, C:\\bots\priority-orders.xlsx.
    3. Em Nome da planilha, insira priority orders.
    4. Em Criar sessão do Excel, selecione Sessão local e insira prioritylist como o nome da sessão.
    5. Salve as alterações.
  4. Copie o cabeçalho da planilha de origem para a nova planilha.
    1. No painel Ações, localize e adicione a ação Excel avançado > Obter várias células ao Editor de bot.
    2. Em Selecionar intervalo de células a serem retornadas, selecione Linhas específicas e, em seguida, insira 1 nos campos Da linha e Para a linha.
    3. Em Nome da sessão, insira orderlist.
    4. Para armazenar os valores copiados em uma variável, crie e atribua uma variável chamada HeaderData em Atribuir valor à variável. Os valores são armazenados em uma variável da tabela de dados.
    5. Salve as alterações.
  5. Escreva o cabeçalho copiado na nova planilha.
    1. Localize e adicione a ação Excel avançado > Escrever a partir da tabela de dados ao Editor de bot.
    2. Em Inserir variável da tabela de dados, selecione HeaderData.
    3. Clique em Planilha de trabalho específica e insira priority orders.
    4. Em Especificar a primeira célula, insira A1.
    5. Em Nome da sessão, insira prioritylist.
    6. Salve as alterações.
  6. Antes de escrever os dados na nova planilha, certifique-se de que a célula A2 esteja selecionada na nova planilha. Para isso:
    1. No painel Ações, localize e adicione a ação Excel avançado > Ir até a célula ao Editor de bot.
    2. Em Célula específica, insira A2.
    3. Em Nome da sessão, insira prioritylist.
    4. Salve as alterações.
  7. Percorrer a lista de pedidos na planilha de origem.
    1. No painel Ações, localize e adicione a ação Loop ao Editor de bot.
    2. Em Iterador, selecione Para cada linha na planilha para Excel avançado.
    3. Em Executar loop, selecione Todas as linhas.
    4. Em Nome da sessão, insira orderlist.
    5. Em Atribuir o valor atual a essa variável, selecione Registrar e, em seguida, crie uma variável chamada order-record.
    6. Salve as alterações.
  8. Selecione os registros em que ShippingType é igual a Priority.
    1. a. No painel Ações, localize e adicione a ação Se dentro da ação Loop.
    2. Em Condição, selecione a condição String.
    3. Em Valor de origem, insira $order_record[4]$ para selecionar a quinta coluna no registro atual.
    4. Em Operador, selecione Igual a(=).
    5. Em Valor de destino, insira Priority.
    6. Salve as alterações.
  9. Se for encontrado um registro correspondente, escreva o registro na nova planilha. Você pode conseguir isso usando a ação Definir célula tantas vezes quanto o número de colunas nos dados de origem. No entanto, este exemplo usa a ação Loop para obter o mesmo resultado.
    1. No painel Ações, localize e adicione a ação Loop dentro da ação Se.
    2. Em Iterador, selecione Para cada valor no registro.
    3. Em Registrar variável, selecione order-record.
    4. Em Atribuir o valor atual a esta variável, selecione Criar uma variável chamada RecordValue.
    5. Salve as alterações.
    6. No painel Variáveis, crie uma variável com os seguintes detalhes:
      • Em Nome, insira RecordValueCounter.
      • Em Tipo, selecione Number.
      • Em Valor padrão, insira 0.
    7. No painel Ações, localize e adicione a ação Excel avançado > Definir célula.
    8. Certifique-se de que a opção Célula ativa esteja selecionada.
    9. Em Valor da célula, insira $order-record[$recordValueCounter$]$.
    10. Em Nome da sessão, insira prioritylist.
    11. Para mover o cursor para a próxima célula na linha, localize e adicione a ação Excel avançado > Ir até a célula e, em seguida, selecione Uma célula à direita em Célula ativa.
    12. Em Nome da sessão, insira prioritylist.
    13. Para incrementar a variável recordValueCounter, localize e adicione a ação Número > Incremento. Selecione recordValueCounter nos campos Inserir número e Atribuir o valor de saída a uma variável. Em Inserir valor de incremento, digite 1.
    14. Salve as alterações.
  10. Redefina a variável recordValueCounter para zero.
    1. Localize e adicione a ação Número > Decremento após o loop interno, mas dentro da ação Se.
    2. Selecione recordValueCounter nos campos Inserir número e Atribuir o valor de saída a uma variável.
    3. Em Inserir valor de incremento, digite 7.
    4. Salve as alterações.
  11. Mova o cursor para a próxima linha antes da próxima iteração.
    1. Localize e adicione a ação Excel avançado > Ir até a célula dentro da primeira ação Loop (após a ação Decremento).
    2. Clique em Célula ativa e selecione Início da linha.
    3. Em Nome da sessão, insira prioritylist.
    4. Localize e adicione a ação Excel avançado > Ir até a célula.
    5. Clique em Célula ativa e selecione Uma célula abaixo.
    6. Em Nome da sessão, insira prioritylist.
    7. Salve as alterações.
  12. Executar o bot.