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

モデル駆動型アプリ内の外部データソースから、連絡先に関する個人情報にアクセス、作成、更新、削除するとします。この簡単なチュートリアルでは、外部スキーマにマップされた列を持つ Person という名前の仮想テーブルを、OData Web サービスから実行時にこれらの操作にモデル化します。

データソースの詳細

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

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

Important

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

このチュートリアルでは、次の列を含む 1 つの仮想テーブルが必要です。

外部列名	外部データの種類	仮想テーブルのデータ型	目的
ID (アイディー)	`Edm.Guid`	プライマリキー	テーブルの主キー
ファーストネーム	`Edm.String`	1 行テキスト	名前
LastName	`Edm.String`	1 行テキスト	ユーザーの姓
年齢	`Edm.Int32`	整数	人物の年齢
LastModifiedOn	`Edm.DateTimeOffset`	データと時刻	個人レコードの最終変更データと時刻

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

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

データソースの作成

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

設定>管理>仮想エンティティデータソースの順に移動します。
新規を選び、OData v4 データプロバイダーを選択し、OK を選択します。

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

フィールド	価値
名前	人物サンプル OData データソース
URL	`https://contosowebservice.azurewebsites.net/odata`
タイムアウト	30
インラインカウントを返す	クライアント側のページング
インラインカウントを返す	正しい

他の列はそのままにして、保存 & 閉じる を選択してください。

ヒント

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

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

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

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

Power Apps で、左側のナビゲーションウィンドウから [ソリューション] を選択し、ツールバーの [クラシックに切り替える] を選択します。項目がサイドパネルウィンドウに表示されない場合は、…さらに表示を選択して、目的の項目を選択します。
[ すべてのソリューション ] の一覧で、目的のアンマネージドソリューションを開きます。

仮想テーブルを作成する

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

[エンティティ: 新しい] フォームで、[仮想テーブル] オプションを選択し、次の情報を入力します。

フィールド	価値
データソース	人物のサンプル OData データソース
表示名	Person
複数名	個人
名前	新規ユーザー
外部名	People
外部コレクション名	People
ノート (添付ファイルを含む)	選択済み
活動	選択済み

注

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

このエンティティを表示する領域の横にある Sales を選択し、[保存] を選択します (ただし、テーブルフォームは閉じないでください)。

仮想テーブルの列を作成する

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

Important

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

new_personid列を開き、次に示す値で次のプロパティを変更します。

外部名: ID
保存して閉じる を選択します。
new_name列を開き、次のプロパティを変更して、ここに示す値を設定します。
- ディスプレイ名: 姓
- 外部名 : LastName
保存して閉じる を選択します。