EC.DynamicsClient 5.6.1

Introduction

This library Dynamics Client wraps calls to Dynamics 365 so you can use this to extend Dynamics 365.

Getting Started

Code Samples

Startup

namespace EC.DynamicsClient.CodeSamples;

using EC.DynamicsClient;

using Microsoft.Extensions.DependencyInjection;

public static class Startup_Code_Samples
{
    public static IServiceCollection Default(this IServiceCollection services) => services
        .AddDynamicsClients();

    public static IServiceCollection With_Keys(
        this IServiceCollection services,
        string authorityKeyName, string clientIdKeyName, string clientSecretKeyName,
        string serviceEndpointKeyName, string scopesKeyName, string retryCountKeyName) => services
            .AddDynamicsClients(
                authorityKeyName,
                clientIdKeyName,
                clientSecretKeyName,
                serviceEndpointKeyName,
                scopesKeyName,
                retryCountKeyName);
}

Query Client Usage

namespace EC.DynamicsClient.CodeSamples;

using EC.DynamicsClient;

using Microsoft.Extensions.Logging;

using System;
using System.Threading.Tasks;

public static class Query_Client_Usage_Code_Samples
{
    public static async Task Query_Client_Usage(
        IDynamicsQueryClient dynamicsQueryClient,
        ILogger log)
    {
        var fake_user = Guid.Empty;

        var result = await dynamicsQueryClient
            .Get_Safe<Contact>(ContactField
                .EntitySetName
                .Query()
                .Where([ // sample filter records
                    ContactField.FullName.Not_Equal_Null(),
                    ContactField.FullName.Contain("Bob"),
                    ContactField.FullName.Starts_With("Dan"),
                    ContactField.OwnerId.Not_Equal_Null(),
                    ContactField.OwnerId.Equal_User_Id(),
                    ContactField.CreatedBy.Not_Equal(fake_user)
                ])
                .Top(10)
                .Select([ // sample select fields
                    ContactField.FirstName,
                    ContactField.LastName,
                    ContactField.ContactId,
                    ContactField.CreatedBy.ToLookup(),
                ])
                .OrderBy([ // sample order by expressions
                    ContactField.CreatedBy.Order_By()
                ])
                .ExpandOn( // sample expand on expressions
                    ContactField.ec_Account
                    .Expand()
                    .Select([AccountField.AccountId])
                    .Where([
                        AccountField.OwnerId.Equal_User_Id()
                    ])
                    .Build())
                .Where([ // sample lambda expressions
                    Lambda.All(ContactOneToMany.account_primary_contact, [
                        Lambda.StartsWith(AccountField.Name, "S"),
                        Lambda.EndsWith(AccountField.Name, "h"),
                        Lambda.Contains(AccountField.Name, "Smith"),
                        Lambda.Equals(AccountField.StatusCode, account_statuscode.Active),
                        new EqualsLambdaExpression("null", "null")
                    ]),
                ])
                .Build())
            .ConfigureAwait(false);

        result.Switch(
            invalid => log.LogWarning("The query that was provided is invalid."),
            contacts =>
            {
                if (contacts?.Entities is not null)
                {
                    foreach (var contact in contacts.Entities)
                    {
                        // do something with the contact
                    }
                }
            },
            not_found => log.LogWarning("The query that was provided did not return any results."),
            failed => log.LogError("The query that was provided resulted in a failed status response."));
    }
}

Manager Client Usage

namespace EC.DynamicsClient.CodeSamples;

using EC.DynamicsClient;

using Microsoft.Extensions.Logging;

using System.Threading.Tasks;

public static class Manager_Client_Usage_Code_Samples
{
    public static async Task Manager_Client_Usage(
        IDynamicsManagerClient dynamicsManagerClient,
        ILogger log)
    {
        var result = await dynamicsManagerClient
            .Create_Safe(new CreateRequest<Contact>(ContactField.EntitySetName, new Contact()
            {
                FirstName = "test first name",
                LastName = "test last name",
            }, headerSet: new HeaderSet([new AddPrefer([new ReturnRepresentation()])])
        )).ConfigureAwait(false);

        result.Switch(
            success => log.LogInformation("The create request provided completed successfully."),
            contact =>
            {
                log.LogInformation("The create request provided completed successfully with the updated contact.");
                // do something with the contact
                var created_contact = contact.Value;
                var contactId = created_contact.ContactId;
                var fullName = created_contact.FullName;
            },
            invalid => log.LogWarning("The create request that was provided is invalid."),
            failed => log.LogError("The create request that was provided resulted in a failed status response.")
        );
    }
}