Word Read Text

Tipo: word-read-text · Paquete: Word Activities v1.0.4 · Salida: string

Lee todo el texto de un documento de Word y lo devuelve como una sola cadena. Es la forma más directa de leer un documento para luego extraer datos con expresiones.

Cómo funciona

Recorre el cuerpo del documento, incluidas las tablas, y une sus fragmentos de texto con saltos de línea (\n). Acepta session (modo sesión) o path (modo rápido) — ver los dos modos; con path abre el archivo, lo lee y lo cierra sin modificarlo.

Saltos de línea: Word guarda el texto en fragmentos según el formato, y cada fragmento ocupa su propia línea. Un párrafo con formato mezclado (una palabra en negrita, por ejemplo) puede quedar repartido en varias líneas. Si necesitas exactamente un elemento por párrafo, usa Word Read Paragraphs.
Alcance: solo el cuerpo; no incluye encabezados ni pies de página.
No requiere Microsoft Word instalado.

Parámetros requeridos

Ninguno — pero debes indicar session o path.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanWordSession`	—	Sesión de Word Open (en vez de `path`). Dentro de un `body` se hereda automáticamente.
`path`	`string`	—	Ruta al `.docx` (modo rápido: abre y cierra solo). Se usa solo si no hay sesión.

Salida

Devuelve un string con todo el texto. Un documento sin texto devuelve una cadena vacía ("").

Ejemplo

Word Read Text   path = asset("contrato.docx")   → output: texto
Set Variable   name = vigencia   value = regexFind(texto, "(?<=Vigencia:\s*)\d+ meses")
Log   message = "Vigencia encontrada: " + vigencia

Errores comunes

Mensaje	Causa y solución
`Indica 'session' o 'path'.`	No hay sesión ni ruta.
`No se encontró el archivo.`	La ruta de `path` no existe en la máquina del robot.
Error al abrir el paquete del documento	El archivo no es un `.docx` válido (por ejemplo, un `.doc` antiguo o un archivo dañado).

Actividades relacionadas

Word Read Paragraphs — el texto separado por párrafos.
Word Read Tables — extraer las tablas.
Word Find & Replace — modificar el texto.