Crear Menú Personalizado

Una de las cosas que podemos hacer con los scripts es crear menúes personalizados en nuestra planilla de cálculo como se ve a continuación.

El menú se puede crear en cualquier momento, corriendo la función que realiza tal acción, pero lo mas usual es que esta función se corra cuando se abre la planilla. Para esto debemos configurar un activador.

Esta tarea podría sonar tediosa, pero por suerte hay activadores automáticos que, con sólo poner el nombre adecuado a la función, se ejecutan en una acción determinada. Para este caso, necesitamos que al abrirse la planilla se ejecute una función. Si a nuestra función la llamamos onOpen, ésta se va a ejecutar en el momento en que se abre la planilla.

Ahora que ya sabemos como correr la función, sólo nos queda por ver como agregar el menú.

Para ello, debemos tomar la planilla activa y agregarle un menú de la siguiente manera:

function onOpen() {

var ss = SpreadsheetApp.getActiveSpreadsheet();

var menuEntries = [ {name: "Opción 1", functionName: "getMap"},{name: "Opción 2", functionName: "getMap"},{name: "Última", functionName: "getMap"}];

ss.addMenu("Menu Personal", menuEntries);

}

El menú se puede agregar directamente, pero en este caso agregamos 3 submenús. La estructura del submenú está definida en un array JSON con objetos de dos propiedades: el nombre que se va a mostrar en el menú y la función que se va a ejecutar.

En el caso de la función asociada a un menú no se encuentre se dará el siguiente mensaje de error al hacer click sobre el menú.

Con estos simples pasos podemos agregar todos los menues que sean necesarios.