Word Set Property

Word Set Property

Tipo: word-set-property  ·  Paquete: Word Activities v1.0.4

Asigna un metadato (propiedad) del documento: título, autor, asunto, palabras clave, etc. Útil al generar documentos para dejarlos con su información correcta (autor, título), o para clasificarlos.

Cómo funciona

Asigna el value (convertido a texto) a la propiedad indicada en property. Acepta session o path — ver los dos modos:

• Con path: abre el archivo, asigna y lo guarda en la misma ruta automáticamente.
• Con session (o dentro de un body): asigna en memoria; guarda después con Word Save (Word Create con body guarda solo).

Para Created y Modified, value debe ser una fecha reconocible (2026-03-14, 2026-03-14 09:30). Si no se puede interpretar como fecha, la propiedad no cambia y la actividad no falla. property se elige de la lista; no admite expresiones.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
property	string	—	Propiedad a asignar: Title · Author · Subject · Description · Keywords · Category · Created · Modified.
value	object	—	Valor a asignar. Se guarda como texto; para las fechas, una fecha válida. Si la expresión da vacío, la propiedad queda vacía.

Parámetros opcionales

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

Salida

Esta actividad no devuelve ningún valor.

Ejemplo

Word Create   path = rutaInforme
 └─ body:
      Word Set Property   property = Title    value = "Informe Mensual"
      Word Set Property   property = Author   value = "Robot de Reportes"
      Word Append Paragraph   text = "Informe Mensual"   style = Title
Word Get Property   path = rutaInforme   property = Title   → output: titulo

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.
'property' es obligatorio.	No se eligió la propiedad.
Propiedad desconocida: '…'.	El nombre de la propiedad no está en la lista admitida.

Actividades relacionadas

• Word Get Property — leer una propiedad.
• Word Create — crear el documento.