Saltar al contenido principal
Filas

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

js
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.