Add Column

Add Column

Tipo: add-column  ·  Paquete: DataTable Activities v1.0.5  ·  Salida: DataTable

Añade a una DataTable una columna nueva calculada: para cada fila, evalúa una expresión y guarda el resultado en la columna. Úsala para derivar datos a partir de los existentes — un total con IVA, una categoría, una marca de “vencido”, un texto combinado.

Cómo funciona

Copia la tabla (columnas y filas) y le añade la columna column al final. Luego recorre las filas evaluando la expresión value. Las columnas de la fila están disponibles como variables dentro de esa expresión: puedes referenciarlas por su nombre directamente, junto con las variables del flujo. Devuelve la tabla nueva; la original no cambia.

• La columna nueva acepta cualquier tipo de valor (object); cada celda guarda lo que devuelva la expresión. Si la expresión da null, la celda queda vacía (DBNull).
• Dentro de la expresión, una celda vacía llega como null.
• Si value es un valor fijo (por ejemplo "Pendiente"), todas las filas reciben ese mismo valor.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
table	DataTable	—	La DataTable a extender.
column	string	—	Nombre de la columna nueva. No debe existir ya en la tabla.
value	object	—	Expresión evaluada en cada fila. Las columnas de la fila se inyectan como variables con su nombre.

Parámetros opcionales

Ninguno.

Salida

Devuelve una DataTable nueva con todas las columnas y filas de la original más la columna añadida al final.

Errores comunes

Mensaje	Causa y solución
'table' debe ser una DataTable.	table no evalúa a una DataTable.
'column' es obligatorio.	Falta el nombre de la columna nueva.
A column named '…' already belongs to this DataTable.	Ya existe una columna con ese nombre (mensaje de .NET, sin traducir). Elige otro nombre o quita la existente con Drop Column.
Error de la expresión	La expresión de value falló en alguna fila (por ejemplo, una conversión de una celda vacía). Usa num(...) y str(...) para tratar celdas vacías.

Ejemplo

Añadir una columna TotalConIva a partir de la columna Total:

Add Column   table = facturas   column = "TotalConIva"   value = num(Total) * 1.19   → output: conIva
Aggregate Column   table = conIva   column = "TotalConIva"   operation = sum   → output: totalConIva

Aquí Total se refiere a la columna Total de la fila actual. Envuélvela en num(...) o str(...) para tratar de forma segura el valor de la celda.

Add Column   table = clientes   column = "Saludo"   value = "Estimado/a " + str(Nombre)   → output: conSaludo

Acceso seguro a las celdas

Dentro de la expresión, usa num(Columna) para cálculos y str(Columna) para texto: así manejas correctamente las celdas vacías. Los nombres de columna con espacios o símbolos no son identificadores válidos; renómbralas antes con Rename Column. Ver DataRow.

Actividades relacionadas

• Drop Column — eliminar columnas.
• Rename Column — renombrar una columna.
• Aggregate Column — resumir una columna numérica.