Build DataTable

Build DataTable

Tipo: build-datatable  ·  Paquete: DataTable Activities v1.0.5  ·  Salida: DataTable

Crea una DataTable desde cero a partir de sus filas. Úsala cuando necesitas construir una tabla tú mismo —para acumular resultados, preparar datos a escribir en Excel, o armar una estructura a la que irás añadiendo filas— en lugar de leerla de una fuente.

Cómo funciona

En el Designer, data se edita con un editor de tablas: defines las columnas y escribes las filas. Cada fila es un objeto { columna: valor } y cada celda acepta un valor literal o una expresión. También puedes dar una expresión que devuelva una lista de objetos de fila (por ejemplo, una lista de diccionarios).

• Columnas: salen de las claves de las filas, en el orden en que aparecen por primera vez. Si una fila no trae una clave que otras sí tienen, esa celda queda vacía.
• Tipo de cada columna: se deduce del primer valor no nulo de la columna: texto → string, entero → int/long, decimal → double/decimal, booleano → bool, fecha → DateTime. Si todos los valores son nulos o de otro tipo, la columna acepta cualquier valor (object).
• Celdas vacías: un valor null o un texto vacío se guarda como celda sin valor (DBNull).
• Valores incompatibles: si un valor no vacío no se puede convertir al tipo de su columna (por ejemplo, texto en una columna deducida como numérica), la actividad falla indicando fila y columna; nunca guarda un valor incorrecto en silencio.
• Si data ya es una DataTable (porque la expresión la devuelve), se entrega tal cual.
• Los elementos de la lista que no son objetos de fila se ignoran; si data no es una lista, el resultado es una tabla vacía, sin columnas.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
data	List	—	Filas de la tabla. Cada fila es un objeto { columna: valor }; las celdas aceptan literales o expresiones. También acepta una expresión que dé una lista de diccionarios o una DataTable.

Parámetros opcionales

Ninguno.

Salida

Devuelve una DataTable con una columna por cada clave distinta de las filas y una fila por cada objeto de fila, en el mismo orden. Como las columnas salen de las filas, con data vacío el resultado es una tabla sin columnas ni filas.

Errores comunes

Mensaje	Causa y solución
El valor de la fila …, columna '…', no es compatible con el tipo de la columna '…'.	Un valor no encaja con el tipo deducido del primer valor no nulo de esa columna (la fila se cuenta desde 1). Usa el mismo tipo en toda la columna: por ejemplo, todos números o todos textos.

Ejemplo

Crear una tabla de facturas con dos filas y escribirla en Excel:

Build DataTable
  data:
     { Cliente: "Comercial Andina",  Total: 1500000 }
     { Cliente: "Distribuidora Sur", Total: 820000 }
  → output: resumen

Log                 message = "Filas creadas: " + rowCount(resumen)
Write Excel Sheet   path = "C:/out/resumen.xlsx"   data = resumen

Una tabla vacía con columnas, lista para llenar

Las columnas se definen con las filas, así que para empezar con una tabla vacía con estructura crea una fila de muestra y vacíala con Clear DataTable: conserva columnas y tipos. Después, dentro de un For Each, añade filas con Add Data Row. Para volcar una DataTable, Write Excel Sheet y Write CSV la reciben directamente.

Actividades relacionadas

• Add Data Row — añadir filas a la tabla creada.
• Clear DataTable — quitar las filas y conservar la estructura.
• Add Column — añadir una columna calculada a una tabla existente.
• Read Excel Sheet — obtener una DataTable desde un archivo.