Hojas de cálculo de Google te permite registrar macros que duplican una serie específica de interacciones de IU que tú defines. Una vez que hayas grabado una macro, puedes vincularla a una combinación de teclas en el formato Ctrl+Alt+Shift+Number. Puedes usar esa combinación de teclas para volver a ejecutar con rapidez los pasos exactos de la macro, por lo general, en un lugar diferente o con datos diferentes.
También puedes activar la macro desde el menú Extensiones
> Macros de Hojas de cálculo de Google.
Cuando grabas una macro, Hojas de cálculo de Google crea automáticamente una función de Apps Script (la función de macro) que replica los pasos de la macro. La función macro se agrega a un proyecto de Apps Script vinculado a la hoja, en un archivo titulado macros.gs. En caso de que ya haya un archivo de proyecto vinculado a la hoja con ese nombre, se le agregará la función de macro. Hojas de cálculo de Google también actualiza automáticamente el manifiesto del proyecto de secuencia de comandos, ya que registra el nombre y la combinación de teclas asignado a la macro.
Como cada macro grabada se define por completo dentro de Apps Script, puedes editarlas directamente en el editor de Apps Script. Incluso puedes escribir macros desde cero en Apps Script o tomar funciones que ya escribiste y convertirlas en macros.
Cómo crear macros en Apps Script
Puedes tomar funciones escritas en Apps Script y usarlas como funciones macro. La forma más fácil de hacerlo es importar una función existente desde el editor de Hojas de cálculo de Google.
Como alternativa, puedes crear macros dentro del editor de Apps Script si sigues estos pasos:
- En la IU de Hojas de cálculo de Google, selecciona Extensiones > Apps Script para abrir la secuencia de comandos vinculada a la hoja en el editor de Apps Script.
- Escribe la función de macro. Las macrofunciones no deben tomar argumentos ni mostrar valores.
- Edita el manifiesto de la secuencia de comandos para crear la macro y vincularla a la función de macro. Asígnale un nombre y un atajo de teclado único.
- Guarda el proyecto de secuencia de comandos. La macro queda disponible para su uso en la hoja.
- Prueba la función macro en la hoja de cálculo para verificar que funcione según lo previsto.
Edición de macros
Para editar macros adjuntas a una hoja, sigue estos pasos:
- En la IU de Hojas de cálculo de Google, selecciona Extensiones > Macros > Administrar macros.
- Busca la macro que quieres editar y selecciona > Editar macro. Esta acción abrirá el editor de Apps Script en el archivo de proyecto que contiene la función de macro.
- Edita la función de macro para cambiar su comportamiento.
- Guarda el proyecto de secuencia de comandos. La macro queda disponible para su uso en la hoja.
- Prueba la función macro en la hoja de cálculo para verificar que funcione según lo previsto.
Importa funciones como macros
Si ya hay una secuencia de comandos vinculada a una hoja, puedes import una función en la secuencia de comandos como una macro nueva y, luego, asignarle una combinación de teclas. Para ello,
edita el archivo de manifiesto
y agrega otro elemento a la propiedad
sheets.macros[].
Como alternativa, sigue estos pasos para importar una función como una macro desde la IU de Hojas de cálculo:
- En la IU de Hojas de cálculo de Google, selecciona Extensiones > Macros > Importar.
- Selecciona una función de la lista que se presenta y haz clic en Agregar función.
- Selecciona para cerrar el cuadro de diálogo.
- Selecciona Extensiones > Macros > Administrar macros.
- Ubica en la lista la función que acabas de importar. Asignar una combinación de teclas única a la macro. Aquí también puedes cambiar el nombre de la macro; el nombre predeterminado es el nombre de la función.
- Haz clic en Update para guardar la configuración de la macro.
Estructura del manifiesto para macros
En el siguiente fragmento de ejemplo de archivo de manifiesto, se muestra la sección de un manifiesto que define macros de Hojas de cálculo de Google.
En la sección sheets del manifiesto, se define el nombre y la combinación de teclas asignados a la macro, así como el nombre de su función.
{
...
"sheets": {
"macros": [{
"menuName": "QuickRowSum",
"functionName": "calculateRowSum",
"defaultShortcut": "Ctrl+Alt+Shift+1"
}, {
"menuName": "Headerfy",
"functionName": "updateToHeaderStyle",
"defaultShortcut": "Ctrl+Alt+Shift+2"
}]
}
}
Consulta el recurso de manifiesto de la macro de Hojas de cálculo para obtener más detalles sobre cómo se construyen los manifiestos de macros de Hojas de cálculo.
Prácticas recomendadas
Cuando creas o administras macros en Apps Script, se recomienda que sigas los siguientes lineamientos.
- Las macros tienen un mejor rendimiento cuando son livianas. Cuando sea posible, limita la cantidad de acciones que realiza una macro.
- Las macros son más adecuadas para operaciones de memorización que deben repetirse con frecuencia con poca o ninguna configuración. Para otras operaciones, considera usar un elemento de menú personalizado en su lugar.
- Recuerda siempre que las combinaciones de teclas de macros deben ser únicas y que una hoja determinada solo puede tener diez macros con combinaciones de teclas a la vez. Las macros adicionales solo se pueden ejecutar desde el menú Extensiones > Macros.
- Las macros que realizan cambios en una sola celda se pueden aplicar a un rango de celdas. Para ello, primero se debe seleccionar el rango completo y, luego, activar la macro. Esto significa que a menudo no es necesario crear macros que dupliquen la misma operación en un rango predefinido de celdas.
Cosas que no puedes hacer
Existen algunas restricciones sobre lo que puedes hacer con las macros:
Cómo usar macros fuera de las secuencias de comandos vinculadas
Las macros se definen en secuencias de comandos vinculadas a Hojas de cálculo de Google específicas. Las definiciones de macros se ignoran si se definen en una secuencia de comandos independiente o una app web.
Define macros en complementos de Hojas de cálculo
No puedes distribuir definiciones de macro con un complemento de Hojas de cálculo. Los usuarios de ese complemento ignoran cualquier definición de macro en un proyecto de complemento de Hojas de cálculo.
Distribuye macros en bibliotecas de secuencias de comandos
No puedes distribuir definiciones de macros con las bibliotecas de Apps Script.
Usa macros fuera de Hojas de cálculo de Google
Las macros son solo una función de las Hojas de cálculo de Google y no existen para Documentos, Formularios ni Presentaciones de Google.