4

Google Apps Script soporta disparadores (Triggers), también llamados activadores, que pasan eventos (Events) a las funciones disparadoras/activadoreas para disparar/activar funciones. Lamentablemente el ambiente de desarrollo no permite probar las funciones sin pasar parámetros así que no es posible simular un evento de esa forma. Cuando se intenta, resulta un error como:

ReferenceError: 'e' is not defined.

Uno puede tratar el evento como un parámetro opcional e insertar un valor predeterminado en la función disparadora usando las técnicas de "Is there a better way to do optional function parameters in Javascript?". Pero esto introduce el riesgo de que un programador perezoso (¿Quién dijo yo?) dejara ese código con efectos colaterales no intencionados.

Con toda seguridad hay mejores maneras.

Referencias
Basado en How can I test a trigger function in GAS? por Mogsdad edición de 2014-11-14 19:40:55Z

2

1 respuesta 1

4

Escribe una función de prueba que pase un evento simulado a la función disparadora. Aquí se incluye un ejemplo que prueba un función disparadora onEdit(). Esta pasa un objeto de evento con toda la información descrita para "Spreadsheet Edit Events" en Understanding Events.

Para usarla, estable una interrupción en tu función objetivo onEdit, selecciona la función test_onEdit y haz clic sobre Debug.

/*
 * Función de prueba para onEdit. Pasa un objento de evento para simular una
 * edición  a una celda en una hoja de cálculo 
 *
 * Para actualizaciones revisar https://stackoverflow.com/a/16089067/1677912
 *
 * Véase 
 * https://developers.google.com/apps-script/guides/triggers/events#google_sheets_events
 */

function test_onEdit() {
  onEdit({
    user : Session.getActiveUser().getEmail(),
    source : SpreadsheetApp.getActiveSpreadsheet(),
    range : SpreadsheetApp.getActiveSpreadsheet().getActiveCell(),
    value : SpreadsheetApp.getActiveSpreadsheet().getActiveCell().getValue(),
    authMode : "LIMITED"
  });
}

Si tienes curiosidad, esto fue escrito para probar la función onEdit para Google Spreadsheet conditional on three cells.

A continuación está una función para eventos de envío de formularios en la hoja de cálculo. Este construye un evento simulado leyendo datos del envío de formulario. Esto fue escrito originalmente para Getting TypeError in onFormSubmit trigger?.

/**
 * Función de prueba para funciones disparadoras en hojas de cálculo de
 * envío de formularios.
 * Recorre el contenido de la hoja, creando eventos de envío de formulario
 * simulados 
 *
 * Para actualizaciones revisar: https://stackoverflow.com/a/16089067/1677912
 *
 * Véase 
 * https://developers.google.com/apps-script/guides/triggers/events#google_sheets_events
 */

function test_onFormSubmit() {
  var dataRange = SpreadsheetApp.getActiveSheet().getDataRange();
  var data = dataRange.getValues();
  var headers = data[0];
  // Inicia en la fila 1, saltando los encabezados en la fila 0
  for (var row=1; row < data.length; row++) {
    var e = {};
    e.values = data[row].filter(Boolean);  // filtro: https://stackoverflow.com/a/19888749
    e.range = dataRange.offset(row,0,1,data[0].length);
    e.namedValues = {};
    // Recorre los encabezados para crear un objeto namedValues
    // NOTA: todos los namedValues son arreglos.
    for (var col=0; col<headers.length; col++) {
      e.namedValues[headers[col]] = [data[row][col]];
    }
    // Pasar el evento simulado a onFormSubmit
    onFormSubmit(e);
  }
}

Consejos

Cuando se simulen eventos, tener cuidado de empatar los objetos de evento documentos los mas preciso que sea posible.

  • Si se quiere validar la documentación, se pueden registrar los eventos recibidos de la función disparadora.

    Logger.log( JSON.stringify( e , null, 2 ) );
    
    • En eventos de envío de formularios en una hoja de cálculo:
    • todos los valores namedValues son arreglos.
    • Las marcas de tiempo son cadenas, y su formato será localizado a la localización del formulario. Si se lee desde la hoja de cálculo con el formato predeterminado*, ellos serán objetos de fecha. Si la función disparadora depende en el formato de cadena de la marca de tiempo (lo cual es una mala idea), tener cuidado de asegurarse que se simula el valor apropiadamente.
    • Si en la hoja de cálculo hay columnas que no están en el formulario, la técnica en este código simulará un "evento" con esas valores adicionales incluídos, lo cual no es lo que se recibirá de un envío de formulario.
    • Como fue reportado enIssue 4335, el arreglo de valores saltará las respuestas en blanco (en "nuevos formularios" + "nueva hoja de cálculo"). El método filter(Boolean) es usado para simular este comportamiento.

*Una celda con formato "texto plano" preservará la fecha como una cadena, y no es una buena idea.

Referencias
Respuesta de Mogsdad edición de 2014-12-03 17:16:57Z.

Tu Respuesta

By clicking “Publica tu respuesta”, you agree to our terms of service and acknowledge you have read our privacy policy.

¿No es la respuesta que buscas? Examina otras preguntas con la etiqueta o formula tu propia pregunta.