Add Data Row

Add Data Row

Tipo: add-row  ·  Paquete: DataTable Activities v1.0.5  ·  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; cada nombre debe ser una columna existente. Las columnas que no menciones quedan vacías.
• Por posición — una lista de valores en el orden de las columnas. Debes proporcionar exactamente un valor por columna.

Cada valor se convierte al tipo de su columna (por ejemplo, "25" a int). Un null o un texto vacío se guarda como celda vacía (DBNull). Todos los valores se validan antes de añadir la fila: si uno falla, la tabla queda como estaba.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
table	DataTable	—	La DataTable a la que se añade la fila, ej. clientes.
values	Dictionary | List	—	Los valores de la fila, por columna { columna: valor } o por posición [v1, v2, …]. Cada valor acepta un literal o una expresión.

Parámetros opcionales

Ninguno.

Salida

Devuelve la DataRow recién creada, ya incluida en la tabla.

Errores comunes

Mensaje	Causa y solución
'table' debe ser una DataTable.	table no evalúa a una DataTable.
La columna '…' no existe. Columnas disponibles: ….	Un nombre del diccionario no es una columna de la tabla. El mensaje lista las columnas reales.
Se dieron … valor(es) pero la tabla tiene … columna(s). Al pasar una lista, da exactamente un valor por columna, en el orden de las columnas.	En modo por posición, la lista no tiene un valor por columna. Completa con null las que quieras dejar vacías.
Un valor no es compatible con el tipo '…' de la columna '…'.	Un valor no se puede convertir al tipo de la columna (texto en una columna numérica, por ejemplo). Convierte el valor antes o revisa el tipo de la columna.
'values' debe ser un objeto { column: value } o una lista de valores.	values no es ni diccionario ni lista (por ejemplo, un texto suelto).

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; la nueva es de " + str(fila["nombre"])

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.

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.