Add Data Row

Add Data Row

Tipo: add-row  ·  Paquete: DataTable Activities v1.0.0  ·  Salida: DataRow

Agrega una fila nueva al final de una DataTable y devuelve la fila creada.

Modifica la tabla en sitio

A diferencia de la mayoría de actividades de este paquete (que devuelven una tabla nueva), las operaciones de fila/celda modifican la tabla original. Tras Add Data Row, la tabla que pasaste tiene una fila más. No necesitas capturar la tabla en otra variable.

Cómo funciona

Crea una fila con los valores que indiques y la añade a la tabla. Devuelve la DataRow creada, para que puedas seguir trabajándola con Set Cell o Update Data Row.

Los valores se dan de dos formas (un interruptor en el editor):

• Por columna — un diccionario { columna: valor }. Independiente del orden; valida el nombre de columna.
• Por posición — una lista de valores en el orden de las columnas. Debes proporcionar exactamente un valor por columna.

Parámetros requeridos

Parámetro	Editor	Descripción
table	expresión	La DataTable a la que se añade la fila, ej. = clientes.
values	valores de fila	Los valores de la fila, por columna { columna: valor } o por posición [v1, v2, …].

Parámetros opcionales

Ninguno.

Salida

Devuelve la DataRow recién creada.

Ejemplo

Construir una tabla y añadir filas de dos maneras:

Build DataTable   data: [ { id: 1, nombre: "Ana", edad: 30 } ]   → output: personas

Add Data Row   table = = personas   values (por columna): { id: 2, nombre: "Luis", edad: 25 }   → output: fila
Add Data Row   table = = personas   values (por posición): [ 3, "Carla", 28 ]

Log   message = = "La tabla tiene " + rowCount(personas) + " filas"

Fallo claro por tipo

Si un valor no es compatible con el tipo de la columna (p. ej. texto en una columna numérica), la actividad falla con un mensaje claro indicando la columna y el tipo esperado — no guarda un valor incorrecto en silencio. Una celda vacía o null se guarda como vacía (DBNull).

Actividades relacionadas

• Build DataTable — crear la tabla a la que se añaden filas.
• Set Cell / Update Data Row — modificar la fila devuelta.
• Tipos de datos › DataRow — qué es una fila.