GetGlobalContext function und ClientGlobalContext.js.aspx (clientseitige Referenz)

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Verwenden GetGlobalContext-Funktion, wenn Sie mit Webressourcen programmieren, um Zugriff auf Kontextinformationen zu erhalten. Um die GetGlobalContext-Funktion in der HTML-Webressource zu erhalten,schließen Sie einen Verweis auf ClientGlobalContext.js.aspx ein.

GetGlobalContext-Funktion

Die Funktion GetGlobalContext gibt das gleiche Kontextobjekt zurück, das in der Datei Xrm.Page.context gefunden wird.

Wenn Sie Kontextinformationen außerhalb eines Formulars benötigen, schließen Sie in die Seite ClientGlobalContext.js.aspx einen Verweis auf die HTML-Webressource ein.

Das folgende Beispiel zeigt eine Funktion an, die dafür konzipiert ist, ein Kontextobjekt zurückzugeben, wenn es enteder in einem Formularskript oder einem Skript verwendet wird, das mi einer HTML-Webressource verwendet wird.

function _getContext() {
 var errorMessage = "Context is not available.";
 if (typeof GetGlobalContext != "undefined")
 { return GetGlobalContext(); }
 else
 {
  if (typeof Xrm != "undefined") {
   return Xrm.Page.context;
  }
  else { throw new Error(errorMessage); }
 }
}

ClientGlobalContext.js.aspx

Sie könen die GetGlobalContext-Funktion verwenden, wenn Sie einen Verweis auf die ClientGlobalContext.js.aspx-Seite einschließen, die sich am Webressource-Stammverzeichnis befindet.

Hinweis

Wenn Sie umgekehrte Schrägstriche nicht in den HTML-Webressourcenamen verwenden, um eine Ordnerstruktur zu simulieren, können Sie das Skript auf der Seite mit diesem Skriptelements einschließen: <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

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 ist für eine HTML-Webressource namens 'sdk_/Contoso.htm' und eine JScript-Webressource, die 'ssdk_/Scripts/ContosoScript.js' mit einer CSS-Webressource namens '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 WebResourcen-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.

Siehe auch

Cclientseitige Programmierreferenz
Clientseitiger Kontext (clientseitige Referenz)
Ausführungskontext (clientseitige Referenz)
Kurzübersicht zum Formularskripting
Schreiben von Code für Microsoft Dynamics CRM 2015-Formulare
Verwenden des Xrm.Page-Objektmodells

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright