Configuración del proyecto

La configuración del proyecto fija valores predeterminados para todas las actividades de interfaz del proyecto (escritorio, navegador y SAP), en lugar de ponerlos actividad por actividad, y guarda los datos del proyecto: nombre, versión, plataforma y duración máxima de una ejecución.

Por ejemplo: si la aplicación que automatizas es lenta y necesitas que cada clic espere hasta 60 segundos a que aparezca su botón, lo pones una vez en el proyecto y lo heredan todas las actividades.

Plataforma del proyecto

Al crear el proyecto eliges dónde va a correr, y no se puede cambiar después (en Propiedades del proyecto aparece con un candado):

Windows: robots de Windows, con escritorio. Admite todas las actividades: escritorio, SAP, navegador, Office…
Headless: los robots sin pantalla de Zoan Cloud. No hay escritorio, SAP GUI ni COM, así que el Designer oculta las actividades que solo funcionan en Windows (escritorio, SAP, UI, OCR, Outlook): no salen en la paleta, en Recientes, en Favoritas ni en la búsqueda (Ctrl+K). Una línea en la paleta indica cuántas se ocultan.
- Si un playbook ya tiene una de esas actividades (por ejemplo, pegada de otro proyecto), se marca como error «Actividad solo para Windows» y no se puede ejecutar ni publicar.
- La grabadora solo graba acciones del navegador.

Dónde se configura

En el Designer: ☰ → Archivo → Propiedades del proyecto…. También se abre con doble clic (o Enter) sobre la raíz del panel Proyecto, o desde el menú del nombre del proyecto en la barra superior. Tiene tres pestañas:

General: ID del proyecto (solo lectura), nombre, descripción, versión, autor, etiquetas y plataforma.
Automatización de interfaz: los valores de la tabla de abajo.
Paquete: versión mínima del motor, duración máxima de una ejecución y una vista previa del manifiesto.

Pulsa Guardar para aplicar los cambios.

Automatización de interfaz

Ajuste	Qué hace	Si lo dejas vacío
Tiempo de espera para encontrar un elemento (segundos)	Cuánto espera cada actividad a que aparezca el elemento sobre el que actúa (un botón, un campo, una celda) antes de fallar.	Cada actividad usa el suyo (normalmente 30 s).
Retardo antes de cada acción (ms)	Pausa antes de cada actividad de interfaz.	Sin pausa.
Retardo después de cada acción (ms)	Pausa después de cada actividad de interfaz. Útil para aplicaciones que necesitan un momento para reaccionar tras un clic.	Sin pausa.
Navegador predeterminado	Navegador que abre Open Browser cuando la actividad no elige uno: Chrome, Edge, Firefox o Chromium.	Chrome.
Ventana del navegador	Si Open Browser abre el navegador con ventana o sin ella (headless).	Con ventana; sin ventana en máquinas sin pantalla (ver abajo).

Qué valor gana

El valor puesto en la propia actividad siempre manda.
Si la actividad no lo tiene, se usa el del proyecto.
Si el proyecto tampoco lo define, el predeterminado de siempre de la actividad.

Un proyecto sin esta configuración usa los valores de cada actividad.

En el panel de propiedades, bajo el campo de tiempo de espera de una actividad que lo dejaste vacío, el Designer te recuerda qué valor va a usar: «Vacío: 60 s (configuración del proyecto)».

A qué actividades aplica

Tiempo de espera: las actividades de escritorio que buscan un elemento (Win Click, Win Type, Win Get Text, Win Attach, Win Wait For…), las de página del navegador (Page Click, Page Fill, Page Get Text, Page Wait For, Page Navigate…) y las de SAP a través del elementTimeout de SAP — Attach y SAP — Log on.
- No aplica a los tiempos que no son de buscar un elemento: arrancar el navegador (Open Browser), esperar una descarga, abrir una aplicación (Open App) o esperar a que aparezca una sesión de SAP.
- Tampoco a las comprobaciones que por diseño son instantáneas (Element Exists de escritorio y de navegador).
Retardos: todas las actividades de escritorio, navegador y SAP que actúan sobre un elemento. Los ámbitos (Win Attach, Open Browser, SAP — Attach con su cuerpo) no esperan: esperan los pasos que tienen dentro.
Navegador y ventana: la actividad Open Browser.

Duración máxima de una ejecución

En la pestaña Paquete, Duración máxima de una ejecución (minutos) es opcional. Si una ejecución tarda más, se termina con un error claro y la máquina queda libre para lo siguiente. Vacío significa sin límite. Admite de 1 a 10080 minutos (7 días).

Zoan Cloud puede fijar otro límite por proceso, por disparador o por ejecución.
No se aplica al depurar en el Designer: puedes detenerte en un punto de interrupción el tiempo que necesites.

Dónde se guarda

En el archivo del proyecto, project.zoanproj, sección settings:

"settings": {
  "ui":        { "timeoutMs": 60000, "delayBeforeMs": 0, "delayAfterMs": 300 },
  "browser":   { "name": "edge", "headless": true },
  "execution": { "maxDurationMinutes": 120 }
}

Como viaja dentro del paquete publicado, la misma configuración se aplica en el Designer, en los robots de Windows y en los robots sin pantalla de Zoan Cloud.

Siguientes pasos

Depuración — probar el playbook con estos tiempos antes de publicarlo.
Selectores — que cada actividad encuentre su elemento a la primera.