Distribute custom hosted controls using Customization Files


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

Use the customization files feature to distribute custom hosted controls and functionality to agent computers. To control the distribution, create or update a customization file record and associate it with a configuration. When agents who are associated with the configuration sign in to Dynamics 365 using the Unified Service Desk client, the custom controls and functionality are downloaded to the agent’s computer and available for use.

To distribute custom controls and functionality:

  1. Create or update one or more custom hosted controls and functionality. This task is typically completed by a developer who has experience with creating hosted controls and includes the following:

    • The custom hosted controls files. Typically, these are assemblies. More information:MSDN: Create custom Unified Service Desk host control

    • A [Content_Types].xml file that describes the customization. This file is an OpenXML file that provides MIME type information by listing the default file extensions for the files that are included in the Unified Service Desk customization. Typically, these are .dll, .xml, .exe, and .config file types, but you can add almost any file type that’s supported by the Windows PC where the Unified Service Deskclient will run.

      More information:MSDN: Create custom listeners for auditing, diagnostics, and traces

  2. Package the custom control files that you want to distribute as a compressed zip folder. To do this, in Windows File Explorer select the files, right-click and point to Send to, and then click Compressed (zipped) folder.

  3. Create a customization file record and add the compressed (.zip) folder as the attachment.

  4. Associate the Customization File record with a Configuration.

Create or update a customization file record for custom functionality distribution

  1. Go to Settings > Unified Service Desk > Customization Files.

  2. Select an existing customization file record in the list or click New to create a new one.

  3. In the Name box, type a name for the record.

    In the Customization Version box, enter a software version number that corresponds to the version of the zipped folder containing the customization files. For example, if this is the original version of the customization, you can enter 1.0. If it is a minor update, you can enter 1.1.

    Optionally, add a description in the Description box.

  4. If this is a new customization file record, click Save to save the record so you can attach customization compressed (.zip) folder. Next, click Attach, and browse to the location of the compressed folder that contains the custom control and functionality files and the [Content_Types].xml file.

    To update an existing customization file record with a new customization compressed (.zip) folder, remove the existing zipped folder by clicking X next to the folder. Then, click Attach, and browse to the location of the compressed folder that contains the updated custom control and functionality files.

  5. Click Done.

  6. Click Save.

  7. If the customization file record isn’t already associated with a Configuration, you must do so before the customization can be used by agents. More information:Manage access using Unified Service Desk configuration

See Also

Administer and manage Unified Service Desk
Migrate your Unified Service Desk configuration to another Dynamics 365 server

Unified Service Desk 2.0

© 2016 Microsoft. All rights reserved. Copyright