Word Create

Word Create

Tipo: word-create  ·  Paquete: Word Activities v1.0.4  ·  Salida: ZoanWordSession

Crea un documento .docx nuevo y vacío y devuelve una sesión para irlo llenando con párrafos, tablas e imágenes. Es el punto de partida para generar documentos desde el robot: cartas, reportes, actas, contratos.

Cómo funciona

Crea el documento en memoria; path es la ruta donde se guardará. El archivo no se escribe en disco hasta que se guarda. Dos modos:

• Con body (recomendado): agregas el contenido dentro del sub-flujo y, cuando el body termina sin errores, el documento se guarda en path y se cierra. Si una actividad interna falla, el documento se cierra sin guardar.
• Sin body: devuelve la sesión como salida; agregas contenido pasándole session, y al final guardas con Word Save y cierras con Word Close.

Al guardar, las carpetas que falten se crean y un archivo existente con el mismo nombre se sobrescribe. El documento nuevo no trae estilos definidos; si necesitas títulos con formato propio, parte de una plantilla con Word Open (ver estilos de párrafo).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta donde se guardará el nuevo .docx.

Parámetros opcionales

Ninguno.

Sub-flujos

body opcional

Actividades para construir el documento. Heredan la sesión; al terminar sin errores, el documento se guarda y cierra solo. Si se omite (o queda vacío), la actividad devuelve la sesión como salida.

Salida

• Sin body: un ZoanWordSession con el documento vacío en memoria. Pásalo como session a las actividades de construcción.
• Con body: esta actividad no devuelve ningún valor; el resultado es el archivo guardado en path.

Ejemplo

Generar un reporte con título, texto y una tabla, y convertirlo a PDF:

Word Create   path = "C:/reportes/ventas_" + today().ToString("yyyyMM") + ".docx"
 └─ body:
      Word Append Paragraph   text = "Reporte de Ventas"   style = Title
      Word Append Paragraph   text = "Generado el " + today().ToString("yyyy-MM-dd")
      Word Append Paragraph   text = "Detalle"   style = Heading1
      Word Append Table       table = ventas
Word to PDF   path = "C:/reportes/ventas_" + today().ToString("yyyyMM") + ".docx"   → output: rutaPdf

Construir requiere sesión

Las actividades Append Paragraph, Append Table e Insert Image solo funcionan dentro de una sesión. Por eso el patrón típico para generar documentos es Word Create con body.

Errores comunes

Mensaje	Causa y solución
'path' es obligatorio.	Falta path o la expresión dio vacío.
Error de acceso al guardar	La ruta no es válida, no hay permisos de escritura o el archivo está abierto en otro programa. Se produce al guardar (al final del body o en Word Save), no al crear.

Actividades relacionadas

• Word Append Paragraph / Word Append Table / Word Insert Image — agregar contenido.
• Word Open — abrir un documento existente.