Word Open

Word Open

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

Abre un documento .docx existente y devuelve una sesión (ZoanWordSession) que compartes con las demás actividades de Word. Úsala cuando vas a hacer varias operaciones sobre el mismo documento o a modificarlo agregando contenido.

Cómo funciona

Lee el archivo de path completo a memoria; los cambios se hacen sobre esa copia y solo llegan al disco cuando guardas. El archivo en disco no queda bloqueado mientras la sesión está abierta. Tienes dos modos (ver el modelo de sesión):

• Con body: las actividades dentro heredan la sesión automáticamente; al terminar, el documento se cierra sin guardar. Si lo modificaste, llama a Word Save dentro del body.
• Sin body: guarda la sesión en una variable de salida; pásala como session a las actividades, guarda con Word Save y ciérrala con Word Close.

Solo abre documentos .docx (Open XML). Para .doc, .rtf u .odt, conviértelos antes o usa Word to PDF si lo que necesitas es el PDF. No requiere Microsoft Word instalado.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo .docx existente.

Parámetros opcionales

Ninguno.

Sub-flujos

body opcional

Actividades a ejecutar con este documento. Heredan la sesión sin configurar session; al salir, el documento se cierra sin guardar (también si una actividad interna falla). Si se omite (o queda vacío), la actividad devuelve la sesión como salida.

Salida

• Sin body: un ZoanWordSession con el documento en memoria. Pásalo como session a las demás actividades de Word.
• Con body: esta actividad no devuelve ningún valor.

Ejemplo

Word Open   path = asset("plantilla_carta.docx")
 └─ body:
      Word Find & Replace   find = "{CLIENTE}"   replace = cliente.nombre
      Word Save             path = "C:/cartas/" + cliente.id + ".docx"

¿Solo una lectura?

Si solo vas a leer el documento una vez, no necesitas sesión: usa directamente el parámetro path de Word Read Text (modo rápido).

Errores comunes

Mensaje	Causa y solución
No se encontró el archivo.	La ruta de path no existe en la máquina donde corre el robot. Verifícala con File Exists antes de abrir.
'path' es obligatorio.	Falta path o la expresión dio vacío.
Error al abrir el paquete del documento	El archivo no es un .docx válido (por ejemplo, un .doc antiguo renombrado o un archivo dañado).

Actividades relacionadas

• Word Create — crear un documento nuevo.
• Word Save / Word Close — guardar y cerrar.