Saltar al contenido principal
Ir al Studio
Filas

Actualizar fila

Actualizar fila

Encuentra la primera fila en la que una columna coincide con un valor indicado y la actualiza.


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.

Localizar la fila por​

Elige cómo se localizará la fila que se actualizará: por Columna y valor o por Número de fila. Predeterminado: Columna y valor.

Cuando es "Columna y valor"​

Columna donde buscar​

El nombre exacto de la columna, tal como aparece en la primera fila (encabezado) de la pestaña. Se actualizará la primera fila que coincida con esa columna/valor.

Valor que se buscará​

Indica el valor que debe compararse con el contenido de la columna, para cada fila de la pestaña.

Cuando es "Número de fila"​

Número de la fila (1 = fila del encabezado)​

Indica el número de la fila que se actualizará, considerando la fila 1 como el encabezado de la pestaña (por lo tanto, el menor número de fila de datos válido es 2).

Nuevos valores de las columnas​

Agrega los pares de encabezado y valor que se escribirán en la fila localizada. Para cada elemento, indica el Encabezado (nombre exacto de la columna, tal como aparece en el encabezado de la pestaña) y el nuevo Valor. 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 (Número)
  • row — la fila tras la actualización, 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 en Nuevos valores de las columnas (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, tanto para localizar la fila como para relacionar los Nuevos valores de las columnas.
  • Al localizar por Columna y valor: ambos campos son obligatorios; si ninguna fila coincide, el robot interrumpe la ejecución con error; si coincide más de una fila, la ejecución también se interrumpe con error. En ese caso, utiliza una columna con valores únicos o localiza la fila por su número.
  • Al localizar por Número de fila: el valor mínimo aceptado es 2 (la fila 1 es el encabezado y no puede actualizarse por este medio); si la fila indicada no existe en la pestaña, el robot interrumpe la ejecución con error.
  • Al menos uno de los nombres indicados en Nuevos valores de las columnas debe coincidir exactamente (incluidas mayúsculas y minúsculas) con una columna existente en el encabezado de la pestaña; de lo contrario, el robot interrumpe la ejecución con error listando las columnas disponibles en la pestaña.
  • Las columnas del encabezado no incluidas en Nuevos valores de las columnas mantienen su valor actual: no se borran.
  • Si la pestaña no tiene ninguna fila de encabezado, o 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.