Cómo pausar y reanudar un flujo de trabajo con devoluciones de llamada y Hojas de cálculo de Google

Crea una carpeta nueva en Google Drive

Crea una carpeta nueva en Google Drive. Esta carpeta se usa para almacenar tu hoja de cálculo. Si configuras un permiso para la carpeta compartida, tu flujo de trabajo puede escribir en la hoja de cálculo.

1. Ve a drive.google.com.
2. Haz clic en Nuevo > Nueva carpeta.
3. Ingresa un nombre para la carpeta.
4. Haz clic en Crear.
5. Haz clic con el botón derecho en la carpeta nueva y selecciona Compartir.

6. Agrega la dirección de correo electrónico de la cuenta de servicio predeterminada de Compute Engine.

   Esto le otorga a la cuenta de servicio acceso a la carpeta. Cuando asocies la cuenta de servicio con tu flujo de trabajo, este tendrá acceso de edición a cualquier archivo de la carpeta. Obtén más información para compartir archivos, carpetas y unidades.

7. Selecciona el rol de Editor.

8. Desmarca la casilla de verificación Notificar a las personas.

9. Haz clic en Compartir

Crea una hoja de cálculo con Hojas de cálculo de Google

Cuando creas una hoja de cálculo con Hojas de cálculo de Google, esta se guarda en Google Drive. De forma predeterminada, la hoja de cálculo se guarda en la carpeta raíz de Drive. No hay opción para crear una hoja de cálculo directamente dentro de una carpeta especificada con la API de Hojas de cálculo de Google. Sin embargo, existen alternativas, como mover la hoja de cálculo a una carpeta específica después de crearla, como se hace en este ejemplo. Para obtener más información, consulta Cómo trabajar con carpetas de Google Drive.

1. Ve a sheets.google.com.

2. Haz clic en Nuevo .

   Se creará y abrirá la nueva hoja de cálculo. Cada hoja de cálculo tiene un valor spreadsheetId único que contiene letras, números, guiones o guiones bajos. Puedes encontrar el ID de la hoja de cálculo en una URL de Hojas de cálculo de Google:

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

3. Anota este ID, ya que lo necesitarás cuando crees tu flujo de trabajo.

4. Agrega encabezados de columna que coincidan con el siguiente ejemplo:

   

   Ten en cuenta que el valor de la columna G, ¿Aprobado?, se usa para iniciar devoluciones de llamada en el flujo de trabajo.

5. Mueve la hoja de cálculo a la carpeta de Google Drive que creaste anteriormente:

   1. En la hoja de cálculo, selecciona Archivo > Mover.
   2. Navega a la carpeta que creaste.
   3. Haz clic en Mover.

También puedes usar el conector de la API de Hojas de cálculo de Google para crear una hoja de cálculo. Ten en cuenta que, cuando usas el conector, se puede recuperar spreadsheetId del resultado resp. Por ejemplo:

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

Cómo extender Hojas de cálculo de Google con Apps Script

Apps Script te permite crear, leer y editar Hojas de cálculo de Google de forma programática. La mayoría de las secuencias de comandos diseñadas para Hojas de cálculo manipulan آرایه‌ها para interactuar con las celdas, filas y columnas de una hoja de cálculo. Si quieres obtener una introducción para usar Apps Script con Hojas de cálculo de Google, consulta la Guía de inicio rápido de funciones personalizadas.

1. Crea un proyecto de Apps Script desde Hojas de cálculo de Google:

   1. Abre tu hoja de cálculo de Hojas de cálculo.
   2. Selecciona Extensiones > Apps Script.
   3. En el editor de secuencia de comandos, haz clic en Proyecto sin título.
   4. Asigna un nombre al proyecto y haz clic en Cambiar nombre.

   Tu secuencia de comandos ahora está vinculada a tu hoja de cálculo, lo que le otorga habilidades especiales para alterar la interfaz de usuario o responder cuando se abre la hoja de cálculo.

   Un proyecto de secuencia de comandos representa una colección de archivos y recursos de Apps Script. Los archivos de código de un proyecto de secuencia de comandos tienen una extensión .gs.

2. Puedes usar Apps Script para escribir funciones personalizadas que puedes usar en Hojas de cálculo de Google como una función integrada. Las funciones personalizadas se crean con JavaScript estándar. Crea una función:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Editor code.
   3. Un archivo de secuencia de comandos aparece como un archivo de proyecto llamado Code.gs. Para editar el archivo, selecciónalo.

   4. Reemplaza cualquier código en el editor de secuencia de comandos por el siguiente código, que lee los datos de tu hoja de cálculo y los pasa como entrada a una ejecución de flujo de trabajo:

      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. Haz clic en Guardar save.

3. Los activadores instalables de Apps Script permiten que un proyecto de secuencia de comandos ejecute una función especificada cuando se cumplan ciertas condiciones, como cuando se abre o edita una hoja de cálculo. Crea un activador:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Activadores alarm.
   3. Haz clic en Agregar activador.
   4. En el diálogo Agregar activador para YOUR_PROJECT_NAME, configura el activador:
      1. En la lista Elige qué función ejecutar, selecciona handleEdit.
      2. En la lista Elige qué implementación se debe ejecutar, selecciona Head.
      3. En la lista Seleccionar fuente de eventos, selecciona Desde una hoja de cálculo.
      4. En la lista Seleccionar tipo de evento, selecciona En edición.
      5. En la lista Failure notification settings, selecciona Notify me daily.
   5. Haz clic en Guardar.

   6. Si recibes un mensaje para elegir una Cuenta de Google, selecciona la cuenta adecuada y, luego, haz clic en Permitir.

      Esto permite que tu proyecto de Apps Script vea, edite, creé y borre tus hojas de cálculo de Hojas de cálculo de Google, y se conecte a un servicio externo.

4. El archivo de manifiesto de un proyecto de Apps Script es un archivo JSON que especifica la información básica del proyecto que Apps Script necesita para ejecutar una secuencia de comandos correctamente. Ten en cuenta que el editor de Apps Script oculta los archivos de manifiesto de forma predeterminada para proteger la configuración de tu proyecto de Apps Script. Edita el archivo de manifiesto:

   1. Abre tu proyecto de Apps Script.
   2. Haz clic en Configuración del proyecto settings.
   3. Selecciona la casilla de verificación Mostrar el archivo de manifiesto "appsscript.json" en el editor.
   4. Haz clic en Editor code.
   5. El archivo de manifiesto aparece como un archivo de proyecto llamado appsscript.json. Para editar el archivo, selecciónalo.

   6. El campo oauthScopes especifica un array de cadenas. Para establecer los permisos de autorización que usa tu proyecto, agrega un array con los permisos que deseas admitir. Por ejemplo:

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

      Esto establece permisos explícitos para lo siguiente:

      • Se conecta a un servicio externo.
      • Ver, editar, configurar y borrar tus datos de Google Cloud y ver la dirección de correo electrónico de tu Cuenta de Google
      • Vea, edite, cree y borre todos sus archivos de Hojas de cálculo de Google

   7. Haz clic en Guardar save.

Implementa un flujo de trabajo que escriba en una hoja de cálculo y use devoluciones de llamada

Implementa un flujo de trabajo que se ejecute, se detenga y, luego, se reanude cuando se apruebe una devolución de llamada a través de una hoja de cálculo. El flujo de trabajo escribe en una hoja de cálculo de Hojas de cálculo con el conector de la API de Hojas de cálculo de Google.

Prueba el flujo de extremo a extremo

Ejecuta el flujo de trabajo para probar el flujo de extremo a extremo. Ejecuta la definición actual del flujo de trabajo asociada con el flujo de trabajo.