Fonction GetGlobalContext et ClientGlobalContext.js.aspx (référence client API)

  • Article

Utilisez la fonction GetGlobalContext lorsque vous programmez avec des ressources Web pour accéder aux informations de contexte globales, telles que des informations spécifiques au client, à l’organisation ou à un utilisateur pour votre instance des applications basées sur un modèle.

Pour obtenir l’accès à la fonction GetGlobalContext dans votre ressource Web HTML, ajoutez une référence à ClientGlobalContext.js.aspx.

Important

Inclure une référence à ClientGlobalContext.js.aspx ne rend pas l’objet Xrm disponible dans les ressources Web HTML. En conséquence, les scripts contenant les méthodes Xrm.* ne sont pas pris en charge dans les ressources Web HTML. parent.Xrm.* fonctionnera si la ressource Web HTML est chargée dans un conteneur de formulaire. Cependant, pour les autres emplacements, comme le chargement d’une ressource Web HTML dans le cadre de SiteMap, parent.Xrm.* ne fonctionnera pas non plus.

Fonction GetGlobalContext

La fonction GetGlobalContext renvoie le même objet de contexte que celui renvoyé par la méthode Xrm.Utility.getGlobalContext, ce qui implique que l’objet de contexte aura les mêmes propriétés et méthodes que celles disponibles pour Xrm.Utility.getGlobalContext. Plus d’informations : Xrm.Utility.getGlobalContext

ClientGlobalContext.js.aspx

Vous devez inclure une référence à la page ClientGlobalContext.js.aspx située à la racine du répertoire de ressources Web pour pouvoir utiliser la fonction GetGlobalContext.

  • Si vous n’utilisez pas de barres obliques dans les noms de ressources Web HTML pour simuler une structure de dossiers, vous pouvez inclure ce script en vous y référant directement. Par exemple :

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

</head>

  • Si vous n’utilisez pas de barres obliques inverses dans les noms de ressources Web HTML pour simuler une structure de répertoire, vous devez refléter ceci dans votre élément de script. L’exemple suivant concerne une ressource Web HTML nommée sdk_/Contoso.htm et une ressource Web JavaScript nommée sdk_/Scripts/ContosoScript.js avec une ressource Web CSS nommée 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>

Notes

Il n’est pas recommandé d’utiliser le chemin d’accès relatif, notamment le dossier racine WebResources, par exemple /WebResources/ClientGlobalContext.js.aspx, car il peut entraîner la perte pour la page du contexte de l’organisation dans un environnement mutualisé.

La page ClientGlobalContext.js.aspx inclut des gestionnaires d’événements globaux. Ces gestionnaires d’événements annulent les événements onselectstart, contextmenu et ondragstart.

Xrm.Utility.getGlobalContext
Comprendre le modèle objet de l’API client
Ressources Web pour les applications basées sur un modèle

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).