Azure Digital Twins コネクタを使用して Power Platform および Logic Apps と統合する

[アーティクル]
02/05/2025

Azure Digital Twins Power Platform コネクタを使用して、Azure Digital Twins を Microsoft Power Platform または Azure Logic Apps フローに統合できます。

このコネクタは、ツイン、モデル、クエリ操作用に Azure Digital Twins データプレーン API のラッパーです。これにより、基になるサービスは、Microsoft Power Automate、Microsoft Power Apps、Azure Logic Apps と通信できます。このコネクタは、ユーザーが自分のアカウントを接続し、事前構築済みの一連のアクションを利用してアプリとワークフローを構築する方法を提供します。

クイックデモを含むコネクタの概要については、次の IoT ショービデオをご覧ください:

また、ブログ投稿の「Azure Digital Twins を利用した、自動化されたワークフローとアプリの構築を簡略化する」の基本的なチュートリアルを完了することもできます。コネクタのアクションとそのパラメーターの完全な一覧など、コネクタの詳細については、Azure Digital Twins コネクタのリファレンスドキュメントを参照してください。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。 Azure アカウントで Azure portal にサインインします。

この記事で Azure Digital Twins を操作するには、まず Azure Digital Twins インスタンスとそれを使用するために必要なアクセス許可が必要です。 Azure Digital Twins インスタンスが既に設定されている場合は、そのインスタンスを使用し、次のセクションに進むことができます。それ以外の場合は、「インスタンスと認証を設定する」の手順に従います。手順には、各ステップを正常に完了したことを確認するために役立つ情報が含まれています。

インスタンスの設定後、インスタンスのホスト名を書き留めておきます。ホスト名は Azure portal で確認できます。

最後に、コネクタを使用する Power Platform サービスを設定する必要があります。

コネクタを設定する

Power Automate と Power Apps の場合は、フローを作成する前に最初に接続を設定します。 Power Automate と Power Apps に接続を追加するには、下記の手順に従います。

左側のナビゲーションメニューから [接続] を選択します (Power Automate では、これは [データ] 見出しの下にあります)。 [接続] ページで、[+ 新しい接続] を選択します。
"Azure Digital Twins" 検索し、Azure Digital Twins (プレビュー) コネクタ選択します。
コネクタから ADT インスタンス名を求められる場合は、お使いのインスタンスのホスト名を入力します。
接続の設定を完了するように要求されたら、認証の詳細を入力します。
接続が作成されたことを確認するには、[接続] ページで接続を探します。

Logic Apps の場合、次のセクションでフローを作成する場合は、Azure Digital Twins 組み込み接続を使用できます。組み込みコネクタの詳細については、「Azure Logic Apps の組み込みコネクタ」を参照してください。

フローの作成

Azure Digital Twins は、Power Automate フロー、Logic Apps フロー、または Power Apps アプリケーションに組み込むことができます。 Azure Digital Twins コネクタと 700 を超える他の Power Platform コネクタを使用すると、他のシステムからツインにデータを取り込んだり、システムイベントに応答したりできます。

Power Automate でコネクタを使用してサンプルフローを作成するには、次の手順に従います。

Power Automate で、左側のナビゲーションメニュー [マイフロー] を選択します。 [+ 新しいフロー] と [インスタントクラウドフロー] を選択します。
フロー名を入力し、トリガーの一覧から [フローを手動でトリガー] を選択します。フローを作成します。
フローにステップを追加し、Azure Digital Twins を検索して接続を見つけます。 Azure Digital Twins の接続を選択します。
コネクタで使用可能なすべてのアクションの一覧が表示されます。 Azure Digital Twins API と対話するには、そのうちの 1 つを選択します。
他のコネクタを使用して統合シナリオを構築することで、ワークフローの編集やステップの追加を続行できます。

Microsoft Power Apps でコネクタを使用してサンプルフローを作成するには、下記の手順に従います。

Power Apps で、左側のナビゲーションメニューから [+ 作成] を選択します。 [空のアプリ] を選択し、プロンプトに従って新しいアプリを作成します。
アプリビルダーで、左側のナビゲーションメニューから [データ] を選択します。 [データの追加] を選択し、Azure Digital Twins を検索してデータ接続を見つけます。 Azure Digital Twins の接続を選択します。
これで、Azure Digital Twins コネクタからアクションが、アプリで使用する関数として使用できるようになります。
Azure Digital Twins データにアクセスして、引き続きアプリケーションを構築できます。 Power Apps の構築の詳細については、「Power Apps でのアプリの作成の概要」を参照してください。

Azure Logic Apps でコネクタを使用してサンプルフローを作成するには、下記の手順に従います。

Azure portal で、ロジックアプリに移動します。左側のナビゲーションメニューから [ワークフロー] を選択し、[+ の追加] を選択します。プロンプトに従って新しいデバイスを作成します。
新しいフローを選択し、Designer に入力します。
アプリにトリガーを追加します。
[操作の選択] を選択して、Azure Digital Twins コネクタからアクションを追加します。 [Azure] タブで Azure Digital Twins を検索して、データ接続を見つけます。 Azure Digital Twins の接続を選択します。
コネクタで使用可能なすべてのアクションの一覧が表示されます。 Azure Digital Twins API と対話するには、そのうちの 1 つを選択します。
Azure Digital Twins コネクタからアクションを選択すると、接続を作成するための認証の詳細を入力するように求められます。
他のコネクタを使用して統合シナリオを構築することで、ワークフローの編集やステップの追加を続行できます。

制限事項と提案

コネクタのいくつかの制限事項と、それらを操作するための推奨事項を次に示します。

一部のコネクタアクション (モデルの追加など) では、@ で始まるリテラル文字列の形式で入力する必要があります。このような場合は、代わりに @@ を使用して @ 文字をエスケープします。これにより、リテラル値が JSON 式として解釈されなくなります。
Azure Digital Twins は動的スキーマ応答を処理するため、API から受信した JSON を解析してから、アプリケーションで使用する必要があります。たとえば、dtId 値を抽出する前にデータを解析する呼び出しのセットを次に示します: Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));。

次のステップ

Power Platform コネクタの詳細については、複数の製品間のワークフローでそれらを使用する方法など、Power Platform および Azure Logic Apps コネクタのドキュメントを参照してください。

次の方法で共有