Clientseitiger Kontext (clientseitige Referenz)

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Ihr Code muss in einem Kontext funktionieren, in dem verschiedene Variablen zur Entwurfszeit nicht bekannt sind. Das Kontextobjekt stellt Methoden zum Abrufen von Informationen bereit, die für eine Organisation, einen Benutzer oder Parameter spezifisch sind, die einer Seite übergeben wurden.

Das Kontextobjekt ist in Formulare verfügbar ist, indem auf Xrm.Page.context verwiesen wird.

Für Webressourcen, die außerhalb eines Formulars ausgeführt werden, verwenden Sie GetGlobalContext-Funktion, um ein Kontextobjekt abzurufen.

Kontexteigenschaften und -methoden

  • client
    Bietet Zugriff auf die getClient, getClientState- und getFormFactor-Methoden, die Sie verwenden können, um zu bestimmen, welcher Client verwendet wird, ob der Client mit dem Server verbunden ist, und welcher Gerätetyp verwendet wird.

  • getClientUrl
    Gibt die Basis-URL zurück, die verwendet wurde, um auf die Anwendung zuzugreifen.

  • getCurrentTheme
    Gibt eine Zeichenfolge zurück, die das aktuelle Microsoft Office Outlook-Theam zurückgibt, das vom Benutzer ausgewählt wurde.

  • getIsAutoSaveEnabled
    Gibt zurück, ob Autosave für die Organisation aktiviert ist.

  • getOrgLcid
    Gibt den Sprachcode-ID (LCIC-Wert zurück, der die Ausgangssprache für die Organisation darstellt.

  • getOrgUniqueName
    Gibt den eindeutigen Textwert des Namens der Organisation zurück.

  • getQueryStringParameters
    Gibt ein Wörterbuchobjekt von Schlüsselwertpaaren zurück, die die Abfragezeichenfolgenargumente darstellen, die zur Seite übergeben wurden.

  • getTimeZoneOffsetMinutes
    Gibt die Differenz zwischen der Ortszeit und der Coordinated Universal Time (UTC) zurück.

    Diese Methode wurde mit Microsoft Dynamics CRM Online 2015-Update 1 eingeführt.

  • getUserId
    Gibt die GUID des SystemUser.Id-Werts für den aktuellen Benutzer zurück.

  • getUserLcid
    Gibt den LCID-Wert zurück, der die Sprache bereitgestellte Sprache darstellt, die der Benutzer als bevorzugte Sprache ausgewählt hat.

  • getUserName
    Gibt den Namen des aktuellen Benutzers zurück.

  • getUserRoles
    Gibt ein Zeichenfolgenarray zurück, das die GUID-Werte für jede der Sicherheitsrollen darstellt, die dem Benutzer oder jedem Team zugeordnet sind, dem der Benutzer angehört.

  • prependOrgName
    Stellt den Organisationsnamen zu dem angegebenen Pfad voran.

  • Entfernte Methoden
    Entfernte Methoden sind entweder veraltet oder durch anderer Methoden ersetzt. Sie müssen sicherstellen, dass diese Methoden nicht in den Skripts verwendet werden.

    Die getAuthenticationHeader- und getServerUrl-Methoden sind in Microsoft Dynamics CRM 2011 veraltet und sind in Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update nicht mehr vorhanden.

    Die isOutlookClient- und isOutlookOnline-Methoden sind in Microsoft Dynamics CRM 2013 veraltet und sind in Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update nicht mehr vorhanden.

client

Bei Microsoft Dynamics CRM 2013 und Microsoft Dynamics CRM Online wurde das Clientobjekt ergänzt, das die getClient- und getClientState-Methode enthält, um Informationen zum Client abzurufen.

In Microsoft Dynamics CRM Online 2015-Update 1 wurde die getFormFactor-Methode hinzugefügt.

getClient

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

context.client.getClient()

Verwenden Sie dies anstelle der entfernten isOutlookClient-Methode.

  • Rückgabewert
    Typ: Zeichenfolge

    Die zurückgegebenen Werte sind:

    Kunde

    Wert

    Browser

    Internet

    Outlook

    Outlook

    Mobiltelefon

    Mobiltelefon

getClientState

Verwenden Sie dies anstelle der entfernten isOutlookOnline-Methode.

Gibt einen Wert zurück, um den Status des Clients anzugeben.

context.client.getClientState()
  • Rückgabewert
    Typ: Zeichenfolge

    Die möglichen zurückgegebenen Werte sind:

    Kunde

    Zurückgegebene Werte

    Web, Outlook, Mobile

    OnLine

    Outlook, Mobile

    Offline

getFormFactor

Verwenden Sie diese Methode, um Informationen zur Art des Geräts, das der Benutzer verwendet, abzurufen.

context.client.getFormFactor()
  • Rückgabewert
    Typ: Anzahl

    Die möglichen zurückgegebenen Werte sind:

    Wert

    Formularfaktor

    0

    Unbekannt

    1

    Desktop

    2

    Tablet

    3

    Telefon

  • Anmerkungen
    Diese Methode wurde mit Microsoft Dynamics CRM Online 2015-Update 1 eingeführt

getClientUrl

Gibt die Basis-URL zurück, die verwendet wurde, um auf die Anwendung zuzugreifen.

context.getClientUrl()

Verwenden Sie dies anstelle der entfernten getServerUrl-Methode.

Die Werte, die zurückgegebenen Werte ähneln denen, die in der folgenden Tabelle aufgeführt sind.

Kunde

Wert

Microsoft Dynamics CRM (lokale Version)

http(s)://server/org

Microsoft Dynamics CRM Online

https://org.crm.dynamics.com

Microsoft Dynamics CRM für Outlook mit Offlinezugriff im Offlinemodus

https://localhost:2525

  • Rückgabewert
    Typ: Zeichenfolge

getCurrentTheme

Gibt eine Zeichenfolge zurück, die das aktuelle Microsoft Office Outlook-Theam zurückgibt, das vom Benutzer ausgewählt wurde.

Hinweis

Diese Funktion kann nicht mit Microsoft Dynamics CRM für Tablets verwendet werden.

context.getCurrentTheme()
  • Rückgabewert
    Typ: Zeichenfolge

Erstellen Sie anhand dieser Informationen ein geeignetes Thema für die HTML- und Silverlight-Webressourcen, wenn sie in der Microsoft Dynamics CRM für Outlook angezeigt werden. In der folgenden Tabelle sind die Werte aufgelistet, auf die von dieser Methode zurückgegeben werden können.

Hinweis

Formulare passen sich nicht sich Änderungen im Microsoft Office-Thema an, daher ist der einzige Fall, in dem Sie an die Microsoft Office-Themen anpassen möchten, wenn Sie eine Seite der Navigation in mit einer HTML-Webressource anzeigen. Selbst in diesem Szenario sind sichtbare Unterschiede schwer zu erkennen.

Wert

Thema

Standard

Microsoft Dynamics 365-Webanwendung

Office12Blue

Microsoft Dynamics CRM für Outlook 2007 oder 2010 Blue Theme

Office14Silver

Microsoft Dynamics CRM für Outlook 2007 oder 2010 Silver oder Black Theme

getIsAutoSaveEnabled

Diese Methode ist neu für Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update

Gibt zurück, ob Autosave für die Organisation aktiviert ist.

context.getIsAutoSaveEnabled()
  • Rückgabewert
    Typ: Boolesch.

    Hinweis

    Diese Funktion gibt den Wert zurück, der zum Zeitpunkt festgelegt ist, wenn die Seite geöffnet wird. Wenn Sie mithilfe dieses Werts Code testen, müssen Sie die Seite aktualisieren, nachdem Sie den Wert geändert haben, um den neuen Wert abzurufen.

    Weitere Informationen:TechNet: Verwalten der automatischen Speicherung.

getOrgLcid

Gibt den LCID-Wert zurück, der die Ausgangssprache für die Organisation darstellt.

context.getOrgLcid()
  • Rückgabewert
    Typ: Anzahl

    Beispiel: 1033 gibt die englische Sprache an.Gültige Gebietsschema-ID-Werte finden Sie unter Gebietsschema-ID-Diagramm (LCID).

    1033
    

getOrgUniqueName

Gibt den eindeutigen Textwert des Namens der Organisation zurück.

context.getOrgUniqueName()
  • Rückgabewert
    Typ: Zeichenfolge

    Beispiel: Dies entspricht dem Organisationsnamewert

    "adventureworkscycle"
    

getQueryStringParameters

Gibt ein Wörterbuchobjekt von Schlüsselwertpaaren zurück, die die Abfragezeichenfolgenargumente darstellen, die zur Seite übergeben wurden.

context.getQueryStringParameters()
  • Rückgabewert
    **Typ:**Objekt

getTimeZoneOffsetMinutes

Gibt die Differenz zwischen der Ortszeit und der Coordinated Universal Time (UTC) zurück.

Hinweis

Diese Methode wurde mit Microsoft Dynamics CRM Online 2015-Update 1 eingeführt.

context.getTimeZoneOffsetMinutes()
  • Rückgabewert
    Typ: Anzahl

getUserId

Gibt die GUID des SystemUser.Id-Werts für den aktuellen Benutzer zurück.

context.getUserId()
  • Rückgabewert
    Typ: Zeichenfolge

    Beispiel:

    "{B05EC7CE-5D51-DF11-97E0-00155DB232D0}"
    

getUserLcid

Gibt den LCID-Wert zurück, der die Microsoft Dynamics CRMSprachpaket darstellt, die der Benutzer als bevorzugte Sprache ausgewählt hat.

context.getUserLcid()
  • Rückgabewert
    Typ: Anzahl

    Beispiel: 1041 gibt die japanische Sprache an.Gültige Gebietsschema-ID-Werte finden Sie unter Gebietsschema-ID-Diagramm (LCID).

    1041
    

getUserName

Gibt den Namen des aktuellen Benutzers zurück.

context.getUserName()
  • Rückgabewert
    Typ: Zeichenfolge

getUserRoles

Gibt ein Zeichenfolgenarray zurück, das die GUID-Werte für jede der Sicherheitsrollen darstellt, die dem Benutzer oder jedem Team zugeordnet sind, dem der Benutzer angehört.

Weitere Informationen zu Sicherheitsrollen finden Sie unter Wie rollenbasierte Sicherheit verwendet werden kann, um Zugriff auf Entitäten in Microsoft Dynamics CRM 2015 zu steuern.

context.getUserRoles()
  • Rückgabewert
    Typ: Array

    Beispiel: Dieser Benutzer hat eine Sicherheitsrolle, die seinem Benutzerkonto zugeordnet ist. Die JSON-Darstellung dieses Arrays mit einem einzigen Wert:

    ["cf4cc7ce-5d51-df11-97e0-00155db232d0"]
    

prependOrgName

Stellt den Organisationsnamen zu dem angegebenen Pfad voran.

context.prependOrgName(sPath)
  • Argumente
    Typ: Zeichenfolge

    Ein lokaler Pfad zu einer Ressource.

  • Rückgabewert
    Typ: Zeichenfolge

    Der zurückgegebene Wert flgt diesem Muster:

    "/"+ OrgName + sPath
    

Entfernte Methoden

Entfernte Methoden sind entweder veraltet oder durch anderer Methoden ersetzt. Sie müssen sicherstellen, dass diese Methoden nicht in den Skripts verwendet werden.

Folgende Möglichkeiten wurden in früheren Versionen von Microsoft Dynamics 365 veraltet und sind nicht mehr in der aktuellen Version vorhanden:

  • getAuthenticationHeader
    Dieser Methode unterstützte die Verwendung von Microsoft Dynamics CRM 4.0-Webdiensten, die nicht mehr vorhanden sind.

  • getServerUrl
    Diese Methode wird durch getClientUrl ersetzt.

  • isOutlookClient
    Diese Methode wird durch client.getClient ersetzt.

  • isOutlookOnline
    Diese Methode wird durch client.getClientState ersetzt.

Siehe auch

GetGlobalContext function und ClientGlobalContext.js.aspx (clientseitige Referenz)
Kurzübersicht zum Formularskripting
Schreiben von Code für Microsoft Dynamics CRM 2015-Formulare
Verwenden des Xrm.Page-Objektmodells
Cclientseitige Programmierreferenz

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright