Word Insert Image

Tipo: word-insert-image · Paquete: Word Activities v1.0.4

Inserta una imagen en el documento como un párrafo propio. Útil para incluir un logo, una firma, un gráfico o una captura en un documento generado.

Cómo funciona

Incrusta la imagen de imagePath en el documento y la añade al final, en un párrafo nuevo, con el tamaño indicado en centímetros. Solo funciona dentro de una sesión; el cambio queda en memoria hasta que se guarda.

Tamaño: widthCm por defecto es 14; si no indicas heightCm, el alto es igual al ancho (la imagen queda cuadrada). Para conservar la proporción de la imagen, indica los dos valores.
Formato: se reconoce por la extensión del archivo: .png, .gif, .bmp; cualquier otra extensión se trata como JPEG.
La imagen queda incrustada en el .docx: el documento no depende del archivo original.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`imagePath`	`string`	—	Ruta del archivo de imagen (JPEG, PNG, GIF o BMP).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanWordSession`	—	Sesión de Word. Dentro de un `body` se hereda automáticamente.
`widthCm`	`number`	`14`	Ancho de la imagen en centímetros. Admite decimales con punto (`4.5`).
`heightCm`	`number`	igual a `widthCm`	Alto de la imagen en centímetros.

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

Insertar un logo al inicio de un reporte:

Word Create   path = "C:/reportes/informe.docx"
 └─ body:
      Word Insert Image      imagePath = asset("logo.png")   widthCm = 5   heightCm = 2
      Word Append Paragraph  text = "Informe Mensual"   style = Title

Errores comunes

Mensaje	Causa y solución
`No se encontró el archivo de imagen.`	La ruta de `imagePath` no existe en la máquina del robot.
`'imagePath' es obligatorio.`	Falta la ruta de la imagen.
`'session' debe ser una sesión de Word válida (usa word-open o word-create).`	La actividad está fuera de un `body` de Word Create/Open y no recibió `session`.

Actividades relacionadas

Word Append Paragraph / Word Append Table — otros tipos de contenido.
Page Screenshot / Win Screenshot — generar una imagen para insertar.