Función GetGlobalContext y ClientGlobalContext.js.aspx (referencia del lado del cliente)

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Use la Función GetGlobalContext al programar recursos web para tener acceso a la información de contexto. Para obtener la función GetGlobalContext en el recurso web HTML, incluya una referencia a ClientGlobalContext.js.aspx.

Función GetGlobalContext

La función GetGlobalContext devuelve el mismo objeto de contexto que se encuentra en el Xrm.Page.context.

Cuando necesita información de contexto fuera de un formulario, incluya una referencia a la página de ClientGlobalContext.js.aspx en un recurso web HTML.

El siguiente ejemplo muestra una función diseñada para devolver un objeto de contexto cuando se usa en un script de formulario o un script usado con un recurso 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

Puede usar la función GetGlobalContext cuando incluye una referencia a la página ClientGlobalContext.js.aspx que se encuentra en la raíz del directorio de recursos web.

Nota

Si no está usando las caracteres de barra diagonal inversa en los nombres de recursos web HTML para simular una estructura de carpetas, puede incluir este script en la página con este elemento de script: <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

Si no está usando las caracteres de barra diagonal inversa en los nombres de recursos web HTML para simular una estructura de directorios, debe reflejar esto en el elemento de script. El siguiente ejemplo es para un recurso web HTML llamado "sdk_/Contoso.htm" y un recurso web JavaScript llamado "sdk_/Scripts/ContosoScript.js" con un recurso web CSS llamado "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>

Nota

El uso de una ruta de acceso relativa incluyendo la carpeta WebResources raíz, por ejemplo, /WebResources/ClientGlobalContext.js.aspx, no es recomendable porque puede hacer que la página pierda contexto de organización a un entorno multiempresa.

La página ClientGlobalContext.js.aspx incluirá algunos controladores de eventos globales. Estos controladores de eventos cancelarán los eventos onselectstartcontextmenu, y ondragstart.

Ver también

Referencia de programación del lado del cliente
Contexto del lado del cliente (referencia del lado del cliente)
Contexto de ejecución (referencia del lado del cliente)
Referencia de scripting de formularios
Escriba código para formularios de Microsoft Dynamics 365
Use el modelo de objeto Xrm.Page

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright