link-entity 要素

エンティティ または リンク エンティティ に関連するテーブルを結合して、結果を含む多くの列を返します。 また、関連するテーブルの列の値に条件を適用するために、フィルター要素と共に使用されます。

FetchXml を使用してテーブルを結合する方法について説明します。

例示

次の例は、さまざまな種類のリレーションシップで link-entity を使用する方法を示しています。

多対一リレーションシップ

このクエリは、取引先企業レコードの PrimaryContactId 参照列に基づいて、取引先企業テーブルと連絡先テーブルからデータを返します。

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <link-entity name='contact'
      from='contactid'
      to='primarycontactid'
      link-type='inner'
      alias='contact'>
      <attribute name='fullname' />
    </link-entity>
  </entity>
</fetch>

一対多リレーションシップ

このクエリは、連絡先account_primary_contact一対多リレーションシップに基づいて、連絡先テーブルと取引先企業テーブルからデータを返します。

<fetch>
  <entity name='contact'>
    <attribute name='fullname' />
    <link-entity name='account' 
     from='primarycontactid' 
     to='contactid' 
     alias='account'>
      <attribute name='name' />
    </link-entity>
  </entity>
</fetch>

多対多リレーションシップ

このクエリは、teammembership_association多対多リレーションシップを使用して、SystemUser テーブルと Team テーブルからデータを返します。

<fetch>
  <entity name='systemuser'>
    <attribute name='fullname' />
    <link-entity name='teammembership'
      from='systemuserid'
      to='systemuserid' >
      <link-entity name='team'
        from='teamid'
        to='teamid'
        link-type='inner'
        alias='team'>
        <attribute name='name' />
      </link-entity>
    </link-entity>
  </entity>
</fetch>

Attributes

from属性とto属性の使用

from属性とto属性の両方の値を設定することをお勧めします。 これらの属性は、通常、一致する列を明示的に定義するために使用されます。 ただし、 from 属性と to 属性は技術的には必要ありません。

どちらの属性も使用せず、2 つのテーブル間にシステム多対多リレーションシップが存在する場合、Dataverse はそのリレーションシップを使用して適切なキー値を選択します。

from属性またはto属性の 1 つのみを指定した場合、Dataverse は、2 つのテーブル間のリレーションシップ スキーマ定義を使用して、正しいリレーションシップの特定を試みます。

それ以外の場合は、次のエラーが表示されます。

コード: 0x80041102
メッセージ: No system many-to-many relationship exists between <table A> and <table B>. If attempting to link through a custom many-to-many relationship ensure that you provide the from and to attributes.

たとえば、これらのクエリの両方で、systemuser テーブルとチーム テーブルの間teammembership_association多対多リレーションシップが使用されます。 この場合、Dataverse は from 属性と to 属性を処理でき、交差テーブルを指定する link-entity は必要ありません。

<fetch top="2">
<entity name="systemuser">
<attribute name="fullname" />
<link-entity
name="teammembership"
from="systemuserid"
to="systemuserid"
intersect="true"
>
<link-entity
name="team"
from="teamid"
to="teamid"
link-type="inner"
alias="team"
>
<attribute name="name" />
</link-entity>
</link-entity>
</entity>
</fetch>

<fetch top="2">
<entity name="systemuser">
<attribute name="fullname" />
<link-entity name="team" alias="team">
<attribute name="name" />
</link-entity>
</entity>
</fetch>

link-type オプション

link-typeを使用して、返されたレコードにフィルターを適用します。 次の表では、有効な link-type 値について説明します。

親要素

子要素