Assigning Case To Appropriate Team User Using Plugin In Dynamics 365/ CRM

Ashish Vishwakarma
Mar 15, 2017

49k
0
6
- facebook
- twitter
- linkedIn
- Reddit
- WhatsApp
- Email
- Print
- Other Artcile

In a recent project, I have worked on one interesting functionality, where I have written a plugin for a Case record to be triggered while assigning it to a Team, and it should fulfil these three requirements.

If the Team has no users in it, Case should be assigned to the default queue of Team.
If the Team has users, the Case should be assigned to the user with the least number of cases.
If more than one user in the Team have the same number of cases, then the case should be randomly assigned to one of them.

Here, I will show you how to implement the above functionaliy. To simplify, I am not using any custom attribute or an entity; you can just create an online trial instance of Dynamics CRM/365 and try it out.

Section 1

Code

Step 1

Create a new project in Visual Studio of type Class Library and give the name. I have given the name as AssignPlugin and don't forget to set the framework version to 4.5.2.

Dynamics CRM

Step 2

Add the required references to project from CRM SDK.

Dynamics CRM

Step 3

Remove the existing class from the project and add a new class to the project with some name like AssignTeamToUser.cs.

Open this class, make it public, add namespace “Microsoft.Xrm.Sdk” and inherit “IPlugin” interface, which is required for the plugin.

IPlugin requires Execute method to be implemented, so add it to our class.

Now, the code should look, as shown below.

using Microsoft.Xrm.Sdk;
using System;
namespace AssignPlugin
{
public class AssignTeamToUser : IPlugin
{
public void Execute(IServiceProvider serviceProvider)
{
}
}
}

Step 4

Now, we need to add some boilerplate code for some null checks and obtain plugin context and organization Service reference. It's a good idea to maintain business logic separately, so BusinessLogic method in it will contain our Business Logic.

using Microsoft.Xrm.Sdk;
using System;
namespace AssignPlugin
{
public class AssignTeamToUser : IPlugin
{
public void Execute(IServiceProvider serviceProvider)
{
if (serviceProvider == null) return;
// Obtain the Plugin Execution Context
var context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));
// Obtain the organization service reference.
var serviceFactory = (IOrganizationServiceFactory)serviceProvider.GetService(typeof(IOrganizationServiceFactory));
var service = serviceFactory.CreateOrganizationService(context.UserId);
// To check depth
if (context.Depth > 2) return;
// The InputParameters collection contains all the data passed in the message request.
if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is EntityReference)
{
// Business logic goes here
new AssignTeamToUser().BusinessLogic(service, context);
}
}
private void BusinessLogic(IOrganizationService service, IExecutionContext context)
{
// Business Logic
}
}
}

Step 5

While registering plugin in Assign step, it will have two Input parameters in context with the name Target & Assignee, we will pick them in the variable for further use. See the code given below.

private void BusinessLogic(IOrganizationService service, IExecutionContext context)
{
// We are hitting Assign button on a Case record so Target will be a Case record
var caseEntityReference = (EntityReference)context.InputParameters["Target"];
// Assignee could be a User or Team
var teamEntityReference = (EntityReference)context.InputParameters["Assignee"];
// In our requirement it should be a Team, otherwise return
if (teamEntityReference.LogicalName != "team") return;
}

Step 6

Now, let’s jump into the main game. We will retrieve all the users in the given team, using fetchXml. Add namespace Microsoft.Xrm.Sdk.Query in our class, so FetchExpression will be available for the user.

private void BusinessLogic(IOrganizationService service, IExecutionContext context)
{
// We are hitting Assign button on a Case record so Target will be a Case record
var caseEntityReference = (EntityReference)context.InputParameters["Target"];
// Assignee could be a User or Team
var teamEntityReference = (EntityReference)context.InputParameters["Assignee"];
// In our requirement it should be a Team, if user it should return
if (teamEntityReference.LogicalName != "team") return;
// fetchXml to retrieve all the users in a given Team
var fetchXmlLoggedUserInTeam = @"
<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='true'>
<entity name='systemuser'>
<attribute name='systemuserid' />
<link-entity name='teammembership' from='systemuserid' to='systemuserid' visible='false' intersect='true'>
<link-entity name='team' from='teamid' to='teamid' alias='ac'>
<filter type='and'>
<condition attribute='teamid' operator='eq' uitype='team' value='{0}' />
</filter>
</link-entity>
</link-entity>
</entity>
</fetch>";
// Passing current Team is fetchXml and retrieving Team's user
var users = service.RetrieveMultiple(new FetchExpression(string.Format(
fetchXmlLoggedUserInTeam,
teamEntityReference.Id))).Entities;
}

Step 7

(Implement Condition 1)

If FetchExpression` in the last step returns no users, then we will assign case record for the default queue of the Team, using AddToQueueRequest, add namespace Microsoft.Crm.Sdk.Messages in order to use the same.

Here, we are retrieving Id of default Queue of Team, which is used in DestinationQueueId parameter of AddToQueueRequest and in Target parameter, our case record is given.

Now, complete the code for the given condition and it should look, as shown below.

using Microsoft.Crm.Sdk.Messages;
using Microsoft.Xrm.Sdk;
using Microsoft.Xrm.Sdk.Query;
using System;
namespace AssignPlugin
{
public class AssignTeamToUser : IPlugin
{
public void Execute(IServiceProvider serviceProvider)
{
if (serviceProvider == null) return;
// Obtain the Plugin Execution Context
var context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));
// Obtain the organization service reference.
var serviceFactory = (IOrganizationServiceFactory)serviceProvider.GetService(typeof(IOrganizationServiceFactory));
var service = serviceFactory.CreateOrganizationService(context.UserId);
// To check depth
if (context.Depth > 2) return;
// The InputParameters collection contains all the data passed in the message request.
if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is EntityReference)
{
// Business logic goes here
new AssignTeamToUser().BusinessLogic(service, context);
}
}
private void BusinessLogic(IOrganizationService service, IExecutionContext context)
{
// We are hitting Assign button on a Case record so Target will be a Case record
var caseEntityReference = (EntityReference)context.InputParameters["Target"];
// Assignee could be a User or Team
var teamEntityReference = (EntityReference)context.InputParameters["Assignee"];
// In our requirement it should be a Team, if user it should return
if (teamEntityReference.LogicalName != "team") return;
// fetchXml to retrieve all the users in a given Team
var fetchXmlLoggedUserInTeam = @"
<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='true'>
<entity name='systemuser'>
<attribute name='systemuserid' />
<link-entity name='teammembership' from='systemuserid' to='systemuserid' visible='false' intersect='true'>
<link-entity name='team' from='teamid' to='teamid' alias='ac'>
<filter type='and'>
<condition attribute='teamid' operator='eq' uitype='team' value='{0}' />
</filter>
</link-entity>
</link-entity>
</entity>
</fetch>";
// Passing current Team is fetchXml and retrieving Team's user
var users = service.RetrieveMultiple(new FetchExpression(string.Format(
fetchXmlLoggedUserInTeam,
teamEntityReference.Id))).Entities;
// Condition 1
// If user count is zero case should be assigned to Team's default Queue
if (users.Count == 0)
{
var team = service.Retrieve("team", teamEntityReference.Id, new ColumnSet("queueid"));
var addToQueueRequest = new AddToQueueRequest
{
Target = caseEntityReference,
DestinationQueueId = team.GetAttributeValue<EntityReference>("queueid").Id
};
service.Execute(addToQueueRequest);
}
} }
}

Our first condition is done. You can directly jump to further sections to quickly test it. Follow the steps further to implement the rest of the conditions.

Step 8

(Implement Condition 2)

If the Team has users available in it, then cases should be assigned to the user. With the least number of cases, follow the else part in the code given below.

Namespaces System.Collections.Generic & System.Linq needs to be added.

// Condition 1
// If user count is zero case should be assigned to Team's default Queue
if (users.Count == 0)
{
var team = service.Retrieve("team", teamEntityReference.Id, new ColumnSet("queueid"));
var addToQueueRequest = new AddToQueueRequest
{
Target = caseEntityReference,
DestinationQueueId = team.GetAttributeValue<EntityReference>("queueid").Id
};
service.Execute(addToQueueRequest);
}
else
{
var caseCountAssignedToUser = new Dictionary<Guid, int>();
users.ToList().ForEach(user =>
{
var fetchXmlCaseAssignedToUser = @"
<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='false'>
<entity name='incident'>
<attribute name='incidentid' />
<link-entity name='systemuser' from='systemuserid' to='owninguser' alias='ab'>
<filter type='and'>
<condition attribute='systemuserid' operator='eq' uitype='systemuser' value='{0}' />
</filter>
</link-entity>
</entity>
</fetch>";
var cases = service.RetrieveMultiple(new FetchExpression(string.Format(
fetchXmlCaseAssignedToUser,
user.Id))).Entities.ToList();
caseCountAssignedToUser.Add(user.Id, cases.Count);
});
var sortedCaseCount = from entry in caseCountAssignedToUser
orderby entry.Value ascending
select entry;
var allUserWithSameLeastNumberOfCases = sortedCaseCount
.Where(w => w.Value == sortedCaseCount.First().Value).ToList();
var targetUser = new Guid();
// Condition 1
// Assign the case to user with least number of case assigned
if (allUserWithSameLeastNumberOfCases.Count() == 1)
{
targetUser = sortedCaseCount.First().Key;
}
var assign = new AssignRequest
{
Assignee = new EntityReference("systemuser", targetUser),
Target = caseEntityReference
};
service.Execute(assign);
}

Step 9

(Implement Condition 3)

If more than one user has the same number of cases, then it should be assigned randomly, else follow the part in the code given below.

// Condition 1
// Assign case to user with least number of case assigned
if (allUserWithSameLeastNumberOfCases.Count() == 1)
{
targetUser = sortedCaseCount.First().Key;
}
// Condition 2
// If more than one users are having same least number of users, then it be assigned randomly
else
{
var randomUser = new Random().Next(0, allUserWithSameLeastNumberOfCases.Count() - 1);
targetUser = allUserWithSameLeastNumberOfCases[randomUser].Key;
}
var assign = new AssignRequest
{
Assignee = new EntityReference("systemuser", targetUser),
Target = caseEntityReference
};
service.Execute(assign);

Step 10

(Sign the Assembly)

In order to use the plugin in Dynamics 365/CRM assembly has to be signed.

To sign, right click on the project and click Properties.
Click on signing on the left pane
Check Sign the assembly checkbox.
In Choose a strong name key file dropdown, select new.
In dialog box, give some name for the key.
Uncheck Protect my key file with a password (Optional).
Hit OK to save.

Now, our final code looks, as shown below.

using Microsoft.Crm.Sdk.Messages;
using Microsoft.Xrm.Sdk;
using Microsoft.Xrm.Sdk.Query;
using System;
using System.Collections.Generic;
using System.Linq;
namespace AssignPlugin
{
public class AssignTeamToUser : IPlugin
{
public void Execute(IServiceProvider serviceProvider)
{
if (serviceProvider == null) return;
// Obtain the Plugin Execution Context
var context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));
// Obtain the organization service reference.
var serviceFactory = (IOrganizationServiceFactory)serviceProvider.GetService(typeof(IOrganizationServiceFactory));
var service = servicefonFactory.CreateOrganizationService(context.UserId);
// To check depth
if (context.Depth > 2) return;
// The InputParameters collection contains all the data passed in the message request.
if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is EntityReference)
{
// Business logic goes here
new AssignTeamToUser().BusinessLogic(service, context);
}
}
private void BusinessLogic(IOrganizationService service, IExecutionContext context)
{
// We are hitting Assign button on a Case record so Target will be a Case record
var caseEntityReference = (EntityReference)context.InputParameters["Target"];
// Assignee could be a User or Team
var teamEntityReference = (EntityReference)context.InputParameters["Assignee"];
// In our requirement it should be a Team, if user it should return
if (teamEntityReference.LogicalName != "team") return;
// fetchXml to retrieve all the users in a given Team
var fetchXmlLoggedUserInTeam = @"
<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='true'>
<entity name='systemuser'>
<attribute name='systemuserid' />
<link-entity name='teammembership' from='systemuserid' to='systemuserid' visible='false' intersect='true'>
<link-entity name='team' from='teamid' to='teamid' alias='ac'>
<filter type='and'>
<condition attribute='teamid' operator='eq' uitype='team' value='{0}' />
</filter>
</link-entity>
</link-entity>
</entity>
</fetch>";
// Passing current Team is fetchXml and retrieving Team's user
var users = service.RetrieveMultiple(new FetchExpression(string.Format(
fetchXmlLoggedUserInTeam,
teamEntityReference.Id))).Entities;
// Condition 1
// If user count is zero case should be assigned to Team's default Queue
if (users.Count == 0)
{
// Retrieving Team's default Queue
var team = service.Retrieve("team", teamEntityReference.Id, new ColumnSet("queueid"));
var addToQueueRequest = new AddToQueueRequest
{
// Case record
Target = caseEntityReference,
// Team's default Queue Id
DestinationQueueId = team.GetAttributeValue<EntityReference>("queueid").Id
};
service.Execute(addToQueueRequest);
}
else
{
// Dictionary to save UserId and number of case assigned pair
var caseCountAssignedToUser = new Dictionary<Guid, int>();
users.ToList().ForEach(user =>
{
// FetchXml query to retrieve number cases assigned to each user
var fetchXmlCaseAssignedToUser = @"
<fetch version='1.0' output-format='xml-platform' mapping='logical' distinct='false'>
<entity name='incident'>
<attribute name='incidentid' />
<link-entity name='systemuser' from='systemuserid' to='owninguser' alias='ab'>
<filter type='and'>
<condition attribute='systemuserid' operator='eq' uitype='systemuser' value='{0}' />
</filter>
</link-entity>
</entity>
</fetch>";
var cases = service.RetrieveMultiple(new FetchExpression(string.Format(
fetchXmlCaseAssignedToUser,
user.Id))).Entities.ToList();
// Adding user id with number of cases assigned to Dictionay defined above
caseCountAssignedToUser.Add(user.Id, cases.Count);
});
// Sorting in ascending order by number of cases
var sortedCaseCount = from entry in caseCountAssignedToUser
orderby entry.Value ascending
select entry;
// Getting all the users with least sae number of cases
var allUserWithSameLeastNumberOfCases = sortedCaseCount
.Where(w => w.Value == sortedCaseCount.First().Value).ToList();
var targetUser = new Guid();
// Condition 1
// Assign case to user with least number of case assigned
if (allUserWithSameLeastNumberOfCases.Count() == 1)
{
targetUser = sortedCaseCount.First().Key;
}
// Condition 2
// If more than one users are having same least number of users, then it be assigned randomly
else
{
var randomUser = new Random().Next(0, allUserWithSameLeastNumberOfCases.Count() - 1);
targetUser = allUserWithSameLeastNumberOfCases[randomUser].Key;
}
var assign = new AssignRequest
{
Assignee = new EntityReference("systemuser", targetUser),
Target = caseEntityReference
};
service.Execute(assign);
}
}
}
}

Section 2

Deploying in Dynamics 365/CRM

To deploy the plugin to CRM

Build the project.
Open Plugin Registration tool and connect it to your Dynamics CRM instance.

Click Register, followed by clicking Register new assembly.
In popup Step 1, select your DLL from the debug folder, which we have just created and the location will be similar to this

"C:\Users\AshV\Documents\Visual Studio 2017\Projects\AssignPlugin\AssignPlugin\bin\Debug\AssignPlugin.dll"

In Step 2, check select all and hit Register Selected Plugin button.

After success, you will see the message given below.

Now, a new step has to be resistered on Assign step of Case record, else this plugin will not be triggered. To regster, right click on assemly and click Register new step.

In dialogbox, select Message as Assign and Primary Entity as an incident (i.e. case).

Hit Register

Section 3

Configuration in CRM & Verifying Functionality

Create Team with Administrator priviledges by following Settings -> Security -> Teams and create new Team. I have given Team name as Quick Service Team.

Assign System Administrator Role to the newly created Team.

Now, this Team has no users. If any case is assigned to this Team it will go to the default queue, let's try it out.
Hit Assign, select Assign To as a User or Team, select Quick Service Team and hit Asssign.

After assigning hit Queue Item Details to verify whether it is assigned to the Queue or not.

To verify the rest of two conditions, create a few more users in Team and try assigning the record to Team and see how records are getting assigned.

You can find this code in my GitHub repo as well https://github.com/AshishVishwakarma/AssignPluginDynamics365. For any query regarding this, feel free to get in touch with me.

Recommended Free Ebook

Printing in C# Made Easy

Download Now!