Tutorial: Creación y activación de una regla de Activador de Fabric

Fabric Activator en Microsoft Fabric permite realizar acciones cuando se detectan patrones o condiciones en flujos de datos. Si no está familiarizado con Fabric Activator, consulte ¿Qué es Fabric Activator? En este tutorial, usará los datos de ejemplo incluidos con Fabric Activator para completar las siguientes tareas:

Requisitos previos

Antes de empezar, necesita un área de trabajo con una capacidad de Fabric. Puede obtener información sobre las áreas de trabajo de Fabric en el artículo Áreas de trabajo. Si no tiene Fabric, se le pedirá que inicie una prueba.

Creación de un activador de ejemplo

1. Vaya al portal de Fabric.

2. En el panel de navegación izquierdo, seleccione los puntos suspensivos (...) y, a continuación, seleccione Crear.

   

3. En la página Crear, en la sección Inteligencia en Tiempo Real, seleccione Activador de datos.

   

4. En la página Activator , seleccione Probar ejemplo.

   

Exploración de los datos

En este paso, exploraremos los datos del flujo de eventos en los que se basa este ejemplo.

El nuevo activador tiene una sección Explorador. Desplácese hacia abajo y seleccione el flujo eventos de entrega de paquete.

Estos eventos muestran el estado en tiempo real de los paquetes que están en proceso de entrega.

Examine los eventos entrantes y mantenga el puntero sobre los datos del evento en la tabla activa. Cada punto de datos contiene información sobre el evento. Es posible que tenga que desplazarse para verlo todo.

Exploración de una regla

Use una regla para especificar los valores de evento que desea supervisar, las condiciones que desea detectar y las acciones que desea que realice Fabric Activator.

El panel Explorador muestra objetos, como secuencias de eventos, para este activador. Eventos de entrega: son uno de los objetos creados a partir de la secuencia Eventos de entrega de paquetes.

1. En el panel Explorador, seleccione el objeto denominado Eventos de entrega. Puede crear reglas sobre objetos que usan datos del flujo de eventos de entrega de paquetes. Por ejemplo, una regla que comprueba la temperatura de los paquetes.

   

2. Observe que la sección Eventos por identificador de objeto está organizada por id. de paquete. El identificador de paquete es el identificador de columna que identifica de forma única cada paquete. Usamos este identificador único para asignar los eventos de Paquete a objetos Paquete.

   

3. Seleccione la regla Temperatura llamada Demasiado caliente para el medicamento. En el panel más a la derecha, consulte el panel Definición para ver cómo funciona la regla.

   

4. En la sección Monitor, seleccione Temperatura. Los valores de temperatura proceden de la columna Temperatura de la tabla Eventos de entrega. Puede ver la columna Temperatura en una captura de pantalla anterior.

   

5. En la sección Condición , verá la condición de regla para supervisar las temperaturas superiores a 20 grados centígrados.

   

6. Desplácese más abajo hasta Filtro de propiedad. Nuestra regla solo se aplica a los paquetes que contienen medicamentos. En la tabla Eventos de entrega, la regla examina la columna denominada Contenidos de cuidado especial. En la columna Contenidos de cuidado especial, algunos de los paquetes tienen un valor de Medicamento.

   

7. Por último, desplácese hacia abajo hasta Acción. Elija una de las siguientes acciones si se cumple la condición:

   1. Enviar notificación por correo electrónico: Envía un correo electrónico a usted mismo o a otros usuarios de su organización.

      1. En Seleccionar acción, seleccione Enviar correo electrónico.
      2. En Para, escriba direcciones de correo electrónico de receptores o use la lista desplegable para seleccionar una propiedad cuyo valor es una dirección de correo electrónico. De forma predeterminada, el correo electrónico se rellena aquí.
      3. En Asunto, escriba el asunto de la notificación por correo electrónico.
      4. En Titular, escriba el titular de la notificación por correo electrónico.
      5. En Notas, escriba notas para la notificación por correo electrónico.

         Nota:

         Al escribir el asunto, el titular o las notas, puede hacer referencia a las propiedades de los datos escribiendo @ o seleccionando el botón situado junto a los cuadros de texto. Por ejemplo: @BikepointID.

      6. En Contexto, seleccione los valores de la lista desplegable que desea incluir en la notificación por correo electrónico.

      

   2. Enviar notificación de Microsoft Teams: Envía un mensaje de Microsoft Teams a ti mismo. Puede personalizar el título y el contenido del mensaje.

      1. Para la acción Seleccionar, seleccione Teams -->Mensaje a individuos o Mensaje de chat en grupo, o Publicación de canal.
      2. Siga uno de estos pasos en función de la selección:
         • Si seleccionó la opción Mensaje a usuarios , escriba direcciones de correo electrónico de receptores o use la lista desplegable para seleccionar una propiedad cuyo valor sea una dirección de correo electrónico. Cuando se cumple la condición, se envía un correo electrónico a individuos especificados.
         • Si seleccionó la opción Mensaje de chat en grupo, seleccione un chat de grupo en la lista desplegable. Cuando se cumple la condición, se publica un mensaje en el chat de grupo.
         • Si seleccionó la opción Publicación del canal , seleccione un equipo y un canal en las listas desplegables. Cuando se cumple la condición, se publica un mensaje en el canal seleccionado.
      3. En Encabezado, escriba el encabezado de la notificación de Teams.
      4. En Notas, escriba notas para la notificación de Teams.

         Nota:

         Al escribir el asunto, el titular o las notas, puede hacer referencia a las propiedades de los datos escribiendo @ o seleccionando el botón situado junto a los cuadros de texto. Por ejemplo: @BikepointID.

      5. En Contexto, seleccione los valores de la lista desplegable que desea incluir en la notificación de Teams.

      

   3. Ejecutar actividades de Fabric: Para configurar la alerta para iniciar una canalización de Fabric, un trabajo de Spark o un cuaderno cuando se cumpla la condición, siga estos pasos:

      1. En Seleccionar acción, seleccione Ejecutar tubería, Ejecutar trabajo de Spark, Ejecutar cuaderno o Ejecutar función (versión preliminar).

      2. En Seleccionar el elemento Fabric que desea ejecutar, seleccione el elemento Fabric (pipeline, notebook, trabajo de Spark o función) de la lista.

      3. Seleccione Agregar parámetro y especifique el nombre del parámetro para el elemento Fabric y un valor para él. Puede agregar más de un parámetro. Puede pasar parámetros de los datos de alerta escribiendo @ o seleccionando el botón situado junto al cuadro de texto. Por ejemplo: @BikepointID.

         

   4. Acciones personalizadas: Para configurar la alerta para llamar a una acción personalizada cuando se cumpla la condición, siga estos pasos:

      1. En Seleccionar acción, seleccione Crear acción personalizada.

         

      2. Como se mencionó en la sección Acción, cree primero la regla y, a continuación, complete la configuración de acciones personalizadas siguiendo los pasos descritos en Desencadenar acciones personalizadas (flujos de Power Automate).

      3. Después de crear la acción personalizada, en el panel Definición , seleccione la acción personalizada en la lista desplegable Seleccionar acción .

   5. Seleccione Crear para guardar la regla Activator.

Hemos creado una regla de Fabric Activator. La regla se ejecuta en la secuencia de eventos de entrega de paquetes. La regla busca paquetes que tienen medicamentos y comprueba si la temperatura es ahora mayor que 20 grados centígrados. Cuando la temperatura se vuelve mayor que 20 grados centígrados, se envía un mensaje de Teams.

Examine las otras reglas para aprender cómo funcionan.

Inicio de la regla

Ahora está familiarizado con los eventos y objetos usados para crear una regla. El siguiente paso es iniciar la regla.

1. Seleccione Demasiado caliente para medicamento.

2. Opcionalmente, envíe un mensaje de prueba seleccionando Enviarme una acción de prueba. En primer lugar, compruebe que es el Destinatario.

   

3. Debe recibir un mensaje similar al siguiente:

   

4. Seleccione Inicio. Esto hace que la regla se active. Recibirá un mensaje de Teams cada vez que un paquete de medicamentos esté demasiado caliente. La regla debe desencadenarse varias veces cada hora.

   

5. Más adelante, puede desactivar la regla mediante el botón Detener de la cinta de opciones.

   

Creación de un objeto 

Ahora es el momento de crear un objeto propio. En esta sección, elimine el objeto Paquete. A continuación, vuelva a crearlo para realizar un seguimiento del estado de los paquetes en tránsito donde las horas de entrega sean mayores que 25.

1. En el panel Explorador , haga clic con el botón derecho en Paquete y seleccione Eliminar. En la ventana Eliminar elemento , seleccione Eliminar.

   

2. Seleccione el flujo eventos de entrega de paquetes y, a continuación, seleccione Nuevo objeto en la cinta de opciones.

   

3. En el panel Compilar objeto de la derecha, siga estos pasos:

   1. Asigne al nuevo objeto el nombre Package2.

   2. Elija PackageId como identificador único.

   3. Seleccione HoursInTransit y City como propiedades del objeto.

   4. Seleccione Crear.

      

Crear una nueva regla

Cree una regla que le avise si el tiempo de tránsito en la entrega supera un umbral.

1. Seleccione la nueva propiedad HorasEnTránsito. En la cinta de opciones, seleccione Nueva regla.

   

2. En el panel Definición , siga estos pasos:

   1. En Monitor, elija el atributo para supervisar y, opcionalmente, agregue filtros.

   2. En Condición, seleccione el tipo de condición y ocurrencia.

   3. En Acción, seleccione una de las opciones para enviar un mensaje en Teams o correo electrónico.

   4. Haga clic en Guardar.

      

3. Debería ver la regla en HoursInTransit en el panel Explorador. Seleccione la regla. En el panel central, seleccione el icono de lápiz en la parte superior y actualice el nombre a Promedio de tiempo de tránsito por encima del destino.

   

4. En el panel Definición a la derecha, seleccione HoursInTransit. A continuación, seleccione Añadir resumen>Promedio.

   

5. Establezca un tamaño de ventana de agregación de cinco minutos y un tamaño de paso de cinco minutos, y a continuación seleccione Guardar.

   

6. El gráfico Monitor se actualiza para reflejar el resumen. El gráfico de reglas de su Monitor tiene este aspecto.

   

7. Para probar la regla, seleccione el botón Enviarme una acción de prueba. Asegúrese de que recibe una alerta. Si usa el correo electrónico, puede tardar un minuto o dos en llegar.

   

8. Para iniciar la regla, seleccione Guardar e inicie en el panel Definición o seleccione Iniciar en la cinta de opciones.

   

   Ha creado el primer objeto y regla. Como pasos siguientes, puede intentar configurar otras reglas en el objeto Paquete2.

   Cuando esté listo para intentar usar Fabric Activator en sus propios datos, siga los pasos del artículo Obtención de datos para Fabric Activator .

Limpieza de recursos

Una vez que termine con las reglas que creó como parte del tutorial, asegúrese de detenerlas. Si no desactivas las reglas, seguirás recibiendo las notificaciones de estas. También puede incurrir en cargos por el procesamiento en segundo plano. Seleccione cada regla a su vez y seleccione el botón Detener de la cinta de opciones.

Contenido relacionado

• ¿Qué es Fabric Activator?

También puede obtener más información sobre Microsoft Fabric:

• ¿Qué es Microsoft Fabric?