Creación de una regla en Fabric Activador

Al incorporar datos de streaming a un activador o asignar eventos a objetos, puede crear reglas para actuar en los datos. La activación de esas reglas puede ser el envío de una notificación, como un correo electrónico o un mensaje de Teams. La activación de esas reglas también puede desencadenar un flujo de trabajo, como iniciar un flujo de Power Automate.

Las reglas del activador también pueden desencadenar acciones basadas en eventos de Fabric y eventos de Azure Blob Storage recibidos a través de Eventstream, lo que permite la orquestación impulsada por eventos. Por ejemplo, puede iniciar trabajos de Spark o flujos de datos cuando los archivos llegan a un contenedor de blobs. Para obtener más información sobre cómo conectar orígenes de eventos, vea Agregar un destino de Fabric Activator a un eventstream.

Requisitos previos

• Un área de trabajo con una capacidad habilitada para Microsoft Fabric.

Abrir activador

Comience abriendo Fabric en el explorador.

En el panel de navegación, seleccione Crear>Activador. Si no ve Crear, seleccione los puntos suspensivos (...) para ver más opciones.

Seleccione Probar ejemplo para crear un activador que esté rellenado previamente con eventos y objetos de ejemplo.

Definición de una condición de regla y una acción

Use Reglas para especificar los valores que desea supervisar en los eventos, las condiciones que desea detectar y las acciones que desea que realice Activator.

Selección de los datos de regla

En el Explorador de Activator, seleccione la propiedad o el flujo de eventos que se van a supervisar en la regla. Para obtener información sobre las propiedades, consulte la sección Crear propiedades .

Después de seleccionar una propiedad o una secuencia de eventos, verá una vista previa de los valores de un ejemplo de las instancias del objeto.

Haz una nueva regla de activador

Para crear una nueva regla, seleccione el flujo que acaba de agregar. Verá un panel Crear regla en el lado derecho. La sección Supervisión de la regla se rellena automáticamente con el flujo de datos que seleccionó.

Definición de la condición que se va a detectar

A continuación, elija el tipo de condición que desea detectar. Puede usar condiciones que comprueban:

• En cada evento, realice una acción.
• En cada evento cuando se cumple un valor, realice una acción.
• En cada evento agrupado por un campo, realice una acción (por ejemplo, en cada evento PackageId cuando Temperature sea mayor que 30)

Por último, seleccione si desea que la acción le envíe un correo electrónico o envíe un mensaje de Teams y seleccione Crear. Puede modificar las condiciones y acciones posteriores.

Los gráficos de la pestaña Definición se actualizan para mostrar un ejemplo de los eventos que cumplen las condiciones establecidas.

Si va a la pestaña Análisis , verá dos gráficos. El primer gráfico muestra el número total de veces que se activó la regla, para todos los identificadores de objeto que Activator está siguiendo. Use este gráfico para comprender el volumen de notificaciones que se activaron sobre todos los id. de objeto. En el segundo gráfico se muestra el número total de veces que se activó la regla para los cinco identificadores de objeto. Use este gráfico para comprender mejor si los identificadores de objeto concretos contribuyen más a todas las activaciones que se activan.

Definición de la acción que se realizará

Por último, use la sección Acción para elegir qué hacer cuando se detecte la condición.

Estos son los tipos de acción admitidos:

• Correo electrónico : envíe un correo electrónico a los destinatarios especificados.

• Teams : envíe un mensaje de Teams a destinatarios, chat grupales o canales especificados.

• Elemento de Fabric: ejecute la canalización de Fabric seleccionada, el cuaderno de Fabric, la definición de trabajo Spark de Fabric, el flujo de datos de Fabric o la función de datos de usuario de Fabric. Use estas acciones para implementar canalizaciones controladas por eventos. Para obtener más información, vea Trigger Fabric items.

• Acción personalizada: activar un flujo de Power Automate.

Los distintos tipos de acción tienen parámetros diferentes. Algunos de esos parámetros incluyen la dirección de correo electrónico a la que quiere enviar, el canal de Teams o el chat de grupo, el flujo de trabajo que desea iniciar, la línea de asunto o información adicional (contexto). En Contexto, puede seleccionar las propiedades adicionales que se van a incluir en el mensaje de alerta.

También puede etiquetar propiedades escribiendo @ para agregar contexto a las acciones que envíe. Por ejemplo: @bikeId.

Si realiza un resumen en la propiedad de la tarjeta Monitor, la acción envía el valor original de la propiedad en lugar del valor resumido.

Seleccione Editar acción para ver un editor con una vista previa del mensaje que la acción envía y opciones para agregar más información a la acción.

Probar la regla

Después de crear una regla, pruébela seleccionando Enviar una alerta de prueba. Al seleccionar este botón se busca un evento pasado para el que la activación de la regla es true y se le envía una alerta para que pueda ver cómo es la alerta para ese evento.

• La alerta de prueba siempre te llega a ti, independientemente del campo del destinatario en la tarjeta Acción.
• La opción Enviar una alerta de prueba solo está habilitada si tiene al menos un evento pasado para el que se cumple la condición de la regla.

Inicio y detención de la regla

Las reglas se crean en un estado Detenido. Este estado significa que el sistema no está evaluando la regla a medida que los datos fluyen al sistema y la regla no realiza ninguna acción como resultado. Después de definir la regla, seleccione Guardar e inicie para activar la regla. Si no está listo para iniciar la regla, guárdela y vuelva más tarde. Cuando esté listo, seleccione Iniciar en la barra de herramientas de Activator para empezar a ejecutar el desencadenador y tomar medidas.

Una vez iniciada, verá En ejecución en el área de título de la tarjeta de regla. Además, el icono del Explorador muestra que la regla se está ejecutando. Al iniciar la regla, las nuevas activaciones comienzan a ejecutarse con nuevos datos ingeridos. La regla no se activa en los datos que ya se han incorporado. Para detener la alerta, seleccione Detener.

Si realiza cambios en la regla (por ejemplo, cambia la condición que busca), seleccione Actualizar en la barra de herramientas para asegurarse de que la regla en ejecución usa los nuevos valores.

Al eliminar una regla (o un objeto), puede tardar hasta cinco minutos en completarse cualquier procesamiento de datos de back-end. Es posible que las reglas eliminadas sigan supervisando los datos y realicen acciones en consecuencia, durante unos minutos después de eliminarlos.

Crear propiedades

A veces, debe reutilizar la lógica de reglas en varias reglas. Cree una propiedad para definir una condición o medida reutilizables y, a continuación, haga referencia a esa propiedad desde varias reglas.

Para crear una propiedad, seleccione la secuencia que agregó al objeto que le interesa, seleccione Nueva propiedad en la cinta de opciones y, a continuación, seleccione la propiedad que desea usar en la lógica de reglas.

Después de definir una propiedad, puede hacer referencia a ella desde una o varias reglas. En este ejemplo, se hace referencia a la propiedad TemperatureDemasiado caliente para la medicina.

Limpieza de recursos

Para eliminar la secuencia de eventos de ejemplo, seleccione los puntos suspensivos (...) a la derecha de la secuencia Eventos de entrega de paquetes y, a continuación, Eliminar.

Paso siguiente

Contenido relacionado

• Información General sobre las Reglas de Activator
• Tutorial de Activator