Word Activities

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

El paquete Word lee y crea documentos .docx directamente sobre el archivo, sin necesidad de tener Microsoft Word instalado (solo Word to PDF necesita LibreOffice o Microsoft Word). 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, si el body terminó sin errores) o se cierra sin guardar (con Open: pon un Word Save dentro del body si lo modificaste).

La sesión trabaja sobre una copia del documento en memoria: los cambios llegan al disco solo al guardar, y el archivo no queda bloqueado mientras tanto. En modo rápido, las actividades que modifican (Find & Replace, Set Property) guardan en la misma ruta al terminar; las de lectura no tocan el archivo.

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)

El estilo se asigna por su identificador, así que su aspecto depende de que el documento lo defina. Los documentos hechos en Word traen estos estilos; un documento nuevo de Word Create no trae definiciones de estilo. Si quieres títulos con un formato concreto, prepara una plantilla en Word y ábrela con Word Open.

Actividades

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

Actividad	Tipo	Salida	Qué hace
Word Open	word-open	ZoanWordSession	Abre un .docx existente (al cerrar no guarda)
Word Create	word-create	ZoanWordSession	Crea un .docx nuevo (con body, lo guarda al terminar)
Word Save (Session)	word-save	—	Guarda la sesión a disco, en su ruta o en otra
Word Close (Session)	word-close	—	Cierra la sesión sin guardar

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<object>	Lista de párrafos (textos)
Word Read Tables	word-read-tables	List<DataTable>	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; devuelve cuántos fragmentos cambió
Word Get Property	word-get-property	object	Lee un metadato (título, autor…)
Word Set Property	word-set-property	—	Asigna un metadato

Convertir

Actividad	Tipo	Salida	Qué hace
Word to PDF	word-to-pdf	string	Convierte un documento a PDF (requiere LibreOffice o Microsoft Word)

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.id + ".docx"   overwrite = true
Word Find & Replace   path = "C:/cartas/" + cliente.id + ".docx"   find = "{NOMBRE}"   replace = cliente.nombre
Word Find & Replace   path = "C:/cartas/" + cliente.id + ".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.