Xrm.Crm.WebApi is a library intended to simplify the use of the Microsoft Dynamics Crm REST API.
It was created out of necessity since the official SDK does not support dotnet core.
Currently the library only supports the online version with the Server-to-server authentication.
The on-premisse authentication and the user authentication will be added in the future.
You can read more about the Server-to-server authentication and how to create a Dynamics 365 application user here.
Initializing the connection:
Guid clientId = new Guid("{00000000-0000-0000-0000-000000000000}");
string clientSecret = "";
string crmBaseUrl = "https://myOrg.crm.dynamics.com";
Guid tenantId = new Guid("{00000000-0000-0000-0000-000000000000}");
ServerToServerAuthentication authentication = new ServerToServerAuthentication(clientId,clientSecret, crmBaseUrl, tenantId);
WebApi webApi = new WebApi(authentication);All the methos have a Async option.
Entity contact = new Entity("contact");
contact["firstname"] = "Jose";
contact["gendercode"] = 1;
contact["isbackofficecustomer"] = false;
contact["overriddencreatedon"] = DateTime.Now.ToUniversalTime();
Guid contactId = webApi.Create(contact);The library will add the necessary information if you use the 'EntityReference' object to define the relationship value
Entity contact = new Entity("contact");
contact["firstname"] = "Jose";
contact["accountid"] = new EntityReference("account", new Guid("{00000000-0000-0000-0000-000000000000}"));
Guid contactId = webApi.Create(contact);The 'EntityReference' type also works with alternate keys
Entity contact = new Entity("contact");
contact["firstname"] = "Jose";
contact["accountid"] = new EntityReference("account", "my_key_name", "my_value");
Guid contactId = webApi.Create(contact);You can also explicitly add the relationship
Entity contact = new Entity("contact");
contact["firstname"] = "Jose";
contact["accountid@odata.bind"] = "/accounts(00000000-0000-0000-0000-000000000000)";
Guid contactId = webApi.Create(contact);Currently only 'FetchXml' has been tested and extensively validated when retrieving multiple records. Other options will be added/improved in the future.
string fetchXml = @"
<fetch count='100'>
<entity name='contact'>
<all-attributes />
</entity>
</fetch> ";
RetrieveMultipleResponse retrieveMultipleResponse = webApi.RetrieveMultiple(fetchXml);
List<Entity> entities = retrieveMultipleResponse.Entities;
foreach(Entity entity in entities)
{
string firstname = entity.GetAttributeValue<string>("firstname");
DateTime firstname = entity.GetAttributeValue<DateTime>("createdon");
EntityReference accountid = entity.GetAttributeValue<EntityReference>("accountid");
}All attributes
Entity entity = webApi.Retrieve("contact", new Guid("00000000-0000-0000-0000-000000000000"));Only 'firstname' and 'createdon' are selected in the API
Entity entity = webApi.Retrieve("contact", new Guid("00000000-0000-0000-0000-000000000000"), "firstname", "createdon");Support for retrieving a single record using an alternate key will be added.
The update method follows the same logic from the create method. The only difference is: the 'Entity' object needs to have a Id or a alternate key
Entity contact = new Entity("contact", new Guid("00000000-0000-0000-0000-000000000000"));
contact["firstname"] = "Jose";
webApi.Update(contact); Entity contact = new Entity("contact", "my_key_name", "my_key_value");
contact["firstname"] = "Jose";
webApi.Update(contact);The upsert method is identical to the Update. You can control its behavior with the 'InsertOptions' parameter. The default option will update the record if it already exists or create it it doesn't
Entity contact = new Entity("contact", new Guid("00000000-0000-0000-0000-000000000000"));
contact["firstname"] = "Jose";
webApi.Upsert(contact);To delete a entity you only need to provide the logical name, id or alternate key
Entity contact = new Entity("contact", new Guid("00000000-0000-0000-0000-000000000000"));
webApi.Delete(contact); Entity contact = new Entity("contact", "my_key_name", "my_key_value");
webApi.Delete(contact);- Improve the Docs
- Improve the Todos 😊
MIT