Saltar al contenido principal
Docs
Ir al Studio
Roberty Studio
RPAFilas

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, 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. La combinación de columna y valor debe identificar una sola fila.

Valor a buscar​

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

Número de fila en la hoja​

Visible cuando la localización es por Número de fila. Indica el número de la fila en la hoja, el mismo que aparece en el lateral de Google Sheets (no su posición dentro de la tabla). La fila de encabezado no es una fila de datos: en una tabla con el encabezado en la fila 1, la primera fila de datos es la 2; con el encabezado en la fila 5, es la 6.

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