Controlador global de excepciones

El Controlador global de excepciones es un tipo de flujo de trabajo diseñado para determinar el comportamiento del proyecto al encontrar un error de ejecución. Solo se puede establecer un Controlador global de excepciones por proyecto de automatización.

Nota: El Controlador de excepciones globales no está disponible para proyectos de biblioteca, solo para procesos.

El Controlador global de excepciones tiene dos argumentos que no se deben eliminar.

El primer argumento es errorInfo con la dirección En y almacena información sobre el error que se ha lanzado y el flujo de trabajo que falló. El nivel de error que se puede registrar en la actividad Mensaje de registro.

Nota: Usa la propiedad ActivityInfo para errorInfo para obtener el nombre de la actividad que ejecutó la excepción y verla en el panel Salida.

El segundo argumento, result, tiene la direcciónFuera y se usa para determinar el siguiente comportamiento del proceso cuando se encuentra un error. Los siguientes valores se pueden asignar al argumento result.

• Continuar: la excepción se vuelve a ejecutar.
• Ignorar: la excepción se ignora y la ejecución continúa desde la siguiente actividad.
• Reintentar: la actividad que ejecutó la excepción se vuelve a intentar. Usa el método RetryCount para errorInfo para contar el número de veces que se ha recuperado.

• Abortar: la ejecución se detiene después de ejecutar el Controlador de excepciones global actual.

  Nota: cualquier flujo de trabajo puede marcarse como Controlador de excepciones global en Studio, excepto para los proyectos de biblioteca y Main.xaml.

Para controlar el flujo de trabajo en caso de un error, el Controlador de excepciones global reintenta la actividad tres veces y luego la aborta con un mensaje de error.

Gestión de errores durante la depuración

Cuando se detecta una excepción durante la depuración, se resalta la actividad que ha fallado, se detiene la ejecución y se mencionan el tipo y los detalles de la excepción en los paneles Locales y Pila de llamadas.

Lasacciones de depuración como Continuar, Detener, Reintentar, Ignorar, Reiniciar y Paso lento están disponibles en la cinta. Ignorar se utiliza para continuar la ejecución desde la siguiente actividad.

El botón Reintentar intenta ejecutar de nuevo la actividad actual sin que actúe el Controlador de excepciones global. La acción Continuar ejecuta el Controlador de excepciones teniendo en cuenta los valores de la opción previamente para el argumento result, ya sean Continuar, Ignorar, Reintentar o Abortar.

Nota:

Al usar el Controlador global de excepciones con un proyecto que incluye un Intento de captura, asegúrate de agrupar las actividades en una Secuencia dentro del contenedor Intentar. De lo contrario, el Controlador global de excepciones no se ejecutará.

En el caso de actividades anidadas, se ejecuta el Controlador global de excepciones para cada actividad de la pila. Sin embargo, no se ejecuta para las actividades encapsuladas directamente en un Intento de captura, a menos que estén en una actividad.

Ejemplo de uso del Controlador global de excepciones

El siguiente ejemplo muestra el comportamiento de un proyecto cuando se produce una excepción durante la ejecución.

El proyecto de automatización está configurado para escribir texto en un archivo TXT y luego cerrar la aplicación, pero no antes de guardar el archivo.

Crear el flujo de trabajo

1. Crea un Proceso vacío siguiendo los pasos de la página Crear proceso básico.
2. Abre el Bloc de notas y guarda un documento en tu máquina. Puedes nombrar el archivo 1.txt.
3. En el panel Actividades, busca Usar aplicación/navegador y arrástralo al panel Diseñador.
4. En Usar aplicación/navegador:

   • Haz clic en Indicar aplicación para automatizar y luego mueve el puntero del ratón a la ventana del Bloc de notas. Cuando la ventana esté resaltada, haz clic en cualquier lugar dentro de ella.

     La actividad Usar aplicación/navegador se actualizará, la ruta se añadirá al campo Ruta de la aplicación y aparecerá una captura de pantalla de la ventana dentro de la actividad.

   • En el panel Propiedades, selecciona la opción Siempre para la propiedad Cerrar. Esto garantiza que el Bloc de notas se cierre después de la automatización.
5. Añade una actividad Escribir en el contenedor Hacer de la actividad Abrir aplicación/navegador. Haz clic en Indicar en aplicación para seleccionar la ventana del Bloc de notas y añade un texto entre comillas, en el campo Escribir esto. Esta actividad escribe el texto en el Bloc de notas.
6. Desde el panel Actividades, añade una actividad Atajos del teclado al flujo de trabajo. Indica la ventana del Bloc de notas, luego selecciona Grabar atajo y presiona Ctrl+S para registrar la combinación de teclas que guarda el archivo después de escribir el texto.

   El flujo de trabajo resultante debe tener este aspecto:

   
   

   

   
   

Añadir un Controlador global de excepciones

1. En la pestaña Diseño de la Cinta, selecciona Nuevo > Controlador global. Se abre la ventana Nuevo controlador global. Escribe un Nombre para el controlador y guárdalo en la ruta del proyecto. Al hacer clic en Crear se añade un Controlador global de excepciones al proyecto de automatización.
   
   

   

   
   
2. Vuelve al flujo de trabajo que creaste anteriormente y modifícalo para que una actividad genere un fallo al ejecutarse. Por ejemplo, en la actividad Usar aplicación/navegador, selecciona la opción Coincidir título exacto y asegúrate de que el archivo esté cerrado antes de hacer clic en Ejecutar archivo en la cinta.

Cuando el Controlador global de excepciones encuentra una excepción, registra el nombre de la actividad que ha fallado e intenta ejecutar la actividad tres veces. Si encuentra la misma excepción cada vez y el número de reintentos alcanza 3, la ejecución se aborta en el ámbito de la actividad que lanzó la excepción.

Si durante uno de los reintentos no se encuentra una excepción, la ejecución del flujo de trabajo continúa y el Controlador global de excepciones no interviene.

Descargar ejemplo