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.

Información general

Hay dos tipos de desencadenadores de eventos basados en las conexiones de Integration Service:

• Conectado : creado con actividades de desencadenador en Studio, utilizado dentro de un proceso.
• Desconectado : creado en Orchestrator o Integration Service, utilizado para iniciar cualquier automatización.

Nota: los desencadenadores dependen de las conexiones. Al eliminar una conexión también se eliminan todos los desencadenadores asociados.

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

Crear desencadenadores

Los desencadenadores de eventos desconectados se crean directamente desde Orchestrator. Para obtener más información, consulta la sección Desencadenadores de eventos en la guía de usuario de Orchestrator.

Orchestrator proporciona una gestión directa de estos desencadenadores. En Integration Service, tu única opción para la modificación del desencadenador es ajustar el intervalo de sondeo, que se establece en el nivel de conexión.

Actualizar el intervalo de sondeo

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

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

El intervalo de sondeo se establece en el nivel de conexión. Esto significa que solo puedes tener un intervalo de sondeo por conexión, aunque crees varios desencadenadores 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.

Para actualizar el intervalo de sondeo:

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.

   El intervalo de sondeo solo se muestra para las conexiones con desencadenadores añadidos.

3. Selecciona el intervalo de tiempo para abrir la ventana Actualizar intervalo de sondeo .

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

5. Selecciona Actualizar y comprobar.

Ver el historial de ejecución del desencadenador

Importante: La tabla del historial de intentos está disponible exclusivamente para los desencadenadores creados en Integration Service y enumerados en la pestaña Desencadenadores . El historial de intentos no está disponible para los desencadenadores creados en Orchestrator.

Para ver el historial de ejecución del desencadenador:

1. En Integration Service, selecciona la pestaña Desencadenadores .
2. Para cualquier desencadenador de la lista, selecciona Ver desencadenador utilizando el Menú Más acciones:

La tabla del historial de intentos muestra:

• La hora del evento: cuándo se capturó el evento
• El número de intentos
• El estado del desencadenador: si el proceso se inició correctamente o no.

Nota: el estado Correcto solo indica que el trabajo se ha iniciado correctamente. No refleja si el trabajo se ejecutó correctamente hasta el final o no. En caso de que un trabajo no se inicie, su estado aparecerá como Fallido. Mantén el puntero del ratón sobre el estado Error para ver el mensaje de error.

Para comprobar si un trabajo se ha ejecutado correctamente, selecciona el botón Ver registros de trabajo . Esta acción te redirige a Orchestrator, donde puedes ver toda la información necesaria sobre la ejecución del trabajo.

Administrar desencadenadores

Las siguientes acciones están disponibles para los desencadenadores creados en Integration Service.

Los desencadenadores creados directamente en Orchestrator pueden gestionarse desde Orchestrator.

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 .
   Alternativamente, puedes seleccionar tu desencadenador de la lista para acceder a la vista detallada. El botón Editar se encuentra a la derecha del nombre del desencadenador.
3. Selecciona el botón Editar y podrás elegir un nuevo nombre para tu desencadenador

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.

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.

Argumentos del evento

Los desencadenadores desconectados te permiten recuperar datos sobre el conector y el evento que desencadena un proceso.

Si quieres conocer el conector, evento, tipo de registro o registro real que desencadenó el proceso en tu flujo de trabajo, define los siguientes argumentos de entrada de tipo String en tu proceso. Integration Service los rellena automáticamente cuando inicia el trabajo:

• UiPathEventConnector : determina qué conector inició la automatización.
• UiPathEvent : determina el tipo de evento que se ha producido.
• UiPathEventObjectType : define el tipo de registro específico resultante del evento.
• UiPathEventObjectId : proporciona el identificador único para el objeto implicado en el evento.

No puede asignar ningún valor a estos argumentos. Se rellenan automáticamente en el momento de la ejecución del desencadenador y no se pueden ver ni editar desde el panel Argumentos en Studio. Obtén más información sobre cómo funcionan los argumentos y cómo gestionarlos en la documentación de Studio: Gestionar argumentos.

Para recuperar y trabajar con un registro que tiene un desencadenador en una ejecución de trabajo, utiliza 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 a los registros de Orchestrator:

Salidas específicas del desencadenador

Los desencadenadores conectados tienen salidas específicas del objeto. Por ejemplo, el desencadenador Microsoft OneDrive & SharePoint Correo electrónico recibido de genera un objeto de tipo Office365Message, con propiedades como AttachmentsNamesList, FromAddress, , InternetMessageId, SentDateTime etc. Para obtener más información, consulta EventosMicrosoft OneDrive & SharePoint .

Utiliza el Editor de expresiones en Studio para ver todas las propiedades disponibles para cualquier objeto de salida de desencadenador.

Limitaciones

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