Esercitazione: Creare e attivare una regola di attivazione Fabric

Fabric Activator in Microsoft Fabric permette di eseguire azioni quando rileva modelli o condizioni nei flussi di dati. Se non si ha familiarità con Fabric Activator, vedere Cosa è Fabric Activator. In questa esercitazione si usano i dati di esempio inclusi in Fabric Activator per completare le attività seguenti:

Prerequisiti

Prima di iniziare, è necessaria un'area di lavoro con la capacità Fabric. Per informazioni sulle aree di lavoro Fabric, vedere l'articolo Workspaces. Se non si dispone di Fabric, viene richiesto di avviare una prova gratuita.

Crea un Attivatore di esempio

1. Nella pagina iniziale di Fabric, nel riquadro di spostamento a sinistra, seleziona i puntini di sospensione (...) e quindi seleziona Crea.

   

2. Nella pagina Crea, in Intelligence in tempo reale, seleziona Activator.

   

3. Nella pagina Activator selezionare Prova esempio.

   

Esplora i dati

In questo passaggio, esplori i dati eventstream su cui si basa il campione.

Il nuovo oggetto Attivatore ha una sezione Esploratore . Scorri verso il basso e seleziona il stream degli eventi di consegna dei pacchetti.

Questi eventi mostrano lo stato in tempo reale dei pacchetti in fase di recapito.

Osservare gli eventi in ingresso e sovrapporre il cursore sui dati dell'evento nella tabella in tempo reale. Ogni punto dati contiene informazioni sull'evento. Potrebbe essere necessario scorrere per visualizzare tutto.

Esplorare una regola

Utilizzare una regola per specificare quali valori degli eventi monitorare, quali condizioni rilevare e quali azioni deve intraprendere Fabric Activator.

Nel riquadro Explorer vengono visualizzati oggetti, ad esempio eventstream, per questo attivatore. Gli eventi di recapito sono uno degli oggetti creati dal flusso di eventi eventi di recapito pacchetti.

1. Nel riquadro Esplora risorse selezionare l'oggetto denominato Eventi di consegna. È possibile creare regole sugli oggetti che usano i dati dal flusso di eventi Package delivery events. Ad esempio, una regola che controlla la temperatura dei pacchetti.

   

2. Si noti che la sezione Events by object ID (Eventi per ID oggetto) è organizzata in base all'ID pacchetto. ID pacchetto è l'ID che identifica in modo univoco ogni pacchetto. Usa questo ID unico per assegnare eventi package agli oggetti package.

   

3. Selezionare la regola Temperatura denominata Troppo caldo per la medicina. Nel pannello più a destra, visualizza il pannello Definizione per vedere come funziona la regola.

   

4. Nella sezione Monitoraggio selezionare Temperatura. I valori di temperatura provengono dalla colonna Temperature nella tabella Eventi di recapito. È possibile visualizzare la colonna Temperature in uno screenshot precedente.

   

5. Nella sezione Condizione viene visualizzata la condizione della regola per monitorare le temperature superiori a 20 gradi Celsius.

   

6. Scorrere più verso il basso fino a Filtro proprietà. La regola si applica solo ai pacchetti contenenti medicine. Nella tabella Eventi di recapito, la regola esamina la colonna denominata contenuti di assistenza speciale. Nella colonna dei contenuti di assistenza speciale , alcuni dei pacchetti hanno un valore Medicina.

   

7. Scorri verso il basso fino a Azione. Scegli una delle seguenti azioni da intraprendere quando la condizione è soddisfatta:

   1. Invia notifica tramite posta elettronica: Invia un messaggio di posta elettronica a se stessi o ad altri utenti dell'organizzazione.

      1. Per Seleziona azione, seleziona Invia messaggio di posta elettronica.
      2. Per To, inserisci gli indirizzi email dei destinatari oppure usa la lista a tendina per selezionare una proprietà il cui valore è un indirizzo email. Il tuo indirizzo email viene inserito qui automaticamente.
      3. Per Oggetto immettere l'oggetto della notifica tramite posta elettronica.
      4. Per Titolo immettere il titolo della notifica tramite posta elettronica.
      5. Per Note immettere le note per la notifica tramite posta elettronica.

         Annotazioni

         Quando inserisci l'argomento, il titolo o le note, puoi fare riferimento alle proprietà dei dati digitando @ o selezionando il pulsante accanto alle caselle di testo. Ad esempio: @PackageId.

      6. Per contestualizzare, seleziona i valori dalla lista a tendina che vuoi includere nella notifica via email.

      

   2. Send Microsoft Teams notification: Invia una notifica di Microsoft Teams a singoli utenti, a una chat di gruppo o a un canale. È possibile personalizzare il titolo e il contenuto del messaggio.

      1. Per Seleziona azione, seleziona Teams>Messaggio a singoli utenti, Messaggio di chat di gruppo o Post del canale.
      2. Seguire uno di questi passaggi a seconda della selezione:
         • Se hai selezionato Messaggio agli individui, inserisci gli indirizzi email dei destinatari oppure usa la lista a tendina per selezionare una proprietà il cui valore è un indirizzo email. Quando la condizione è soddisfatta, Fabric Activator invia un messaggio Teams agli individui specificati.
         • Se hai selezionato messaggio di gruppo chat, seleziona una chat di gruppo dalla lista a tendina. Quando la condizione è soddisfatta, Fabric Activator pubblica un messaggio nella chat di gruppo.
         • Se hai selezionato post Canale, seleziona una squadra e un canale dai menu a tendina. Quando la condizione è soddisfatta, Fabric Activator invia un messaggio al canale selezionato.
      3. Per Titolo immettere il titolo della notifica di Teams.
      4. Aggiungi Note alla notifica di Teams.

         Annotazioni

         Quando inserisci l'argomento, il titolo o le note, puoi fare riferimento alle proprietà dei dati digitando @ o selezionando il pulsante accanto alle caselle di testo. Ad esempio: @PackageId.

      5. Per contesto, seleziona i valori dalla lista a tendina che vuoi includere nella notifica di Teams.

      

   3. Eseguire attività di Fabric: Per configurare l'avviso in modo da avviare una pipeline di Fabric, un Dataflow, un processo Spark, un notebook, una funzione, un processo di copia o pubblicare un evento aziendale (anteprima) quando la condizione è soddisfatta, segui questi passaggi:

      1. Per selezionare l'azione, selezionare Esegui Pipeline, Esegui Dataflow, Esegui il lavoro Spark, Esegui il Notebook, Esegui Funzione, Esegui il lavoro Copia o Pubblica evento aziendale (anteprima).

      2. In Seleziona l'elemento Fabric da eseguire, seleziona l'elemento Fabric (pipeline, flusso di dati, notebook, processo Spark, funzione, processo di copia o pubblicazione di eventi aziendali (anteprima)) dall'elenco.

      3. Seleziona Aggiungi parametro, poi specifica il nome del parametro per l'elemento Fabric e un valore per esso. È possibile aggiungere più di un parametro. È possibile passare parametri dai dati dell'avviso digitando @ o selezionando il pulsante accanto alla casella di testo. Ad esempio: @PackageId. I job di copia non accettano parametri, quindi questo passaggio non si applica a loro.

         

   4. Azioni personalizzate: Per configurare l'avviso per chiamare un'azione personalizzata quando viene soddisfatta la condizione, seguire questa procedura:

      1. Per Seleziona azione, selezionare Crea azione personalizzata.

         

      2. Prima di tutto, crea la regola. Completa quindi la configurazione delle azioni personalizzate seguendo i passaggi in Attivare azioni personalizzate (flussi di Power Automate).

      3. Dopo aver creato l'azione personalizzata, nel pannello Definizione , seleziona la tua azione personalizzata dal menu a tendina Seleziona azione .

8. Dopo aver configurato l'azione selezionata, seleziona Crea per salvare la regola Attivatore.

È stata creata una regola di attivazione Fabric. La regola viene applicata al flusso di eventi Eventi di Recapito del Pacchetto. La regola cerca pacchi che contengono medicinali e verifica se la temperatura supera i 20 gradi Celsius. Quando la temperatura supera i 20 gradi Celsius, la regola invia un messaggio su Teams.

Questo esempio di oggetto Activator include altre regole. Esplorali al tuo ritmo per vedere come funzionano.

Avvia la regola

Ora che si ha familiarità con gli eventi e gli oggetti usati per creare una regola, avviare la regola.

1. Selezionare Troppo caldo per la medicina.

2. Se lo desideri, invia un messaggio di prova selezionando Esegui un'azione di test. Prima di tutto, verifica di essere il destinatario.

   

3. Viene visualizzato un messaggio simile al seguente:

   

4. Selezionare Inizio. Questa azione attiva la regola. Ricevi un messaggio di Teams ogni volta che una confezione di medicinali è troppo calda. La regola viene attivata più volte ogni ora.

   

5. In un secondo momento, è possibile disattivare la regola usando il pulsante Arresta sulla barra multifunzione.

   

Creare un oggetto

Ora crea un oggetto tutto tuo. In questa sezione, elimini l'oggetto Package e lo ricrei con le proprietà che userai nella sezione successiva per costruire una regola.

1. Nel riquadro Explorer fare clic con il pulsante destro del mouse su Pacchetto e scegliere Elimina. Nella finestra Elimina elemento selezionare Elimina.

   

2. Selezionare il flusso di eventi di recapito dei pacchetti e quindi selezionare Nuovo oggetto sulla barra multifunzione.

   

3. Nel riquadro Compila oggetto a destra seguire questa procedura:

   1. Assegnare un nome al nuovo oggetto Package2.

   2. Scegliere PackageId come ID univoco.

   3. Selezionare HoursInTransit e City come proprietà dell'oggetto.

   4. Seleziona Crea.

      

Crea una regola

Crea una regola che ti avvisi quando il tempo medio di transito supera le 25 ore.

1. Seleziona la nuova proprietà HoursInTransit. Nella barra multifunzione selezionare Nuova regola.

   

2. Nel riquadro Definizione seguire questa procedura:

   1. Per Monitoraggio scegliere l'attributo da monitorare e, facoltativamente, aggiungere filtri.

   2. Per Condizione, imposta la condizione in modo che venga attivata quando HoursInTransit è maggiore di 25.

   3. Per Azione selezionare una delle opzioni per inviare un messaggio in Teams o un messaggio di posta elettronica.

   4. Seleziona Salva.

      

3. Vedi la regola sotto HoursInTransit nel riquadro Esplora. Selezionare la regola. Nel riquadro centrale selezionare l'icona a forma di matita nella parte superiore e aggiornare il nome in Tempo medio di transito sopra la destinazione.

   

4. Nel riquadro Definizione a destra selezionare HoursInTransit. Seleziona quindi Aggiungi riepilogo>Media.

   

5. Impostare una dimensione della finestra di aggregazione di cinque minuti e una dimensione del passaggio di cinque minuti e quindi selezionare Salva.

   

6. Il grafico Monitor viene aggiornato per riflettere il riepilogo e il grafico Monitor delle tue regole ha un aspetto simile al seguente.

   

7. Verifica la tua regola selezionando il pulsante Inviami un'azione di test. Assicurarsi di ricevere un avviso. Se si usa un messaggio di posta elettronica, potrebbero essere necessari un minuto o due per arrivare.

   

8. Avviare la regola selezionando Salva e avvia nel riquadro Definizione oppure selezionando Avvia sulla barra multifunzione.

   

   Hai creato il tuo primo oggetto e regola. Come passo successivo, prova a impostare altre regole sull'oggetto Package2 .

   Quando si è pronti per provare a usare Fabric Activator sui propri dati, seguire la procedura descritta nell'articolo Get data for Fabric Activator.

Pulire le risorse

Dopo aver terminato con le regole create come parte dell'esercitazione, arrestale. Se non interrompi le regole, continuerai a ricevere le notifiche delle regole. Potresti anche incorrere in costi per l'elaborazione in background. Selezionare ogni regola a sua volta e selezionare il pulsante Arresta sulla barra multifunzione.

Contenuto correlato

• Esercitazione: Creare una regola di attivazione end-to-end usando l'intelligenza artificiale agente
• Che cos'è Fabric Activator?

Per altre informazioni sulle Microsoft Fabric, vedere:

• Che è Microsoft Fabric?