VeeFriends.CRM 5.0.1

VeeFriends.CRM

This package has nothing todo with VeeFriends.com or Gary Vaynerchuk or NFTs.

Installation

$ dotnet add package VeeFriends.CRM

Usage

This SDK is a very opinionated OData Microsoft Dynamics 365 SDK. It is designed to be used with your own CRM instance.

1. Supply your CRM host
2. Supply your CRM credentials
3. Supply your CRM entities
4. Supply your CRM anayltics key (power apps) (optional)
5. Build the client

var client = new CrmClientBuilder()
    .AddCrmVersion()
    .AddCrmHost(host)
    .AddCredentials(clientId, clientSecret, tenantId)
    .AddEntity<SampleUserModel>()
    .AddAnalytics(anayltics)
    .Build();	

Next, get your entity context.

var context = client.For<SampleUserModel>();

Note: In order for models to be used with the SDK, they must inherit from CrmModel and be supplied with a class attribute [CrmEntity('contacts', 'contactid')] The first parameter is the collection name and the second is the primary key or identifier of the entity.

Here's an example contact entity.

[CrmEntity("contacts", "contactid")]
public class SampleUserModel : CrmModel
{
    [JsonPropertyName("contactid")]
    public Guid Id { get; set; }

    [JsonPropertyName("firstname")]
    public string? FirstName { get; set; }

    [JsonPropertyName("lastname")]
    public string? LastName { get; set; }
}

Next, you can use the context to query your CRM.

var users = await context
	.QueryAsync(x => x.FirstName == "Gary");

Feel free to explore the other methods.