Galería de escenarios

Un escenario es un archivo JSON: una lista de acciones, en orden. Es la unidad de trabajo de Diwall — escribirá algunos, reutilizará otros y los pondrá bajo control de versiones.

Estos cuatro se entregan con la herramienta. Funcionan en una instalación nueva, sin configuración previa — salvo el último, que necesita un directorio cifrado.

1 · Leer sin capturar

El más ligero. Espera la página y luego lee su título — sin captura, sin análisis de imagen.

{"url": "https://example.com",
 "actions": [
   {"type": "attendre_selecteur_present", "selecteur": "body"},
   {"type": "evaluer", "script": "document.title"}]}

diwall-rpa --scenario /opt/diwall/scenarios/exemples/sondage_fast.json --guide-version 1.3

{"succes": true, "http_status": 200,
 "evaluations": [{"script": "document.title", "valeur": "Example Domain"}],
 "respect": {"actions_executees": 2, "duree_totale_ms": 1174}}

Dos acciones, poco más de un segundo. Es la forma a la que recurrir cuando solo necesita saber qué dice una página.

2 · Ver, y luego pulsar por número

La misma página, pero con --som: cada elemento interactivo queda numerado, y el clic designa un número en lugar de un selector.

{"actions": [
   {"type": "attendre_selecteur_present", "selecteur": "body"},
   {"type": "cliquer_som", "id": 1}]}

diwall-rpa --scenario /opt/diwall/scenarios/exemples/navigation_som.json --som --guide-version 1.3

{"succes": true, "http_status": 200,
 "respect": {"actions_executees": 2, "duree_totale_ms": 1160}}

Cómo funciona la numeración →

3 · Diagnosticar una página que se resiste

El mismo esqueleto, otro propósito: apúntelo a una interfaz local que se comporte mal y lea erreurs_js y erreurs_console en la respuesta. Una página en blanco que oculta un error HTTP 500 se parece exactamente a una sesión caducada — es la consola la que las distingue.

diwall-rpa --scenario /opt/diwall/scenarios/exemples/depannage_local.json --guide-version 1.3

{"succes": true, "http_status": 200, "erreurs_js": [], "erreurs_console": [],
 "evaluations": [{"script": "document.title", "valeur": "Example Domain"}]}

Listas vacías aquí, porque example.com no tiene nada que señalar. Ponga su propia URL y se llenan.

4 · Autenticarse desde el directorio cifrado

El más demostrativo, y el que cierra la página en lugar de abrirla: necesita un directorio cifrado montado y configurado.

{"auth_indicator": ".user-menu",
 "actions": [
   {"type": "evaluer", "script": "document.title", "contient": "Example"},
   {"type": "remplir", "selecteur": "input[name=\"username\"]",
    "valeur": "depuis_secrets", "secret_cle": "username"},
   {"type": "remplir", "selecteur": "input[name=\"password\"]",
    "valeur": "depuis_secrets", "secret_cle": "password"},
   {"type": "cliquer", "selecteur": "button[type=\"submit\"]"},
   {"type": "attendre_selecteur_present", "selecteur": ".user-menu"}]}

Aquí no se muestra ninguna salida, y es deliberado: sin ese directorio este escenario no se ejecuta, y mostrar el error que lanza no probaría nada sobre la funcionalidad. Configure primero uno y luego ejecútelo contra un destino propio.

Dos detalles sostienen todo el modelo de seguridad. "valeur": "depuis_secrets" significa que la contraseña se resuelve dentro del proceso del navegador, nunca en su shell. Y la primera acción es una aserción, no un paso: si la página no es la esperada, el escenario se detiene antes de escribir nada en ninguna parte.

La galería crece con el uso real

Cuatro escenarios son un punto de partida deliberadamente modesto. journal.py --exporter-skill convierte una ejecución real exitosa en un escenario reutilizable — la galería crece al ritmo de los usos reales, nunca con ejemplos fabricados para rellenar la página.