Crear un desencadenador

Puedes crear un desencadenador como parte de un conector personalizado. Puedes utilizar desencadenadores de conectores personalizados para iniciar automáticamente automatizaciones o procesos basados en eventos del proveedor.

Cómo funciona

Los desencadenadores del Creador de conectores utilizan el sondeo de recursos para detectar cambios de proveedor. El sondeo de recursos implica llamar a un recurso de la API en un intervalo regular para detectar cuándo se devuelven nuevos eventos.

Una vez que se publica un conector personalizado y se utiliza el desencadenador en una automatización publicada, la URL definida se utiliza como recurso de sondeo para recuperar eventos e iniciar un flujo de automatización.

Detectar nuevos eventos

La URL de sondeo del desencadenador debe incluir parámetros de consulta para filtrar los resultados del proveedor.

El sondeo se produce en un intervalo programado (cada 5, 10, 15 minutos, etc.). Por lo tanto, uno de los parámetros de consulta del proveedor debe ser una fecha para filtrar los resultados. De esta manera, el motor de sondeo puede rellenar el valor del parámetro de consulta para incluir solo los eventos que ocurrieron desde la última hora de sondeo.

Limitaciones

• Puedes crear un desencadenador por recurso. Si se necesita más de un caso de uso, utiliza una URL de sondeo más general y configura campos de filtro de respuesta que puedan cumplir con múltiples casos de uso.

• Las API de proveedor deben permitir el filtrado de parámetros de consulta basados en fechas. Si el proveedor no dispone de parámetros de consulta basados en fechas, no debe utilizarse como desencadenador.

Requisitos previos

Requisitos del proveedor

La API del proveedor debe ofrecer un recurso con un punto final GET que devuelva una lista de objetos. Además, el punto final debe permitirte consultar el recurso en función de un parámetro de fecha.

Ejemplo de un recurso válido

Pipedrive ofrece un punto final Obtener todas las actividades , que devuelve una colección de actividades. Este punto final incluye un parámetro de consulta since que filtra los resultados por todas las actividades con una fecha update_time posterior a la fecha since proporcionada como valor para el parámetro de consulta. Puedes utilizar el parámetro since como parte de la URL de sondeo para detectar cualquier actualización de las actividades de Pipedrive. El motor de sondeo de UiPath rellena automáticamente este campo de fecha para capturar eventos.

Requisitos del conector

Los desencadenadores del Creador de conectores utilizan recursos que ya están disponibles en el conector como URL de sondeo. Al crear un nuevo desencadenador, debe haber un recurso existente en el lado del conector al que asociar el desencadenador.

Los desencadenadores utilizan la configuración del recurso, por lo que es importante que el recurso existente ya tenga:

• Parámetros de consulta: los desencadenadores pueden importar parámetros de consulta existentes, por lo que el recurso ya debería tener algunos parámetros configurados antes de crear el desencadenador.

• Campos de respuesta: desencadena el objeto de respuesta del recurso asociado, además de permitir la configuración de la actividad basada en estos campos. Es necesario generar los campos de respuesta para el recurso llamando correctamente al punto final.

Crear un desencadenador personalizado

Para crear un desencadenador en el Creador de conectores, sigue estos pasos:

Agregar un desencadenador

1. En primer lugar, asegúrate de cumplir los requisitos previos.
2. En Integration Service, abre el Generador de conectores y selecciona tu conector personalizado.
3. Selecciona Más opciones junto a Desencadenadores.
4. Selecciona Añadir desencadenador.

Establecer el nombre y el recurso

Se mostrará la ventana emergente Crear evento . Aquí puedes seleccionar qué tipo de evento crear. Actualmente, Sondeo es la única opción disponible.

1. Selecciona el tipo de evento.
2. Añade un nombre para tu desencadenador.
3. Selecciona el recurso utilizado para detectar estos eventos.
4. Selecciona Crear para iniciar el proceso de configuración de tu desencadenador.

Configurar el desencadenador

El proceso de creación de un desencadenador consta de tres pasos:

1. Configurar solicitud.
2. Configurar respuesta.
3. Configurar filtros de desencadenador.

Estos pasos corresponden al proceso de sondear una URL de recurso y trabajar con la respuesta.

Consejo: Utiliza la funcionalidad Probar desencadenador durante todo el proceso de configuración del desencadenador para asegurarte de que funciona como se espera.

Configurar solicitud

En primer lugar, configura cómo se configura la URL de sondeo y cómo se muestra el desencadenador en Studio cuando se utiliza en una automatización.

El diseño de vista previa representa cómo se muestra el desencadenador en Studio. Puedes configurar los parámetros y los campos de respuesta para cambiar los campos que ves y utilizas en Studio al configurar el desencadenador de una automatización.

URL de sondeo

La URL de sondeo se muestra en la parte superior de la página de configuración. Esta es la URL utilizada para realizar solicitudes al proveedor para detectar nuevos eventos.

Esta URL debe configurarse de forma que filtre los eventos de interés. La URL de sondeo utiliza un parámetro de fecha para filtrar los nuevos eventos desde la última solicitud de sondeo. Es obligatorio incluir un parámetro de fecha que el motor de sondeo pueda rellenar.

Importar parámetros

Los desencadenadores pueden importar parámetros de recursos para utilizarlos en la URL de sondeo.

Si un parámetro no está disponible en el recurso, navega hasta el recurso y añádelo, luego vuelve a la ventana de configuración del desencadenador para importarlo.

1. Selecciona Importar parámetros para ver la lista de parámetros disponibles para un recurso específico.
2. Selecciona el parámetro que deseas utilizar en la URL de sondeo.
3. Una vez añadido un parámetro, se incluye en la vista previa de la URL en la parte superior de la página.

Puedes marcar los parámetros importados como Requeridos para que se muestren en el lienzo del desencadenador. Esto significa que debes introducir un valor para el parámetro de consulta al utilizar el desencadenador en una automatización.

Importante: Se necesita al menos un parámetro de consulta basado en fechas para la URL de sondeo. Un parámetro de consulta basado en fechas es cualquier parámetro con un formato DateTime . Los formatos DateTime se pueden encontrar para un parámetro con un tipo de datos de proveedor String o Integer .

A menos que se especifique un valor de fecha específico, los parámetros de consulta basados en fechas se rellenan automáticamente con un valor igual al de la fecha y hora de la solicitud de sondeo anterior.

Probar desencadenador

Utiliza la opción Desencadenador de prueba para asegurarte de que se devuelven los resultados esperados.

Al seleccionar Desencadenador de prueba, se muestra la ventana Probar la solicitud , que muestra:

• Periodo retrospectivo: este campo define qué fecha debe insertarse en los parámetros de consulta basados en fechas y replica el comportamiento de nuestro motor de sondeo, que rellena automáticamente este valor en función de la fecha de la última solicitud de sondeo.
• Los parámetros de consulta especificados como necesarios.

Selecciona Intentar solicitud para abrir el panel Depuración de eventos y ver el seguimiento de la solicitud con un desglose paso a paso del proceso de solicitud. También se muestra el número de resultados devueltos.

Nota: Comprueba que el número de resultados devueltos es el número de resultados esperado. El uso incorrecto de los parámetros de consulta puede dar lugar a un alto nivel de objetos de salida y al uso innecesario de UiPath Robot una vez publicado el conector y utilizado el desencadenador en un flujo de trabajo.

Se recomienda tener expectativas de respuesta (número de eventos, tipos de eventos, etc.) al probar un desencadenador para comprobar que los filtros de los parámetros de consulta funcionan como se espera.

Configurar respuesta

En este paso, se especifica qué campo de respuesta corresponde a la Clave principal o a la salida del desencadenador.

1. Utiliza la lista desplegable bajo Clave principal para seleccionar un campo.
2. El campo seleccionado se añade a la vista previa del desencadenador, en Salida. Puedes utilizar esta salida en pasos posteriores de tu flujo de trabajo.

El paso Configurar respuesta también proporciona una vista del objeto de respuesta asociado al recurso de sondeo para su revisión.

Configurar filtros de desencadenador

Una vez que configures la solicitud y la respuesta, puedes configurar aún más el desencadenador utilizando filtros.

El filtrado de eventos se configura estableciendo valores específicos para los campos de respuesta. Estos valores se especifican durante la configuración de la automatización (en Studio), pero el diseñador de desencadenadores también te permite configurar qué campos se muestran para el filtrado.

Hidratación

Si el recurso utilizado como URL de sondeo no devuelve el objeto completo necesario para la salida del desencadenador, es posible hidratar la respuesta utilizando un punto final GETBYID . Este proceso se conoce como hidratación.

Selecciona la pestaña Hidratación , activa el botón de alternancia Usar hidratación y especifica el punto final que se utilizará para la hidratación, y el ID utilizado para consultar el objeto.

Nota: La lista de posibles recursos de hidratación se extrae de la lista Obtener registros en el panel de navegación de la izquierda. Configura el recurso GETBYID antes de utilizarlo como recurso de hidratación para un desencadenador.

El uso de la hidratación reemplaza los campos de respuesta de los campos de recursos de respuesta de sondeo con los campos de respuesta de recursos hidratados. A continuación, los campos de respuesta de hidratación se convierten en los únicos campos disponibles para los parámetros de desencadenador y la configuración de filtros.

Filtros

El proceso de configuración del desencadenador ofrece tres opciones para mostrar los campos utilizados para el filtrado. Estos campos se extraen de los campos de respuesta de recursos del recurso de sondeo o del recurso de hidratación. Estas opciones están disponibles en la columna Mostrar como de la tabla Parámetros de filtro :

• Oculto: el campo está oculto en el lienzo y no está disponible en el Creador de filtros. Si todos los campos están marcados como Ocultos, el creador de filtros también estará oculto.

• Opcional: en tiempo de diseño, el campo se muestra como una opción en el Creador de filtros.

• Obligatorio: en tiempo de diseño, el campo se muestra directamente en el lienzo del desencadenador y requiere la entrada del usuario. Solo los eventos con un valor de campo de respuesta que coincida con el valor proporcionado dan como resultado un evento de automatización.

Guardar el desencadenador

Cuando termines de configurar el filtro, selecciona el botón Guardar . Una vez guardado, el desencadenador se incluirá como evento cuando se publique el conector.

Uso del desencadenador

Una vez que se guarda un desencadenador y ya no está en modo borrador, el desencadenador está disponible para su uso tan pronto como publique su conector personalizado.