La función GetGlobalContext y ClientGlobalContext.js.aspx (referencia de la API cliente)

  • Artículo

Utilice la función GetGlobalContext cuando programe con recursos web para obtener acceso a la información de contexto global, como la información específica del cliente, organización o usuario para su instancia de aplicaciones basadas en modelos.

Para obtener acceso a la función GetGlobalContext en el recurso web HTML, incluya una referencia a ClientGlobalContext.js.aspx.

Importante

Al incluir una referencia en ClientGlobalContext.js.aspx no pone el objeto Xrm disponible en recursos web HTML. Por lo tanto, los scripts que contienen métodos Xrm.* no se admiten en recursos web HTML. parent.Xrm.* funcionará si el recurso web HTML se carga en un contenedor del formulario. Sin embargo, en otros casos, como al cargar un recurso web HTML como parte del SiteMap, parent.Xrm.* tampoco funcionará.

Función GetGlobalContext

La función GetGlobalContext devuelve el mismo objeto de contexto tal como lo devuelve el método Xrm.Utility.getGlobalContext, lo que indica que el objeto de contexto tiene las mismas propiedades y métodos que están disponibles para Xrm.Utility.getGlobalContext. Más información: Xrm.Utility.getGlobalContext

ClientGlobalContext.js.aspx

Debe incluir una referencia a la página ClientGlobalContext.js.aspx situada en la raíz del directorio de recursos web para poder usar la función GetGlobalContext.

  • Si no está utilizando barras oblicuas en los nombres de recursos web HTML para simular una estructura de carpeta, puede incluir este script refiriéndose directamente a él. Por ejemplo:

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

</head>

  • 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 que incluye 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 en un entorno multiempresa.

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

Xrm.Utility.getGlobalContext
Comprender el modelo de objetos de la API del cliente
Recursos web para aplicaciones basadas en modelos

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).