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.

Desencadenadores en Orchestrator

Importante:

A partir de finales de abril de 2025, puedes crear nuevos desencadenadores de Integration Service solo en Orchestrator.

Los desencadenadores creados en Orchestrator no aparecerán en la pestaña Desencadenadores de Integration Service. Los desencadenadores de Integration Service existentes seguirán ejecutándose y permanecerán visibles en la pestaña Desencadenadores de Integration Service hasta el 31 de julio de 2025 (esta fecha está sujeta a posibles extensiones). Después de esta fecha, los desencadenadores de Integration Service existentes se migrarán a Orchestrator y se eliminará la pestaña Desencadenadores en Integration Service.

Este cambio está programado para estar disponible primero para los usuarios de Community, y luego para los usuarios de Enterprise de forma progresiva, dependiendo de la organización y las regiones del tenant. Sigue la guía de notas de la versión de Integration Service para saber cuándo se anuncia el cambio por primera vez.

Ventajas clave de los desencadenadores en Orchestrator

Mover los desencadenadores de Integration Service a Orchestrator es un gran cambio, pero tiene muchas ventajas. Estas son las razones principales que impulsan esta actualización:

1. Asignación cuenta-máquina: Orchestrator permite el control a nivel de máquina sobre los procesos desencadenados por Integration Service.
2. Control de ejecución de procesos específico de bot: Orchestrator te permite especificar qué robot debe ejecutar un proceso en una carpeta donde se asignan varios bots. Esto proporciona un control preciso sobre qué bot ejecuta un proceso desencadenado, elimina la necesidad de soluciones alternativas como carpetas de un solo bot y mejora la escalabilidad al permitir múltiples bots sin perder el control de la ejecución.
3. Argumentos de entrada y asignación dinámica de procesos: Orchestrator habilita los argumentos de entrada dinámicos y te permite definir el número máximo de instancias de proceso activas. Esto reduce la duplicación de procesos al permitir argumentos dinámicos, optimiza el uso de recursos al limitar los procesos activos y mejora la eficiencia de los procesos que gestionan las solicitudes de forma secuencial.
4. Gestión mejorada de procesos de larga duración: los desencadenadores creados en Orchestrator admiten las opciones "Detener después de" y "Eliminar después de", lo que permite la terminación automática de procesos después de una duración o condición especificada. Esto evita el uso excesivo de recursos al finalizar los procesos de larga duración y garantiza la ejecución oportuna al detener los flujos de trabajo que no responden.
5. Capacidades de edición: Orchestrator te permite editar desencadenadores existentes.
6. Experiencia de desencadenador unificada: crea y gestiona todos los tipos de desencadenadores desde una ubicación.
7. Vista de desencadenador único: mover la creación de desencadenadores a Orchestrator garantiza que todos los desencadenadores basados en Integration Service conserven una vista única. Ahora puedes crear un desencadenador basado en Integration Service de dos maneras: desde Integration Service, creando un desencadenador para un conector específico, y desde Studio, utilizando una actividad de desencadenador para iniciar una automatización. La información de configuración que se muestra para los dos desencadenadores puede diferir ligeramente, aunque capturen el mismo evento.

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 selecciona 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 continuación, selecciona el Proceso a ejecutar.

7. Selecciona la licencia de tiempo de ejecución (el tiempo de ejecución 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. 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á 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 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

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

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