Bibliotecas JavaScript para Microsoft Dynamics 365

Artigo
03/03/2017

Publicado: janeiro de 2017

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

As bibliotecas JavaScript são Recursos da Web de script (JScript) que contêm funções que você pode usar:

Formulário de tratamento e eventos do campo.
Executar ações para controles configurados na faixa de opções.
Suportar outras funções.

Usando bibliotecas JScript

Você pode usar bibliotecas JavaScript bem como você usaria bibliotecas JavaScript em qualquer aplicativo web.

Associar funções a eventos de Formulário e de Campo

Você pode associar até 50 recursos de script da Web de modo que sejam carregados em um formulário de entidade.

Após adicionar uma biblioteca ao formulário, ela estará disponível a todos os eventos no formulário. Em qualquer evento, você pode decidir quais funções serão manipuladores de eventos. Você pode especificar até 50 funções como manipuladores de eventos para qualquer evento.

Associar funções em tempo de execução

Você pode adicionar funções ao atributo OnChange, OnSave do formulário e eventos PreSearch do controle de pesquisa em tempo de execução usando Xrm.Page.data.entity attribute.addOnChange, o Xrm.Page.data.entity.addOnSave e os métodos addPreSearch de controle de pesquisa. Quando esses métodos são usados, a função é adicionada na parte inferior do pipeline do manipulador de eventos e recebem o contexto de execução como o primeiro parâmetro. Você pode usar os métodos removeOnChange,removeOnSave e removePreSearch correspondentes para remover as funções adicionadas dessa maneira.

Contexto de execução

Cada manipulador de eventos pode ser configurado para aceitar um objeto de contexto de execução como o primeiro parâmetro. O contexto de execução inclui as funções que podem ser chamadas para determinar:

Profundidade: A ordem relativa em que o manipulador é executado.
Origem do evento: Uma referência ao objeto que iniciou o evento.

Esse recurso é importante quando você está criando uma função que pode responder a eventos de diversos eventos de formulário ou campo diferentes.
Variáveis compartilhadas: Isso permite que uma função defina uma variável como um par de chaves/valor que possa ser acessado por outros manipuladores de eventos.

Para obter mais informações:Contexto de execução (referência do cliente)

Na caixa de diálogo de propriedades do manipulador, você pode inserir uma lista de valores de string separados por vírgula que será passada à função. Isso pode ser útil para permitir que o comportamento de uma função seja alterado sem exigir alterações no código.

Associar funções com os comandos da barra de comandos (Faixa de opções)

Todos os controles na barra de comandos ou na faixa é associada ao <CommandUIDefinition> (RibbonDiffXml) que contém um elemento <Actions> (RibbonDiffXml) que inclui uma ou mais ações.<JavaScriptFunction> (RibbonDiffXml) é uma das ações disponíveis. O elemento JavaScriptFunction exige uma referência a uma biblioteca e uma função nessa biblioteca.

Desenvolver e testar scripts

Você pode editar scripts através do formulário de recurso da Web ou do guia de Eventos onde você configura bibliotecas de formulários e manipuladores de eventos.

Além disso, você pode usar sua ferramenta de edição de script favorita e fazer upload de suas alterações para atualizar o recurso web de script. Você deve publicar o recurso da Web depois de fazer alterações.

Criando bibliotecas de script

Quando você cria as funções que serão usadas para bibliotecas JavaScript, as funções podem ser carregadas em um formulário com outras bibliotecas JavaScript. Se outra biblioteca contém uma função que possui o mesmo nome de uma função fornecida, qualquer que seja a função carregada por último, esta será definida na página. Para evitar ter suas funções substituídas por funções em outra biblioteca, você deve assegurar que as funções tenham nomes exclusivos.

Duas estratégias que você pode usar para ajudar a garantir que as funções tenham nomes específicos:

Prefixo exclusivo de função
Defina cada uma de suas funções usando a sintaxe padrão com um nome consistente que inclua uma convenção de nomenclatura exclusiva, conforme mostrado no exemplo a seguir.
```
function MyUniqueName_performMyAction()
{
// Code to perform your action.
}
```
Nomes de bibliotecas de Namespaced
Associe cada uma de suas funções com um objeto JavaScript para criar um tipo de namespace para uso sempre que você ligar suas funções, conforme mostrado no exemplo a seguir.
```
//If the MyUniqueName namespace object isn’t defined, create it.
if (typeof (MyUniqueName) == "undefined")
 { MyUniqueName = {}; }
  // Create Namespace container for functions in this library;
  MyUniqueName.MyFunctions = {
   performMyAction: function(){
   // Code to perform your action.
   //Call another function in your library
   this.anotherAction();
  },
  anotherAction: function(){
   // Code in another function
  }
};
```
Então, quando você usar a função, você poderá especificar o nome completo. O exemplo a seguir mostra isso.
```
MyUniqueName.MyFunctions.performMyAction();
```
Se você ligar uma função em outra função, você poderá usar palavras-chave this como um atalho ao objeto que contenha ambas as funções. No entanto, se a função estiver sendo usada como um manipulador de eventos, a palavra-chave this fará referência ao objeto em que estiver ocorrendo o evento.

Depurando scripts

Cada navegador tem seu próprio conjunto de ferramentas para desenvolvedores. As instruções seguintes descrevem usando Internet Explorer.

Deputar o script nos formulários do Microsoft Dynamics 365

Pressione F12 para abrir as ferramentas do desenvolvedor.
Na guia Script, à direita do botão Iniciar depuração, use a lista suspensa para localizar sua biblioteca JavaScript.
Defina um ponto de interrupção clicando na margem esquerda em sua função.
Clique em Iniciar depuração.
Se o script estiver no evento Onload, talvez seja necessário selecionar a janela Microsoft Dynamics 365 e pressionar F5 para recarregar a janela.

Para obter mais informações, consulte Depurando script com ferramentas do desenvolvedor.

Confira Também

Usar o Javascript com o Microsoft Dynamics 365
Personalizar o aplicativo Microsoft Dynamics 365
Estender o Microsoft Dynamics 365 no cliente
Recursos da Web de script (JScript)
Crie códigos para os formulários do Microsoft Dynamics 365
Personalizar formulários de entidade
Definir ações da faixa de opções
Exemplo: Importar arquivos como recursos da Web
Exemplo: utilitário de recurso da Web

Microsoft Dynamics 365