Word to PDF

Word to PDF

Tipo: word-to-pdf  ·  Paquete: Word Activities v1.0.4  ·  Salida: string

Convierte un documento de Word a PDF: la carta, el contrato o el acta que acabas de generar, listo para enviar o archivar sin que nadie pueda editarlo. Acepta .docx, .doc, .rtf y .odt, y devuelve la ruta del PDF generado.

Requiere un programa de conversión

A diferencia del resto del paquete, esta actividad sí necesita un programa instalado en la máquina donde corre el robot: LibreOffice (recomendado, gratuito) o Microsoft Word. Sin ninguno de los dos, la actividad falla.

Cómo funciona

1. Toma el documento de path y decide dónde guardar el PDF: en outputPath o, si lo omites, en la misma carpeta y con el mismo nombre que el documento, con extensión .pdf. Las rutas relativas se resuelven contra la carpeta de trabajo del robot.
2. Convierte con el motor indicado en engine. Con auto (por defecto) intenta primero LibreOffice y, si no está o falla, Microsoft Word.
3. Devuelve la ruta completa del PDF.

Si ya existe un PDF en la ruta de destino, se sobrescribe. Las carpetas que falten se crean solas. El documento original no se modifica.

• LibreOffice corre en segundo plano, sin ventanas, con un perfil temporal propio: funciona aunque LibreOffice esté abierto en la máquina. Disponible en Windows y Linux.
• Microsoft Word se abre oculto, exporta el PDF y se cierra sin guardar cambios en el documento. Solo en Windows.
• La actividad espera a que la conversión termine; no tiene un tiempo de espera propio (respeta la cancelación de la ejecución).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del documento a convertir (.docx, .doc, .rtf, .odt).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
outputPath	string	—	Ruta del .pdf de destino. Si se omite: la misma carpeta y nombre del documento con extensión .pdf.
engine	string	"auto"	Motor de conversión: auto · libreoffice · word. auto prueba LibreOffice y luego Microsoft Word; cualquier otro valor se trata como auto.

Salida

Devuelve un string con la ruta completa del PDF generado.

Ejemplo

Rellenar una carta desde una plantilla y convertirla a PDF:

Copy File             source = asset("plantilla_carta.docx")   destination = "C:/cartas/900123456.docx"   overwrite = true
Word Find & Replace   path = "C:/cartas/900123456.docx"   find = "{NOMBRE}"   replace = cliente.nombre
Word to PDF           path = "C:/cartas/900123456.docx"   → output: rutaPdf
Log                   message = "PDF listo en " + rutaPdf

Generar un documento nuevo y guardar el PDF en otra carpeta:

Word Create   path = "C:/actas/acta-comite.docx"
 └─ body:
      Word Append Paragraph   text = "Acta del comité"   style = Title
      Word Append Table       table = asistentes
Word to PDF   path = "C:/actas/acta-comite.docx"   outputPath = "C:/actas/pdf/acta-comite.pdf"   → output: rutaPdf

Convierte el archivo guardado en disco

La actividad trabaja sobre el archivo, no sobre una sesión abierta. Conviértelo después de que el documento se haya guardado: al terminar el body de Word Create, o tras Word Save si trabajas sin body.

¿Dónde busca LibreOffice?

En la variable de entorno ZOAN_SOFFICE_PATH (si la defines con la ruta de soffice), en las carpetas de instalación habituales (C:\Program Files\LibreOffice\program\, /usr/bin/soffice) y en el PATH del sistema. Una instalación normal de LibreOffice se encuentra sola.

Errores comunes

Cuando ningún motor logra convertir, el mensaje es No se pudo convertir el documento a PDF. seguido del motivo de cada motor intentado, separados por |:

Mensaje	Causa y solución
No se encontró el archivo.	La ruta de path no existe en la máquina donde corre el robot.
'path' es obligatorio.	Falta path o la expresión dio vacío.
LibreOffice: no se encontró 'soffice' (instala LibreOffice o define ZOAN_SOFFICE_PATH).	LibreOffice no está instalado o no está donde se busca. Instálalo o define ZOAN_SOFFICE_PATH.
LibreOffice: LibreOffice could not convert the document (exit …)	LibreOffice no pudo abrir o convertir el archivo (dañado, protegido con contraseña). Ábrelo a mano para revisarlo.
Word: Microsoft Word no está instalado.	Se intentó convertir con Word y no está instalado.
Word: la automatización COM requiere Windows.	El motor word solo funciona en Windows. En otros sistemas, usa LibreOffice.

Actividades relacionadas

• Word Create / Word Save — generar y guardar el documento antes de convertir.
• Excel to PDF — lo mismo para libros de Excel.
• PDF — trabajar con el PDF generado.