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

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

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.

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.