Walkthrough: Create a UII WPF Hosted Control

 

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

This walkthrough demonstrates how you can build a Windows Presentation Foundation (WPF)-based User Interface Integration (UII) hosted control that interacts with Unified Service Desk and external applications (standalone and web).

In this walkthrough, you’ll:

• Create a UIIWPF hosted control, Sample UII WPF Hosted Control, which will display first name, last name, street address and ID of a contact when you search for contacts, and click a contact name to open it in a session in Unified Service Desk. These values are displayed from the Unified Service Desk context.

• Change first name, last name, or street address values in an external application and web application hosted in Unified Service Desk from the UIIWPF hosted control that we create. The external and web applications were created in the following earlier walkthroughs: Walkthrough: Create a UII Application Adapter and Walkthrough: Create a UII Web Application Adapter.

• Notify changes to the Unified Service Desk context to update the values there.

In This Topic

Prerequisites

Step 1: Create a UII WPF hosted control using Visual Studio

Step 2: Define the hosted control in Unified Service Desk

Step 3: Define UII actions for the external application and web application hosted controls in Unified Service Desk

Test the hosted control

Prerequisites

• Microsoft .NET Framework 4.5.2

• Unified Service Desk client application. This is required for testing the hosted control.

• Microsoft Visual Studio 2012, Visual Studio 2013, or Visual Studio 2015

• NuGet Package Manager for Visual Studio 2012, Visual Studio 2013, or Visual Studio 2015

• Microsoft Dynamics 365 SDK templates for Visual Studio that contain the UIIWPF hosted control project template. You can get the template in one of the following ways:

  • Download the CRM SDK template. Double-click the CRMSDKTemplates.vsix file to install the template in Visual Studio.

  • Download and extract the CRM SDK package. Go to the SDK\Templates folder. Double-click the CRMSDKTemplates.vsix file to install the template in Visual Studio.

• You should have completed the Walkthrough: Create a UII Application Adapter and Walkthrough: Create a UII Web Application Adapter to ensure that you have the external and web applications set up with the adapters to facilitate interaction with those applications.

Step 1: Create a UII WPF hosted control using Visual Studio

1. Start Visual Studio, and create a new project.

2. In the New Project dialog box:

   1. From the list of installed templates, expand Visual C#, and select Dynamics 365 SDK Templates > Unified Service Desk > UII WPF Hosted Control.

   2. Specify the name and location of the project, and choose OK to create a new project.

      

3. In Solution Explorer, right-click the UiiWpfControl.xaml file, and select Open to display the XAML designer.

4. In the designer, add the following controls from the Toolbox:

   Control type	Name	Text
   Label	lblFirstName	First Name
   Label	lblLastName	Last Name
   Label	lblAddress	Street Address
   Label	lblID	ID
   TextBox	txtFirstName
   TextBox	txtLastName
   TextBox	txtAddress
   TextBox	txtID
   Button	btnUpdate	Update values in hosted apps
   Button	btnUpdateContext	Update context

   This is how the controls should be laid out in the XAML designer.

   

5. Double-click the Update values in hosted apps button (btnUpdate) to add the code for the click event for this button, and add the following code.

   private void btnUpdate_Click(object sender, System.Windows.RoutedEventArgs e)
   {
      // This is how you fire an action to other hosted applications. 
      // The DoAction() code in the other application or application adapter 
      // will be called.
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateFirstName", txtFirstName.Text)); // For the external application
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateLastName", txtLastName.Text)); // For the external application
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateAddress", txtAddress.Text)); // For the external application
   
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateFirstName", txtFirstName.Text)); // For the external web application
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateLastName", txtLastName.Text)); // For the external web application
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateAddress", txtAddress.Text)); // For the external web application
   }
   

6. Go to the XAML designer, and double-click the Update context button (btnUpdateContext) to add the code for the click event for this button. Add the following code.

   private void btnContextChange_Click(object sender, System.Windows.RoutedEventArgs e)
   {
      // Get the current context and create a new context object from it.
      string temp = Context.GetContext();
      Context updatedContext = new Context(temp);
   
      // Update the new context with the changed information.
      updatedContext["firstname"] = txtFirstName.Text;
      updatedContext["lastname"] = txtLastName.Text;
      updatedContext["address1_line1"] = txtAddress.Text;
   
      // Notify Unified Service Desk of this new context information.
      FireChangeContext(new ContextEventArgs(updatedContext));
   
      // Notify this UII hosted control about the change.
      NotifyContextChange(updatedContext);
   }
   

7. In the same file (UiiWpfControl.xaml.cs), update the override definition of the NotifyContextChange method to the following.

   public override void NotifyContextChange(Context context)
   {
      // Populating text fields from context information.
      txtFirstName.Text = context["firstname"];
      txtLastName.Text = context["lastname"];
      txtAddress.Text = context["address1_line1"];
      txtID.Text = context["CustomerID"];
   
      base.NotifyContextChange(context);
   }
   

8. Save your project, and build it (Build > Build Solution). After the project builds successfully, an assembly (.dll file) is generated with the same name as your project name (in this case, UIIWPFHostedControl1.dll) in the /bin/debug folder of your project.

9. Copy this file to your Unified Service Desk client application installation directory (typically C:\Program Files\Microsoft Dynamics CRM USD\USD). This file is required for testing, and eventually using this control from your client application.

   Tip

   Note the name of the class that is used to build your UII hosted control in the UiiWpfControl.xaml.cs file. In this case, it’s UiiWpfControl. You’ll need this information in the next step.

Step 2: Define the hosted control in Unified Service Desk

To host the UII WPF hosted control in Unified Service Desk, you’ll have to define and configure it.

1. Sign in to Microsoft Dynamics 365.

2. On the nav bar, choose Microsoft Dynamics 365 > Settings > Unified Service Desk.

3. On the Unified Service Desk page, choose Hosted Controls.

4. On the Hosted Controls page, choose New.

5. On the New Hosted Control page, specify the following values.

   Field	Value
   Name	UIIWPFHostedControl
   Display Name	Sample UII WPF Hosted Control
   USD Component Type	CCA Hosted Application
   Hosted Application	Hosted Control
   Application is Global	Selected
   Display Group	MainPanel
   Adapter	Use No Adapter
   Assembly URI	UIIWPFHostedControl1
   Assembly Type	UIIWPFHostedControl1.UiiWpfControl

   Note

   Assembly URI is the name of your assembly and the Assembly Type is the name of your assembly followed by a dot (.) and then the class name in your Visual Studio project. In this example, the name of the assembly is UIIWPFHostedControl1 and name of the class is UiiWpfControl, which is the default class name when you create a UII WPF hosted control.

   

6. Choose Save to create the hosted control.

Step 3: Define UII actions for the external application and web application hosted controls in Unified Service Desk

The adapters for the external standalone and web applications expose the following three actions: UpdateFirstName, UpdateLastName, and UpdateAddress. These adapters and the hosted controls for the external standalone and web applications were created in the earlier walkthroughs (Walkthrough: Create a UII Application Adapter and Walkthrough: Create a UII Web Application Adapter).

To update information in the external applications from within the UII WPF hosted control, you’ll have to define three UII actions with the same name as defined earlier in the adapters for each of the external applications. In the earlier adapter walkthroughs (Walkthrough: Create a UII Application Adapter and Walkthrough: Create a UII Web Application Adapter), we defined the following two hosted controls in Unified Service Desk to display the external applications within Unified Service Desk: QsExternalApp and QsExternalWebApplication. In this step, we will add three UII actions for each hosted control.

Important

If you have already added the UII actions as part of step 3 in Walkthrough: Create a UII Windows Forms Hosted Control, you don’t have to perform this step again. You can proceed to the next section for testing your hosted control.

1. Sign in to Microsoft Dynamics 365.

2. On the nav bar, choose Microsoft Dynamics 365 > Settings > Unified Service Desk.

3. On the Unified Service Desk page, choose Hosted Controls.

4. On the Hosted Controls page, search for the QSExternalApp, and open it for editing.

5. On the QSExternalApp page, choose the down arrow next to the hosted control name, and then choose UII Actions.

6. On the next page, choose Add New UII Action.

7. On the New UII Action page, type the name as UpdateFirstName, and choose Save & Close. This adds the action in the previous page.

8. Similarly, add the following two actions: UpdateLastName and UpdateAddress. All the three actions become available for the QSExternalApp hosted control.

   

9. Follow steps 4 through 8 to create three UII actions with the same names for the QSExternalWebApp.

Test the hosted control

Before you test the UIIWPF hosted control, ensure that your sample web application is running so that it renders within Unified Service Desk.

1. Run Unified Service Desk client to connect to your Dynamics 365 server.

2. On successful sign in, you’ll see three hosted controls: Sample UII WPF Hosted Control, Sample External Web Application, and Sample External Application.

   

3. Choose Search, and then choose Contacts. Choose any of the contacts to display the contact details in a session. This also displays the first name, last name, street address, and ID of the currently displayed contact record in all the three sample controls:

   

4. Change the values in Sample UII WPF Hosted Control, and click Update values in hosted apps to update the values in the other two external applications.

   

5. In Sample UII WPF Hosted Control, choose Update context to update the context information in Unified Service Desk.

   

See Also

Integrate with external applications and web applications
Use UII hosted controls with Unified Service Desk
Walkthrough: Create a UII Windows Forms Hosted Control
UII actions

Unified Service Desk 2.0

© 2017 Microsoft. All rights reserved. Copyright