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 メタデータ:

データ ソースの作成

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

   

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 分かかります。 個人データは収集されません (プライバシー ステートメント)。