テーブル定義間に存在する関連付けを使用して、テーブル行の個々のレコードを他のレコードと関連付けることができます。 OData では、関連付けはナビゲーション プロパティとして表現されます。
どのナビゲーション プロパティが $metadata サービス ドキュメントに存在するかを検出できます。 Web API ナビゲーション プロパティを参照してください。 既存の Dataverse テーブルについては、Web API EntityType リファレンスを参照してください
では、エンティティの種類ごとに、一覧表示されている単一値ナビゲーション プロパティとコレクション値ナビゲーション プロパティを参照してください。
次のテーブルは、Dataverse におけるテーブル間の 3 種類の関係性について説明しています。
| タイプ | 説明 | 例 |
|---|---|---|
| 一対多 | 1 つのレコードに多数のレコードを関連付けることができます。 |
取引先企業 レコードには、contact_customer_accountsに多くの取引先担当者レコードが存在する場合があります。 |
| 多対一 | 多数のレコードを 1 つのレコードに関連付けることができます。 多対一は、一対多の関連付けのミラー イメージです。 リレーションシップは 1 つだけです。 |
単一値のナビゲーション プロパティを使用すると、複数のparentcustomerid_accountレコードを単一の取引先企業レコードに関連付けることができます。 |
| 多対多 | 多数のレコードを多数のレコードに関連付けることができます。 | 各セキュリティロール (役割) には、システムユーザーの定義への参照が含まれる場合があります。 どちらのテーブルにも systemuserroles_associationコレクション値ナビゲーション プロパティがあります。 |
単一値ナビゲーション プロパティを使用する
一対多または多対一の関連付けの多側の既存のレコードについては、他のレコードへの URI 参照を設定することでレコードを関連付けることができます。 これを行う最も簡単で最も一般的な方法は、@odata.bind 注釈を 単一値ナビゲーション プロパティに追加し、PATCH 要求の他のレコードに Uri として値を設定することです。
単一値ナビゲーション プロパティと関連付ける
たとえば、の単一値ナビゲーション プロパティを使用して取引先企業レコードにparentcustomerid_accountレコードを関連付けるには、次のようにします。
要求:
PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
{
"parentcustomerid_account@odata.bind": "accounts(ce9eaaef-f718-ed11-b83e-00224837179f)"
}
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)
「 作成時にテーブル行を関連付ける」で説明されているように、同じ方法で新しいレコードを既存のレコードに関連付けることもできます。
単一値ナビゲーション プロパティを使用して関連付けを解除する
関連付けを解除するには、値を null に設定します。
要求:
PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
{
"parentcustomerid_account@odata.bind": null
}
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)
このメソッドを使用して関連付けを解除する場合は、 @odata.bind 注釈を含めないでください。 単一値ナビゲーション プロパティの名前を使用します。
要求:
PATCH [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
If-Match: *
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
{
"parentcustomerid_account": null
}
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
OData-EntityId: [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)
詳細情報: 基本アップデート
他のメソッド
他の方法を使用して、単一値ナビゲーション プロパティで前述したのと同じ結果を得ることができます。
次の PUT 要求を使用して、 parentcustomerid_account の単一値ナビゲーション プロパティの値を設定します。
要求:
PUT [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/parentcustomerid_account/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
{
"@odata.id": "[Organization URI]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)"
}
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
メモ
@odata.idの値を設定するときは、絶対 URL を使用する必要があります。
参照を削除するには、次の DELETE 要求を使用します。
要求:
DELETE [Organization Uri]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/parentcustomerid_account/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
コレクション値ナビゲーション プロパティを使用する
OData では、多対多リレーションシップの両側にコレクション値のナビゲーション プロパティがあります。 1 対多および多対 1 のリレーションシップにおいて、「1」側のテーブルはコレクション値のナビゲーションプロパティがあります。 コレクション値ナビゲーション プロパティを使用しながら、これらの種類のリレーションシップを操作する方法に違いはありません。 このセクションでは、任意の種類のリレーションシップに対してコレクション値ナビゲーション プロパティを操作する方法について説明します。
レコードをコレクションに追加する
次の例は、取引先担当者レコードを取引先企業contact_customer_accountsコレクション (1 対多リレーションシップ) に追加する方法を示しています。
要求:
POST [Organization Uri]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)/contact_customer_accounts/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
{
"@odata.id": "[Organization URI]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)"
}
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
次の例は、ロール レコードを systemusersystemuserroles_association コレクション (多対多リレーションシップ) に追加する方法を示しています。
要求:
POST [Organization Uri]/api/data/v9.2/systemusers(34dcbaf5-f718-ed11-b83e-00224837179f)/systemuserroles_association/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
{
"@odata.id": "[Organization URI]/api/data/v9.2/roles(886b280c-6396-4d56-a0a3-2c1b0a50ceb0)"
}
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
レコードをコレクションから削除する
以下の例は、取引先担当者レコードを、取引先担当者 の値が contact_customer_accounts であるcontactid00aa00aa-bb11-cc22-dd33-44ee44ee44eeコレクションから削除する方法を示しています。
要求:
DELETE [Organization Uri]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)/contact_customer_accounts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)/$ref HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
次の要求も機能します:
要求:
DELETE [Organization Uri]/api/data/v9.2/accounts(ce9eaaef-f718-ed11-b83e-00224837179f)/contact_customer_accounts/$ref?$id=[Organization URI]/api/data/v9.2/contacts(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json
応答：
HTTP/1.1 204 NoContent
OData-Version: 4.0
関連項目
Web API 基本操作のサンプル (C#)
Web API の基本的な操作のサンプル (クライアント側の JavaScript)
Web API を使用して演算を実行する
Http 要求を作成し、エラーを処理する
Web API を使用してデータのクエリを実行する
Web API を使用してテーブル行を作成する
Web API を使用してテーブル行を取得する
Web API を使用してテーブル行を更新および削除する
Web API 関数を使用する
Web API アクションの使用
Web API を使用してバッチ操作を実行する
Web API を使用して別のユーザーを偽装する
Web API を使用して条件付き操作を実行する