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

Crea tu proceso en UiPath® Studio como lo harías normalmente. Al utilizar Integration Service, se puede desencadenar cualquier automatización para cualquier proceso.

Para recibir los detalles de un registro, también puede seguir las siguientes indicaciones:

• 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
  • IDDeObjetoDeEventoDeUiPath
    Nota: Obtenga más información sobre cómo funcionan los argumentos y cómo administrarlos aquí.
• Para recuperar y trabajar con un registro que tiene un desencadenador en un trabajo ejecutado, use el argumento de entrada UiPathEventObjectId para recuperar el registro del sistema de origen.

A continuación, se muestra un ejemplo de cómo el servicio de integración pasa los valores de los argumentos de entrada .

Publicar su proceso

Publique su proceso en Orchestrator como lo haría normalmente. Puede publicarlo en una carpeta compartida o en un espacio de trabajo personal. Asegúrese de crear un proceso a partir de su 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, haz clic en Integration Service. La ventana del servicio de integración incluye tres pestañas independientes: Conectores, Conexiones y Desencadenadores.
3. Accede a la pestaña Desencadenadores y haz clic en 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 seleccionará automáticamente.

5. Selecciona el Evento y el Registro deseados en sus respectivos menús desplegables.

   Nota: los tipos de eventos pueden variar según el conector.
6. A la derecha, seleccione 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. Opciones disponibles: NonProduction, Unattended, Headless, TestAutomation, AutomationCloud, Serverless, Desarrollo.

   • 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 de Gestión de desencadenadores en Orchestrator y Runtimes (licencias de robots) .
8. Haga clic en el botón Añadir desencadenador para crear su desencadenador y activarlo.

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

1. Haz clic en el botón Más acciones de una conexión.
2. Selecciona la opción Añadir desencadenador .
3. Selecciona el Evento y el Tipo de Registro deseados en sus respectivos menús desplegables. En este caso, el Conector y la Conexión ya están seleccionados y no se pueden cambiar.
4. A la derecha, selecciona el proceso a ejecutar y la licencia de runtime correspondiente.

5. Haga clic en el botón Añadir desencadenador para crear su desencadenador y activarlo.

   Nota:

   La supervisión de eventos está actualmente configurada para sondear cada 5 minutos. Por tanto, pueden transcurrir hasta 5 minutos antes de que se inicie el proceso asociado.

   Puedes ver los detalles de un trabajo en la pestaña Trabajos de tu carpeta de Orchestrator. Un trabajo iniciado desde el servicio de integración 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éricos, que representan las operaciones típicas de creación, actualización y eliminación. Cuando selecciona un evento genérico, también debe definir el registro de evento a supervisar. Por ejemplo, Nuevo registro creado para el registro de Calendario .

   
   

   

   
   

2. Predefinidos, que representan acciones específicas sobre objetos específicos. Por ejemplo, se crea un evento de calendario.

   
   

   

   
   

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.

Con los filtros de datos, puede configurar desencadenadores que coincidan con patrones de datos específicos. Esto significa menos lanzamientos de su robot y no tener que aplicar filtros adicionales dentro de su automatización.

Polling Interval

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.

Puedes personalizar este intervalo con la función Intervalo de sondeo ajustable , que te permite elegir el intervalo en el que los desencadenadores de eventos buscan nuevos eventos de objetos.

Importante: solo puedes tener un intervalo de encuesta por conexión, aunque puedes tener varios desencadenadores configurados por conexión. Cambiar el intervalo de sondeo afecta a todos los desencadenadores asociados en una conexión.

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. Vaya a la página Conectores y seleccione un conector.
3. En la página del conector, selecciona una conexión para abrir la página de detalles de la conexión.

4. Haga clic en el intervalo que se encuentra debajo del nombre de la conexión, como se indica a continuación. El intervalo de encuesta se muestra solo para las conexiones con desencadenadores añadidos.

Alternativamente, puede configurar su intervalo de sondeo desde la pestaña Conexiones :

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. Haga clic en el intervalo que se encuentra debajo del nombre de la conexión.
4. Se mostrará la ventana Actualizar intervalo de encuesta .

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 haciendo clic en él 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 que recibió el servicio de integración y si el proceso se inició correctamente, en cuyo caso muestra la palabra Correcto en la columna Estado .

Nota: El estado Correcto solo indica que el trabajo se inició correctamente. No refleja si el trabajo se ejecutó correctamente hasta el final.

Importante: en caso de que un trabajo no pueda iniciarse, su estado aparecerá como Erróneo. Pasa el cursor del ratón sobre el estado Fallido para ver el mensaje de error.

Para comprobar si un trabajo se ejecutó correctamente, haga clic en el botón Ver registros de trabajo . Le 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 del Servicio de integración . Haga clic en el botón Más acciones correspondiente a su desencadenador y seleccione Eliminar.

Vista de detalles del desencadenador

Simplemente haga clic en un desencadenador para ver sus detalles.

Activar / desactivar un desencadenador

Para activar o desactivar un desencadenador, primero tendrá que hacer clic en él para ver sus detalles. Luego haz clic en el interruptor ubicado en la parte superior izquierda de la ventana.

Deshabilitar automáticamente un desencadenador en caso de fallo

Un desencadenador se deshabilita y se establece en estado de error si no puede iniciar el trabajo después de 11 intentos (~ 34 horas) para un solo evento o si el trabajo no se inicia para los últimos 100 eventos.

Los 10 reintentos para cada evento se realizan con una estrategia de retirada exponencial. Cada reintento posterior ocurre después de un retraso dos veces más largo que el intento anterior.

Cambiar el nombre de un desencadenador

Siga los pasos a continuación para cambiar el nombre de un desencadenador:

1. Accede a la pestaña Desencadenadores .

2. Mantenga el cursor del ratón sobre el nombre del desencadenador que desea modificar y ahora debería ver el botón Editar .

   Nota: Como alternativa, puede seleccionar su desencadenador de la lista para acceder a la vista detallada. El botón Editar se encuentra a la derecha del nombre de su desencadenador.
3. Haga clic en el botón Editar y podrá elegir un nuevo nombre para su desencadenador.

Limitaciones

Actualmente no exponemos las API de Integration Service a través de Swagger.