Word Activities

Versión: 1.0.0  ·  ID: zoan-packages-word  ·  Autor: Zoan Software

El paquete Word lee y crea documentos .docx, sin necesidad de tener Microsoft Word instalado. Sus dos usos principales:

• Leer documentos: extraer su texto, párrafos y tablas para procesarlos.
• Generar documentos: crear cartas, contratos, reportes o actas a partir de datos, combinando párrafos con estilos, tablas e imágenes.

¿Word o PDF?

Word es ideal para generar documentos con formato (párrafos, encabezados, tablas, imágenes) que luego se editan o imprimen. Si solo necesitas un PDF de texto simple, PDF Create es más directo. Para leer PDF, usa el paquete PDF.

Concepto 1: modo rápido vs. modo sesión

Como en Excel, hay dos formas de trabajar:

Modo rápido (path)

Las actividades de lectura y modificación puntual aceptan una ruta directamente: abren el archivo, hacen la operación y lo cierran. Ideal para una operación suelta.

Word Read Text   path = = asset("contrato.docx")   → output: texto

Modo sesión (session)

Para varias operaciones sobre el mismo documento —y obligatorio para construir un documento nuevo— abres una sesión con Word Open (documento existente) o Word Create (documento nuevo), y compartes esa sesión con las demás actividades.

Word Create   path = "C:/salida/reporte.docx"
 └─ body:
      Word Append Paragraph   text = "Reporte mensual"   style = Title
      Word Append Table       table = = datos

Dentro del body, las actividades heredan la sesión automáticamente, y al terminar el documento se guarda y se cierra solo (con Create) o se cierra (con Open).

Construir un documento requiere sesión

Las actividades que agregan contenido —Append Paragraph, Append Table, Insert Image— solo funcionan dentro de una sesión (no tienen modo path), porque van construyendo el documento en memoria. El patrón típico es Word Create con body.

Concepto 2: estilos de párrafo

Al agregar párrafos con Word Append Paragraph, puedes aplicar un estilo que da estructura visual al documento:

Estilo	Para qué
Title	El título principal del documento
Heading1 / Heading2 / Heading3	Encabezados de sección (niveles)
Normal	Texto de cuerpo (por defecto)

Actividades

Sesión (abrir, crear, guardar, cerrar)

Actividad	Tipo	Salida	Qué hace
Word Open	word-open	ZoanWordSession	Abre un .docx existente
Word Create	word-create	ZoanWordSession	Crea un .docx nuevo
Word Save	word-save	—	Guarda la sesión a disco
Word Close	word-close	—	Cierra la sesión

Leer

Actividad	Tipo	Salida	Qué hace
Word Read Text	word-read-text	string	Todo el texto del documento
Word Read Paragraphs	word-read-paragraphs	List	Lista de párrafos
Word Read Tables	word-read-tables	List	Las tablas como DataTables

Construir contenido (requiere sesión)

Actividad	Tipo	Salida	Qué hace
Word Append Paragraph	word-append-paragraph	—	Agrega un párrafo (con estilo)
Word Append Table	word-append-table	—	Agrega una DataTable como tabla
Word Insert Image	word-insert-image	—	Inserta una imagen

Modificar y metadatos

Actividad	Tipo	Salida	Qué hace
Word Find & Replace	word-find-replace	int	Busca y reemplaza texto
Word Get Property	word-get-property	object	Lee un metadato (título, autor…)
Word Set Property	word-set-property	—	Asigna un metadato

Un flujo típico

Generar una carta a partir de una plantilla con marcadores:

Copy File   source = = asset("plantilla_carta.docx")   destination = = "C:/cartas/" + cliente.nit + ".docx"   overwrite = true
Word Find & Replace   path = = "C:/cartas/" + cliente.nit + ".docx"   find = "{NOMBRE}"   replace = = cliente.nombre
Word Find & Replace   path = = "C:/cartas/" + cliente.nit + ".docx"   find = "{FECHA}"   replace = = today().ToString("yyyy-MM-dd")

Siguientes pasos

• Word Create — generar un documento desde cero.
• Word Read Text — leer un documento.
• Word Find & Replace — rellenar plantillas.