04. Ajustando el código para el complemento

Seguimos en nuestro curso para crear complementos en Google Sheets.

En esta lección 04, vamos a ajustar el código del script para que funcione como un complemento, usando el método adecuado para crear el menú y agregando las funciones necesarias para que el complemento se instale y cargue correctamente.

Veremos cómo usar createAddonMenu en lugar de createMenu, por qué es importante el nombre del proyecto, cómo agregar las funciones onInstall(e) y onOpen(e), y la forma correcta de pasar los nombres de las funciones en los items del menú.

Como vimos en el video, para que nuestro script funcione como complemento debemos reemplazar createMenu por createAddonMenu. Esto es fundamental porque el menú de un complemento no es el menú inicial sino uno específico para addons. Además, el nombre que aparece en el menú de Extensiones proviene del nombre del proyecto, así que es importante definirlo bien.

También agregamos las funciones reservadas onInstall(e) y onOpen(e). onInstall se ejecuta solo al instalar el addon y normalmente llama a onOpen para crear el menú inmediatamente. onOpen se ejecuta cada vez que se abre la hoja y construye el menú con los ítems que definamos usando addItem.

Un detalle importante es que al usar addItem, el nombre de la función que se ejecuta debe pasarse como cadena, sin paréntesis. Por ejemplo: addItem("Descombinar celdas activas", "descombinarCeldasActivas"). Esto es porque la interfaz invoca la función por ese nombre.

También es recomendable incluir un ítem «Info» que llame a una función como mostrarInfo(), la cual despliega un mensaje con ui.alert para explicar el complemento al usuario.

Para probar el complemento, basta guardar y actualizar el script. El nombre del addon aparecerá bajo el menú Extensiones y los ítems funcionarán en ese documento. Pero para usarlo en otros archivos, será necesario instalar el complemento. En la próxima lección veremos cómo configurar el proyecto en Google Cloud Console, activar APIs y gestionar autorizaciones.

Te invito a repasar este ajuste del código para que tu complemento funcione correctamente y puedas avanzar con la parte de publicación y distribución.

Si eres miembro, no olvides terminar esta lección y seguir con las siguientes para completar el curso. Si tienes dudas o quieres proponer nuevos temas, contáctame.