getGlobalContext.client (Client-API-Referenz)

  • Artikel

Bietet Zugriff auf die Methoden zum Bestimmen, welcher Client verwendet wird, ob der Client mit dem Server verbunden ist, und welcher Gerätetyp verwendet wird.

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

Die folgenden Methoden sind für den Clientkontext verfügbar.

getClient

Gibt einen Wert zurück, um anzugeben, in welchem Client das Skript ausgeführt wird.

Syntax

clientContext.getClient()

Rückgabewert

Typ: Zeichenfolge

Bezeichnung: Die zurückgegebenen Werte sind:

Wert Client-ID
Web Webanwendung
Web Einheitliche Oberfläche
Outlook Dynamics 365 for Outlook-Client (COM-Add-In)
Mobile Mobile App

getClientState

Gibt einen Wert zurück, um den Status des Clients anzugeben. Ein Client im Offline-First-Modus (in der Vorschau) zeigt immer an, dass er offline ist.

Syntax

clientContext.getClientState()

Rückgabewert

Typ: Zeichenfolge

Bezeichnung: Die zurückgegebenen Werte sind:

Wert Client-ID
Online Webanwendung, Dynamics 365 for Outlook-Client (COM-Add-In), Mobile App, Einheitliche Oberfläche
Offline Outlook, Mobile App

getFormFactor

Gibt die Informationen zur Art des vom Benutzer verwendeten Geräts zurück.

Syntax

clientContext.getFormFactor()

Rückgabewert

Typ: Anzahl

Bezeichnung: Die zurückgegebenen Werte sind:

Wert Formularfaktor
0 Unknown
1 Desktop
2 Tablet
3 Telefon

isOffline

Gibt die Informationen zurück, ob der Clientstatus online oder offline ist. Ein Client im Offline-First-Modus meldet immer, dass er offline ist.

Syntax

clientContext.isOffline()

Rückgabewert

Typ: Boolesch

Bezeichnung: true, wenn der Server offline ist, andernfalls false.

isNetworkAvailable

Zurückgegebenen Information, ob das Netzwerk verfügbar ist oder nicht, ungeachtet des Clientmodus.

Hinweis

Diese API ist nicht verfügbar für Dynamics 365 Customer Engagement, das lokal bereitgestellt wird. Weitere Informationen: Client APIs werden in Customer Engagement (on-premises) nicht unterstützt

Syntax

clientContext.isNetworkAvailable()

Rückgabewert

Typ: Boolesch

Beschreibung: true wenn das Netzwerk verfügbar ist, sonst false.

Organisationseinstellungen
Benutzereinstellungen
Xrm.Utility.getGlobalContext

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).