ASP.NET Web API (プレビュー) のキャンバス アプリ フロント エンドを作成します

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

Power Platform では、Power Apps キャンバス アプリをフロント エンドとして使用して、Web API 開発者がモバイルまたは Web アプリケーションをすばやく構築できるようにします。 Visual Studio 2022 の Power Platform 接続済みサービスにより、ASP.NET Web API 開発者は、Power Apps と Power Automate で使用するカスタム コネクタを簡単に作成できます。

API をパブリック エンドポイントに公開する前に、Visual Studio 開発トンネル を使用して、キャンバス アプリを作成できます。 開発トンネルは、ローカルで実行されている Web API と Power Apps の間にアドホック接続を作成します。 この機能を使用すると、Power Platform のコンテキストでリアルタイムに、Web API をローカルでテストおよびデバッグできます (内部ループ)。

このチュートリアルでは、サンプルの ASP.NET Weather Web API を使用して、キャンバス アプリに接続を追加 します。 これは、ASP.NET Core を使用して Web API を作成する チュートリアルに基づいています。

前提条件

Visual Studio で ASP.NET プロジェクトを作成する

  1. ASP.NET Core Web API プロジェクトを作成します。
  2. 次へを選択します。
  3. プロジェクト名WeatherSample を入力して、次へ を選択します。
  4. 作成を選択します。

WeatherSample プロジェクトには、RESTful HTTP サービスのサンプル コントローラーが含まれています。

Power Platform を接続済みサービスとして追加する

Visual Studio にサービスの依存関係を追加するスクリーンショット。

  1. ソリューション エクスプローラー接続済みサービス ノードを右クリックして、コンテキスト メニューから 接続済みサービスを管理する を選択します。

  2. 接続済みサービス タブで、サービスの依存関係 用の + アイコンを選択します。

  3. 依存関係の追加 ダイアログで、検索ボックスに Power Platform と入力します。

  4. Microsoft Power Platform を選択してから 次へ を選択します。

    Microsoft Power Platform アカウントにまだサインインしていない場合は、サインインします。 Power Platform アカウントがない場合、開発環境を作成します

  5. Microsoft Power Platform に接続する 画面で、開発環境を選択します。

  6. カスタム コネクタ名 では、値 WeatherSample_Connector がすでに設定されている必要があります。

  7. パブリック開発トンネルの選択 で、+ アイコンを選択します。

    1. 名前 フィールドで、SampleTunnel と入力します。
    2. トンネルの種類: 永続的 を選択します。
    3. アクセス : パブリック を選択します。
    4. OK を選びます。
  8. 完了 を選択します

  9. 接続済みサービスが構成されたら、閉じる を選択します。

カスタム コネクタでキャンバス アプリを作成する

Visual Studio が Web アプリを実行し、トンネルがアクティブである場合、Web ブラウザは localhost URL ではなくトンネル URL を開きます。

  1. Visual Studio ソリューションを実行し、デバッグを開始します。

  2. ブラウザーが開くと、トンネル URL に送信された最初の要求で警告ページが開きます。 続行 を選択します。

  3. Web API を実行している状態で、新しいブラウザー タブで Power Apps を開きます。

  4. 右上隅で開発環境を選択します。

  5. 電話 を形式として、空白のキャンバス アプリを作成 します。

  6. トップ メニューで データを追加 を選択します。

  7. WeatherSample_Connector を検索して選択し、接続 を選択します。 詳細: キャンバス アプリに接続を追加する

  8. ボタンを挿入し、フォームの下部にドラッグします。

  9. ボタン テキストデータの読み込み に変更します。

  10. ボタンの OnSelect プロパティに次の式を入力します:

    ClearCollect(weatherCollection, WeatherSample_Connector.GetWeatherForecast())
    
  11. 垂直ギャラリー を挿入します

  12. データ ソースとして weatherCollection を選択して、レイアウトを タイトルとサブタイトル に変更します。

  13. アプリを実行します。 次の例のようになります:

    サンプル ASP.NET Weather Web API を使用して作成された Power Apps キャンバス アプリのスクリーンショット。

API をデバッグする

キャンバス アプリを実行した状態で、ブレークポイントを設定してデバッグします。 ホット リロード を使用することもできます。

参照

キャンバス アプリとは
ASP.NET Core アプリのある Visual Studio 2022 で開発トンネルを使用する方法