Introducción
Este módulo describe cómo puede ampliar la funcionalidad de los conectores personalizados con definiciones de desencadenadores.
Contenido del módulo:
Obtener más información sobre los desencadenadores en conectores personalizados.
Descubrir escenarios comunes en los que se pueden utilizar desencadenadores.
Identificar los diferentes tipos de desencadenadores.
Obtenga información sobre cómo extender una definición de conector personalizado a los desencadenadores definidos mediante una API de servicio.
Los desencadenadores le permiten ampliar la funcionalidad del conector en Microsoft Power Automate y Microsoft Azure Logic Apps, cuando un sistema necesite responder a los cambios en los datos o servicios subyacentes. El escenario más común de uso de los activadores es la creación de un flujo de nube que comienza cuando cambian los datos subyacentes, como "Cuando se crea un registro" o cuando se produce un evento determinado en el servicio definido mediante el conector personalizado, como "Cuando se activa una alarma".
Desencadenadores en Power Automate y Logic Apps
Power Automate y Logic Apps definen un desencadenador como un evento que inicia un flujo de nube o un flujo de trabajo de Logic Apps. Estos eventos puede iniciarlos un usuario, pueden programarse o puede generarlos un conector, incluido uno personalizado. Las definiciones de desencadenadores amplían los conectores personalizados y permiten que estos conectores se utilicen para iniciar flujos de nube y flujos de trabajo de Logic Apps.
La mayoría de los conectores definen un resumen de desencadenadores como "Cuando <object> es <verb>", y una implementación de conector típica incluye un desencadenador para una o más acciones.
Tipos de desencadenadores
Considere un sistema de administración de correo de voz. Un desencadenador en dicho sistema podría ser un evento de "nuevo mensaje de correo de voz recibido". Existen dos formas de definir un método para identificar si se ha recibido un nuevo correo de voz:
Llamar periódicamente al buzón de mensajes de voz y comprobar si hay mensajes nuevos. Este comportamiento describe un desencadenador de sondeo, es decir, la implementación donde se sondean los datos del servicio subyacente. Un desencadenador de sondeo es una actividad temporizada que inicia una llamada a la API de servicio en un intervalo configurable y regular para determinar si hay nuevos datos disponibles. Para apoyar a los desencadenadores de sondeo, la API puede filtrar los resultados según un estado. El estado se basa comúnmente en el tiempo, por ejemplo, "Devolver todos los mensajes de voz recibidos desde ayer".
Hacer que el sistema de correo de voz le envíe un correo al recibir un nuevo mensaje de voz. Este enfoque define un desencadenador o implementación webhook, donde el servicio introduce los datos. El servicio que apoya a los desencadenadores webhook debe poder mantener una lista de partes a las que devolver llamadas y saber cómo devolver las llamadas. En el ejemplo del correo de voz, sería una lista de direcciones de correo electrónico y la capacidad de enviar un correo electrónico de notificación.
Básicamente, estos dos tipos de desencadenadores difieren en lo relativo a qué lado es responsable de la gestión de operaciones.
| Sondeo | Webhook |
|---|---|
| Comienza estableciendo un estado | Registrado en el servicio |
| Comprueba periódicamente si hay actualizaciones | Señala cuando ocurre el evento |
| Solicita todos los nuevos datos desde la última actualización de estado | Se abandona automáticamente |
| El servicio mantiene el estado | Power Automate o Logic Apps gestiona el proceso de registro y la baja de webhooks |
Importante
La disponibilidad de una API de REST para un servicio no implica que sea posible definir desencadenadores de conectores personalizados. El servicio subyacente debe poder devolver los datos de forma incremental o proporcionar una implementación de webhook. Si se requieren desencadenadores pero la API del servicio no tiene esa capacidad, un desarrollador necesitaría ampliar el servicio para que los usuarios pudieran definir un desencadenador.
Definir un desencadenador
Al igual que con la definición de los conectores, ambos tipos de desencadenadores se definen mediante un documento OpenAPI (Swagger) que especifica los puntos de conexión, los parámetros, las condiciones y las respuestas. Sin embargo, la versión de la especificación de OpenAPI que utiliza Microsoft Power Platform no diferencia acciones y desencadenadores. Microsoft Power Platform agrega extensiones de OpenAPI personalizadas para ampliar las especificaciones para definir desencadenadores y sus contenidos.
Está disponible un asistente paso a paso para desencadenadores, que sigue el mismo diseño general que el asistente de acciones.
Al igual que con las acciones de conectores personalizados, es importante seleccionar un buen resumen de desencadenadores. El resumen se utiliza cuando un fabricante busca los conectores y, al seleccionarse un desencadenador, su resumen se convierte en el título de paso predeterminado en Power Automate y Logic Apps.
A diferencia de las acciones, la mayoría de las cuales pueden construirse por completo en el diseñador de conectores personalizados, los desencadenadores pueden ser más complejos y requerir a menudo modificaciones manuales. Este módulo describe cómo crear definiciones de desencadenadores en escenarios de sondeos y webhooks.