knowledgecenter-breadcrum

Knowledge Center

26 Apr, 2023

How to use FetchXml with link-entity in WebAPI D365 CE

Posted on 26 Apr, 2023 by Admin, Posted in Dynamics 365 Dataverse

How to use FetchXml with link-entity in WebAPI D365 CE Blogs

What is Link-Entity

1. To combine data from different records in your query you need to use the <link-entity> element.
2. Each <link-entity> needs 3 key pieces of information:</link-entity></link-entity>

2.a. The entity types to link to

2.b. The attribute in the main entity to join from

2.c. The attribute in the another entity to join to

NOTE: If you have a many-to-many (N:N) relationship you can’t join the entities directly, you have to join via the intermediate “intersect” entity.

3. There are two types of link-types: inner and outer.

4. The Link-Entity syntax requires providing of an Alias using which the values of the attributes can be accessed from the result-set.

NOTE:  If you do not provide an alias, the platform will auto generate the alias for you.

Example:
Suppose we have a requirement in which we need contact details like fullname, firstname, lastname and the account details like name and phone number that is related to contact.

Solution:
First, we will write a simple FetchXml query for contact in which we will select the attributes like fullname, firstname, lastname.

API Request:
https://dev-onepiece07.api.crm7.dynamics.com/api/data/v9.2/contacts?fetchXml=<link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity> </link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity>

Output:

2. As per the requirement that has been mentioned in the example, we will add the link- entity to get the account and its details like name and phone number that are related to contact.

2.a. We will use an inner link-type which will match the data of both the entity, and it will give the result.

API Request:

https://dev-onepiece07.api.crm7.dynamics.com/api/data/v9.2/contacts?fetchXml=<link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity> <link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"> </link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity>

Output:

2.b. We will use an outer link-type which will give all the data of the first entity if there are no matching records.

API Request

https://dev-onepiece07.api.crm7.dynamics.com/api/data/v9.2/contacts?fetchXml=<link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity><link-entity></link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity></link-entity><link-entity alias="account" from="accountid" link-type="inner" name="account" to="parentcustomerid"></link-entity><link-entity></link-entity><link-entity> </link-entity> <link-entity alias="account" from="accountid" link-type="outer" name="account" to="parentcustomerid"> </link-entity> </link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity></link-entity>

Output:

NOTE: Each query can contain a maximum of 10 links

We have used the link-entity to fetch all contact details like fullname, firstname, lastname and the account details like name and phone number that is related to contact.

Comment

This is a Required Field

Loading

Recent Updates

Blogs
02 Apr, 2024

Sales accelerator in D365 Sales

Introduction: In this blog we will see how Sales accelerator works and also how 'My work list' displays the work items.…

READ MORE
Blogs
01 Apr, 2024

How to Create Entitlement in D365 Customer Service

In this blog we will learn about what is Entitlement and how to create it. 1)what is Entitlement? Entitlement is…

READ MORE
Blogs
22 Mar, 2024

How to Create Product Catalog in Dynamics 365 for Sales - Part 1

In this blog series we will learn how to set up a product catalog in D365 Sales. The Product Catalog contains…

READ MORE