Una función llamada onEdit es un activador simple. Una vez guardado el proyecto, Sheets la ejecuta cada vez que alguien edita una celda, sin configurar nada. Recibe un objeto de evento, que suele llamarse e:
- e.range es la celda editada. getSheet().getName(), getRow() y getColumn() te dicen dónde está.
- e.value es el valor nuevo y e.oldValue el anterior, los dos como texto. Una casilla marcada llega como "TRUE", no como el booleano true.
- e.source es la hoja de cálculo, para llegar a otras pestañas.
onEdit se ejecuta con cada edición de todo el archivo, así que empieza con cláusulas de guarda: si la edición no está en la pestaña, la columna o la fila correctas, haz return antes de hacer nada. Sin ellas, un cambio en el encabezado o una edición en otra pestaña también activan tu código.
Los activadores simples no pueden hacer cosas que necesitan tu permiso, como enviar correos; para eso hace falta un activador instalable, en la próxima lección. En esta copia de práctica, las ediciones que haces en la cuadrícula ejecutan tu onEdit guardado, y el corrector pasa por él una serie de ediciones.
Primero las cláusulas de guarda y después el trabajo para la única edición que importa.