getGlobalContext.client (クライアント API 参照)
メソッドへのアクセスを提供して、使用されているクライアント、クライアントがサーバーに接続されているかどうか、使用されているデバイスの種類を決定します。
var clientContext = Xrm.Utility.getGlobalContext().client
クライアントコンテキストでは、次のメソッドを使用できます。
getClient
どのクライアントでスクリプトを実行するかを示す値を返します。
構文
clientContext.getClient()
戻り値
種類: 文字列
説明: 返される可能性のある値は次のとおりです:
価値 | Client |
---|---|
Web |
Web アプリケーション |
Web |
統一インターフェイス |
Outlook |
Dynamics 365 for Outlook クライアント (COM アドイン) |
Mobile |
Mobile app |
getClientState
クライアントの状態を示す値を返します。 オフラインファースト モード (プレビュー中) のクライアントは、常にオフラインであることを示します。
構文
clientContext.getClientState()
戻り値
種類: 文字列
説明: 返される可能性のある値は次のとおりです:
価値 | Client |
---|---|
Online |
Web アプリケーション、Dynamics 365 for Outlook クライアント (COM アドイン)、モバイル アプリ、統一インターフェイス |
Offline |
Outlook、モバイル アプリ |
getFormFactor
ユーザーが使用しているデバイスの種類に関する情報を返します。
構文
clientContext.getFormFactor()
戻り値
種類: 数値
説明: 返される可能性のある値は次のとおりです:
価値 | フォーム ファクター |
---|---|
0 |
Unknown |
1 |
デスクトップ |
2 |
タブレット PC |
3 |
電話番号 |
isOffline
クライアント ステータスがオンラインまたはオフラインかどうかを示す情報を返します。 オフラインファースト モードのクライアントは、常にオフラインであることをレポートします。
構文
clientContext.isOffline()
戻り値
種類: ブール値
説明: サーバーがオフラインの場合 true ; それ以外の場合 false。
isNetworkAvailable
クライアント モードに関わらず、ネットワークが利用可能かどうかに関する情報を返します。
注意
この API は、Dynamics 365 Customer Engagement の設置型展開に利用できません。 詳細: クライアント API は Customer Engagement (on-premises) でサポートされていません
構文
clientContext.isNetworkAvailable()
戻り値
種類: ブール値
説明: ネットワークが利用可能である場合はtrue 、それ以外の場合はfalse です。
関連記事
組織の設定
ユーザー設定
Xrm.Utility.getGlobalContext
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。