Agregar fila
Agregar fila
Agrega una nueva fila al final de una pestaña, relacionando los valores con los encabezados de las columnas.
Opciones
Conexión de Google Sheets
Selecciona la acción de Conexión configurada en el flujo.
ID de la hoja de cálculo
Indica el ID de la hoja de cálculo. El ID se encuentra en la URL de la hoja de cálculo: docs.google.com/spreadsheets/d/{spreadsheetId}/edit.
Nombre o ID de la pestaña
Indica el nombre de la pestaña (ej.: Página1) o, usando el tipo número, el ID numérico de la pestaña.
Valores de las columnas
Agrega los pares de encabezado y valor que se escribirán en la nueva fila. Para cada elemento, indica el Encabezado (nombre exacto de la columna, tal como aparece en la primera fila de la pestaña) y el Valor que se escribirá. Usa el botón "Agregar valor" para incluir más columnas. Las columnas del encabezado que no se indiquen quedan en blanco en la nueva fila.
Opciones avanzadas
Origen de los valores de las columnas
Elige entre Encabezado y valor (lista de pares construida en el formulario) o Código personalizado (reemplaza la lista por un campo de código). Predeterminado: Encabezado y valor.
Valores de las columnas (código)
Visible solo cuando el origen es Código personalizado. La primera fila de la pestaña se usa como encabezado de las columnas. Indica un objeto que relacione el nombre de cada columna con el valor deseado — ej., como código: { "Nome": nome.value, "Email": email.value }. También puedes referenciar la salida de una acción anterior o una variable que ya contenga un objeto con ese formato.
Retornos
Código Javascript
actions["id-de-la-accion"].rowNumber // número de la fila recién agregada (Número)
actions["id-de-la-accion"].row // la fila agregada, como objeto (Any)
Selección de campos
- rowNumber — número de la fila recién agregada (Número)
- row — la fila agregada, como un objeto que relaciona el nombre de cada columna con su valor (Any)
Reglas y Condiciones
- Los campos Conexión de Google Sheets, ID de la hoja de cálculo y Nombre o ID de la pestaña son obligatorios; es necesario indicar al menos una columna (modo "Encabezado y valor") o el código de valores (modo "Código personalizado").
- La primera fila de la pestaña se usa siempre como encabezado: los valores indicados se relacionan con los nombres de columna de esa fila, en el orden en que aparecen.
- Si la pestaña está vacía (sin ninguna fila de encabezado), el robot interrumpe la ejecución con error (pestaña sin fila de encabezado).
- La nueva fila se agrega siempre al final de la pestaña, justo después de la última fila con contenido.
- Las columnas del encabezado que no se indiquen en Valores de las columnas quedan en blanco en la nueva fila; los valores indicados para nombres de columna que no existen en el encabezado se ignoran.
- Si la pestaña indicada (por nombre o ID) no existe en la hoja de cálculo, el robot interrumpe la ejecución con error.