チュートリアル: ファブリック アクティベーター ルールを作成してアクティブ化する

Microsoft Fabric の Fabric アクティベーターを使用すると、データ ストリームでパターンまたは条件が検出されたときにアクションを実行できます。 Fabric Activator を初めて使用する場合は、「 Fabric Activator とは」を参照してください。 このチュートリアルでは、Fabric Activator に含まれているサンプル データを使用して、次のタスクを完了します。

前提条件

開始する前に、Fabric 容量を持つワークスペースが必要です。 Fabric ワークスペースについては、ワークスペースに関する記事を参照してください。 Fabric をお持ちでない場合は、試用版を開始するように求められます。

サンプル アクティベーターを作成する

1. Fabric ポータルに移動します。

2. 左側のナビゲーション ウィンドウで省略記号 (...) を選択し、[ 作成] を選択します。

   

3. [ 作成 ] ページの [Real-Time インテリジェンス] セクションで、[ データ アクティベーター] を選択します。

   

4. [ アクティベーター ] ページで、[ サンプルを試す] を選択します。

   

データを検索する

この手順では、このサンプルが基づいているイベント ストリーム データを調べます。

新しいアクティベーターには、[エクスプローラー] セクションがあります。 下にスクロールし、[Package delivery events] ストリームを選択します。

これらのイベントは、配達中の荷物のリアルタイムの状態を示します。

受信イベントを確認し、ライブ テーブル内のイベント データにカーソルを合わせます。 各データ ポイントに、イベントに関する情報が含まれています。 すべて表示するには、スクロールしなければならない場合があります。

ルールを調べる

ルールを使用して、監視するイベント値、検出する条件、Fabric Activator で実行するアクションを指定します。

エクスプローラー ペインには、このアクティベーターのオブジェクト (イベント ストリームなど) が表示されます。 配信イベントは、パッケージ配信イベント Eventstream から作成されたオブジェクトの 1 つです。

1. エクスプローラー ペインで、[Delivery events] というオブジェクトを選択します。 [Package delivery events] イベント ストリームのデータを使うオブジェクトに関するルールを作成できます。 たとえば、荷物の温度をチェックするルールなどです。

   

2. [Events by object ID] セクションは [Package ID] によって編成されていることがわかります。 [Package ID] は、各荷物を一意に識別する列 ID です。 この一意の ID を使って、Package イベントを Package オブジェクトに割り当てます。

   

3. [Too hot for medicine] という [Temperature] ルールを選択します。 右端のウィンドウで、[ 定義 ] ウィンドウを参照して、ルールの動作を確認します。

   

4. [監視] セクションで、[Temperature] を選択します。 温度の値は、Delivery events テーブルの Temperature 列から取得されます。 前のスクリーンショットで Temperature 列を確認できます。

   

5. [ 条件] セクションには、 20 °C を超える 温度を監視するルール条件が表示されます。

   

6. さらに下にある [プロパティ フィルター] までスクロールします。 このルールは、薬が含まれている荷物にのみ適用されます。 Delivery events テーブルで、ルールは Special care contents という列を確認しています。 Special care contents 列では、一部のパッケージは Medicine という値を持っています。

   

7. 最後に、[アクション] まで下にスクロールします。 条件が満たされた場合は、次のいずれかのアクションを選択します。

   1. 電子メール通知を送信する: 自分または組織内の他のユーザーに電子メールを送信します。

      1. [アクションの選択] で、[ 電子メールの送信] を選択します。
      2. [ 宛先] には、受信者の メール アドレス を入力するか、ドロップダウン リストを使用して、値が電子メール アドレスであるプロパティを選択します。 既定では、電子メールがここに入力されます。
      3. [ 件名] に、電子メール通知の件名を入力します。
      4. [ 見出し] に、メール通知の見出しを入力します。
      5. [メモ] には、電子メール通知のメモを入力します。

         注

         件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

      6. [コンテキスト] で、電子メール通知に含めるドロップダウン リストの値を選択します。

      

   2. Microsoft Teams通知を送信します。 Microsoft Teams メッセージを自分に送信します。 タイトルとメッセージの内容をカスタマイズできます。

      1. [アクションの選択] で、Teams の 個人へのメッセージ、グループチャットメッセージ、または チャネルへの投稿 を選択します。
      2. 選択内容に応じて、次のいずれかの手順に従います。
         • [ 個人へのメッセージ ] オプションを選択した場合は、受信者の メール アドレス を入力するか、ドロップダウン リストを使用して、値が電子メール アドレスのプロパティを選択します。 条件が満たされると、指定された個人に電子メールが送信されます。
         • [グループ チャット メッセージ] オプションを選択した場合は、ドロップダウン リストからグループ チャットを選択します。 条件が満たされると、メッセージがグループ チャットに投稿されます。
         • [チャネル投稿] オプションを選択した場合は、ドロップダウン リストからチームとチャネルを選択します。 条件が満たされると、選択したチャネルにメッセージが投稿されます。
      3. [見出し] には、Teams 通知の見出しを入力します。
      4. [メモ] には、Teams 通知のメモを入力します。

         注

         件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

      5. [コンテキスト] で、Teams 通知に含めるドロップダウン リストの値を選択します。

      

   3. Fabric アクティビティを実行します。 条件が満たされたときにファブリック パイプライン、Spark ジョブ、またはノートブックを起動するようにアラートを構成するには、次の手順に従います。

      1. [アクションの選択] で、[パイプラインの実行]、[Spark ジョブの実行]、[ノートブックの実行]、または [関数の実行 (プレビュー)]を選択します。

      2. 実行するファブリック項目の選択で、一覧から Fabric 項目 (パイプライン、ノートブック、Spark ジョブ、または関数) を選択します。

      3. [ パラメーターの追加] を選択し、Fabric 項目のパラメーターの名前とその値を指定します。 複数のパラメーターを追加できます。 アラート データからパラメーターを渡すには、「@」と入力するか、テキスト ボックスの横にあるボタンを選択します。 たとえば、「 @BikepointID 」のように入力します。

         

   4. カスタム アクション: 条件が満たされたときにカスタム アクションを呼び出すアラートを構成するには、次の手順に従います。

      1. [ アクションの選択] で、[ カスタム アクションの作成] を選択します。

         

      2. 「アクション」セクションで説明したように、最初にルールを作成してから、カスタム アクションのトリガー (Power Automate フロー) の手順に従ってカスタム アクションのセットアップを完了します。

      3. カスタム アクションを作成した後、[ 定義 ] ウィンドウで、[アクションの選択] ドロップダウン リストからカスタム アクションを選択 します。

   5. [ 作成 ] を選択してアクティブ化ルールを保存します。

ファブリック アクティベータールールを作成しました。 このルールは、Package delivery events イベント ストリームに対して実行されます。 このルールは、薬が含まれている荷物を探し、温度が現在摂氏 20 度を超えているかどうかを確認します。 温度が摂氏 20 度を超えると、Teams メッセージが送信されます。

他のルールを見て、それらがどのように機能するかを学びましょう。

ルールを開始する

これで、ルールの作成に使われるイベントとオブジェクトについて理解できました。 次の手順では、ルールを開始します。

1. [Too hot for medicine] を選択します。

2. 必要に応じて、[テスト アクションを自分に送信] を選択してテスト メッセージを送信します。 まず、自分が [受信者] であることを確認します。

   

3. 次のようなメッセージが表示されます。

   

4. [スタート] を選択します。 これにより、ルールがアクティブになります。 薬の荷物が熱くなりすぎている場合は、常に Teams メッセージを受信します。 このルールは、1 時間ごとに数回トリガーされるはずです。

   

5. 後で、リボンの [停止 ] ボタンを使用してルールをオフにすることができます。

   

オブジェクトを作成します

次に、独自のオブジェクトを作成します。 このセクションでは、Package オブジェクトを削除します。 次に、それを再作成して、配送時間が 25 を超えている輸送中の荷物の状態を追跡します。

1. エクスプローラー ウィンドウで、[パッケージ] を右クリックし、[削除] を選択します。 [ アイテムの削除 ] ウィンドウで、[削除] を選択 します。

   

2. パッケージ配信イベント ストリームを選択し、リボンの [新しいオブジェクト] を選択します。

   

3. 右側の [ビルド オブジェクト ] ウィンドウで、次の手順に従います。

   1. 新しいオブジェクトに Package2 という名前を付けます。

   2. 一意の ID として PackageId を選択します。

   3. オブジェクトのプロパティとして HoursInTransit と City を選択します。

   4. ［作成］ を選択します

      

新しいルールの作成

配送中の輸送時間がしきい値を超えた場合に警告するルールを作成します。

1. 新しい HoursInTransit プロパティを選択します。 リボンから、[新しいルール] を選択します。

   

2. [定義] ウィンドウで、次の手順に従います。

   1. [監視] では、監視する属性を選択し、必要に応じてフィルターを追加します。

   2. [条件] で、条件と発生の種類を選択します。

   3. [アクション] で、Teams またはメールでメッセージを送信するオプションのいずれかを選択します。

   4. 保存 を選択します。

      

3. [エクスプローラー] ウィンドウの [HoursInTransit ] にルールが表示されます。 ルールを選択します。 中央のウィンドウで、上部にある鉛筆アイコンを選択し、名前を ターゲットより上の平均輸送時間に更新します。

   

4. 右側の [定義 ] ウィンドウで、[ HoursInTransit] を選択します。 次に、[集計の追加]、> の順に選択します。

   

5. 集計 ウィンドウ サイズ を 5 分、 ステップ サイズ を 5 分に設定し、[保存] を選択 します。

   

6. 集計を反映して [監視] のグラフが更新され、[監視] のグラフ ルールは次のようになります。

   アクティベーターチュートリアルの平均通過時間グラフのスクリーンショット。

7. [Send me a test action] (テスト アクションを自分に送信) ボタンを選択して、ルールをテストします。 警告を受け取ることを確認します。 メールを使用する場合は、到着するまでに 1、2 分かかる場合があります。

   

8. [定義] ウィンドウで [保存して開始] を選択するか、リボンの [開始] を選択して、ルールを開始します。

   

   最初のオブジェクトとルールを作成できました。 次の手順として、Package2 オブジェクトに対する他のルールを設定してみてください。

   独自のデータで Fabric Activator を使用する準備ができたら、 Fabric Activator のデータの取得 に関する記事の手順に従ってください。

リソースをクリーンアップする

このチュートリアルの一環として作成したルールの使用を終えたら、必ず停止してください。 ルールを停止しないと、ルールの通知を受け取り続けることになります。 バックグラウンド処理の料金が発生する場合もあります。 各ルールを順番に選択して、リボンの [停止] ボタンを選択します。

関連するコンテンツ

• ファブリック アクティベーターとは

Microsoft Fabric の詳細についても確認してください。

• Microsoft Fabric とは