USD Website Integration


In this topic, we will go through how to integrate USD with a website. In the scenario, an agent may need to look up information in a website and would want to do this within the context and session of USD.

Let’s go through the example on MSDN here.

First, we will create a website application, i.e. a typical ASP.NET website. We will create this for the purpose of the demonstration, and when we integrate with USD, the idea is that we do not have access to the website code.

Open the project located in the UII SDK – UII\SampleCode\UII\AIF\QsWebApplication.

You may need to replace the Microsoft.Uii.Csr.Core dll with the one from the UII\Bin\UII directory.

Let’s look at the code. The default page is pretty simple, setting the text boxes:

Save the solution and then compile the project. Press F5 and you will see the website URL with the text boxes created:

Next, create a hosted control in the Dynamics 365, with the highlighted parameters:

At this point we can confirm USD is configured to open the new hosted control. On signing in, we see the control. The values are empty as we have not integrated the control with our application fully.

Next, we will create a web application adapter to get USD to talk to the web application.

In Visual Studio, create a new project. Select Unified Service Desk->UII Web Application Adapter:

The project will look like below when you open it:

If you have missing references, you can re-add these from the assemblies in the UII\Bin\UII directory.

Under Uii Methods, there is NotifyContextChange, which runs when the context has changed.

We will add code in the NotifyContextChange method to set values of the text boxes from the context in USD. When we open a new contact, we will be able to get these values (firstname, lastname, address1_line1, CustomerID) and assign them to our hosted control’s text fields:

Also, ensure to add the using mshtml line or you will get compile errors on HTMLDocument:

Override the DoAction method to set the values of the text fields with the context from USD:

Compile and build. We will now configure the application adapter. Go to the hosted control we set up in the USD configuration and change the Adapter Configuration to:

The URI is the assembly name and the Type is the assembly name and default class, in this case WebAdapter:

To deploy the code to the client, copy the code to the USD client folder:

We can now test this in USD. Launch the USD client. At first, there is nothing in the hosted control:

Click on Search and select the Patrick sample:

The sample application is populated with the data:

We can see the context variables in the debugger:

Update the Last Name:

Note the web application is now also updated:



Carl de Souza is a developer and architect focusing on Microsoft Dynamics 365, Power BI, Azure, and AI.

carldesouza.comLinkedIn Twitter | YouTube


2 Responses to USD Website Integration

    • Hi Arun,

      Good question! I did some digging, the environment that I did this on is no longer available. It may have been installed through a sample. If I find something I’ll reach back out.

Leave a Reply

Your email address will not be published. Required fields are marked *