Try / Catch

Try / Catch

Tipo: try-catch  ·  Paquete: Core Activities v1.0.0

Ejecuta un bloque de actividades y, si alguna falla, en vez de detener toda la ejecución, salta a un bloque alternativo donde puedes reaccionar: registrar el error, notificar, o seguir un plan B. Es la herramienta clave para que tu automatización sea robusta ante los problemas que sabes que pueden ocurrir (una página que no carga, un archivo que no existe, un sistema que a veces falla).

Tiene tres bloques: try (lo que intentas), catch (qué hacer si falla) y finally (lo que se ejecuta siempre, pase lo que pase).

Cómo funciona

1. Ejecuta las actividades de try.
2. Si todas tienen éxito, omite el catch.
3. Si alguna falla, detiene el try en ese punto, guarda el error en errorVariable (si la definiste) —un objeto ZoanError con el detalle de la excepción— y ejecuta el bloque catch.
4. Al final, siempre ejecuta finally —tanto si hubo error como si no— ideal para liberar recursos (cerrar un navegador, una conexión).

Tras el catch, la ejecución continúa normalmente con lo que venga después del Try/Catch: el error quedó “atrapado”.

Parámetros opcionales

Parámetro	Editor	Descripción
errorVariable	nombre de variable	Variable de tipo ZoanError con el error capturado. En el catch accede a sus propiedades: .Message (el mensaje), .Type (el tipo de excepción, p. ej. "HttpRequestException"), .Source y .StackTrace.

Sub-flujos (lanes)

try requerido

Actividades a intentar. Si una falla, el resto del try no se ejecuta.

catch opcional

Actividades que se ejecutan solo si algo en el try falló.

finally opcional

Actividades que se ejecutan siempre, haya fallado o no el try.

Ejemplo

Intentar leer un Excel; si falla, registrar el error y seguir; y cerrar el libro pase lo que pase:

Try / Catch   errorVariable = error
 ├─ try:
 │    Excel Open        path = = asset("datos.xlsx")   output = libro
 │    Excel Read Range  excel = = libro   range = "A1:D100"   output = tabla
 ├─ catch:
 │    Log   level = error   message = = "No se pudo leer el Excel (" + error.Type + "): " + error.Message
 │    Set Variable   name = tabla   value = = newDataTable()    // valor por defecto
 └─ finally:
      Excel Close   excel = = libro

errorVariable es un objeto ZoanError

La variable de error es un objeto con el detalle de la excepción capturada:

• error.Message — el mensaje del error.
• error.Type — el tipo de excepción (p. ej. "HttpRequestException", "TimeoutException"); úsalo para distinguir errores y ramificar el catch.
• error.Source y error.StackTrace — origen y traza, para diagnóstico.

Tratarla como texto sigue funcionando: = error o "Error: " + error usan el mensaje, así que los playbooks que ya la leían como string no se rompen.

Try/Catch vs Retry

• Usa Try / Catch cuando quieres manejar un error y continuar con un plan alternativo.
• Usa Retry cuando el error es transitorio (una web lenta, la red) y basta con volver a intentar la misma acción.

Puedes combinarlos: un Retry dentro de un Try/Catch reintenta primero y, si aun así falla, el catch maneja la situación.

Cancelaciones y break/continue no son errores

Si cancelas la ejecución desde el portal, o usas Break/Continue dentro del try, no se tratan como errores: el catch no se dispara. El finally, en cambio, sí se ejecuta.

Actividades relacionadas

• Retry — reintentar automáticamente un bloque que falla.
• Throw — lanzar un error a propósito (que un Try/Catch externo puede capturar).
• Log — registrar el error capturado en el catch.