Input Dialog

Input Dialog

Tipo: input-dialog  ·  Paquete: UI Activities v1.0.4  ·  Salida: string

Muestra un diálogo con un campo de texto y devuelve el valor que escribe el usuario. Sirve para pedir un dato al inicio o en medio de una automatización asistida: un número de documento, una fecha, una ruta.

Solo en modo atendido

Bloquea la ejecución hasta que el usuario escriba algo y confirme. No lo uses en procesos desatendidos; para esos, recibe el dato por un parámetro de entrada del proceso, una cola, o un archivo.

Cómo funciona

Muestra una ventana de Windows centrada en la pantalla, con el texto prompt sobre un campo de entrada (precargado con default, si lo indicas) y los botones Aceptar y Cancelar. Espera sin límite de tiempo a que la persona responda:

• Aceptar (o la tecla Enter) devuelve el texto del campo, tal como quedó; puede ser "" si lo dejó vacío.
• Cancelar, la tecla Esc o cerrar la ventana devuelven null y dejan una advertencia en el log: El usuario canceló el cuadro de diálogo.

Necesita un escritorio interactivo de Windows: no funciona cuando el Agent corre como servicio de Windows (Session 0) ni en robots sin interfaz.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
prompt	string	—	Texto de la etiqueta sobre el campo. Texto fijo entre comillas o expresión. Caben unas dos líneas.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
title	string	"Zoan Automation"	Título de la ventana.
default	object	""	Valor inicial precargado en el campo. Puede ser de cualquier tipo: se muestra como texto.

Salida

Tipo	Descripción
string	El texto que ingresó el usuario al pulsar Aceptar ("" si lo dejó vacío), o null si canceló o cerró la ventana.

El valor siempre es texto: si pides un número o una fecha, conviértelo (por ejemplo con num(...)) antes de usarlo.

Ejemplo

Pedir un número de cliente, detenerse si la persona cancela y usarlo en una consulta:

Input Dialog   prompt = "Número de cliente:"   title = "Consulta de saldo"   → output: numero
If   condition = isEmpty(numero)          // vacío o cancelado
 └─ then:
      Throw   message = "No se indicó el número de cliente."   errorType = "BusinessRuleException"
DB Query   sql = "SELECT * FROM Clientes WHERE Numero = @n"   params = { "n": numero }   → output: cliente

Errores comunes

Mensaje	Causa y solución
No se pudo mostrar el cuadro de entrada. Las actividades de interfaz (input-dialog, message-box) 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 reemplaza el diálogo por un argumento de entrada del proceso.
La ejecución se queda esperando	El diálogo espera una respuesta sin límite de tiempo. Úsalo solo cuando haya una persona frente a la pantalla.
La consulta siguiente falla con null	La persona canceló. Comprueba isEmpty(numero) (verdadero para null y para texto vacío) antes de usar el valor.

Actividades relacionadas

• Message Box — mostrar un mensaje o pedir confirmación.
• Throw — detener el proceso si falta el dato.