OData v4 データ プロバイダーを使用してテーブル チュートリアルを仮想

モデル駆動型のアプリで、外部データソースからの取引先担当者の個人情報にアクセスし、作成、更新、削除する場合を考えてみましょう。 このチュートリアルでは、外部スキーマにマップされた列を持つ個人という仮想テーブルをモデリングして、OData Web サービスから実行時にこれらの操作を行うことを説明します。

データ ソースの詳細

このチュートリアルで使用されるデータ ソースには OData v4 Web サービスがあるため、ユーザーの環境に含まれる OData v4 データ プロバイダーを使用することができます。

Web サービス URL: https://contosowebservice.azurewebsites.net/odata/

重要

  • このチュートリアルで使用する Web サービス URL は、機能しているWeb サービスではありません。
  • OData v4 データ プロバイダーを使用して別の環境に接続することはできません。

このチュートリアルでは、以下の列を含む単一の仮想テーブルが必要です。

外部列名 外部データの種類 仮想テーブル データの種類 目的
ID Edm.Guid 主キー テーブルの主キー
FirstName Edm.String 1 行テキスト その個人の名
LastName Edm.String 1 行テキスト その個人の姓
年齢 Edm.Int32 整数 その個人の年齢
LastModifiedOn Edm.DateTimeOffset 日付と時刻 個人レコードの最終変更日と時刻

外部データ ソースの個人テーブルの OData メタデータ:

 Odata 外部データ ソース XML パート 2。

データ ソースの作成

OASIS オープン データ プロトコル (OData) のサンプル Web サービスを使用する OData v4 データ プロバイダーに、データソースを作成します。

  1. 設定 > 管理 > 仮想エンティティのデータ ソースの順に移動します。

  2. 新規を選び、OData v4 データ プロバイダーを選択し、OK を選択します。

  3. 以下の情報を入力または選択します。

    フィールド
    件名 個人サンプル OData データ ソース
    URL https://contosowebservice.azurewebsites.net/odata
    タイムアウト 30
    インライン カウントの取得 クライアント側のページング
    インライン カウントの取得

他の列を現状のまま残し、保存 & 閉じるを選択します。

ヒント

独自の Web サービスを使用する場合は、URL が Webブラウザーに貼り付けることで有効であることを確認します。 関心のあるテーブルに対応する列とデータ型を理解したい場合は、URL の最後に /$metadata を追加することで、Web サービスのテーブルの定義を確認できます。

ソリューション エクスプローラーを開きます

作成するユーザー定義テーブルの名前の一部はカスタマイズの接頭辞です。 これは、作業中のソリューションの発行者に基づいて設定されます。 カスタマイズの接頭辞がこのテーブルに対して必要な接頭辞であるアンマネージド ソリューションで作業するようにします。 詳細: ソリューション発行者の接頭辞を変更する

アンマネージド ソリューションを開く

  1. Power Apps の左ナビゲーション ペインからソリューションを選択し、ツール バーのクラシックに切り替えを選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。

  2. すべてのソリューション リストから、必要な [アンマネージド ソリューション] を開きます。

仮想テーブルの作成

  1. ソリューション エクスプローラーの左側のナビゲーション ウィンドウで、エンティティを選び、メイン ウィンドウから新規選択します。

  2. エンティティ: 新規フォームで、仮想テーブル オプションを選び、以下の情報を入力します。

    フィールド
    データ ソース 個人サンプル OData データ ソース
    表示名
    複数名 個人
    件名 new_person
    外部名
    外部コレクション名
    メモ (添付ファイルを含む) 選択済み
    活動 選択済み

    注意

    OData リソース パス セマンティクスでは、リソースの識別に EntitySet を使用しています。 サンプルの OData Web サービスでは、EntitySetと定義されています。 この値は、仮想テーブル個人外部名として使用されます。

  3. このエンティティが表示される領域の横で、営業を選択してから、保存を選択します (テーブル フォームを閉じないでください)。 個人のテーブル定義。

仮想テーブルの列を作成

エンティティ: 個人ページの左のナビゲーション ウィンドウで、フィールドを選択します。 このチュートリアルの一部として、既存の 2 つの列を編集し、外部のデータ ソースで使用できる列をさらに 3 つ追加します。

重要

外部名は大文字と小文字が区別されます。 正しい名前を使用しているか Web サービス メタデータを参照してください。 false の Nullable 値は、属性が必要なことを示します。 主キー列は常にシステムが必要であることに注意してください。

  1. new_personid 列を開き、次に表示される値のプロパティを変更します。

    外部名 : ID

    ID 列を作成します。

  2. 保存して閉じるを選択します。

  3. new_name 列を開き、以下のプロパティを変更して、表示されている値にします。

    • 表示名 : 姓
    • 外部名 : LastName

    姓の列を作成します。

  4. 保存して閉じるを選択します。

  5. 新規を選び、フィールド: 個人の新規ページで以下の情報を入力します。

    フィールド
    表示名
    件名 new_firstname
    外部名 FirstName
    フィールド要件 必須項目
    データの種類 1 行テキスト

    個人の年齢列を作成します。

  6. 保存して閉じるを選択します。

  7. 新規を選び、フィールド: 個人の新規ページで以下の情報を入力します。

    フィールド
    表示名 年齢
    件名 new_age
    外部名 年齢
    フィールド要件 必須項目
    データの種類 整数

    年齢列を作成します。

  8. 保存して閉じるを選択します。

  9. 新規を選び、フィールド: 個人の新規ページで以下の情報を入力します。

    フィールド
    表示名 最終修正日
    件名 new_lastmodifiedon
    外部名 LastModifiedOn
    フィールド要件 必須項目
    データの種類 日付と時間

    最終修正日列を作成します。

メイン フォームに列を追加

  1. 個人テーブルで、フォームを選択します。

  2. メイン フォームを開き、年齢、および最終変更日列を、右側のペインから一般セクションのフォームにドラッグ アンド ドロップします。

    メイン フォームに追加された名、年齢、および最終変更日の列。

  3. 個人テーブル ウィンドウで、保存して閉じるを選択します。

既定のビューを構成

  1. ソリューション エクスプローラーの左側のペインの、個人エンティティの下で、ビューを選択します。
  2. すべての人ビューを開きます。
  3. タスク ペインで、列の追加を選択します。 ビュー列を追加します。
  4. 年齢、および最終変更日列を選択してから、OK を選択します。
  5. ビュー : すべての人ウィンドウで、左に移動と右に移動の矢印を選択して列の順序を並べ替えてから、保存して閉じるを選択します。
  6. ソリューション エクスプローラー ウィンドウで、すべてのカスタマイズの公開を選択します。
  7. すべてのカスタマイズの公開後、ソルーション エクスプローラー ウィンドウを閉じます。

モデル駆動型アプリで仮想テーブルを使用する

モデル駆動型アプリを作成し、個人テーブルをサイト マップに追加します。 次に、個人メイン フォームと個人の高度な検索ビューを選択します。 アプリを公開します。 詳細: 初めてモデル駆動型アプリを自分ですべて構築する

これで、アプリ ユーザーは、Microsoft Dataverse にある他のテーブルと同じように、仮想テーブルを使用して読み取り、作成、更新、削除操作を実行できます。

仮想テーブルを使用してレコードを作成、表示、および削除する

  1. モデル駆動型アプリを実行します。 新規を選択して、必要な列に入力してから、レコードを保存します。
  2. もう一度新規を選択して、別のレコードを作成して保存します。
  3. これで、すべての個人ビューに次のような 2 つのレコードが作成されます。 すべての個人を表示します。
  4. レコードを削除するには、個人レコードを選択してから、削除を選択します。 確認ページでレコードを削除することを確認します。

関連項目

OData v4 データ プロバイダーの構成、要件、ベスト プラクティス
外部データ ソースからのデータを含む仮想テーブルの作成および編集

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。