GET [Organization URI]/api/data/v9.2/contacts?$select=fullname 
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

Sample response of above query

{
    "@odata.context": "https://[Organization URI].crm8.dynamics.com/api/data/v9.2/$metadata#contacts(fullname)",
    "value": [
        {
            "@odata.etag": "W/\"867043\"",
            "fullname": "Yvonne McKay (sample)",
            "contactid": "fe2a6a27-89fd-e711-a836-000d3a33a7cb"
        },
        {
            "@odata.etag": "W/\"866666\"",
            "fullname": "अनामिका अग्रवाल (नमूना)",
            "contactid": "540b4637-a636-ec11-8c65-000d3af2b6a6"
        }
    ]
}

If all attributes need to be retrieved, remove $select clause like shown below.

GET [Organization URI]/api/data/v9.2/contacts
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

Sample response of above query

{
    "@odata.context": "https://[Organization URI].crm8.dynamics.com/api/data/v9.2/$metadata#contacts",
    "value": [
        {
            "@odata.etag": "W/\"867043\"",
            "customertypecode": 1,
            "address2_addresstypecode": 1,
            "merged": false,
            "territorycode": 1
            ...
            ...
        }
    ]
}

1. Endpoint

Like any other Web API you need to get endpoint for your Datavserse environment. Format from Dataverse Web API endpoint is shown below.

https://<Environment Name>.<CRM Region URL>/api/data/<api version>/

Suppose, your environment is "creativebiz", your CRM region is India(i.e crm8.dynamics.com) & current api version is v9.2 then your endpoint should look like

https://creativebiz.crm8.dynamics.com/api/data/v9.2/

Here you can notice 3 things

a. Environment Name

This is set at the time of Dataverse environment creation, if you don't define it then it will be generated randomly. You should pay attention on this while creating a new Dataverse Environment.

b. API Version

Current Dataverse Web API version is v9.2, hence v9.2 is shown in example. You can even make call with full build numbers like v9.2.786.1008 or a supported previous version number like v9.1.

c. Region

Microsoft assigns Region based on your geographical location, refer below table. source

2. HTTP Headers

Dataverse Web API supports many HTTP headers, some are standard HTTP & OData headers while few are proprietary headers for specific operations which will be discussed in respective recipes. Microsoft suggests below 4 headers as standard to be added with all the requests made against Dataverse Web API.

Accept: application/json 
OData-MaxVersion: 4.0 
OData-Version: 4.0
If-None-Match: null

3. HTTP Method

At the time of writing this Dataverse Web API supports below 5 HTTP methods.

GET
POST
PATCH
PUT
DELETE

4. Authentication

All requests should be authenticated by Azure AD. Refer here for detailed setup steps.

5. Permission/Authentication

Requests can not be anonymous, there must be some user to make the request and that user should have appropriate permission to perform specific operations.

I further recipes these basics will be used.

We finally headed to our good old CRM SDK libraries and written code in C# then access this via Dynamics 365 WebApi using Dynamics 365 Custom Action.

I’m sharing here core logic, it can be used either in Action or any other place where CRM SDK C# libraries can be consumed.

Model class to get history as a list

public class FieldHistory
{
    public string ChangedBy { get; set; }
    public DateTime ChangedOn { get; set; }
    public string Oldvalue { get; set; }
    public string NewValue { get; set; }
}

Function to get and parse field history

Below code is using FormattedValues which retrieve user readable component out of OptionSet and EntityReference fields, this can be modified according to your requirements.

public static List<FieldHistory> GetFieldHistory(string entityLogicalName, Guid recordId, string fieldName, IOrganizationService service)
{
    // Retrieving change history fro given attribute/field
    var attributeChangeHistoryRequest = new RetrieveAttributeChangeHistoryRequest
    {
        Target = new EntityReference(entityLogicalName, recordId),
        AttributeLogicalName = fieldName
    };

    var attributeChangeHistoryResponse = (RetrieveAttributeChangeHistoryResponse)service.Execute(attributeChangeHistoryRequest);
    var details = attributeChangeHistoryResponse.AuditDetailCollection;

    // List to store changes
    var fieldHistory = new List<FieldHistory>();

    foreach (var detail in details.AuditDetails)
    {
        var detailType = detail.GetType();
        if (detailType == typeof(AttributeAuditDetail))
        {
            // retrieve old & new value of each action of each audit change from AttributeAuditDetail
            var attributeDetail = (AttributeAuditDetail)detail;

            var userName = attributeDetail.AuditRecord.GetAttributeValue<EntityReference>("userid").Name;
            var changedOn = attributeDetail.AuditRecord.GetAttributeValue<DateTime>("createdon");
            var newValue = attributeDetail.NewValue.FormattedValues[fieldName];
            var oldValue = attributeDetail.OldValue?.FormattedValues[fieldName];

            fieldHistory.Add(new FieldHistory
            {
                ChangedBy = userName,
                ChangedOn = changedOn,
                Oldvalue = oldValue,
                NewValue = newValue
            });

            return fieldHistory;
        }
    }
}

If you observe I have use safe navigation operator for var oldValue = attributeDetail.OldValue?.FormattedValues[fieldName]; this is because for the first occurrence OldValue will always remain null.

This code is good if we are using in C# specific requirement, while it’s a workaround if we need field history via WebAPI. Let’s keep an eye in official documentation and in this issue if Microsoft returns more meaningful response in future.

I hope this helps.

Web Development has changed drastically in recent years. These days even most of the front-end requires to be run from a web-server, and if like me you are not a full-time web developer, you may find a hard time setting up a local webserver.

Here’s good news! Many frameworks and languages provide out of the box web-server which can be utilized for the task. I mainly code on Microsoft related technologies so IISExpress is already installed in my machine, which can be used as a local web-server using this command.

C:\> <path to iisexpress.exe> /path:<absolute path to folder> /port:<port to be used>

Suppose your IISExpress is installed at the default location, your front-end code is kept at C:\MyWeb and port to be used is 8000, then the command will look like this.

C:\> "C:\Program Files (x86)\IIS Express\iisexpress.exe" /path:C:\MyWeb /port:8000

To avoid typing this command every time I moved this to a batch file with a small tweak like below, where %cd% picks your current directory.

"C:\Program Files (x86)\IIS Express\iisexpress.exe" /path:%cd% /port:8000

You simply paste this batch file in your folder and get going. Executing this batch file will start a local webserver at the current folder with port 8000. Access your webpage at http://localhost:8000

Download server.bat batch file here.

To find local webserver options for other languages & frameworks follow this awesome Github Gist. Big list of HTTP static server one-liners

Ref: https://crmtipoftheday.com/1155/the-clock-is-ticking-on-your-endpoint/

Ref: https://community.dynamics.com/crm/f/microsoft-dynamics-crm-forum/311096/is-organization-service-is-going-to-be-deprecated

Finally, CrmServiceClient provides option to connect to organization service using Client Id & Client Secret. Let’s try it out.

Why to use Client ID & Client Secret to Authenticate

• Only minor code chanegs required in existing code.
• OAuth is safer than using password based authenticaton.
• Save user licencing cost by using Application User

Sample Code

As part of initial setup Application User & Azure AD App is required if you don’t have it already please refer to Step 1 & Step 2 in this artice. Once you have all the details, prepare connection string as shown below and use AuthType=ClientSecret here.

public static IOrganizationService GetOrganizationServiceClientSecret(string clientId, string clientSecret, string organizationUri)
{
    try
    {
        var conn = new CrmServiceClient($@"AuthType=ClientSecret;url={organizationUri};ClientId={clientId};ClientSecret={clientSecret}");

        return conn.OrganizationWebProxyClient != null ? conn.OrganizationWebProxyClient : (IOrganizationService)conn.OrganizationServiceProxy;
    }
    catch (Exception ex)
    {
        Console.WriteLine("Error while connecting to CRM " + ex.Message);
        Console.ReadKey();
        return null;
    }
}

IOrganizationService orgService = GetOrganizationServiceClientSecret(
                 "<Client Id obtained from Azure AD App>",
                 "<Client Secret obtained from Azure AD App>",
                 "<Organization Uri>");

var response = orgService.Execute(new WhoAmIRequest());

All the necessary packages should be installed, package Microsoft.CrmSdk.XrmTooling.CoreAssembly version should be 9.1.0.13 or higher in order to connect using ClientSecret. see release notes.

You can find this code on my GitHub.

Feel free to get back in case of any suggestions/queries.

Navigate to https://make.powerapps.com and select your environment here or create a new one, I’m selecting my Dynamics 365 environment.

Navigate to Dataflows on the left pane, expand Data and click Dataflows.

Click on + New dataflow here.

Provide a name for dataflow, we are going to migrate a WebAPI, hence I’d call it WebAPI Dataflow.

Dataflow supports a huge set of data sources to choose from, but mostly they require a gateway if they are outside of your tenant. Select WebAPI here, we will try a publically available API.

I’m going to use https://api.itbook.store/ which a publically available API, you may try with other APIs as well. This API provides an endpoint https://api.itbook.store/1.0/new which provides newly released books, we will use this to store all the latest books data in an entity.

Have a look at the sample response from this endpoint. We are going to store books as entity records.

{
    "error": "0",
    "total": "10",
    "books": [
        {
            "title": "AI Blueprints",
            "subtitle": "How to build and deploy AI business projects",
            "isbn13": "9781788992879",
            "price": "$31.99",
            "image": "https://itbook.store/img/books/9781788992879.png",
            "url": "https://itbook.store/books/9781788992879"
        },
        {
            "title": "Data Analysis with Python",
            "subtitle": "A Modern Approach",
            "isbn13": "9781789950069",
            "price": "$31.99",
            "image": "https://itbook.store/img/books/9781789950069.png",
            "url": "https://itbook.store/books/9781789950069"
        },
        {
            "title": "Build Reactive Websites with RxJS",
            "subtitle": "Master Observables and Wrangle Events",
            "isbn13": "9781680502954",
            "price": "$28.98",
            "image": "https://itbook.store/img/books/9781680502954.png",
            "url": "https://itbook.store/books/9781680502954"
        },
        {
            "title": "Forge Your Future with Open Source",
            "subtitle": "Build Your Skills. Build Your Network. Build the Future of Technology",
            "isbn13": "9781680503012",
            "price": "$26.18",
            "image": "https://itbook.store/img/books/9781680503012.png",
            "url": "https://itbook.store/books/9781680503012"
        },
        {
            "title": "Xcode Treasures",
            "subtitle": "Master the Tools to Design, Build, and Distribute Great Apps",
            "isbn13": "9781680505863",
            "price": "$22.03",
            "image": "https://itbook.store/img/books/9781680505863.png",
            "url": "https://itbook.store/books/9781680505863"
        },
        {
            "title": "Learning C++ by Building Games with Unreal Engine 4, 2nd Edition",
            "subtitle": "A beginner's guide to learning 3D game development with C++ and UE4",
            "isbn13": "9781788476249",
            "price": "$44.99",
            "image": "https://itbook.store/img/books/9781788476249.png",
            "url": "https://itbook.store/books/9781788476249"
        },
        {
            "title": "Apache Kafka Quick Start Guide",
            "subtitle": "Leverage Apache Kafka 2.0 to simplify real-time data processing for distributed applications",
            "isbn13": "9781788997829",
            "price": "$23.99",
            "image": "https://itbook.store/img/books/9781788997829.png",
            "url": "https://itbook.store/books/9781788997829"
        },
        {
            "title": "Hands-On Dark Web Analysis",
            "subtitle": "Learn what goes on in the Dark Web, and how to work with it",
            "isbn13": "9781789133363",
            "price": "$29.99",
            "image": "https://itbook.store/img/books/9781789133363.png",
            "url": "https://itbook.store/books/9781789133363"
        },
        {
            "title": "CentOS Quick Start Guide",
            "subtitle": "Get up and running with CentOS server administration",
            "isbn13": "9781789344875",
            "price": "$31.99",
            "image": "https://itbook.store/img/books/9781789344875.png",
            "url": "https://itbook.store/books/9781789344875"
        },
        {
            "title": "Machine Learning with Apache Spark Quick Start Guide",
            "subtitle": "Uncover patterns, derive actionable insights, and learn from big data using MLlib",
            "isbn13": "9781789346565",
            "price": "$29.99",
            "image": "https://itbook.store/img/books/9781789346565.png",
            "url": "https://itbook.store/books/9781789346565"
        }
    ]
}

Now head back to PowerApps screen and provide https://api.itbook.store/1.0/new in the URL text box, you may observe that Authentication kind is set as Anonymous because it’s publically available, otherwise either a gateway is required or API should be in the same tenant. Click Next.

Let’s understand the appearing Power Query screen, we are going to spend quite some time�here.

• On top Header menu has options related to transforming the data.
• Power Query is auto-generated when we apply operations to data, but this can be edited manually also. Power Query is widely used in Power BI.
• Below that our current state of data is shown, we can interact with it and transform as per our requirement.
• On right pane all the Applied Steps are listed, we can traverse back and forth here to update any changes made earlier.

Let’s start transforming now, click on books[list], it will expand the records.

Click on Convert to table button here and then Ok in appearing popup, it will transform your list of records as a table.

Click on the arrow button as shown in the image and uncheck the checkbox ‘Use original column name as prefix’ which makes column names tidier. Click Ok, it will expand all the column data.

By default, all columns datatype are treated as raw(string), We can specify it explicitly also, let’s try this with ‘isbn13’ column so we can use this as Key later. Select the column, expand the ‘Transform column’ and click ‘Detect data type’.

You can see on Query that it is detected as Int64.

Change it to ‘text’ manually.

Table.TransformColumnTypes(#"Expanded Column1", \{\{"isbn13", type text\}\})

You may observe all the transformations are being recorded on the right pane. Now the transformation part is completed, click on Next to proceed to load.

You can either load data to an existing entity or create a new entity here and then load. Choosing an existing entity gives more control over the prefix name and solution. Here we are going to load data to a new entity.

Select ‘Load to new entity’, specify name and display name for the entity. In the field mapping section we will specify isbn13 as Key field and title as Primary name field, before doing that change field type as Text for both of them and then set as Key and Primary name fields. Now click Next to schedule.

We can choose to run our dataflow manually or can be scheduled at regular intervals, which can be triggered manually as well. Once scheduled click Create which will start creating entity and loading the data.

Once it is loaded click Done and verify this loaded data in Dynamics 365 Advanced Find or Model-driven Power App.

To Refresh any dataflow manually you can click Refresh as shown in the image.

Please feel free to get back in case of any feedback or query.

Cheers!

In Dynamics 365 integration scenarios most of the times we need to authenticate only single tenant. Since now Dynamics 365 authentication only through Azure AD (for online instances) is recommended let’s see how to do it. To achieve this first of all we need to create App in Azure Active Directory and good news is that you don’t need Azure subscription to try this out, your Dynamics 365 free trial is enough.

These 4 steps are involved to implement this, you can always jump to next step if know current step. This topic may not be very new to everyone, but when I got to implement the same recently it took me few hours to make it work, because of recent of frequent Azure updates or outdated content maybe. which leads me to write this.

1. Create & configureApp in Azure Active Directory
2. Create User in Azure AD and Configure it as Application User in Dynamics 365
3. Write C# code with ADAL(Active Directory Authentication Library) to generate Access Token
4. Making requests to Dynamics 365 with above generated Access Token

Step 1: Create Azure AD App

• Navigate to Azure(https://portal.azure.com).

• On left menu click on Azure Active Directory -> App registrations(Preview) => + New registration, We will use Preview version only because it has more straight forward options and going forward this only is going to be default option.

• Give some Name to your App, and for account type select Accounts in this organizational directory only because we need it for single tenant only.

• Once App is created, click on API permissions to add new permission for your app.

• Select Dynamics CRM here.

• Check user_impersonation box in upcoming screen and click Add permissions

• These permission require admin consent, click on Grant admin consent for your-org button and confirm it. You need administrator role to do it.

• 

Now your App is created, we need three things to use further from here.

1. Application Id aka Client Id
2. Tenant Id

3. Client Secret

4. Application Id & Tenant Id you can grab from App Overview.

5. To generate Client Secret go to Certificates & secrets and then + New client secret, Give some description and select validity of your secret, click Add.

6. Client Secret is something which you should keep secret, that why you can see this only once after generation, copy it and keep it safe to use later.

7. 

Step 2: Create Application User

• You need to create a new user, all CRM Api calls will be made on behalf of this user.
• This user does not require Dynamics 365 license.
• This user should be created from Azure(https://portal.azure.com), not from Office Portal(https://admin.microsoft.com)
• Navigate to Azure -> Azure Active Directory -> Users, Click on + New user.

• Here Username field must be has same domain name as your org.
• Once this user is create, Go to your Dynamics 365 instance.
• Navigate to Dynamics 365 -> Settings -> Security, Click on Users here.

• Change view to Application Users & click on + NEW to create new Application User.

• You may need to set form also as Application User if it’s not coming by default.

• Here Application ID must be the same as Azure AD App created in previous step. Username & email you can keep same as the one created in Azure AD. Though it’s not necessary to be the same, I have tried with different name also. Once you save it Application ID URI & Azure AD Object ID will auto populate.

• Now you need to assign security role to this user to perform operation on desired records, I’ve seen in many blogs that this user must have a custom security role, so you can copy some existing role and assign it. But when I tried with OOB security role it was still working.

Step 3: Get Access Token with ADAL

• Create new project in Visual Studio and add ADAL package via NuGet.

• Create below shown method and replace Application Id, Client Secret, Tenant Id & your organization Url in appropriate place.

Step 4: Consuming Access Token

• You have access token now, you can make request to your Dynamics 365 by including this to your HTTP requests, see below method.

  public static async Task CrmRequest(HttpMethod httpMethod, string requestUri, string body = null) {

  var accessToken = await AccessTokenGenerator();
  var client = new HttpClient();
  var msg = new HttpRequestMessage(httpMethod, requestUri);
  msg.Headers.Add("OData-MaxVersion", "4.0");
  msg.Headers.Add("OData-Version", "4.0");
  msg.Headers.Add("Prefer", "odata.include-annotations=\"*\"");
  
  // Passing AccessToken in Authentication header
  msg.Headers.Add("Authentication", $"Bearer {accessToken}");
  
  if (body != null)
      msg.Content = new StringContent(body, UnicodeEncoding.UTF8, "application/json");
  
  return await client.SendAsync(msg);
  

  }

• You can make different requests using above method, here is an example for retrieving all contacts with GET.

  var contacts = CrmRequest(

  HttpMethod.Get, 
  "https://efrig.api.crm8.dynamics.com/api/data/v9.1/contacts")
  .Result.Content.ReadAsStringAsync();
  

Full Code (Replace your Azure Credentials before executing)

using Microsoft.IdentityModel.Clients.ActiveDirectory;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace D365S2S
{
    class Program
    {
        static void Main(string[] args)
        {
            var contacts = CrmRequest(
                HttpMethod.Get,
                "https://efrig.api.crm8.dynamics.com/api/data/v9.1/contacts")
                .Result.Content.ReadAsStringAsync();
            // Similarly you can make POST, PATCH & DELETE requests
        }

        public static async Task<string> AccessTokenGenerator()
        {
            string clientId = "13950f0e-0000-4e2f-0000-b923302c4338"; // Your Azure AD Application ID
            string clientSecret = "0^C#%0000DR7/#Z[-.m5aYO00000000$"; // Client secret generated in your App
            string authority = "https://login.microsoftonline.com/ceb48f70-0000-1111-0000-9170f6a706a6"; // Azure AD App Tenant ID
            string resourceUrl = "https://efrig.crm8.dynamics.com"; // Your Dynamics 365 Organization URL

            var credentials = new ClientCredential(clientId, clientSecret);
            var authContext = new Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContext(authority);
            var result = await authContext.AcquireTokenAsync(resourceUrl, credentials);
            return result.AccessToken;
        }

        public static async Task<HttpResponseMessage> CrmRequest(HttpMethod httpMethod, string requestUri, string body = null)
        {
            // Acquiring Access Token
            var accessToken = await AccessTokenGenerator();

            var client = new HttpClient();
            var message = new HttpRequestMessage(httpMethod, requestUri);

            // OData related headers
            message.Headers.Add("OData-MaxVersion", "4.0");
            message.Headers.Add("OData-Version", "4.0");
            message.Headers.Add("Prefer", "odata.include-annotations=\"*\"");

            // Passing AccessToken in Authentication header
            message.Headers.Add("Authorization", $"Bearer {accessToken}");

            // Adding body content in HTTP request 
            if (body != null)
                message.Content = new StringContent(body, UnicodeEncoding.UTF8, "application/json");

            return await client.SendAsync(message);
        }
    }
}

Hope it helps, feel free to get in touch for any query/suggestions.

Sometimes we need to programatically query that which all records are participating in customer journey workflow. Then we need to parse JSON store in msdyncrm_workflowdefinition field, while doing this in client side linq.js will make our job easy af.

Below is the code to parse a few components which can be used as it is, or you might need to modify code a bit as per requirement or if you are adding you custom channels to your customer journey. This code snippet is stored as Github Gist at https://gist.github.com/AshV/b0eb8aef725a8c6670d3c20f80b54029.

In above code I have written a function to filter all the node reference related to provided component, which can be queried further as per requirements. Below given is json for a typical customer journey workflow you can observe outer ActivityTypeId is representing type of tile in customer jorney designer while inner ActivityTypeId is refering to reocrds in most of the places.

[
    {
        "ActivityTypeId": "bpf_root",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "bpf_root",
                    "Title": "Undefined",
                    "Name": "New ActivityTypeName_bpf_root_TitleText",
                    "ActivityItemId": 0
                },
                {
                    "ItemId": null,
                    "ActivityTypeId": "bpf_root",
                    "Title": "Undefined",
                    "Name": "New ActivityTypeName_bpf_root_TitleText",
                    "ActivityItemId": 1
                }
            ]
        }
    },
    {
        "ActivityTypeId": "Segment",
        "ParentActivityId": "01",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "Segment",
                    "Title": "Undefined",
                    "Name": "my customers",
                    "ActivityItemId": 8,
                    "SegmentMergeMethod": "Union",
                    "ContainmentMethod": "Inclusion",
                    "Description": ""
                },
                {
                    "ItemId": null,
                    "ActivityTypeId": "SegmentItem",
                    "Title": "Undefined",
                    "Name": "New Segment",
                    "ActivityItemId": 9,
                    "ContainmentMethod": "Inclusion",
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "Email",
        "ParentActivityId": "01_2",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2_4",
        "Properties": {
            "Items": [
                {
                    "ItemId": "08634d0e-25dc-e811-a965-000d3af2924b",
                    "ActivityTypeId": "Email",
                    "Title": "Undefined",
                    "Name": "invite email",
                    "ActivityItemId": 17,
                    "Description": ""
                },
                {
                    "ItemId": null,
                    "ActivityTypeId": "LandingPage",
                    "Title": "Undefined",
                    "Name": "event page",
                    "ActivityItemId": 28,
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "Trigger",
        "ParentActivityId": "01_2_4_14_19",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2_4_7",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "Trigger",
                    "Title": "Undefined",
                    "Name": "registered?",
                    "ActivityItemId": 38,
                    "TimeoutValue": 5,
                    "ConditionExpressions": [
                        {
                            "SourceActivityItemId": "28",
                            "Condition": "UserRegistered"
                        }
                    ],
                    "RuleLogic": "AND",
                    "TimeoutUnit": "Day",
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "empty",
        "ParentActivityId": "01_2_4_7",
        "ParentBranchId": 1,
        "ParentRelationshipType": "NoBranch",
        "ActivityId": "01_2_4_7_9",
        "Properties": {
            "Items": []
        }
    },
    {
        "ActivityTypeId": "CreateCrmActivity",
        "ParentActivityId": "01_2_4_7",
        "ParentBranchId": 0,
        "ParentRelationshipType": "YesBranch",
        "ActivityId": "01_2_4_7_11",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "CreateCrmActivity",
                    "Title": "Undefined",
                    "Name": "follow up call",
                    "ActivityItemId": 50,
                    "TemplateEntityLogicalName": "msdyncrm_phonecallactivitymarketingtemplate",
                    "ActivityTypeName": "phonecall",
                    "Owner": "msdyncrm_customerjourney.ownerid",
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "Email",
        "ParentActivityId": "01_2_4_7_11_32",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2_4_7_11_26_30",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "Email",
                    "Title": "Undefined",
                    "Name": "thank you",
                    "ActivityItemId": 80,
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "Scheduler",
        "ParentActivityId": "01_2_4_7_11",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2_4_7_11_32",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "Scheduler",
                    "Title": "Undefined",
                    "Name": "New Scheduler",
                    "ActivityItemId": 98,
                    "WaitUntilMonday": true,
                    "WaitUntilTuesday": true,
                    "WaitUntilWednesday": true,
                    "WaitUntilThursday": true,
                    "WaitUntilFriday": true,
                    "WaitUntilSaturday": true,
                    "WaitUntilSunday": true,
                    "WaitUntilFromHour": 0,
                    "WaitUntilFromMinute": 0,
                    "WaitUntilToHour": 23,
                    "WaitUntilToMinute": 59,
                    "OffsetType": "Duration",
                    "ScheduledDurationUnit": "Minute",
                    "ScheduledHour": 0,
                    "ScheduledMinute": 0,
                    "ScheduledDurationValue": 0,
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "Event",
        "ParentActivityId": "01_2_4",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2_4_14",
        "Properties": {
            "Items": [
                {
                    "ItemId": "306c65eb-18dc-e811-a96a-000d3af29d99",
                    "ActivityTypeId": "Event",
                    "Title": "Undefined",
                    "IsNameSystemDefined": true,
                    "Name": "New Event",
                    "ActivityItemId": 65,
                    "Description": ""
                }
            ]
        },
        "EntityTarget": "contact"
    },
    {
        "ActivityTypeId": "Event",
        "ParentActivityId": "01_2_4_14",
        "ParentBranchId": 0,
        "ParentRelationshipType": "Default",
        "ActivityId": "01_2_4_14_19",
        "Properties": {
            "Items": [
                {
                    "ItemId": null,
                    "ActivityTypeId": "Event",
                    "Title": "Undefined",
                    "IsNameSystemDefined": true,
                    "Name": "New Event",
                    "ActivityItemId": 91
                }
            ]
        },
        "EntityTarget": "contact"
    }
]

Hope it helps.

Then after few more google search I got sevearal javascript libraries with LINQ like syntax, after comparing I found linq.js most promising and even size is lesser when comparing to lodash and underscore.

Library

GZipped size

lodash

~ 24 KB

linq.js

~ 7 KB

underscore

~ 6.6 KB

linq.js github project link -> https://github.com/mihaifm/linq

With Linq.js dynamics 365 developers can use their existing knowledge of LINQ in javascript code whith nominal changes. see below examples from their github

// C# LINQ - delegate
Enumerable.Range(1, 10)
    .Where(delegate(int i) { return i % 3 == 0; })
    .Select(delegate(int i) { return i * 10; });

// linq.js - anonymous function
Enumerable.range(1, 10)
    .where(function(i) { return i % 3 == 0; })
    .select(function(i) { return i * 10; });


// C# LINQ - lambda
Enumerable.Range(1, 10).Where(i => i % 3 == 0).Select(i => i * 10);

// linq.js - arrow function
Enumerable.range(1, 10).where(i => i % 3 == 0).select(i => i * 10);


// C# LINQ - anonymous type
array.Select((val, i) => new { Value = val, Index = i });

// linq.js - object literal
Enumerable.from(array).select((val, i) => ({ value: val, index: i}));

Example with Dynamics 365/CRM

Let’s retrieve some data from CRM and query in client side javascript. First of all download and save linq.min.js as a javascript webresource, and save below code as html webresource and change your linq.js webresource name accordingly.

<head>
  <title>Trying linq.js</title>
  <script src="/WebResources/new_linq.js" type="text/javascript"></script>
  <script src="ClientGlobalContext.js.aspx" type="text/javascript"></script>
  <script>
    // to bypass a product bug, ignore this
    window["ENTITY_SET_NAMES"] = window["ENTITY_SET_NAMES"] || '{ "account" : "accounts"}';

    // retrieving accoount records
    Xrm.WebApi.retrieveMultipleRecords("account").then(
      function(result) {
        debugger;
        console.log(result);
        // storing all the records to var accounts 
        var accounts = result.entities;

        // build query filter all records with address1_city == "Redmond"
        var accountsCityRedmond = Enumerable.from(accounts).where(a => a.address1_city == "Redmond");
        // use toArray(); to evaluate the query
        console.log(accountsCityRedmond.toArray());

        // previously built query can be filtered even further
        var accountsCityRedmondCountryColumbia = accountsCityRedmond.where(a => a.address1_country == "Columbia").select(w => w.websiteurl);
        // and can be evaluated anytime with .toArray()
        console.log(accountsCityRedmondCountryColumbia.toArray());
      },
      function(error) {
        console.log(error.message);
      }
    );
  </script>
</head>

Run above HTML web resource in browser & press F12 to see output, it would be similar to below shown output, I have run this code in newly created trial instance of dynamics 365.

Go through code comments to understand it better.

Hope it helps. Feel free to ask any questons.

For creating N:N relationships between tables itersect tables are used which usually has 3 columns It’s own primary key, first table’s primary key & second table’s primary key. In dynamics 365 GUIDs are used as primary key so each row conatins 3 GUIDs with given data.

To execute fetchXML, dynamics 365 webAPI requires entity’s plural name, but intersect tables don’t have that so we need to link with one of participating entity in fetchXML to query intersect entity.

Syntax: WebAPI Endpoint + / + Entity Plural Name + ?fetchXml= + Your fetchXml here

Find more here about executing fetchXml with WebAPI

You need to form fetchXML like this, here entity could be either of User or Security Role, their logical names are systemuser & role resplectivey. Relationship entity name can be found in N:N relationship in solutions. (refer image)

Syntax:

<fetch>
   <entity name="Entity Name">
      <attribute name="Entity Logical ID" />
      <link-entity name="Relationship Entity Name" from="Entity ID" to="Entity ID" intersect="true">
         <all-attributes />
      </link-entity>
   </entity>
</fetch>

Images:Find Relationship Entity Name

Create FetchXML

FetchXml can be written against any of the participating entity, in this case User & Security Role. It should be executed accordingly in webAPI with same entity’s plural name which is used in fetchXML. See below.

For Security Role => OrgURL/api/data/v9.0/roles?…

For User => OrgURL/api/data/v9.0/systemusers?…

<fetch>
  <entity name="role">
    <attribute name="roleid" />
    <link-entity name="systemuserroles" from="roleid" to="roleid" intersect="true">
     <all-attributes/>
    </link-entity>
  </entity>
</fetch>


<fetch>
  <entity name="systemuser">
    <attribute name="systemuserid" />
    <link-entity name="systemuserroles" from="systemuserid" to="systemuserid" intersect="true">
     <all-attributes/>
    </link-entity>
  </entity>
</fetch>

Click here to use Fetch XML Tester to verify created query

Output: it would look similar

{
   "@odata.context":"https://ashv.crm.dynamics.com/api/data/v8.2/$metadata#roles(roleid)",
   "value":[
      {
         "@odata.etag":"W/\"1003197\"",
         "roleid":"e9133cb3-92e5-41c1-a242-9d17098e5f7b",
         "systemuserroles1_x002e_systemuserroleid":"1b22830d-93c0-e811-a960-000d3af0375c",
         "systemuserroles1_x002e_roleid":"e9133cb3-92e5-41c1-a242-9d17098e5f7b",
         "systemuserroles1_x002e_systemuserid":"e4613b07-93c0-e811-a960-000d3af06590"
      },
      {
         "@odata.etag":"W/\"1003198\"",
         "roleid":"1a71447c-8751-4bf6-9800-a53faa4258f3",
         "systemuserroles1_x002e_systemuserroleid":"bc1c140d-93c0-e811-a962-000d3af04fc2",
         "systemuserroles1_x002e_roleid":"1a71447c-8751-4bf6-9800-a53faa4258f3",
         "systemuserroles1_x002e_systemuserid":"e4613b07-93c0-e811-a960-000d3af06590"
      }
   ]
}

Hope it helps.