USD填坑指南之部署篇

Q：为什么第一个话题先讲部署安装？

A：不先讲部署安装，后面我说那么多你去哪里看去哪里试？又不是看小说……

1. 下载最新的USD客户端

下载地址：https://www.microsoft.com/en-us/download/details.aspx?id=56555

有坑请注意：在百度上搜索Unified Service Desk所返回的第一条记录是2.2的下载版本，而截止到当前，最新的client端版本是3.2。切记一定要对应Dynamics 365和USD客户端的版本。我曾经发生过用2.2的USD客户端打死连不上9.0的D365的情况。9.0以上的D365只能使用3.0以上的USD客户端。

所以，下载之前切记点开“详情”查看版本号。

2. 向Dynamics 365组织部署USD

第一步下载的内容会包括三个文件：

Dynamics365-USD-3.2.0.886-PackageDeployer.exe

Dynamics365-USD-3.2.0.896-amd64.exe

Dynamics365-USD-3.2.0.896-i386.exe

其中第二三个是USD的客户端，而第一个是用来向Dynamics 365组织部署USD服务器端解决方案用的。这里仅给出过程中值得注意的地方。

有坑请注意：如果Dynamics 365上存在多组织，请勾选“显示可用组织列表”，否则会缺省连接上一次连接的组织。

有坑请注意：关于这几个option一定要吐槽一下微软负责USD的产品经理，难道菜单项文字是否清晰明了不应该是用户体验设计规范的一部分吗？我问了好几个人也没能说清楚。

其中第一项“Unified Service Desk - 新环境”和第二项“Unified Service Desk - Microsoft Dynamics 365 Web客户端”的说明文字一字不差完全一样

网上的官方解释在此：https://docs.microsoft.com/zh-cn/dynamics365/customer-engagement/unified-service-desk/admin/deploy-sample-unified-service-desk-applications-using-package-deployer

摘录如下（可不看，后面有总结）：

总结如下：

简单来说，交互式服务中心中会在USD中缺省部署基于交互式服务中心的界面，例如这样：

而Web客户端缺省的界面是这样的：

至于新环境则仅包括最低必需的配置数据，若不进行进一步配置，可能不适合用于演示目的。

有坑请注意：在部署过程中可能会出现错误，如果遇到这种情况只能再部署一次直到所有实体部署完成，否则可能出现某些组件不全的情况。

3. 配置USD用户权限

接下来进入Dynamics 365，就应该可以在Settings下面看到Unified Service Desk目录了。

点击进入并选择其中的configurations

可以看到当前可用的配置项。

根据之前所选择的安装项目可能会有所不同，甚至可能没有。如果没有的话那你首先需要做的就是创建一个。并将需要使用该配置的用户加入到其中的user中去。配置好后应该和下图类似：

有坑请注意：如果在后续开发过程中出现辛辛苦苦做完一套东西却在客户端看不到新增内容的情况，那首先需要确认的就是你是否已经将新增的内容加入到了所需要的配置中。之前因此所导致的疏忽很多，而且当USD项目内容越来越复杂之后，其配置管理会变得非常繁琐复杂。希望以后的USD版本可以在配置添加方面更加的人性化一点。

4. 测试USD客户端

打开USD客户端，在进入loading内容之前在界面的右下端会有配置入口。

点击“更改凭据”进入配置界面：

录入登录用户的认证信息登录即可。如果之前该用户未经加入任何配置则会收到权限相关的报错。如果以后一直都是该用户登录同一客户端，则不再需要每次都进入该设置界面。

由于USD的机制是每次都将配置信息load进内存，所以你会发现每次第一次打开的时候都会花费大量的时间从服务器端下载配置实体内容。从这点而言体验不好，如果以后研发团队能够将其变为异步加载方式就会好很多了。

有坑请注意：在进入USD界面后往往用户的第一个疑惑之处在于：为什么我还要再登录CRM一次？

原因是因为USD作为一个桌面整合框架，本身缺省并不会进行单点登录相关实现，而这部分是需要后续单独实现的。不过作为自身依赖程度这么重的Dynamics 365倒真的应该开箱即用实现这一点。

至此你就完成了USD部署的基本内容。不过，这只是万里长征开始的第一步，因为到现在为止你所能看到的界面还是这样的：

此外，要让系统正常运行还有一些坑是需要预先了解的，包括：

坑#1：请将CRM站点url添加到block-site的白名单。

这里的坑在于，如果你安装了多个浏览器，那你需要注意哪个是你的缺省浏览器。之前曾经发生过我看到这条提示直觉的跑去IE里面设置block site，结果错误依旧。后来发现我已经把缺省浏览器设置为Chrome了。在Chrome中完成了同样添加这条错误才消失。

后续我将会开始逐一对其进行配置，展现出所有USD可以企及的功能。

注：USD的版本在持续更新中，后续如有变化，可能我会在本文后以更新方式给出，也许不会。请注意问题与版本的对应关系。