Delen via

Functie GetGlobalContext en ClientGlobalContext.js.aspx (clientreferentie)

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Gebruik de Functie GetGlobalContext wanneer u programmeert met webresources om toegang te krijgen tot contextinformatie. Als u de functie GetGlobalContext in uw HTML-webresource wilt krijgen, neemt u een verwijzing op naar ClientGlobalContext.js.aspx.

Functie GetGlobalContext

De functie GetGlobalContext retourneert hetzelfde contextobject uit de Xrm.Page.context.

Wanneer u contextinformatie buiten een formulier nodig hebt, neemt u een verwijzing naar de pagina ClientGlobalContext.js.aspx op in een HTML-webresource.

Dit voorbeeld toont een functie waarmee een contextobject wordt geretourneerd wanneer deze wordt gebruikt in een formulierscript of een script dat wordt gebruikt met een HTML-webresource.

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

U kunt de functie GetGlobalContext gebruiken wanneer u een verwijzing opneemt naar de pagina ClientGlobalContext.js.aspx, die zich in de hoofdmap van de webresourcedirectory bevindt.

Notitie

Als u geen backslashes in html-webresourcenamen gebruikt om een mapstructuur te simuleren, kunt u dit script in uw pagina opnemen met dit scriptelement: <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

Als u wel backslashes in html-webresourcenamen gebruikt om een mapstructuur te simuleren, moet u daar in uw scriptelement rekening mee houden. Het volgende voorbeeld is voor een HTML-webresource genaamd "sdk_/Contoso.htm" en een JScript-webresource genaamd 'sdk_/Scripts/ContosoScript.js’ met een CSS-webresource genaamd ‘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>

Notitie

Een relatief pad inclusief de hoofdmap WebResources gebruiken, bijvoorbeeld /WebResources/ClientGlobalContext.js.aspx, wordt niet aanbevolen omdat de pagina erdoor de organisatiecontext kwijt kan raken in een omgeving met meerdere tenants.

De pagina ClientGlobalContext.js.aspx bevat enkele algemene gebeurtenishandlers. Deze gebeurtenishandlers annuleren de gebeurtenissen onselectstart, contextmenu en ondragstart.

Zie ook

Programmeerreferentie op de client
Clientcontext (clientreferentie)
Uitvoeringscontext (clientreferentie)
Beknopte naslag voor het opstellen van formulierscripts
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Het objectmodel Xrm.Page gebruiken

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht