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, 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
  • 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.

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 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 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. 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. Selecciona el botón Añadir desencadenador para crear tu 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érico, que representa las operaciones típicas de creación, actualización y eliminación. Cuando seleccionas un evento genérico, también debes definir el registro de eventos 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.

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. 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.

   
   

   

   
   

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. Selecciona el intervalo que se encuentra bajo el 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 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 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 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. Accede a la pestaña Desencadenadores .

2. Pasa el cursor del ratón sobre el nombre del desencadenador que deseas modificar. Se mostrará 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. 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

Esta sección enumera las limitaciones conocidas de los desencadenadores de Integration Service.

Limitación máxima de registros

Descripción

Los desencadenadores de Integration Service tienen actualmente un límite máximo de 1000 registros por ejecución de desencadenador. Si un desencadenador intenta recuperar más de 1000 registros dentro del intervalo de tiempo configurado (por ejemplo, un minuto o cinco minutos) y el sistema del proveedor emite más registros que este límite, los registros que superen el umbral no se capturan y pueden perderse.

Repercusión

Esta limitación puede afectar a los flujos de trabajo o automatizaciones que requieren el procesamiento de grandes conjuntos de datos, ya que el desencadenador puede no recuperar todos los registros.

Solución

Estamos trabajando activamente para abordar esta limitación. Hasta entonces, para minimizar el impacto, puedes configurar el intervalo de activación con la duración mínima posible, como se explica en Intervalo de sondeo. El aumento de la frecuencia de ejecución del desencadenador garantiza que todos los registros se capturen en varias ejecuciones de desencadenadores.

Desactivación automática de desencadenadores

Si un desencadenador encuentra 100 errores consecutivos causados por problemas en aplicaciones de terceros durante el sondeo de eventos nuevos o actualizados, el sistema deshabilita automáticamente el desencadenador. Este mecanismo ayuda a mantener la estabilidad del sistema.

Cuando uno de tus desencadenadores esté deshabilitado, recibirás una notificación por correo electrónico. Debes volver a habilitar manualmente el desencadenador después de que se haya solucionado el problema subyacente que causa los errores.

Editar desencadenadores

Actualmente no se admite la edición de un desencadenador existente. Las únicas opciones para la gestión de desencadenadores son crear o eliminar desencadenadores. Para cualquier cambio deseado, debes eliminar el desencadenador existente y añadir uno nuevo.