Partager via

Fonction GetGlobalContext et ClientGlobalContext.js.aspx (référence côté client)

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Utilisez la Fonction GetGlobalContext lorsque vous effectuez une programmation avec des ressources Web pour accéder aux informations de contexte. Pour obtenir la fonction GetGlobalContext dans votre ressource Web HTML, ajoutez une référence à ClientGlobalContext.js.aspx.

Fonction GetGlobalContext

La fonction GetGlobalContext renvoie le même objet de contexte situé dans la Xrm.Page.context.

Lorsque vous avez besoin d'informations sur le contexte en dehors d'un formulaire, ajoutez une référence à la page ClientGlobalContext.js.aspx dans une ressource Web HTML.

Cet exemple suivant montre une fonction conçue pour renvoyer un objet de contexte lorsque celui-ci est utilisé dans un script de formulaire ou un script utilisé avec une ressource Web HTML.

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

Vous pouvez utiliser la fonction GetGlobalContext lorsque vous incluez une référence à la page ClientGlobalContext.js.aspx placée à la racine du répertoire des ressources Web.

Notes

Si vous n'utilisez pas de barres obliques inverses dans les noms de ressources Web HTML pour simuler une arborescence, vous pouvez inclure ce script à votre page à l'aide de l'élément de script suivant : <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

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 onselectstartcontextmenu et ondragstart.

Voir aussi

Référence par programmation côté client
Contexte côté client (référence côté client)
Contexte d'exécution (référence côté client)
Référence rapide des scripts de formulaires
Écrire du code pour les formulaires Microsoft Dynamics 365
Utiliser le modèle d’objet Xrm.Page

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright