Desencadenadores

Los desencadenadores proporcionan un mecanismo uniforme para suscribirse a eventos desde las plataformas del conector. Le da la flexibilidad de iniciar automáticamente automatizaciones o procesos en Orchestrator.

Requisitos previos

Antes de poder configurar los desencadenadores, asegúrate de que se cumplen las siguientes condiciones:

• Integration Service está habilitado y aprovisionado para tu tenant.
• La pestaña Desencadenadores se muestra en la ventana Integraciones.
• Ya has configurado un robot desatendido o de no producción en tu instancia de Orchestrator.
• Está utilizando carpetas modernas (los procesos dentro de las carpetas clásicas no son visibles al definir los desencadenadores).

Nota:

Los desencadenadores solo son compatibles con las carpetas modernas. Las carpetas clásicas no son compatibles con el paradigma de identidad de usuario moderno, por lo que no pueden admitir conexiones en general ni desencadenadores.

Creación de su proceso

Cree su proceso en UiPath® Studio como lo haría normalmente. Al utilizar Integration Service, cualquier automatización puede desencadenarse para cualquier proceso.

Para recibir los detalles de un registro, sigue los siguientes pasos:

• Si quieres saber el Conector, Evento, Tipo de Registro o Registro real que activó el proceso en tu flujo de trabajo, puedes definir los siguientes argumentos de entrada de tipo String en tu proceso.

  Integration Service los completará automáticamente cuando inicie el trabajo.

  • ConectorDeEventoDeUiPath
  • EventoDeUiPath
  • TipoDeObjetoDeEventoDeIU
  • UiPathEventObjectId Nota: Más información sobre cómo funcionan los argumentos y cómo gestionarlos aquí.

• To retrieve and work with a record that has a trigger on a job run, use the UiPathEventObjectId input argument to retrieve the record from the source system.

Este es un ejemplo de cómo Integration Service pasa los valores de los argumentos de entrada.

Publicar su proceso

Publica tu proceso en Orchestrator como lo harías normalmente. Puedes publicarlo en una carpeta compartida o en un espacio de trabajo personal. Asegúrate de crear un proceso a partir de tu paquete.

Configurar su desencadenador

Para añadir un desencadenador, sigue los siguientes pasos:

1. Accede a Automation Cloud^TM.
2. En el menú de la izquierda, selecciona Integration Service. La ventana de Integration Service incluye tres pestañas independientes: Conectores, Conexiones y Desencadenadores.
3. Accede a la pestaña Desencadenadores y selecciona el botón Añadir desencadenador .
4. Selecciona el conector y la conexión deseados en sus respectivos menús desplegables. Si solo hay una conexión configurada para ese conector en particular, se selecciona automáticamente.
5. Selecciona el evento y el registro deseados en sus respectivos menús desplegables. Nota: los tipos de eventos pueden variar con el conector.
6. A continuación, selecciona el Proceso a ejecutar.
7. Selecciona la licencia de Runtime (el runtime utilizado para ejecutar los trabajos iniciados por el desencadenador) en el menú desplegable. La lista de tiempos de ejecución que se muestra se basa en la respuesta recibida de Orchestrator, es decir, las licencias de tiempo de ejecución "asignadas" a esa carpeta. Para el tiempo de ejecución seleccionado, un mensaje indica el número de tiempos de ejecución asignados. Para obtener más información, consulta la documentación Gestionar desencadenadores en Orchestrator y Runtimes (licencias de robot) .
8. Selecciona el botón Añadir desencadenador para crear tu desencadenador y activarlo.

Como alternativa, puedes crear un nuevo desencadenador desde la pestaña Conexiones . Para ello:

1. Selecciona el botón Más acciones de una conexión.
2. Select the Add trigger option.
3. Select the desired Event and Record Type from their respective dropdown menus. In this case, the Connector and Connection are already selected and cannot be changed.
4. On the right, select the Process to execute and the respective Runtime license.
5. Selecciona el botón Añadir desencadenador para crear tu desencadenador y activarlo.

Nota:

La supervisión de eventos está configurada actualmente para sondear cada cinco minutos. Por tanto, pueden pasar hasta cinco minutos antes de que se inicie el proceso asociado. Puedes ver los detalles de un trabajo en la pestaña Trabajos en tu carpeta de Orchestrator. Un trabajo iniciado desde Integration Service mostrará su origen como Desencadenador de integración.

Events

Los conectores admiten eventos a través de un mecanismo de sondeo. Esto es compatible con la mayoría del catálogo de conectores.

El servicio de integración admite los siguientes dos tipos de eventos:

1. Genérico, que representa las operaciones típicas de creación, actualización y eliminación. Al seleccionar un evento genérico, también debes definir el registro del evento a supervisar. Por ejemplo, Registro creado para el registro Calendario .
2. Predefinidos, que representan acciones específicas en objetos específicos. Por ejemplo, Evento de calendario creado.

Encontrará más información sobre eventos en la página de cada conector.

Filtros de datos

Cuando defines un evento para tu desencadenador, puedes añadir un filtrado más específico.

With Data filters, you can configure triggers that match specific data patterns. This means fewer launches of your robot and not having to apply additional filtering within your automation.

Polling Interval

Los conectores admiten eventos a través de un mecanismo de sondeo.

Cuando creas una nueva conexión y configuras un desencadenador de eventos en esa conexión, el intervalo de sondeo se establece de forma predeterminada en cinco minutos.

El campo Intervalo de sondeo ajustable te permite personalizar el intervalo en el que los desencadenadores de eventos comprueban si hay nuevos eventos de objetos.

Importante:

You can have only one polling interval per connection, even though you can have several triggers set up per connection. Changing the polling interval affects all the associated triggers on a connection.

El sondeo se ejecuta en la conexión en el intervalo seleccionado. Una vez que se han recuperado los datos, todos los desencadenadores activos para esa conexión se aplican al conjunto de datos. Si se está ejecutando una encuesta cuando cambias el intervalo, el servicio espera a que finalice la encuesta existente y luego inicia otra.

Cambiar su intervalo de encuesta

Puedes cambiar tu intervalo de sondeo desde la página de un conector específico o desde la pestaña Conexiones .

1. En Automation Cloud^TM, accede a Integration Service.

2. Go to the Connectors page and select a connector.

3. En la página del conector, selecciona una conexión para abrir la página de detalles de la conexión.

4. Selecciona el intervalo que se encuentra bajo el nombre de la conexión, de la siguiente manera. El intervalo de sondeo solo se muestra para las conexiones con desencadenadores añadidos.

   

Alternatively, you can configure your polling interval from the Connections tab:

1. En Integration Service, ve a la pestaña Conexiones .

2. Selecciona una conexión específica para abrir la página de detalles de la conexión.

3. Selecciona el intervalo que se encuentra bajo el nombre de la conexión.

4. The Update polling interval window is displayed.

5. Puedes elegir una de las opciones disponibles o configurar un intervalo personalizado , en minutos u horas. El intervalo de sondeo debe ser superior a un minuto y no superior a 24 horas o 1440 minutos.

   

   El siguiente mensaje de error te advierte si introduces un valor incorrecto: "El intervalo de sondeo debe ser un número natural de 1 a 1440 minutos o 24 horas".

6. Selecciona Actualizar intervalo.

Historial de ejecución del desencadenador

Puedes ver el historial de ejecución de un desencadenador simplemente seleccionándolo en la pestaña Desencadenadores . En la nueva página, el historial de intentos se muestra en la parte inferior de la interfaz.

Este historial muestra los eventos recibidos por Integration Service y si el proceso se inició con éxito, en cuyo caso muestra la palabra Correcto en la columna Estado .

Nota:

The Successful state only indicates that the job was successfully launched. It does not reflect whether the job was successfully executed to the end or not.

Importante:

In case a job fails to start, its State will appear as Failed. Hover with the mouse cursor over the Failed state to view the error message.

Para comprobar si un trabajo se ha ejecutado correctamente, selecciona el botón Ver registros de trabajo . Te redirigirá a Orchestrator, donde se muestra toda la información necesaria sobre la ejecución del trabajo.

Eliminar un desencadenador

Ve a la pestaña Desencadenadores en la ventana de Integration Service . Selecciona el botón Más acciones correspondiente a tu desencadenador y selecciona Eliminar.

Cambiar el nombre de un desencadenador

Para cambiar el nombre de un desencadenador, sigue los siguientes pasos:

1. Access the Triggers tab.
2. Pasa el cursor del ratón sobre el nombre del desencadenador que deseas modificar. Se mostrará el botón Editar . Como alternativa, puedes seleccionar tu desencadenador de la lista para acceder a la vista detallada. El botón Editar se encuentra a la derecha del nombre de tu desencadenador.
3. Selecciona el botón Editar y podrás elegir un nuevo nombre para tu desencadenador

Vista de detalles del desencadenador

Selecciona un desencadenador para ver sus detalles.

Activar o desactivar un desencadenador

Para activar o desactivar un desencadenador, primero debes seleccionarlo para ver sus detalles. A continuación, selecciona el interruptor situado en la parte superior izquierda de la ventana.

Limitaciones

Las limitaciones de los desencadenadores se documentan en la sección Resolución de problemas de esta guía. Consulta Limitaciones del desencadenador.