Del via

GetGlobalContext-funktion og ClientGlobalContext.js.aspx (klientsidreference)

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Brug GetGlobalContext-funktion, når du programmerer med webressourcer for at få adgang til kontekstoplysninger. For at få GetGlobalContext-funktionen i din HTML-webressource, skal du medtage en reference til ClientGlobalContext.js.aspx.

GetGlobalContext-funktion

GetGlobalContext-funktionen returnerer det samme kontekstobjekt, som findes i Xrm.Page.context.

Hvis du har brug for kontekstoplysninger uden for en formular, skal du medtage en reference til ClientGlobalContext.js.aspx-siden i en HTML-webressource.

Følgende eksempel viser en funktion, der er designet til at returnere et kontekstobjekt, når det anvendes i et formular-script eller et script, der bruges sammen med en HTML-webressource.

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

Du kan bruge GetGlobalContext-funktionen, når du medtager en reference den ClientGlobalContext.js.aspx-side, der er placeret i roden af mappen med webressourcer.

Bemærk

Hvis du ikke bruger omvendte skråstreger i navne på HTML-webressourcer for at simulere en mappestruktur, kan du medtage dette script på siden ved hjælp af dette script-element: <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

Hvis du bruger omvendte skråstreger i navne på HTML-webressourcer for at simulere en mappestruktur, skal dette afspejles i dit script-element. Følgende eksempel er for en HTML-webressource med navnet "sdk_/Contoso.htm" og en JavaScript-webressource med navnet "sdk_/Scripts/ContosoScript.js" med en CSS-webressource med navnet "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>

Bemærk

Det anbefales ikke at anvende en relativ sti, herunder WebResources-rodmappen, for eksempel /WebResources/ClientGlobalContext.js.aspx, da det kan medføre, at siden mister organisationskontekst i et multiprofilmiljø.

Siden ClientGlobalContext.js.aspx indeholder nogle globale hændelseshandlere. Disse hændelseshandlere annullerer hændelserne onselectstart, contextmenu og ondragstart.

Se også

Programmeringsreference på klientsiden
Klientsidekontekst (klientsidereference)
Kontekst for udførelse (klientsidereference)
Formularscripter - hurtig henvisning
Skriv kode til Microsoft Dynamics 365-formularer
Bruge Xrm.Page-objektmodel

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret