使用 Unified Service Desk 客户端连接到 Dynamics 365 实例
发布日期: 2016年11月
适用于: Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016
Unified Service Desk 客户端是代理应用程序,您可以使用它连接到已部署 Unified Service Desk 实体和配置数据的 Microsoft Dynamics 365 实例。 在通过客户端应用程序登录时,请阅读 Dynamics 365 实例上的 Unified Service Desk 配置,并相应地公开应用程序中的控件和功能。
本主题内容
登录到统一服务台
配置登录信息
登录问题疑难解答
登录到统一服务台
如果您想配置登录体验,例如在登录对话框中预填充值或无需显示登录对话框而自动登录用户,请参阅配置登录信息。
通过双击您桌面上的快捷方式启动 Unified Service Desk 客户端。
在 Unified Service Desk 登录对话框中,提供连接到 Dynamics 365 服务器所需的身份验证详细信息。
对于 Microsoft Dynamics 365 (online),请选择“Office 365”。
对于内部部署,请选择“内部部署”并从以下“身份验证源”中进行选择。
Active Directory。 如果您正在从您的网络内部连接到 Dynamics 365(本地) 而不是通过 Internet 连接到 Microsoft Dynamics 365,请选择此身份验证源。
面向 Internet 的部署 (IFD)。 如果您正在通过 Internet 连接到 Dynamics 365(本地),请选择此身份验证源。
OAuth。 如果您正在使用不是 Windows Server 但支持 OAuth 开放框架的安全令牌服务 (STS) 连接到 Dynamics 365(本地),请选择此身份验证源。
如果您有多个组织,并想选择在其中部署 Unified Service Desk 的组织,请选中“总是显示可用组织的列表”复选框,然后单击“登录”。
如果您有多个组织,请选择您连接到的组织。
显示 Unified Service Desk 闪屏。 此屏幕将显示有关客户端在后台读取的配置数据的信息。 接下来,主窗口会显示并提示您输入您的 Dynamics 365 服务器凭据。 键入您的凭据,然后登录到 Unified Service Desk 客户端应用程序。
在任何时候启动 Unified Service Desk 客户端并需要再次登录时,您不必再次提供您的连接信息。 您的凭据安全地存储在 Windows 凭据管理器中,而其他连接信息存储在 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD 的 Default_USD.config 文件中,用于后续登录活动。
如果您要更改连接信息,请单击闪屏中的“更改凭据”。 您将会看到可以输入不同凭据的初始登录对话框。
配置登录信息
如果需要,管理员可以配置 Unified Service Desk 的登录体验,并在其登录对话框中预填充值(用户名和密码除外),以便让用户连接到指定的 Dynamics 365 实例;或者管理员也可以基于其 Active Directory 凭据将该体验配置为将用户自动登录到本地 Dynamics 365 实例而无需显示登录对话框。
说明 |
---|
您无法添加或移除 Unified Service Desk 登录对话框中的字段。 您只能指定用户尝试登录时在字段中显示的值。 但是,用户在登录前可以更改Unified Service Desk登录对话框中预先填充的值。 |
若要配置登录信息,请使用客户端安装目录(通常为 c:\Program Files\Microsoft Dynamics CRM USD\USD)中的 UnifiedServiceDesk.exe.config 文件。
以管理员身份运行 记事本。
在 记事本 中,从客户端文件安装目录(通常为 c:\Program Files\Microsoft Dynamics CRM USD\USD)中打开 UnifiedServiceDesk.exe.config 文件。
将 <appSettings> 节点下的以下键添加到 UnifiedServiceDesk.exe.config 文件。
<add key="CrmDeploymentType" value="<DEPLOYMENT_TYPE>" /> <add key="CrmUseSSL" value="<VALUE>" /> <add key="CrmOrg" value="<ORG_NAME>" /> <add key="CrmPort" value="<PORT_NUMBER>" /> <add key="CrmServerName" value="<CRM_SERVER_NAME>" /> <add key="UseDefaultCreds" value="<VALUE>" /> <add key="CacheCredentials" value="<VALUE>" /> <add key="CrmOnlineRegion" value="<CRM_ONLINE_REGION>" /> <add key="AuthHomeRealm" value="<VALUE>" /> <add key="AskForOrg" value="<VALUE>" /> <add key="CrmDomain" value="<DOMAIN_NAME>" />
为每个键提供适当值。 登录对话框中的每个键映射单个字段。 下表显示了有效的键值。
键
值
CrmDeploymentType
Prem 或 O365
如果您连接的是 Dynamics 365 的 面向 Internet 的部署 (IFD),则必须使用 Prem;如果您连接的是 Dynamics 365(在线),则必须使用 O365。
CrmUseSSL
True 或 False
如果您在 CrmDeploymentType 键中指定了 Prem,则此键适用。
CrmOrg
指定 Dynamics 365 组织名称
CrmPort
指定 Dynamics 365 端口号
如果您在 CrmDeploymentType 键中指定了 Prem,则此键适用。
CrmServerName
指定 Dynamics 365 服务器名称
如果您在 CrmDeploymentType 键中指定了 Prem,则此键适用。
UseDefaultCreds
True 或 False
备注
对于本地 Dynamics 365 安装 (<add key="CrmDeploymentType" value="Prem" />) 和 Active Directory 身份验证 (<add key="AuthHomeRealm" value="Active Directory" />),请将此键的值设置为 True 以直接将用户登录到指定的 Dynamics 365 服务器或组织,甚至不显示登录对话框。
<p></p></td> </tr> <tr class="odd"> <td><p><em>CacheCredentials</em></p></td> <td><p><strong>True</strong> 或 <strong>False</strong></p>
备注
若要在每次启动 Unified Service Desk 客户端时强制显示连接对话框,请将此键的值设置为False。 默认情况下,客户端会缓存上一条连接信息并在下次使用它与 Dynamics 365 服务器建立连接,除非用户取消该连接并指定不同的连接。
CrmOnlineRegion
NorthAmerica、EMEA、APAC、SouthAmerica、Oceania、JPN、CAN、IND 或 NorthAmerica2
如果您不知道联机区域,请保留 value="" 值为空。
如果您在 CrmDeploymentType 键中指定了 O365,则此键适用。
AuthHomeRealm
Active Directory 或Internet-facing deployment(IFD)。
如果您在 CrmDeploymentType 键中指定了 Prem,则此键适用。
AskForOrg
True 或 False
指示是否选中登录对话框中的“显示可用组织列表”复选框。
CrmDomain
Windows 域的名称。
如果您在 CrmDeploymentType 键中指定了 Prem,则此键适用。
保存 UnifiedServiceDesk.exe.config 文件。
在要配置登录信息的每个用户的计算机上执行以下操作:
将您刚刚修改的 UnifiedServiceDesk.exe.config 复制到客户端安装目录(通常为 c:\Program Files\Microsoft Dynamics CRM USD\USD)以替换现有文件。
在用户计算机上从漫游的用户配置文件中删除 Unified Service Desk 登录信息。 如果用户从其计算机上至少一次登录到 Unified Service Desk,则会在 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD 目录(Default_USD.config 和 Default_USD)下创建以下文件。 必须删除 UnifiedServiceDesk.exe.config 中有关配置设置的这两个文件以生效。
当用户开始在其计算机上启动 Unified Service Desk 应用程序时,
登录对话框将显示 UnifiedServiceDesk.exe.config 文件中指定的值,并在 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD 目录下创建 Default_USD.config 文件,以存储连接信息(用户名和密码除外;此类信息存储在 Windows 凭据管理器 中)。 之后,客户端应用程序使用 Default_USD.config 文件显示登录信息或自动登录到 Unified Service Desk。
对于需要进行 Active Directory 身份验证的本地 Dynamics 365 安装,如果您已配置为自动登录用户而不显示登录对话框 (<add key="UseDefaultCreds" value="True" />),则登录对话框不会显示,但会在 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\USD 目录中创建 Default_USD.config 文件,以存储连接信息(用户名和密码除外)。 之后,客户端应用程序将使用 Default_USD.config 文件自动登录到 Unified Service Desk。
如果需要修改默认登录信息,则必须重复步骤 1-6。
登录问题疑难解答
Unified Service Desk 为登录到 Microsoft Dynamics 365 时出现的错误提供错误日志支持。 在客户端应用程序中,当您首次遇到登录问题时,将会在 c:\Users\<USER_NAME>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<Version> 创建一个 Login_ErrorLog.log 日志文件。 此后,日志文件用于记录有关后续登录问题的信息。 此信息有助于解决有关从客户端应用程序登录到 Microsoft Dynamics 365 的问题。
说明 Unified Service Desk 也可以在同一位置创建另一个日志文件,UnifiedServiceDesk.log,用于记录客户端应用程序中的操作错误。 当您在客户端应用程序中首次遇到问题时将会创建该日志文件。详细信息:在 Unified Service Desk 中配置客户端诊断日志记录
另请参阅
Unified Service Desk 的安全性
学习使用统一服务台
统一服务台配置演练
管理统一服务台Unified Service Desk 2.0
© 2016 Microsoft。 保留所有权利。 版权