Configuring Virtual Entity in Dynamics 365

Updateyou have to also create a second GET method in the controller… public Person Get (Guid key){} in this method you have to return the single record represented by “key”. it should then load the form with the record you selected on the home page or any other grid

Virtual Entity is a new featured introduced in July 2017 Update of Dynamics 365. With Virtual Entity, we can get the data from the external data source, to show inside Dynamics 365 easily with simple configuration. Earlier to achieve the same we need to write custom code to read that data or need to save that data inside Dynamics 365. With Virtual Entity, the data is still residing in the source system.

Few points to consider while using Virtual Entity are

  • They are read only.

  • They don’t support audit or duplicate detection, can’t be of activity type, are organization owned but doesn’t support the Dynamic’s security model, no BPF etc.

To configure the Virtual Entity,

  1. We need to define a Virtual Entity Data Source, currently it only supports OData V4 Data Provider.
  2. Create a new custom Entity of type Virtual Entity, specifying External Name and External Collection Name corresponding to the name of the entity and entity set in the OData service to connect to.
  3. Set the Id and Name attributes (or any custom attribute) of the Virtual Entity to the corresponding fields of OData entity.
  4. Id (Primary Key) field must be of type GUID else we will get the exception.

To begin with, let us first create a OData V4 service.

1) Open Visual Studio, create a new ASP.NET Web Application project with Empty Template of type Web API.

Add a new Model class of type Person

 public class Person
public string ID { get; set; }
public String Name { get; set; }
public String Description { get; set; }

Add a new Sample Data Source as shown below.

 public class SampleDataSource
private static SampleDataSource instance = null;
public static SampleDataSource Instance
if (instance == null)
instance = new SampleDataSource();
return instance;
public List<Person> Persons { get; set; }

private SampleDataSource()
public void Reset()
this.Persons = new List<Person>();
public void Initialize()
this.Persons.AddRange(new List<Person>
new Person()
ID = "testID1",
Name = "Person 1",
Description = "Person 1 Description"

new Person()

ID = "testID2",
Name = "Person 2",
Description = "Person 2 Description"
new Person()
ID ="3920A281-E6A8-48FF-B119-5873C63B434A",
Name = "Person 3",
Description = "Person 3 Description"

Add a new controller as shown below.

public class PersonsController : ODataController
public IHttpActionResult Get()
return Ok(SampleDataSource.Instance.Persons.AsQueryable());

Update WebApiConfig.cs as shown below

 public static class WebApiConfig
public static void Register(HttpConfiguration config)
config.MapODataServiceRoute("odata", null, GetEdmModel(), new DefaultODataBatchHandler(GlobalConfiguration.DefaultServer));
private static IEdmModel GetEdmModel()
ODataConventionModelBuilder builder = new ODataConventionModelBuilder();
builder.Namespace = "Sample";
builder.ContainerName = "DefaultContainer";
var edmModel = builder.GetEdmModel();
return edmModel;

Here we have published it as Microsoft Azure Web Apps.Note down the Entity Type Name and the EntitySet  Name. Here the ID field is of type GUID.

Inside Dynamics 365, go to Settings à Administration click on Virtual Entity Data Sources.

Click on New to create a new Data Source, OData V4 Data Provider is the only provider available currently.

Specify the URL of the OData Service and other values and save the record.

Create a new Virtual Entity, and specify the Entity and EntitySet for External Name and External Collection Name property respectively.

This creates an id and name field for the entity. Open those fields and map them to the corresponding field of the Entity defined in OData. Similarly, we can create a new field (new_description) and map it to the corresponding field inside OData Entity as shown below.

Publish the changes.

To see it in action, open Advanced Find View and search against the Person entity.

Hope it helps..


Author: Nishant Rana

I love working in and sharing everything about Microsoft.NET technology !

13 thoughts on “Configuring Virtual Entity in Dynamics 365”

  1. Hi Nishant,

    I am facing the below issue “Entity Could Not be Retrieve from Data Source”. Please see the screenshot. I have follow the all the steps as mentioned in the above blog. Please let me know if i missed anything.




    1. if you are trying to host on the local machine – that does not seem to work. i got the same error with localhost. when i deployed to a server (in my case, Azure web app) the error resolved.


  2. Hi Nishat,
    Thanks , Its working.
    But while click the record in the Person view always shows the first record. (Person1).
    Please guide


    1. in case anyone else stumbles across this thread… you have to also create a second GET method in the controller… public Person Get (Guid key){} in this method you have to return the single record represented by “key”. it should then load the form with the record you selected on the home page or any other grid.

      Liked by 1 person

  3. Hi,

    I have scenario where I m getting data from SAP using virtual Entity concept…now I m showing this data as subgrid in contact entity….but I need to apply filter on subgrid data by passing guid ….can this be done by registering plugin on retrieveall..could you guide


Please share your thoughts

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

My Trial

It is my experience timeline.


Sharing my knowledge and experience about the Microsoft Power Platform.

Arpit Power Guide

a guide to powering up community

Welcome to the Blog & Website of Paul Andrew

Technical Leadership Centred Around the Microsoft Data Platform

Deriving Dynamics 365

Deriving Solutions and features on Power Platform/Dynamics 365

The CRM Ninja

Thoughts & musings from a Dynamics 365 Ninja!

D CRM Explorer

Learn about Microsoft Dynamics CRM Power Platform customization and implementation and other cool stuffs

Stroke // Jonas Rapp

I know pre-stroke. I will improve who I was.

Power Melange

Power Melange By Shalinee

Clavin's Blog

Power Automate - Power Apps - SharePoint Online - Azure - Nintex - K2 - Artificial Intelligence

Sat Sangha Salon

An Inquiry in Being

The Indoencers

The Influencers & Influences of Indian Music

Monika Halan's blog

Hand's-free money management

D365 Demystified

A closer look at Microsoft Dynamics 365.

Microsoft Mate (msftmate) - Andrew Rogers

Experienced consultant primarily focused on Microsoft Dynamics 365 and the Power Platform


Specific topics by Django Lohn on the whole Microsoft365 Stack

Manmit Rahevar's Blog

One Stop Destination for Microsoft Technology Solutions


Naturally Curious

Brian Illand

Power Platform and Dynamics 365

Steve Mordue MVP

A Microsoft Business Applications MVP

Subwoofer 101

Bass defines your home theater

SQLTwins by Nakul Vachhrajani

SQL Server tips and experiences dedicated to my twin daughters.

Everything D365

Discovering Azure DevOps and D365 Business Applications

Tech Wizard

Lets do IT Spells

XRM Tricks (Power Platform & Dynamics CRM )

Power Platform & Dynamics CRM


Mail to for queries and suggestions

Giving back to the community what I have learned

xrm CRM Dynamics

Dynamics CRM Technical & Functional Info

Dynamics 365 Blogs - Explained in unique way

Sometimes you need to look at things from different perspective.

CRM Keeper

Dynamics 365 Customer Engagement, CRM, Microsoft CRM, Dynamics CRM


Step into the world of a Dynamics 365 Consultant

Dianamics PCF Lady

Diana & Dynamics 365 & Power Platform

%d bloggers like this: