Função GetGlobalContext e ClientGlobalContext.js.aspx (referência do cliente)

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Use o Função GetGlobalContext quando programar com recursos da Web para obter às informações de contexto. Para obter a função GetGlobalContext no recurso da Web HTML, inclua uma referência para ClientGlobalContext.js.aspx.

Função GetGlobalContext

A função GetGlobalContext retorna o mesmo do objeto de contexto encontrado no Xrm.Page.context.

Quando precisar de informações de contexto fora de um formulário, inclua uma referência à página ClientGlobalContext.js.aspx no recurso da Web HTML.

O exemplo a seguir mostra uma função criada para retornar um objeto de contexto quando usado em um script de formulário ou um script usado com um recurso da 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

Você pode usar a função GetGlobalContext ao inclui uma referência à página ClientGlobalContext.js.aspx localizada na raiz do diretório de recursos da Web.

Observação

Se você não estiver usando caracteres de barra invertida em nomes de recurso da Web HTML para simular uma estrutura de pastas, você pode incluir o script na página usando este elemento de script: <script type="text/javascript" src="ClientGlobalContext.js.aspx"></script>

Se você não estiver usando caracteres de barra invertida em nomes de recurso da Web HTML para simular uma estrutura de diretórios, você deve refletir neste elemento de script. O exemplo a seguir é para recursos da Web HTML chamado "sdk_/Contoso.htm" e um recurso da Web do JavaScript chamado ‘sdk_/Scripts/ContosoScript.js’ com um recurso da Web CSS chamado ‘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>

Observação

Usar um caminho relativo incluindo a pasta raiz de WebResources, por exemplo, /WebResources/ClientGlobalContext.js.aspx, não é recomendável porque poderá fazer com que a página perca o contexto da organização para um ambiente multi-locatário.

A página ClientGlobalContext.js.aspx incluirá alguns manipuladores de eventos globais. Esses manipuladores de eventos cancelarão os eventos onselectstart, contextmenu e ondragstart.

Confira Também

Referência de programação do cliente
Contexto do cliente (referência do cliente)
Contexto de execução (referência do cliente)
Referência rápida do script de formulário
Crie códigos para os formulários do Microsoft Dynamics 365
Use o modelo de objeto Xrm.Page

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais