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

モデル駆動型アプリ内で、外部データ ソースからのチケット情報にアクセスするとします。 この単純なチュートリアルでは、実行時にチケット データを OData Web サービスから取得する、外部スキーマにマップされたフィールドを持つ仮想エンティティをモデル化します。

データ ソースの詳細

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

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

Important

このチュートリアルで使用する Web サービス URL は、機能しているWeb サービスではありません。

このチュートリアルでは、以下の 3 つのフィールドを含む単一の仮想エンティティが必要です。

外部のフィールド名 外部データの種類 仮想エンティティ データの種類 目的
チケット ID Edm.Guid 主キー エンティティの主キー
タイトル Edm.String 1 行テキスト チケットのタイトル
重要度 Edm.Int32 整数 チケットの重要度を示す 0-4 の数値

外部データ ソース チケット エンティティの OData メタデータ:

<EntityType Name="Ticket">
  <Key>
    <PropertyRef Name="TicketID" />
  </Key>
  <Property Name="TicketID" Nullable="false" Type="Edm.Guid" />
  <Property Name="Title" Type="Edm.String" />
  <Property Name="Severity" Nullable="false" Type="Edm.Int32" />
</EntityType>

データ ソースを作成

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

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

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

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

    フィールド Value
    名前 Contoso サンプル データ ソース
    URL https://contosowebservice.azurewebsites.net/odata
    タイムアウト 30
    インライン カウントの取得 はい

他のフィールドを現状のまま残し、保存 & 閉じるを選択します。

Tip

独自の Web サービスを使用する場合は、URL が Webブラウザーに貼り付けることで有効であることを確認します。

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

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

  1. Power Apps ポータルからソリューションを選択し、ツール バーのクラシックに切り替えを選択します。

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

仮想エンティティを作成

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

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

    フィールド Value
    データ ソース Contoso サンプル データ ソース
    表示名 チケット
    複数名 チケット
    名前 new_ticket
    外部名 チケット
    外部コレクション名 チケット
    メモ (添付ファイルを含む) 選択済み
    活動 選択済み
  3. このエンティティが表示される領域の横で、サービスを選択してから、保存を選択します (エンティティ フォームを閉じないでください)。 チケット エンティティの定義

仮想エンティティのフィールドを作成

エンティティ: チケットページの左のナビゲーション ウィンドウで、フィールドを選択します。 このチュートリアルの一部として、2 つの既存のフィールドを編集し、3 番目のフィールドを追加します。

Important

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

  1. new_ticketid フィールドを開き、次に表示される値の属性を変更します。外部名: TicketID TicketID フィールド

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

  3. 新しい名前フィールドを開き、次に表示される値をもつ属性を変更します。

    • 表示名: タイトル
    • 外部名: タイトル Title フィールド
  4. 保存して閉じるを選択します。

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

    フィールド Value
    表示名 重要度
    名前 new_severity
    外部名 重要度
    フィールド要件 必須項目
    データの種類 整数
    最小値 0
    最大値 4

重要度フィールド

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

主フォームにフィールドを追加

  1. チケット エンティティ ウィンドウで、フォームを選択します。
  2. メイン フォームを開き、タイトルフィールド下概要セクションの フォーム上の右側のウィンドウから重要度フィールドをドラッグおよびドロップします。 メイン フォームに追加される重要度フィールド
  3. チケット エンティティ ウィンドウで、保存および閉じるを選択します。

既定のビューを構成

  1. ソリューション エクスプローラーの左側のウィンドウの、チケット エンティティの下で、ビューを選択します。
  2. すべてのチケットビューを開きます。
  3. タスクウィンドウで、検索列の追加を選択します。 ビュー列の追加
  4. 重要度を選び、OK を選択します。
  5. ビュー: すべてのチケットウィンドウで、保存して閉じるを選択します。
  6. ソリューション エクスプローラー ウィンドウで、すべてのカスタマイズの公開を選択します。 すべてのカスタマイズの公開
  7. すべてのカスタマイズの公開後、ソルーション エクスプローラー ウィンドウを閉じます。

Dynamics 365 のアクションで仮想エンティティを表示

  1. サービス > 拡張 > チケットへ移動します。

    チケット領域

    すべてのチケットビューが表示されます。 サービス領域からでエンティティを参照するには、ブラウザーを更新する必要がある場合があることに注意してください。

    すべての通知を表示

  2. 特定のレコードのタイトルおよび重要度フィールドを含むフォームを表示するためにチケットレコードを開きます。 チケット レコード

関連項目

OData v4 データ プロバイダーの構成、要件、ベスト プラクティス
外部データ ソースからのデータを格納する仮想エンティティの作成および編集