提供对方法的访问权限,以确定正在使用哪个客户端、客户端是否连接到服务器,以及正在使用哪种类型的设备。
var clientContext = Xrm.Utility.getGlobalContext().client
以下方法可用于客户端上下文。
getClient
返回一个值,该值指示脚本正在执行哪个客户端。
Syntax
clientContext.getClient()
返回值
类型:字符串
说明:返回的值包括:
| 价值 | 客户 |
|---|---|
Web |
Web 应用程序 |
Web |
统一界面 |
Outlook |
Dynamics 365 for Outlook 客户端(COM 加载项) |
Mobile |
移动应用 |
getClientState
返回一个值,该值指示客户端的状态。 处于脱机优先模式(预览版)的客户端始终表示它处于脱机状态。
Syntax
clientContext.getClientState()
返回值
类型:字符串
说明:返回的值包括:
| 价值 | 客户 |
|---|---|
Online |
Web 应用程序、Dynamics 365 for Outlook 客户端(COM 加载项)、移动应用、统一接口 |
Offline |
Outlook、移动应用 |
getFormFactor
返回有关用户正在使用的设备类型的信息。
Syntax
clientContext.getFormFactor()
返回值
类型:数字
说明:返回的值包括:
| 价值 | 外形规格 |
|---|---|
0 |
未知 |
1 |
桌面 |
2 |
平板电脑 |
3 |
电话 |
isOffline
返回客户端状态是联机还是脱机的信息。 处于脱机优先模式的客户端始终报告它处于脱机状态。
Syntax
clientContext.isOffline()
返回值
类型:布尔值
说明:如果服务器处于脱机状态,则 为 true ;否则为 false 。
isNetworkAvailable
无论客户端模式如何,返回网络是否可用的信息。
注释
此 API 不适用于 Dynamics 365 Customer Engagement 本地部署。 详细信息: 客户参与中不支持客户端 API(本地)
Syntax
clientContext.isNetworkAvailable()
返回值
类型:布尔值
说明:如果网络可用,则 为 true ;否则为 false 。