Guía de usuario de Studio

Última actualización 17 de dic. de 2024

Información general

Las automatizaciones attended basadas en desencadenadores pueden implicar lo siguiente:

Formularios: se crean utilizando el Creador de formularios y se gestionan con el paquete Form.Activities.
Llamadas: se crean utilizando el Creador de formularios y se muestran con el paquete Callout.Activities
Desencadenadores: utilizan los paquetes System.Activities y UIAutomation.Activities.
Variables globales: creadas desde Data Manager.

Los formularios y las llamadas representan una capacidad básica de la automatización attended. Ejecutarlos utilizando desencadenadores te permite crear escenarios complejos. Estos escenarios implican múltiples eventos que ocurren al mismo tiempo. Además, la posibilidad de desencadenar acciones en función de los valores de las variables globales te ayuda a cubrir escenarios aún más attended.

El siguiente diagrama muestra un proceso creado utilizando formularios, desencadenadores de eventos de formularios y desencadenadores de eventos de aplicación. También puedes crear procesos similares basados en desencadenadores de eventos de usuario y llamadas.

Requisitos previos

Para diseñar y ejecutar automatizaciones attended basadas en desencadenadores:

Instala los siguientes paquetes de actividades:
- Form.Activities versión 23.4
- System.Activities 23.4
- UIAutomation.Activities 23.4
- Callout.Activities 23.4
Si te encuentras con el siguiente error al intentar crear un archivo de formulario: no se pudo encontrar una instalación compatible de Webview2 Runtime para alojar WebViews, instala Microsoft Edge WebView2.

Formularios

El propósito de los formularios en la automatización attended es recopilar y procesar la entrada del usuario o de la aplicación. Con las funciones del formulario actuales, puedes:

Crea formularios fuera de las actividades, utilizando un formulario (archivo uiform) dentro de tu proyecto. Más tarde puedes crearlos o editarlos de forma independiente de cualquier actividad que utilice los formularios. Esto te permite separar el proceso de creación de formularios y luego utilizarlos en la misma automatización.
Crea formularios utilizando archivos HTML personalizados. Puedes trabajar con formularios HTML de forma similar a como lo haces con los archivos uiform.
Muestra varios formularios al mismo tiempo, utilizando la actividad Mostrar formulario. Añade varias actividades Mostrar formulario y proporciona un nombre único en el campo Nombre de la instancia para cada una de ellas.La propiedad Nombre de la instancia está disponible para la mayoría de las actividades del paquete Form.Activities y se puede utilizar para:
- Muestra o realiza acciones en varias instancias del mismo formulario, proporcionando Nombres de la instancia únicos para cada formulario que muestras.
- Muestra o realiza acciones en todas las instancias, dejando vacío el campo Nombre de la instancia.
Establece un desencadenador para iniciar basado en los eventos del formulario. Estos eventos pueden representar un formulario que se cierra o un componente determinado del formulario que cambia. Puedes lograrlo utilizando la actividad Desencadenador de eventos de formularios.
Elige mostrar solo un formulario o mostrarlo mientras se ejecuta el resto del flujo de trabajo. Puedes hacerlo activando o desactivando la propiedad Continuar ejecución del flujo de trabajo.
Edita y obtiene valores del formulario en el tiempo de ejecución, utilizando las actividades Establecer valores del formulario y Obtener valores del formulario.
Cambia las propiedades del formulario en tiempo de ejecución, utilizando la actividad Cambiar propiedades del formulario.
Inyecta JavaScript personalizado en el formulario, utilizando la actividad Ejecutar script del formulario.

Avisos

La función de las llamadas en la automatización attended es dirigir al usuario a un elemento de IU específico dentro de una aplicación, sitio web, producto o incluso un formulario. También puedes utilizar llamadas para crear validaciones personalizadas para las aplicaciones, rellenar campos previamente y desencadenar varias automatizaciones en función de la entrada del usuario.

Con las capacidades de llamada, puedes:

Crea una llamada utilizando un archivo de formulario (uiform) y diséñala utilizando el Creador de formularios.
Indica el elemento de IU junto al que deseas que se muestre la llamada utilizando la actividad Mostrar llamada.
Pasar valores a los elementos de una llamada.

Nota: una llamada es un formulario vinculado a un elemento de IU y que se muestra junto a él, utilizando la actividad Mostrar llamada.

Aunque hay un paquete Callout.Activities dedicado a las llamadas, también es posible gestionar las llamadas utilizando el paquete Form.Activities, ya que las llamadas son archivos uiform al igual que los formularios normales.Esto significa que puedes trabajar con las llamadas de la misma manera que trabajarías con un formulario normal si utilizas el paquete Form.Activities

Desencadenadores

El propósito de los desencadenadores en la automatización attended es:

Iniciar flujos de trabajo basados en eventos de la aplicación o del usuario. Además, puedes especificar cómo ejecutar acciones cuando se dispara un desencadenador, a través del modo Programación:

Secuencial: las acciones se ejecutan una tras otra.
Concurrente: la ejecución de las acciones puede solaparse.
OneTime : ejecuta una Actions y sale de la supervisión.
Contracción secuencial: ignora todos los eventos próximos, excepto el último, hasta que el evento actual finaliza la ejecución.
Despliegue secuencial: detiene la ejecución del evento anterior e inicia el siguiente evento.

Para desencadenar flujos de trabajo basados en eventos de la aplicación o del usuario, utiliza las siguientes actividades:

Actividades	Descripción
Desencadenador de evento de formulario	Desencadena flujos de trabajo basados en un evento que ocurre dentro de un formulario.
Desencadenador de eventos de aplicación	Establece un desencadenador en función de un evento nativo de cualquier tipo de elemento (ventana de nivel superior o cualquier otro elemento de IU indicado).
Repetir desencadenador	Esta actividad te permite configurar un TimeSpan como InArgument. Cuando expira el período de tiempo, el desencadenador se ejecuta y puede repetirse en función de la configuración.
Desencadenador de eventos de pulsación de tecla	Establece un desencadenador de evento de tecla pulsada en el elemento de IU indicado.
Clic desencadenador de eventos	Establece un desencadenador de evento de clic en el elemento de IU indicado.
Desencadenador de tecla de acceso rápido	Supervisa un evento clave especificado en todo el sistema.
Desencadenador del ratón*	Supervisa un evento específico en el sistema de combinación de teclas del ratón.
Desencadenador de clic de imagen*	Supervisa la imagen definida por el elemento de la IU de destino para la entrada del ratón.
Desencadenador del sistema*	Supervisa una clave específica del sistema o un evento del ratón.
Desencadenador de atributos de sesión de SAP cambiados*	Supervisa los cambios en los atributos de sesión SAP especificados.

*: se puede utilizar tanto por sí mismo como dentro de una actividad Ámbito de desencadenador.

Para automatizar varios escenarios attended que pueden ocurrir una vez, en secuencia o al mismo tiempo. Puedes lograrlo utilizando las siguientes actividades:

Actividades	Descripción
Ejecutar desencadenadores locales	Inicia y arranca todos los desencadenadores locales que escuchan eventos en la máquina del usuario.
Detener desencadenadores locales	Finaliza la ejecución de los desencadenadores locales. Cuando se ejecuta, cancela todas las acciones en curso, incluidos los flujos de trabajo desencadenados por eventos. Cuando se ejecuta Detener desencadenadores locales, se cancelan los flujos de trabajo desencadenados por eventos en curso, pero las actividades del flujo de trabajo principal continúan como de costumbre.
Deshabilitar desencadenador local	Desactiva uno o más desencadenadores locales activos que se iniciaron previamente con la actividad Ejecutar desencadenadores locales .
Habilitar desencadenador local	Activa uno o más desencadenadores locales activos que se iniciaron previamente con la actividad Ejecutar desencadenadores locales.

Para iniciar flujos de trabajo basados en el comportamiento de las variables globales que creas en Data Manager.Puedes lograrlo utilizando las siguientes actividades:

Actividades	Descripción
Desencadenador de variable global cambiada	Envía una notificación a todos los suscriptores cuando cambia el valor de una variable global.
Notificar la modificación de la variable global	Desencadenador que se inicia cuando cambia el valor de una variable global.

Ejecutar desencadenadores locales

La actividad Ejecutar desencadenadores locales le permite desencadenar varios eventos simultáneamente. En el backend, genera un flujo de trabajo de solo lectura independiente llamado Triggereventargs en tiempo de Runtime o durante la depuración. Este flujo de trabajo contiene múltiples actividades en el ámbito de desencadenador que ejecutan todos los desencadenadores en paralelo dentro de tu proyecto.

Cuando ejecutas el proyecto por primera vez, cada flujo de trabajo desencadenador captura el flujo de trabajo Triggereventargs como argumento en el panel Argumentos . Cada flujo de trabajo desencadenador tiene su propio argumento Triggereventargs , que contiene información sobre sí mismo. A medida que ejecutas el proyecto, los argumentos Triggereventargs se actualizan con la información de ejecución más reciente.

El argumento Triggereventargs proporciona principalmente la siguiente información específica para cada flujo de trabajo desencadenador:

Tipo de desencadenador
Nombre del desencadenador
Elemento de destino que activó el desencadenador
Componentes del formulario (en el caso de la actividad Desencadenador de formulario)
Nombre de instancia del formulario (en el caso de la actividad Desencadenador de formulario)

Para acceder a la información desde el argumento Triggereventargs , puedes aplicar varios métodos según el tipo de desencadenador. Para los desencadenadores de eventos de usuario, están disponibles los siguientes métodos:

ElementoDeDestino : obtiene información sobre el elemento de destino supervisado
1. Atributos : obtén los atributos del elemento de destino supervisado.
2. DisplayDpiScaleFactor : determina el tamaño del elemento de destino en píxeles
3. ImageBase64 : convierte la imagen del elemento de destino en una imagen Base64
4. Selector : recupera información sobre el selector utilizado en el elemento de destino
Tipo de desencadenador

Para los desencadenadores de formulario, puedes utilizar los siguientes métodos:

FormSourceId : accede al ID del formulario en el que se activó el desencadenador
Nombre de instancia : recupera el nombre de instancia del formulario en el que se activó el desencadenador

Comportamiento del desencadenador

Los flujos de trabajo de desencadenadores son flujos de trabajo que comienzan con un desencadenador. Estos pueden depurarse en el contexto de todo el proyecto, o de forma independiente.
Si crees que un número elevado de desencadenadores afecta al rendimiento, puedes habilitar o deshabilitar desencadenadores específicos, utilizando las actividades Habilitar desencadenador local y Deshabilitar desencadenador local.
Las actividades Habilitar desencadenador local y Deshabilitar desencadenador local son útiles en escenarios en los que hay múltiples flujos de trabajo que supervisan los eventos del usuario que están determinados por la fase de la automatización que ha alcanzado el usuario.
- Por ejemplo, puede utilizar la actividad Habilitar desencadenador local para activar un desencadenador una vez que el usuario haya introducido su nombre de usuario en un formulario.
- Por otro lado, la actividad Deshabilitar desencadenador local se puede utilizar para desactivar un desencadenador que se programó para ejecutarse secuencialmente una vez que el usuario haya llegado a un paso específico durante una visita guiada del producto, por ejemplo.

Variables globales

El propósito de las variables globales en la automatización attended es registrar información sobre los eventos del usuario o de la aplicación y luego almacenarla dentro de una variable que más tarde puedes utilizar como entrada o desencadenador para otras actividades. Esto te permite compartir datos fácilmente entre varios flujos de trabajo. Con las capacidades de variables globales, puedes:

Notifica cuando cambia el valor de una variable global, utilizando la actividad Notificar cambio de variable global
Desencadena un flujo de trabajo o una actividad cuando cambia el valor de una variable global, utilizando la actividad Desencadenador de variable global cambiado.

En esta página