Word Append Table

Word Append Table

Tipo: word-append-table  ·  Paquete: Word Activities v1.0.4

Agrega una DataTable como una tabla en el documento, con bordes simples y, opcionalmente, una fila de encabezados en negrita. Es la forma de incluir datos tabulares en un reporte generado: un detalle de ventas, un cuadro de resultados.

Cómo funciona

Inserta la table como una tabla de Word al final del documento. Por defecto escribe los nombres de columna como primera fila en negrita (hasHeader = true). Solo funciona dentro de una sesión; el cambio queda en memoria hasta que se guarda.

• Cada celda se escribe como texto (el valor convertido a texto; los nulos quedan vacíos). Si necesitas un formato concreto (fechas, moneda), prepara la columna antes con DataTable.
• Todas las celdas llevan borde sencillo; el ancho de las columnas lo ajusta Word al abrir el documento.
• Una DataTable sin filas agrega solo la fila de encabezados (si hasHeader = true).
• hasHeader se marca en el editor; no admite expresiones.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
table	DataTable	—	La DataTable a insertar.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanWordSession	—	Sesión de Word. Dentro de un body se hereda automáticamente.
hasHeader	bool	true	Escribir los nombres de columna como fila de encabezado en negrita.

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

DB Query      sql = "SELECT Producto, Cantidad, Total FROM Ventas WHERE Mes = @mes"   params = { "mes": mes }   → output: ventas
Word Create   path = "C:/reportes/ventas.docx"
 └─ body:
      Word Append Paragraph   text = "Detalle de Ventas"   style = Heading1
      Word Append Table       table = ventas

¿De dónde sale la tabla?

La DataTable puede venir de Excel, una consulta a base de datos, un CSV, o construirse con DataTable. Procésala (filtra, ordena) antes de insertarla.

Errores comunes

Mensaje	Causa y solución
'table' debe ser un DataTable.	El valor de table no es una DataTable (por ejemplo, una lista o un texto). Convierte los datos a DataTable antes.
'session' debe ser una sesión de Word válida (usa word-open o word-create).	La actividad está fuera de un body de Word Create/Open y no recibió session.

Actividades relacionadas

• Word Read Tables — la operación inversa: leer tablas.
• Word Append Paragraph — agregar texto.