提供方法的存取權,以判斷正在使用哪個用戶端、用戶端是否連線到伺服器,以及正在使用的裝置類型。
var clientContext = Xrm.Utility.getGlobalContext().client
下列方法可用於用戶端內容。
get客戶端
傳回一個值,指出指令碼正在哪個用戶端執行。
語法
clientContext.getClient()
傳回值
類型:字串
說明:傳回的值為:
| 價值觀 | 客戶 |
|---|---|
Web |
Web 應用程式 |
Web |
整合介面 |
Outlook |
Dynamics 365 for Outlook 用戶端 (COM 增益集) |
Mobile |
行動應用程式 |
getClientState
傳回值以指出用戶端的狀態。 離線優先模式 (預覽版) 的用戶端一律會指出它處於離線狀態。
語法
clientContext.getClientState()
傳回值
類型:字串
說明:傳回的值為:
| 價值觀 | 客戶 |
|---|---|
Online |
Web 應用程式、Dynamics 365 for Outlook 用戶端 (COM 增益集)、行動應用程式、整合介面 |
Offline |
Outlook、行動應用程式 |
getFormFactor
傳回使用者正在使用的裝置類型的相關資訊。
語法
clientContext.getFormFactor()
傳回值
類型:數字
說明:傳回的值為:
| 價值觀 | 外形尺寸 |
|---|---|
0 |
Unknown |
1 |
桌面 |
2 |
平板電腦 |
3 |
電話 |
是離線的
傳回用戶端狀態是線上還是離線的資訊。 處於離線優先模式的用戶端一律會報告其離線狀態。
語法
clientContext.isOffline()
傳回值
類型:布林值
說明:如果伺服器離線,則 為true ; false ,否則。
isNetwork可用
傳回網路是否可用的資訊,無論用戶端模式為何。
備註
此 API 不適用於 Dynamics 365 Customer Engagement 內部部署。 其他資訊: Customer Engagement (on-premises) 不支援的用戶端 API
語法
clientContext.isNetworkAvailable()
傳回值
類型:布林值
說明:如果網路可用,則 為true ; false ,否則。