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.

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 Non-production en tu instancia de Orchestrator.
• Está utilizando carpetas modernas (los procesos dentro de las carpetas clásicas no son visibles al definir los desencadenadores).
• Los usuarios que trabajan con desencadenadores tienen los permisos necesarios en Orchestrator. Para crear un desencadenador, un usuario debe tener el permiso Desencadenadores : Crear en la carpeta de destino. Para obtener más información sobre los permisos, consulta Configurar el acceso para las cuentas en la guía del usuario de Orchestrator.

Cómo funcionan los desencadenadores

Los desencadenadores basados en sondeos, como Registro creado o Incidente creado, están disponibles para varios conectores de UiPath. Este tipo de desencadenador detecta nuevos registros utilizando un mecanismo de sondeo en las API públicas de la aplicación de destino.

Los desencadenadores funcionan de la siguiente manera:

1. Intervalo de sondeo : Integration Service sondea el sistema de destino a un intervalo establecido (de forma predeterminada, cada cinco minutos). El intervalo de sondeo se establece en el nivel de conexión, por lo que cambiar el intervalo de sondeo afecta a todos los desencadenadores asociados a esa conexión.

2. Detección basada en API : durante cada ciclo de sondeo, Integration Service consulta el objeto/tabla relevante utilizando las API REST estándar del proveedor.

3. Identificación incremental de registros : los nuevos registros se identifican utilizando los parámetros de consulta de la API, más comúnmente basados en:

   • Marca de tiempo de creación de registros (por ejemplo, sys_created_on)
   • En algunos escenarios, las marcas de tiempo de modificación

   Integration Service almacena la marca de tiempo de creación más reciente (o marcador equivalente) del último ciclo de sondeo exitoso. En el siguiente sondeo, la consulta se reanuda a partir de ese valor almacenado, lo que garantiza la continuidad y evita el procesamiento duplicado.

   Por ejemplo, una consulta para sondear nuevos incidentes en ServiceNow podría tener el siguiente aspecto: GET https://{instance}.service-now.com/api/now/v1/table/incident?sysparm_query=sys_created_on>={last_max_created_date}

   Nota:

   Se pueden incluir parámetros adicionales como paginación, límites, desplazamientos o expansión de campo para admitir el filtrado y la configuración de datos. Estos no cambian la lógica de sondeo del núcleo.

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 a 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 se muestra solo 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

Para ver el historial de ejecución del desencadenador:

1. En Integration Service, selecciona la pestaña Desencadenadores .
2. Para cualquier desencadenador enumerado, selecciona Ver desencadenador usando 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 Fallido 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.

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

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.

Nota:

Esto se aplica solo a los desencadenadores desconectados. Para los desencadenadores conectados, debes tener todo el objeto ya disponible cuando diseñes tu proceso.

No se 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 de objetos. Por ejemplo, el desencadenador Correo electrónico recibido de Microsoft OneDrive & SharePoint genera un objeto de tipo Office365Message, con propiedades como AttachmentsNamesList, FromAddress, InternetMessageId, SentDateTime etc. Para obtener más información, consulta Eventos de Microsoft OneDrive y SharePoint.

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

Preguntas frecuentes

Si se interrumpe una conexión, ¿qué sucede con los desencadenadores asociados a esa conexión?

Si una conexión se desconecta, los desencadenadores asociados dejarán de ejecutarse temporalmente. Una vez que la conexión se vuelva a conectar con éxito, los desencadenadores reanudarán automáticamente la ejecución. Como paso adicional, asegúrate de que el desencadenador no está en estado deshabilitado.

Para desencadenadores desconectados, ¿cómo puedo asociar la salida del desencadenador con mi proceso?

Consulta la sección Argumentos de evento para obtener más información sobre cómo recuperar datos sobre el conector y el evento que desencadena un proceso.

Utilizando el argumento UiPathEventObjectId , puedes añadir una llamada de actividad Obtener registro o HTTP en tu proceso para obtener los datos de registro correspondientes.

Nota:

Esto se aplica solo a los desencadenadores desconectados. Para los desencadenadores conectados, debes tener todo el objeto ya disponible cuando diseñes tu proceso.

¿Cómo puedo cambiar el intervalo de sondeo para mi desencadenador?

Puedes modificar el intervalo de sondeo directamente desde la configuración del desencadenador. Consulta esta guía para conocer los pasos detallados: Actualizar el intervalo de sondeo.

¿Puedo filtrar qué registros desencadenan mi automatización?

Sí. Puedes añadir filtros de datos (para conectores que lo admitan) para controlar qué registros inician tu proceso en última instancia.

Nota:

Los filtros se aplican después de que Integration Service obtenga los registros.

Por ejemplo:

• Crea un filtro en Studio Web:

  

• Crea un filtro en Orchestrator:

  

¿Por qué mi desencadenador no se activa inmediatamente?

El tiempo de ejecución del desencadenador puede variar en función del tipo de desencadenador, el volumen de datos y la disponibilidad del robot.

Para desencadenadores basados en sondeos:

• El desencadenador obtiene registros nuevos o actualizados en función del intervalo de sondeo configurado en Integration Service.

• Dependiendo del volumen de datos recuperados, Integration Service aplica cualquier filtro definido o condición de desencadenador antes de pasar eventos de calificación a Orchestrator.

• Este procesamiento puede introducir una latencia menor, especialmente cuando se manejan grandes conjuntos de datos o filtros complejos.

• Una vez que los eventos se transfieren a Orchestrator, la automatización se inicia solo si hay un robot desatendido disponible en ese momento.

• Si el intervalo de sondeo se establece demasiado largo, se puede recuperar un gran volumen de datos a la vez, lo que puede ralentizar el proceso. En tales casos, considera reducir el intervalo para mejorar el rendimiento.

  Nota:

  Si tu desencadenador aparece retrasado, comprueba tu intervalo de sondeo, revisa la eficiencia de los filtros y asegúrate de que un robot desatendido esté disponible para ejecutar el trabajo.

Para desencadenadores basados en webhook (por ejemplo, HTTP Webhook):

• Los desencadenadores de Webhook están diseñados para activarse casi al instante, ya que la aplicación externa envía los eventos directamente a Integration Service.
• Dado que los webhooks suelen gestionar un registro por transacción, la latencia es mínima.
• Sin embargo, si se aplican filtros de desencadenador o lógica de procesamiento antes de que el evento se transfiera a Orchestrator, es posible que observes un pequeño retraso.

¿Cómo soluciono un problema de un desencadenador que no se activa?

• Comprueba que la conexión asociada está activa.
• Comprueba que el desencadenador está habilitado.
• Verifica si tu conexión requiere un ámbito o rol específico para acceder al punto final de la API de destino que se está sondeando.
• Confirme que el filtro coincide con los datos esperados.
• Para desencadenadores de webhook, confirma que el registro de webhook es válido en la aplicación externa.

¿Cuándo un desencadenador recoge registros por primera vez?

La primera ejecución de un desencadenador comienza en el momento en que se crea el desencadenador.

Los registros creados antes de la creación del desencadenador no se recogen y todos los registros creados/actualizados después de la marca de tiempo de creación del desencadenador son elegibles para su procesamiento según los filtros del 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.