GetGlobalContext-Funktion und ClientGlobalContext.js.aspx (clientseitige API-Referenz)

  • Artikel

Verwenden Sie die Funktion GetGlobalContext bei der Programmierung mit Webressourcen, um zu globalen Kontextinformationen wie Informationen zum Kunden, der Organisation oder dem Benutzer für Ihre modellgestützte App-Instanz Zugriff zu erhalten.

Um die GetGlobalContext-Funktion in der HTML-Webressource zu erhalten,schließen Sie einen Verweis auf ClientGlobalContext.js.aspx ein.

Wichtig

Durch Einschließen eines Verweises auf ClientGlobalContext.js.aspx macht das Xrm-Objekt nicht in HTML-Webressourcen verfügbar. Daher werden Skripts, die Xrm.*-Methoden enthalten in HTML-Webressourcen nicht unterstützt. parent.Xrm.* funktioniert, wenn die HTML-Webressource in einem Formularcontainer geladen wird. Für andere Speicherorte, wie etwa beim Laden einer HTML-Webressource als Bestandteil der SiteMap, funktioniert parent.Xrm.* allerdings nicht.

GetGlobalContext-Funktion

Die Funktion GetGlobalContext gibt das gleiche Kontextobjekt zurück wie die Xrm.Utility.getGlobalContext-Methode, die impliziert, dass das Kontextobjekt die gleichen Eigenschaften und Methoden hat wie für Xrm.Utility.getGlobalContext verfügbar. Weitere Informationen: Xrm.Utility.getGlobalContext

ClientGlobalContext.js.aspx

Sie müssen einen Verweis auf der ClientGlobalContext.js.aspx Seite einschließen, die am Stamm des Webressourceverzeichnisses vorhanden ist, um GetGlobalContext zu verwenden.

  • Wenn Sie keine Schrägstrich-Zeichen in HTML-Webressourcennamen verwenden, um eine Ordnerstruktur zu simulieren, können Sie dieses Skript einbinden, indem Sie direkt auf es verweisen. Beispiel:

    <head>
  <title>HTML Web Resource</title>
  <script src="ClientGlobalContext.js.aspx" type="text/javascript" ></script>

</head>

  • Wenn Sie umgekehrte Schrägstriche nicht in den HTML-Webressourcenamen verwenden, um eine Verzeichnisstruktur zu simulieren, müssen Sie dies im Skriptelement wiedergeben. Das folgende Beispiel gilt für eine HTML-Webressource mit dem Namen sdk_/Contoso.htm und eine JavaScript-Webressource mit dem Namen sdk_/Scripts/ContosoScript.js mit einer CSS-Webressource mit dem Namen sdk_/Styles/ContosoStyles.css.

    <head>
  <title>HTML Web Resource</title>
  <script src="../ClientGlobalContext.js.aspx" type="text/javascript" ></script>

  <script src="Scripts/ContosoScript.js" type="text/javascript"></script>
  <link href="Styles/ContosoStyles.css" rel="stylesheet" type="text/css" />
</head>

Hinweis

Das Verwenden eines relativen Pfads einschließlich des WebResources-Stammverzeichnisses, beispielsweise /WebResources/ClientGlobalContext.js.aspx, wird nicht empfohlen, da es dazu führen kann, dass die Seite eine Organisationskontext in einer Umgebung mit mehreren Iinstanzen verlieren kann.

Die ClientGlobalContext.js.aspx-Seite enthält mehrere globale Ereignishandler. Diese Ereignishandler brechen die Ereignisse onselectstart, contextmenu und ondragstart ab.

Xrm.Utility.getGlobalContext
Grundlegendes zum Client API-Objektmodell
Webressourcen für modellgesteuerte Apps

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).