Message Box

Tipo: message-box · Paquete: UI Activities v1.0.4 · Salida: string

Muestra un cuadro de diálogo de Windows con un mensaje y unos botones, y devuelve el botón que pulsó el usuario. Sirve para informar (un aviso) o pedir una confirmación (“¿Desea continuar?”).

Cómo funciona

Muestra el message con el conjunto de buttons y el icon indicados, y espera sin límite de tiempo. Devuelve el nombre del botón pulsado, que puedes evaluar con un If, y deja en el log Cuadro de diálogo cerrado con '…'.

Los textos de los botones los pone Windows en el idioma del equipo, pero el valor devuelto es siempre el nombre en inglés de la tabla de abajo.
buttons e icon se eligen de una lista (no son expresiones) y no distinguen mayúsculas; un valor desconocido usa el predeterminado.
Necesita un escritorio interactivo de Windows: no funciona cuando el Agent corre como servicio de Windows (Session 0).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`message`	`string`	—	El mensaje a mostrar. Texto fijo entre comillas o expresión.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`title`	`string`	`"Zoan Automation"`	Título de la ventana.
`buttons`	`string`	`"OK"`	Botones a mostrar: `OK`, `OKCancel`, `YesNo`, `YesNoCancel`, `RetryCancel`, `AbortRetryIgnore`.
`icon`	`string`	`"Information"`	Icono: `None`, `Information`, `Question`, `Warning`, `Error`.

Salida

Tipo	Descripción
`string`	El botón pulsado: `OK`, `Cancel`, `Yes`, `No`, `Retry`, `Abort` o `Ignore`.

Qué puede devolver cada combinación:

`buttons`	Valores posibles
`OK`	`OK`
`OKCancel`	`OK`, `Cancel`
`YesNo`	`Yes`, `No`
`YesNoCancel`	`Yes`, `No`, `Cancel`
`RetryCancel`	`Retry`, `Cancel`
`AbortRetryIgnore`	`Abort`, `Retry`, `Ignore`

Cerrar la ventana con la X o con Esc, cuando Windows lo permite, equivale a Cancel (o a OK si es el único botón).

Ejemplo

Pedir confirmación antes de una acción:

Message Box   message = "¿Procesar " + total + " registros?"   buttons = YesNo   icon = Question   → output: respuesta
If   condition = respuesta == "Yes"
 ├─ then:
 │    ... procesar ...
 └─ else:
      Log   level = warning   message = "Proceso cancelado por el usuario"

Errores comunes

Mensaje	Causa y solución
`No se pudo mostrar el cuadro de mensaje. Las actividades de interfaz (message-box, input-dialog) necesitan un escritorio interactivo y no funcionan cuando el Agent corre como servicio de Windows (Session 0). …`	No hay un escritorio donde mostrar la ventana. Ejecuta el Agent en una sesión interactiva de Windows, o usa Log para avisar sin diálogo.
La condición nunca se cumple	Comparaste con el texto del botón en español (`"Sí"`). Compara con el valor devuelto: `"Yes"`, `"No"`, `"OK"`…

Actividades relacionadas

Input Dialog — pedir un texto.
Log — registrar información sin diálogo (apto para desatendido).