Элемент link-entity

Присоединяет таблицу, связанную с сущностью или сущностью 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>

Связь "многие ко многим"

Этот запрос возвращает данные из таблиц SystemUser и Team с помощью связи teammembership_association "многие ко многим".

<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 Однако и атрибуты не требуются технически.

Если вы не используете ни один из этих атрибутов, а система "многие ко многим" существует между двумя таблицами, Dataverse выбирает соответствующие ключевые значения, используя эту связь.

Если указать только один из from атрибутов или to атрибутов, Dataverse пытается определить правильную связь с помощью определений схемы отношений между двумя таблицами.

В противном случае вы получите следующую ошибку:

Код: 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.

Например, оба этих запроса используют связь 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 значения:

Родительские элементы

Дочерние элементы