Saltar al contenido principal
Filas

Actualizar fila

Actualizar fila

Actualiza una fila de la tabla, localizada por el número de fila o por un filtro de columna/valor.


Opciones

Conexión de Google Sheets

Selecciona la acción de Conexión de Google Sheets 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 de la tabla

Indica el nombre de la tabla (intervalo con nombre), por ejemplo Clientes.

Localizar la fila por

Elige cómo se localizará la fila: Columna y valor (predeterminado) o Número de fila.

Columna donde buscar

Visible cuando la localización es por Columna y valor. Indica el nombre exacto de la columna, tal como aparece en el encabezado de la tabla, por ejemplo Email. Se actualizará la primera fila que coincida con esa columna/valor.

Valor que se buscará

Visible cuando la localización es por Columna y valor. Indica el valor que se buscará en la columna indicada.

Número de la fila

Visible cuando la localización es por Número de fila. Indica el número de la fila que se actualizará, considerando la fila de encabezado de la tabla como fila 1.

Nuevos valores de las columnas

Agrega los pares de encabezado y valor que se actualizarán en la fila localizada. Para cada elemento, indica el Encabezado (nombre de la columna, exactamente como aparece en el encabezado de la tabla) y el nuevo Valor que se escribirá. Usa el botón "Agregar valor" para incluir más columnas. Las columnas del encabezado que no se indiquen mantienen su valor actual.

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.

Nuevos valores de las columnas (código)

Visible solo cuando el origen es Código personalizado. Indica un objeto que relacione el nombre de cada columna con el nuevo valor — ej., como código: { "Nome": nome.value, "Status": "Concluído" }. También puedes referenciar la salida de una acción anterior o una variable que ya contenga un objeto con ese formato. Las columnas no indicadas mantienen el valor actual.

Retornos

Código Javascript

js
actions["id-de-la-accion"].rowNumber // número de la fila actualizada (Número)
actions["id-de-la-accion"].row // la fila tras la actualización, como objeto (Any)

Selección de campos

  • rowNumber — Número de la fila actualizada.
  • row — La fila tras la actualización, como un objeto que relaciona el nombre de cada columna con su valor.

Reglas y Condiciones

  • Los campos Conexión de Google Sheets, ID de la hoja de cálculo y Nombre de la tabla son obligatorios.
  • Cuando la localización es por Columna y valor, los campos Columna donde buscar y Valor que se buscará son obligatorios. Cuando es por Número de fila, el campo Número de la fila es obligatorio.
  • Es necesario indicar al menos una columna a actualizar (en el modo "Encabezado y valor") o el código de valores (en el modo "Código personalizado").
  • La tabla indicada debe existir en la hoja de cálculo; de lo contrario, el robot interrumpe la ejecución con error de tabla no encontrada.
  • Al localizar por Columna y valor: si ninguna fila coincide, el robot interrumpe la ejecución con error de fila no encontrada; si coincide más de una fila, el robot interrumpe la ejecución con error de ambigüedad (es necesario usar una columna con valores únicos, o actualizar por el número de fila).
  • Al localizar por Número de fila: si la fila no existe dentro de los límites de la tabla, el robot interrumpe la ejecución con error de fila no encontrada.
  • Al menos uno de los encabezados indicados en Nuevos valores de las columnas debe coincidir exactamente (diferenciando mayúsculas y minúsculas) con un encabezado existente en la tabla; de lo contrario, el robot interrumpe la ejecución con error de mapeo de columnas.
  • Las columnas de la tabla que no se indiquen en Nuevos valores de las columnas mantienen el valor actual de la fila.