Exemplo de como usar a ação Encontrar arquivo/pasta do pacote Google Drive

Crie um bot que pesquise um arquivo no Google Drive e crie o arquivo se ele não for encontrado no caminho especificado.

Pré-requisitos

Imagine que você deseja criar uma planilha do Google se ela não existir no Google Drive. Você pode usar a ação Google Drive > Encontrar arquivo/pasta do pacote Google Drive para verificar se um arquivo já existe no Google Drive. Se não existir, você pode criar o arquivo usando a ação Criar pasta de trabalho do pacote Planilhas do Google.

Esse bot verifica o Google Drive em busca de uma planilha do Google. Se não existir no caminho especificado, o bot cria uma planilha do Google e copia dados de um arquivo CSV para ela.

Procedimento

  1. Crie um novo bot.
    1. No painel do lado esquerdo, clique em Automação.
    2. Clique em Criar novo > Task Bot.
    3. Na janela Criar Task Bot, insira um nome para o bot.
    4. Aceite o local da pasta padrão: \Bots\
    5. Para alterar o local de armazenamento do bot padrão, clique em Escolher e siga as instruções.
    6. Clique em Criar e editar.
  2. Abra o arquivo CSV que contém os dados que você deseja copiar para um Planilhas do Google.
    1. No painel Ações, encontre e adicione a ação CSV/TXT > Abrir ao Editor de bot.
    2. Em Nome da sessão, insira csvsession.
    3. Em Caminho do arquivo, especifique o caminho para o arquivo CSV do qual os dados devem ser copiados.
    4. Se a tabela CSV tiver um cabeçalho, selecione Contém cabeçalho.
    5. Selecione um delimitador conforme o usado no arquivo CSV.
    6. Salve as alterações.
  3. Leia dados do CSV e armazene-os em uma variável da tabela de dados.
    1. No painel Ações, encontre e adicione a ação CSV/TXT > Ler ao Editor de bot.
    2. Em Nome da sessão, insira csvsession.
    3. Em Atribuir valor à variável, clique em (x) e crie uma variável chamada TableFromCSV.
    4. Salve as alterações.
  4. Feche o arquivo CSV.
    1. No painel Ações, encontre e adicione a ação CSV/TXT > Fechar ao Editor de bot.
    2. Em Nome da sessão, insira csvsession.
    3. Salve as alterações.
  5. Conecte-se ao Google Drive.
    1. No painel Ações, encontre e adicione a ação Google Drive > Conectar ao Editor de bot.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth que você configurou.
    3. No Modo de autenticação OAuth2, selecione Control Room gerenciada.
    4. Clique em Escolher e selecione a conexão que você configurou na Control Room.
    5. Salve as alterações.
  6. Conecte-se ao Planilhas do Google.
    1. No painel Ações, encontre e adicione a ação Planilhas do Google > Conectar ao Editor de bot.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth que você configurou.
    3. Em Nome da sessão, insira gsheetsession.
    4. No Modo de autenticação OAuth2, selecione Control Room gerenciada.
    5. Clique em Escolher e selecione a conexão que você configurou na Control Room.
    6. Salve as alterações.
  7. Antes de criar uma nova planilha no Google Drive, verifique se o arquivo que você está tentando criar já existe. Crie o arquivo somente se ele não existir no caminho especificado. Para fazer isso, use as ações Tentar Capturar.
    1. No painel Ações, encontre e adicione a ação Gerenciador de erros > Tentar ao Editor de bot.
    2. Salve as alterações.
  8. Para verificar se o arquivo já existe, use a ação Encontrar arquivo/pasta do Google Drive.
    1. No painel Ações, encontre e adicione a ação Google Drive > Encontrar arquivo/pasta no bloco Tentar.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth.
    3. Em Encontrar, clique em Arquivo.
    4. Em Caminho da pasta de origem, insira a pasta de origem. Por exemplo, neste cenário de amostra, o bot procura o arquivo no caminho aa-docs/spreadsheets.
    5. Em Tipo de correspondência, selecione Correspondências exatas.
    6. Em Nome do arquivo/pasta, insira contacts.
    7. Em Retorna a lista de arquivos ou pastas, selecione Dicionário.
    8. Clique em (x) e crie uma variável de dicionário chamada FileFolderDictionary com subtipo como Qualquer um.
    9. Salve as alterações.
  9. Crie um arquivo se ele não existir.
    1. No painel Ações, encontre e adicione a ação Planilhas do Google > Criar pasta de trabalho no bloco Capturar.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth.
    3. Em Nome da sessão, insira gsheetsession.
    4. Em Nome da pasta de trabalho, insira contacts.
    5. Em Caminho do arquivo, clique em Do meu local compartilhado e insira o caminho da pasta pai. Por exemplo, nesta amostra de cenário, o bot procura o arquivo no caminho aa-docs/spreadsheets.
    6. Salve as alterações.
  10. Para abrir uma planilha do Google Drive, você precisa do ID do arquivo ou do caminho do arquivo. Como o bot cria o arquivo de forma dinâmica, você não terá o caminho do arquivo anterior à execução do bot. No entanto, você pode obter o ID do arquivo usando a ação Encontrar arquivo/pasta do Google Drive outra vez.
    1. No painel Ações, encontre e adicione a ação Google Drive > Encontrar arquivo/pasta após os blocos Tentar Capturar.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth.
    3. Em Encontrar, clique em Arquivo.
    4. Em Caminho da pasta de origem, insira a pasta de origem. Por exemplo, o bot de amostra neste exemplo procura o arquivo no caminho aa-docs/spreadsheets.
    5. Em Tipo de correspondência, selecione Correspondências exatas.
    6. Em Nome do arquivo/pasta, insira contacts.
    7. Em Retorna a lista de arquivos ou pastas, clique em Dicionário e selecione a variável FileFolderDictionary.
      A API Encontrar arquivo/pasta retorna um dicionário com informações sobre os arquivos correspondentes. O dicionário contém uma chave chamada NumberOfFiles. Ela mostra a contagem de arquivos correspondentes. O dicionário também contém chaves chamadas Arquivo1, Arquivo2 e assim por diante, dependendo do número de arquivos correspondentes. Essas chaves contêm informações como nomes e IDs dos arquivos no formato JSON. Confira a seguir um exemplo de dicionário retornado pela chamada de API Encontrar arquivo/pasta:
      {NumberOfFiles,1},{File1,{"fileName":"contacts","fileId":"171yBUzqH80ZW_KLEp23DwebzkCdDZgnGFWBzB6K9kco"}}
      Você pode recuperar o ID do arquivo analisando a string JSON, que é o valor associado à chave Arquivo1.
    8. Salve as alterações.
  11. Analise a string JSON associada à chave Arquivo1.
    1. No painel Ações, encontre e adicione a ação Json > Iniciar sessão.
    2. Em Fonte de dados, selecione Texto e insira $FileFolderDictionary{File1}$.
    3. Em Sessão do objeto JSON, clique em Sessão local e insira jsonsession.
    4. Salve as alterações.
  12. Recuperar o ID do arquivo do objeto JSON.
    1. No painel Ações, encontre e adicione Json > Obter o valor do nó.
    2. No campo Chave ou caminho do nó JSON, insira fileId.
    3. Em Nome da sessão, insira jsonsession.
    4. Em Salvar o resultado em uma variável, clique em (x) e crie uma variável chamada FileId.
    5. Salve as alterações.
  13. Encerrar a sessão JSON.
    1. No painel Ações, encontre e adicione a ação Json > Encerrar sessão.
    2. Em Nome da sessão, insira jsonsession.
    3. Salve as alterações.
  14. Com o ID do arquivo recuperado, abra a planilha criada no Google Drive.
    1. No painel Ações, encontre e adicione a ação Planilhas do Google > Abrir planilha.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth.
    3. Em Nome da sessão, insira gsheetsession.
    4. Em Abrir planilha, clique em Do ID da planilha e insira $FileId$.
    5. Salve as alterações.
  15. Grave a variável da tabela de dados no Planilhas do Google.
    1. No painel Ações, encontre e adicione a ação Planilhas do Google > Gravar da tabela de dados.
    2. Em Nome da sessão, insira gsheetsession.
    3. Em Opções de planilha, clique em Planilha específica e insira Sheet1 ou o nome da planilha conforme sua planilha de destino em Nome da planilha.
    4. Em Inserir variável da tabela de dados, selecione TableFromCSV.
    5. Em Valor inicial da célula, insira A1.
    6. Salve as alterações.
  16. Desconecte o Google Drive e o Planilhas do Google.
    1. No painel Ações, encontre e adicione a ação Google Drive > Desconectar.
    2. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth.
    3. Salve as alterações.
    4. No painel Ações, encontre e adicione a ação Planilhas do Google > Desconectar.
    5. Em Nome de usuário, selecione String insegura e insira o ID de e-mail associado à conexão OAuth.
    6. Em Nome da sessão, insira gsheetsession.
    7. Salve as alterações.
  17. Executar o bot.