When using USD in a CRM implementation there is a lot we can accomplish using configuration and out-of-the-box hosted controls, but in implementations that are more complex, we often find ourselves utilizing custom hosted controls to get the job done.
Often these custom hosted controls are comprised simply of “.dll” libraries but sometimes we may need other files or dependencies. In the past, we would have to deploy these files using some distributed installer or script to copy the dependencies into each user’s USD install folder, but no longer!
Now with Customization File records we can easily distribute and update custom controls and functionality to our agent’s machines.
To create one, let’s navigate to Settings > Unified Service Desk > Customization Files and create a new record.
Customization Files, like any other USD configuration, are records in Dynamics 365 and should be associated with a USD Configuration record. We can track the version number using the version field, as we increment this number, the cached controls will be overwritten on the user’s machine.
Next, let’s prepare the attachment which will contain our files to distribute. This is a zip file consisting of the files we want to distribute and a “Content Types” file describing what file types should be extracted from the zip.
So, gather your files and create a new file with them named “[Content_Types].xml” which should contain XML like the following:
<?xml version=”1.0″ encoding=”utf-8″?>
<Default Extension=”dll” ContentType=”application/octet-stream” />
<Default Extension=”config” ContentType=”application/octet-stream” />
<Default Extension=”css” ContentType=”application/octet-stream” />
Each child of the “Types” element will describe a file type which should be extracted. The above Content Types XML will cause any files ending in .dll, .config, or .css to be extracted. After creating this file, place it in the same folder as the files that you wish to distribute and then zip them up with your favorite archive tool.
Finally, attach this zip file to the previously created Customization File.
Now when our users start USD, it will pull down, extract, and cache these files in their Local AppData folder at the following location: C:/Users/<UserName>/AppData/Local/Microsoft/UnifiedServiceDes/<OrgUniqueName>/<GUID>/
That’s all there is to it!
For more helpful Dynamics 365 tips and tricks, subscribe to our blog!
Happy Dynamics 365’ing!