Pausar e retomar um fluxo de trabalho usando callbacks e o app Planilhas Google

Criar uma pasta no Google Drive

Crie uma pasta no Google Drive. Essa pasta é usada para armazenar sua planilha. Ao configurar uma permissão para a pasta compartilhada, seu fluxo de trabalho pode gravar na planilha.

1. Acesse drive.google.com.
2. Clique em Novo > Nova pasta.
3. Digite um nome para a pasta.
4. Clique em Criar.
5. Clique com o botão direito do mouse na nova pasta e selecione Compartilhar.

6. Adicione o endereço de e-mail da conta de serviço padrão do Compute Engine.

   Isso dá à conta de serviço acesso à pasta. Quando você associa a conta de serviço ao fluxo de trabalho, ele tem acesso de edição a qualquer arquivo na pasta. Saiba mais sobre como compartilhar arquivos, pastas e drives.

7. Selecione o papel Editor.

8. Desmarque a caixa de seleção Notificar pessoas.

9. Clique em Compartilhar.

Criar uma planilha usando as Planilhas Google

Quando você cria uma planilha no Planilhas Google, ela é salva no Google Drive. Por padrão, a planilha é salva na pasta raiz do Drive. Não há opção para criar uma planilha diretamente em uma pasta especificada usando a API Google Sheets. No entanto, há alternativas, incluindo mover a planilha para uma pasta específica depois de criá-la, como é feito neste exemplo. Para mais informações, consulte Trabalhar com pastas do Google Drive.

1. Acesse sheets.google.com.

2. Clique em Novo .

   A planilha será criada e aberta. Cada planilha tem um valor de spreadsheetId exclusivo que contém letras, números, hífens ou sublinhados. Você pode encontrar o ID da planilha em um URL do app Planilhas Google:

   https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

3. Anote esse ID, porque ele será necessário ao criar o fluxo de trabalho.

4. Adicione cabeçalhos de coluna para corresponder ao exemplo a seguir:

   

   O valor na coluna G, Aprovado?, é usado para iniciar callbacks no fluxo de trabalho.

5. Mova a planilha para a pasta do Google Drive que você criou anteriormente:

   1. Na planilha, selecione Arquivo > Mover.
   2. Acesse a pasta que você criou.
   3. Clique em Mover.

Você também pode usar o conector da API Google Sheets para criar uma planilha. Ao usar o conector, o spreadsheetId pode ser recuperado do resultado resp. Exemplo:

- create_spreadsheet:
    call: googleapis.sheets.v4.spreadsheets.create
    args:
      body:
      connector_params:
        scopes: ${driveScope}
    result: resp
- assign_sheet_id:
    assign:
      - sheetId: ${resp.spreadsheetId}

Ampliar as Planilhas Google usando o Apps Script

Com o Apps Script, é possível criar, ler e editar Planilhas Google de maneira programática. A maioria dos scripts criados para as Planilhas manipula matrizes para interagir com as células, linhas e colunas de uma planilha. Para uma introdução ao uso do Apps Script com as Planilhas Google, consulte o Guia de início rápido de funções personalizadas.

1. Crie um projeto do Apps Script nas Planilhas Google:

   1. Abra sua planilha do Google.
   2. Selecione Extensões > Apps Script.
   3. No editor de script, clique em Projeto sem título.
   4. Dê um nome ao projeto e clique em Renomear.

   Agora, o script está vinculado à sua planilha, o que dá a ele habilidades especiais para alterar a interface do usuário ou responder quando a planilha é aberta.

   Um projeto de script representa uma coleção de arquivos e recursos do Apps Script. Os arquivos de código em um projeto de script têm uma extensão .gs.

2. É possível usar o Apps Script para escrever funções personalizadas que podem ser usadas no Google Sheets como uma função integrada. As funções personalizadas são criadas usando JavaScript padrão. Crie uma função:

   1. Abra seu projeto do Apps Script.
   2. Clique em Editor code.
   3. Um arquivo de script aparece como um arquivo de projeto chamado Code.gs. Para editar o arquivo, selecione-o.

   4. Substitua o código no editor de script pelo seguinte, que lê os dados na sua planilha e os transmite como entrada para uma execução de fluxo de trabalho:

      function handleEdit(e) {
        var range = e.range.getA1Notation();
        var sheet = e.source;
      
        if (range.length > 1 && range[0] === 'G') {
          if (e.value == "TRUE") {
            Logger.log("Approved: TRUE");
      
            var row = range.slice(1);
            var url = sheet.getRange('E' + row).getCell(1, 1).getValue();
            var approver = sheet.getRange('F' + row).getCell(1, 1).getValue();
      
            callback(url, approver);
          }
          else {
            Logger.log("Approved: FALSE");
          }
        }
      }
      
      function callback(url, approver) {
        const headers = {
          "Authorization": "Bearer " + ScriptApp.getOAuthToken()
        };
      
        var payload = {
          'approver': approver
        };
      
        const params = {
          "method": 'POST',
          "contentType": 'application/json',
          "headers": headers,
          "payload": JSON.stringify(payload)
        };
      
      
        Logger.log("Workflow callback request to " + url);
        var response = UrlFetchApp.fetch(url, params);
        Logger.log(response);
      }

   5. Clique em Salvar save.

3. Os gatilhos instaláveis do Apps Script permitem que um projeto de script execute uma função especificada quando determinadas condições são atendidas, como quando uma planilha é aberta ou editada. Crie um gatilho:

   1. Abra seu projeto do Apps Script.
   2. Clique em Acionadores alarm.
   3. Clique em Adicionar gatilho.
   4. Na caixa de diálogo Adicionar gatilho para YOUR_PROJECT_NAME, configure o gatilho:
      1. Na lista Escolha a função que será executada, selecione handleEdit.
      2. Na lista Escolha qual implantação deve ser executada, selecione Head.
      3. Na lista Selecionar origem do evento, escolha Da planilha.
      4. Na lista Selecionar tipo de evento, escolha Ao editar.
      5. Na lista Configurações de notificação de falha, selecione Me notificar diariamente.
   5. Clique em Salvar.

   6. Se você receber uma solicitação para escolher uma Conta do Google, selecione a conta apropriada e clique em Permitir.

      Isso permite que seu projeto do Apps Script veja, edite, crie e exclua suas planilhas Google; e se conecte a um serviço externo.

4. Um arquivo de manifesto do projeto do Apps Script é um arquivo JSON que especifica informações básicas do projeto que o Apps Script precisa para executar um script com sucesso. O editor do Apps Script oculta os arquivos de manifesto por padrão para proteger as configurações do projeto do Apps Script. Edite o arquivo de manifesto:

   1. Abra seu projeto do Apps Script.
   2. Clique em Configurações do projeto settings.
   3. Selecione a caixa de seleção Mostrar arquivo de manifesto "appsscript.json" no editor.
   4. Clique em Editor code.
   5. O arquivo de manifesto aparece como um arquivo de projeto chamado appsscript.json. Para editar o arquivo, selecione-o.

   6. O campo oauthScopes especifica uma matriz de strings. Para definir os escopos de autorização que seu projeto usa, adicione uma matriz com os escopos que você quer oferecer suporte. Exemplo:

      {
        "timeZone": "America/Toronto",
        "dependencies": {
        },
        "exceptionLogging": "STACKDRIVER",
        "runtimeVersion": "V8",
        "oauthScopes": [
          "https://www.googleapis.com/auth/script.external_request",
          "https://www.googleapis.com/auth/cloud-platform",
          "https://www.googleapis.com/auth/spreadsheets"
        ]
      }

      Isso define escopos explícitos para:

      • Conectar a um serviço externo
      • Ver, editar, configurar e excluir seus Google Cloud dados e consultar o endereço de e-mail da sua Conta do Google
      • Ver, editar, criar e excluir todas as suas planilhas do Planilhas Google

   7. Clique em Salvar save.

Implantar um fluxo de trabalho que grava em uma planilha e usa callbacks

Implante um fluxo de trabalho que executa, pausa e retoma quando um callback é aprovado em uma planilha. O fluxo de trabalho grava em uma planilha do Google usando o conector da API Google Sheets.

Testar o fluxo completo

Execute o fluxo de trabalho para testar o fluxo completo. Quando um fluxo de trabalho é executado, a definição atual associada a ele também é.