getGlobalContext.client (Referència de l'API de client)

Proporciona accés als mètodes per determinar quin client s'està utilitzant, si el client està connectat al servidor i quin tipus de dispositiu s'està utilitzant.

var clientContext = Xrm.Utility.getGlobalContext().client

Els mètodes següents estan disponibles per al context del client.

getClient

Retorna un valor per indicar en quin client s'està executant l'script.

Sintaxi

clientContext.getClient()

Valor retornat

Tipus: Cadena

Descripció: Els valors retornats són:

Valor	Client
Web	aplicació web
Web	Interfície unificada
Outlook	Client del Dynamics 365 for Outlook (complement COM)
Mobile	Aplicació mòbil

getClientState

Retorna un valor per indicar l'estat del client. Un client en mode fora de línia (en visualització prèvia) sempre indica que està fora de línia.

Sintaxi

clientContext.getClientState()

Valor retornat

Tipus: Cadena

Descripció: Els valors retornats són:

Valor	Client
Online	Aplicació web, client del Dynamics 365 for Outlook (complement COM), aplicació mòbil, interfície unificada
Offline	Outlook, aplicació mòbil

getFormFactor

Retorna informació sobre el tipus de dispositiu que utilitza l'usuari.

Sintaxi

clientContext.getFormFactor()

Valor retornat

Tipus: Nombre

Descripció: Els valors retornats són:

Valor	Factor de forma
0	Desconegut
1	Dispositiu d'escriptori
2	Tauleta
3	El número de telèfon

Està fora de línia

Retorna informació sobre si l'estat del client està en línia o fora de línia. Un client en mode offline first sempre informa que està fora de línia.

Sintaxi

clientContext.isOffline()

Valor retornat

Tipus: Booleà

Descripció: true si el servidor està fora de línia; false en cas contrari.

isNetworkAvailable

Retorna informació sobre si la xarxa està disponible o no, independentment del mode client.

Nota

Aquesta API no està disponible per a les implementacions locals del Dynamics 365 Customer Engagement. Més informació: Les API de client no s'admeten al Customer Engagement (on-premises)

Sintaxi

clientContext.isNetworkAvailable()

Valor retornat

Tipus: Booleà

Descripció: true si la xarxa està disponible; false en cas contrari.

Articles relacionats

Configuració de l'organització
Configuració de l'usuari
Xrm.Utility.getGlobalContext