Mettere in pausa e riprendere un flusso di lavoro utilizzando i callback e Fogli Google

Creare una nuova cartella su Google Drive

Crea una nuova cartella su Google Drive. Questa cartella viene utilizzata per archiviare il foglio di lavoro. Configurando un'autorizzazione per la cartella condivisa, il flusso di lavoro è autorizzato a scrivere nel foglio di lavoro.

1. Accedi a drive.google.com.
2. Fai clic su Nuovo > Nuova cartella.
3. Inserisci un nome per la cartella.
4. Fai clic su Crea.
5. Fai clic con il tasto destro del mouse sulla nuova cartella e seleziona Condividi.

6. Aggiungi l'indirizzo email dell'account di servizio predefinito Compute Engine.

   In questo modo, l'account di servizio avrà accesso alla cartella. Quando associ l'account di servizio al tuo flusso di lavoro, questo avrà accesso in modifica a qualsiasi file nella cartella. Scopri di più sulla condivisione di file, cartelle e unità.

7. Seleziona il ruolo Editor.

8. Deseleziona la casella di controllo Invia notifiche.

9. Fai clic su Condividi.

Creare un foglio di lavoro utilizzando Fogli Google

Quando crei un foglio di lavoro tramite Fogli Google, questo viene salvato su Google Drive. Per impostazione predefinita, il foglio di lavoro viene salvato nella cartella principale su Drive. Non è possibile creare un foglio di lavoro direttamente all'interno di una cartella specificata utilizzando l'API di Fogli Google. Tuttavia, esistono alternative, tra cui lo spostamento del foglio di lavoro in una cartella specifica dopo la creazione, come mostrato in questo esempio. Per ulteriori informazioni, consulta Utilizzare le cartelle di Google Drive.

1. Vai alla pagina sheets.google.com.

2. Fai clic su Nuovo .

   Verrà creato e aperto un nuovo foglio di lavoro. Ogni foglio di lavoro ha un valore spreadsheetId univoco contenente lettere, numeri, trattini o trattini bassi. Puoi trovare l'ID del foglio di lavoro in un URL di Fogli Google:

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

3. Prendi nota di questo ID perché ti servirà quando crei il flusso di lavoro.

4. Aggiungi le intestazioni di colonna in modo che corrispondano all'esempio seguente:

   

   Tieni presente che il valore nella colonna G, Approvato?, viene utilizzato per avviare i callback nel flusso di lavoro.

5. Sposta il foglio di lavoro nella cartella di Google Drive che hai creato in precedenza:

   1. Nel foglio di lavoro, seleziona File > Sposta.
   2. Vai alla cartella che hai creato.
   3. Fai clic su Sposta.

Puoi anche utilizzare il connettore dell'API Google Sheets per creare un foglio di lavoro. Tieni presente che, quando utilizzi il connettore, il valore spreadsheetId può essere recuperato dal risultato resp. Ad esempio:

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

Espandere Fogli Google utilizzando Apps Script

Apps Script ti consente di creare, leggere e modificare in modo programmatico i fogli Google. La maggior parte degli script progettati per Fogli manipola gli array per interagire con le celle, le righe e le colonne di un foglio di lavoro. Per un'introduzione all'utilizzo di Apps Script con Fogli Google, consulta la guida rapida alle funzioni personalizzate.

1. Crea un progetto Apps Script da Fogli Google:

   1. Apri il foglio di lavoro di Fogli.
   2. Seleziona Estensioni > Apps Script.
   3. Nell'editor di script, fai clic su Progetto senza titolo.
   4. Assegna un nome al progetto e fai clic su Rinomina.

   Lo script ora è legato al foglio di lavoro, il che gli conferisce capacità speciali per modificare l'interfaccia utente o rispondere all'apertura del foglio di lavoro.

   Un progetto di script rappresenta una raccolta di file e risorse di Apps Script. I file di codice in un progetto di script hanno un'estensione .gs.

2. Puoi utilizzare Apps Script per scrivere funzioni personalizzate che puoi utilizzare in Fogli Google come una funzione integrata. Le funzioni personalizzate vengono create utilizzando JavaScript standard. Crea una funzione:

   1. Apri il progetto Apps Script.
   2. Fai clic su Editor code.
   3. Un file di script viene visualizzato come file di progetto denominato Code.gs. Per modificare il file, selezionatelo.

   4. Sostituisci qualsiasi codice nell'editor di script con il seguente codice che legge i dati nel foglio di lavoro e li passa come input per un'esecuzione del flusso di lavoro:

      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. Fai clic su Salva save.

3. Gli attivatori installabili di Apps Script consentono a un progetto di script di eseguire una funzione specificata quando vengono soddisfatte determinate condizioni, ad esempio quando un foglio di lavoro viene aperto o modificato. Crea un trigger:

   1. Apri il progetto Apps Script.
   2. Fai clic su Attivatori alarm.
   3. Fai clic su Aggiungi trigger.
   4. Nella finestra di dialogo Aggiungi trigger per YOUR_PROJECT_NAME, configura l'attivatore:
      1. Nell'elenco Scegli la funzione da eseguire, seleziona handleEdit.
      2. Nell'elenco Scegli quale implementazione eseguire, seleziona Principale.
      3. Nell'elenco Seleziona l'origine evento, seleziona Da foglio di lavoro.
      4. Nell'elenco Seleziona il tipo di evento, seleziona Al momento della modifica.
      5. Nell'elenco Impostazioni di notifica degli errori, seleziona Avvisami ogni giorno.
   5. Fai clic su Salva.

   6. Se ti viene chiesto di scegliere un Account Google, seleziona l'account appropriato e poi fai clic su Consenti.

      In questo modo, il tuo progetto Apps Script potrà visualizzare, modificare, creare ed eliminare i tuoi fogli di lavoro di Fogli Google e connettersi a un servizio esterno.

4. Un file manifest di un progetto Apps Script è un file JSON che specifica le informazioni di base del progetto di cui Apps Script ha bisogno per eseguire correttamente uno script. Tieni presente che l'editor di Apps Script nasconde i file manifest per impostazione predefinita per proteggere le impostazioni del progetto Apps Script. Modifica il file manifest:

   1. Apri il progetto Apps Script.
   2. Fai clic su Impostazioni progetto settings.
   3. Seleziona la casella di controllo Mostra il file manifest "appsscript.json" nell'editor.
   4. Fai clic su Editor code.
   5. Il file manifest viene visualizzato come file di progetto denominato appsscript.json. Per modificare il file, selezionalo.

   6. Il campo oauthScopes specifica un array di stringhe. Per impostare gli ambiti di autorizzazione utilizzati dal progetto, aggiungi un array con gli ambiti che vuoi supportare. Ad esempio:

      {
        "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"
        ]
      }

      In questo modo vengono impostati gli ambiti espliciti su:

      • Connettersi a un servizio esterno
      • Visualizzare, modificare, configurare ed eliminare i tuoi dati di Google Cloud, nonché vedere l'indirizzo email del tuo Account Google
      • Visualizzare, modificare, creare ed eliminare tutti i tuoi fogli Google

   7. Fai clic su Salva save.

Esegui il deployment di un flusso di lavoro che scrive in un foglio di lavoro e utilizza i callback

Esegui il deployment di un flusso di lavoro che viene eseguito, messo in pausa e poi ripreso quando un callback viene approvato tramite un foglio di lavoro. Il flusso di lavoro scrive in un foglio di lavoro di Fogli utilizzando il connettore dell'API Fogli Google.

Testa il flusso end-to-end

Esegui il flusso di lavoro per testare il flusso end-to-end. L'esecuzione di un flusso di lavoro esegue la definizione attuale del flusso di lavoro associata al flusso di lavoro.