Usar o editor de formulários

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Este tópico descreve como acessar o editor de formulários, o recursos que contém, os elementos de formulário que você pode editar e as propriedades desses elementos.

Neste tópico

Abrir o editor de formulários

Interface do usuário do editor de formulários

Propriedades do formulário

Opções de visibilidade

Propriedades da Guia

Propriedades da seção

Propriedades do campo comum

Propriedades do campo especial

Propriedades da subgrade

Propriedades de controle de exibição rápida

Propriedades do recurso da Web

Propriedades do IFRAME

Controle de anotações

Configurar o Bing maps

Editar Navegação

Controle do timer

Configurar manipuladores de eventos

Abrir o editor de formulários

Você pode acessar o editor de formulários através da barra de comandos ou da faixa de opções, dependendo da entidade. Esses métodos abrirão o formulário no contexto da solução padrão. Se você criar qualquer novo componente de solução no processo de edição do formulário, por exemplo, os recursos da Web, os nomes dos componentes usarão o prefixo de personalização do fornecedor de soluções para a solução padrão e esses componentes serão apenas incluídos na solução padrão. Se quiser que qualquer novo componente da solução seja incluído em uma solução não gerenciada específica, é necessário abrir o editor de formulários através dessa solução não gerenciada.

Para acessar o editor de formulários pela barra de comandos

1. Exibir o registro de uma das Entidades atualizadas, por exemplo, abrir um registro da conta.

2. Se houver vários formulários principais para a entidade, verifique se o formulário é aquele que você deseja editar. Caso contrário, use o seletor de formulários para escolher o formulário a ser editado.

3. Na barra de comandos, clique no botão Mais Comandos.

4. Escolher Formulário.

Isso abrirá o editor de formulários do formulário usando a solução padrão.

Para acessar o editor de formulários pela faixa de opções

1. Exibir um registro para um dos Entidades usando formulários clássicos.

2. Se houver vários formulários principais para a entidade, verifique se o formulário é aquele que você deseja editar. Caso contrário, use o seletor de formulários para escolher o formulário a ser editado.

3. Na guia Personalizar da faixa de opções, no grupo Criar, selecione Formulário.

Isso abrirá o editor de formulários do formulário usando a solução padrão.

Para acessar o editor de formulários pela solução padrão

1. Vá para Configurações > Personalizações.

2. Selecione Personalizar o Sistema para abrir a solução padrão.

3. Em Componentes, expanda Entidades e a entidade desejada e selecione Formulários.

4. Na lista de formulários, selecione o formulário que deseja editar.

Para acessar o editor de formulários de uma solução não gerenciada

1. Vá para Configurações > Personalizações.

2. Escolha Soluções.

3. Clique duas vezes na solução não gerenciada que você deseja trabalhar.

4. Localize a entidade com o formulário que você deseja editar. Se a entidade não estiver lá, será necessário adicioná-la.

   Adicionar uma entidade para uma solução não gerenciada

   1. Selecione o nó Entidades e, na barra de ferramentas acima da lista, selecione Adicionar Existente.

   2. Na caixa de diálogo Selecionar Componentes da Solução, com o seletor Tipo de Componente definido para Entidade, selecione a entidade que deseja adicionar e selecione OK.

   3. Se a caixa de diálogo Componentes Necessários Ausentes aparecer, você pode escolher Não, não incluir os componentes necessários não se pretende exportar essa solução não gerenciada para outra organização. Se optar por não incluir os componentes necessários ausentes no momento, você poderá adicioná-los posteriormente. Você receberá uma notificação novamente se exportar essa solução no futuro.

5. No gerenciador de soluções, expanda a entidade com o formulário que deseja editar e selecione Formulários.

6. Na lista de formulários, clique duas vezes no formulário que deseja editar.

Interface do usuário do editor de formulários

O editor de formulários exibe comandos em duas guias da faixa de opções: Início e Inserir. Para obter detalhes sobre os comandos disponíveis, consulte Guia Inicial e Guia Inserir.

O corpo do editor de formulários é dividido em três áreas: Navegação, Corpo e Gerenciador.

• Área de navegação
  Localizada no lado esquerdo, use a área de navegação para controlar o acesso às entidades relacionadas ou adicionar links para recursos da Web ou URLs a serem exibidas no painel principal do formulário. Para editar a navegação, você deve selecionar primeiro o comando Navegação no grupo Selecionar da guia Início.

  Os formulários para o Entidades usando formulários clássicos oferecem uma experiência de navegação visualmente semelhante àquela exibido na área de navegação. Os formulários do Entidades atualizadas fornecem opções de navegação na barra de navegação, mas usam os mesmos dados para controlar quais opções de navegação estão disponíveis.Para obter mais informações:Editar Navegação

• Área do corpo
  Localizado no centro, use a área do corpo para controlar o layout do formulário. Você pode selecionar e arrastar elementos do formulário para posicioná-los. Clicar duas vezes em um elemento abrirá as propriedades do elemento.

  • Para adicionar um campo, selecione-o no Gerenciador de Campos e arraste-o para uma seção.

  • Para adicionar um elemento que não seja um campo, selecione onde deseja colocá-lo e use o comando adequado na guia Inserir para adicionar.

  • Para remover um elemento, selecione-o e use o comando Remover no grupo Editar da guia Início.

  • Para editar o Cabeçalho ou o Rodapé do formulário, você primeiro deve selecionar o comando correspondente no grupo Selecionar da guia Início.

• Área do Gerenciador
  Localizado no lado direito, o gerenciador da área do gerenciador depende do contexto.

  Ao seleciona Corpo, Cabeçalho ou Rodapé no grupo Selecionar da guia Início, você verá o Gerenciador de Campos. Use o Gerenciador de Campos para arrastar os campos que você deseja exibir em uma seção no formulário ou dentro do cabeçalho ou rodapé. Você pode incluir o mesmo campo várias vezes em um formulário. Use o botão Novo Campo como um atalho para criar um novo campo.

  Ao selecionar Navegação, no grupo Selecionar da guia Início, você verá o Gerenciador de Relacionamentos. Arraste qualquer relacionamento em um dos grupos na área de navegação. Você não pode adicionar o mesmo relacionamento duas vezes. Os relacionamentos estão disponíveis com base em como são configurados. Se você configurar um relacionamento para não ser exibido, não será exibido no Gerenciador de Relacionamentos. Para obter informações sobre como configurar as opções de exibição padrão para relacionamentos, consulte Item do painel de navegação para entidade principal.

  Você pode usar Novo 1:N e Novos botões de N:N como um atalho para adicionar novos relacionamentos de entidades.

Guia Inicial

A guia Início exibe os comandos na seguinte tabela.

Grupo	Comando	Descrição
Salvar	Salvar (Ctrl+S)	Salve o formulário.
	Salvar como	Cria uma cópia deste formulário com um nome diferente.
	Salvar e Fechar	Salva o formulário e fecha o editor de formulários.
	Publicar	Publica o formulário.Para obter mais informações:Publicando personalizações
Editar	Alterar propriedades	Altera as propriedades do item selecionado no corpo. Consulte as seguintes seções dependendo do item selecionado: Propriedades da Guia Propriedades da seção Propriedades do campo comum Propriedades do campo especial Propriedades da subgrade Propriedades de controle de exibição rápida Propriedades do recurso da Web Propriedades do IFRAME Controle de anotações Configurar o Bing maps
	Remover	Remove o item selecionado.
	Desfazer (Ctrl+Z)	Desfaça a ação anterior.
	Refazer (Ctrl+Y)	Refaz a ação anterior.
Selecionar	Corpo	Edita o corpo principal do formulário.
	Cabeçalho	Edita o cabeçalho do formulário.
	Rodapé	Edita o rodapé do formulário.
	Navegação	Edita a navegação de formulário. Para obter mais informações:Editar Navegação
Formulário	Regras de Negócios	Exibir, Editar ou Criar novas Regras de Negócios com o Gerenciador de Regras de Negócios. Para obter mais informações:Criar e editar regras de negócios
	Propriedades do formulário	Para obter mais informações:Propriedades do formulário
	Visualizar	Visualiza como ficará a aparência do formulário depois que for publicado. As opções são: Criar Formulário: Como o formulário aparecerá antes de um registro ser salvo. Atualizar Formulário: Como formulário de um registro existente será exibido. Formulário Somente Leitura: Como o formulário será exibido para os usuários com acesso somente leitura a um registro. Os scripts no formulário podem ser testados, mas determinados cenários, como verificar valores de dados no evento OnLoad não podem ser testados porque o formulário de visualização não contém dados.
	Habilitar Direitos de Acesso	Use essa opção para definir as funções de segurança que terão acesso aos formulários.Para obter mais informações:Controlar o acesso aos formulários Importante Se você criar um novo formulário, apenas as funções de segurança de personalizador do sistema ou administrador do sistema terão acesso ao formulário. Você precisa atribuir acesso a outras funções de segurança antes que as pessoas na organização possam usá-lo.
	Mostrar Dependências	Ver quais componentes da solução dependem desse formulário e quais componentes da solução são exigidos por esse formulário.Para obter mais informações:Dependências de solução
	Propriedades Gerenciadas	A única propriedade gerenciada é Personalizável. Definir isso para falso significa que o formulário não será personalizável após incluir em uma solução, exportar essa solução como uma solução gerenciada e importar a solução gerenciada em uma organização diferente.Para obter mais informações:Propriedades gerenciadas
Atualizar	Mesclar Formulários	Use essa configuração para mesclar um formulário de uma versão anterior depois da atualização. Isso facilitará a adoção de novos layouts de formulário introduzidos nesta versão. O formulário será acrescentado na parte inferior do formulário atual. Use isso para combinar os formulários enquanto preserva os manipuladores de eventos para scripts do formulário.

Guia Inserir

A guia Inserir exibe os comandos na seguinte tabela:

Grupo	Comando	Descrição
	Seção	Adicionar uma seção a uma guia selecionada. Você pode optar incluir uma seção com uma das quatro colunas. Para obter mais informações:Propriedades da seção
3 Guias	Três Colunas	Insere uma guia com três colunas de larguras iguais. Para obter mais informações:Propriedades da Guia
	Três Colunas	Insere uma guia com três colunas, com a coluna do meio mais larga.
2 Guias	Duas Colunas	Insere uma guia com duas colunas, com a coluna direita mais larga.
	Duas Colunas	Insere uma guia com duas colunas, com a coluna esquerda mais larga.
	Duas Colunas	Insere uma guia com duas colunas de larguras iguais.
1 Tabulação	Uma Coluna	Insere uma guia de uma coluna.
Controle	Subgrade	Formata uma subgrade e insere no formulário. Para obter mais informações:Propriedades da subgrade
	Espaçador	Insere um espaço vazio.
	Formulário de Visualização Rápida	Insere um formulário de exibição de rápida. Para obter mais informações:Propriedades de controle de exibição rápida
	Recurso da Web	Insere um recurso da Web. Para obter mais informações:Propriedades do recurso da Web
	IFRAME	Insere um IFRAME. Para obter mais informações:Propriedades do IFRAME
	Observações	Insere um controle para exibir atividades, postagens e anotações.Para obter mais informações:Controle de anotações
	Bing Mapas	Insere um controle para mostrar mapas no formulário.Para obter mais informações:Configurar o Bing maps
	Link de Navegação	Insere um link na navegação na área de navegação. Esse comando está desabilitado, a não ser que você selecione o comando Navegação no grupo Selecionar da guia Início.Para obter mais informações:Propriedades do link de navegação
	Timer	Insira um controle do timer.Para obter mais informações:Controle do timer

Propriedades do formulário

As propriedades do formulário estão na tabela a seguir:

Guia	Propriedade	Descrição
Eventos	Bibliotecas de formulários	Gerenciar quais recursos da Web JavaScript estão disponíveis no formulário e a ordem em que serão carregados.
	Manipuladores de Eventos	Configurar quais funções do JavaScript das Bibliotecas de Formulários serão executadas para eventos de formulário OnLoad e OnSave e a ordem em que serão realizados.
Exibição	Nome do Formulário	Digite um nome que faça sentido para as pessoas. Esse nome será exibido quando os usuários utilizarem o formulário. Se pode usar vários formulários configurados para a entidade, eles usarão esse nome para diferenciar entre formulário disponíveis.
	Descrição	Insira uma descrição que explica como esse formulário é diferente de outros formulários principais. Essa descrição será exibida apenas na lista de formulários para uma entidade no gerenciador de soluções.
	Navegação de Página	Você pode optar por não mostrar itens de navegação. Nos formulários para entidades atualizadas, isso significa que o valor do nome principal para o registro sendo atualmente exibido não será mostrado na barra de navegação para permitir a navegação em exibições associadas. Em formulários usando a apresentação clássica, as opções de navegação para selecionar exibições associadas no lado esquerdo do formulário não serão mostradas.
	Imagem	Quando uma entidade tiver um campo de imagem e a opção Imagem da Página das entidades estiver definida, essa configuração habilitará a exibição do campo de imagem no cabeçalho desse formulário. Consulte Habilitar ou desabilitar opções da entidade para obter mais informações sobre as opções de entidade.
	Exibição	Definir a largura máxima (em pixels) para limitar a largura do formulário. O valor padrão é 1900.
Parâmetros	Parâmetros	Cada formulário pode ser aberto com código usando uma URL. A URL também pode conter dados que podem ser transmitidos para o formulário usando uma cadeia de caracteres anexada à URL. As cadeias de caracteres parecem com este exemplo: ?p_firstName=Jim&p_lastName=Daly Como uma medida segurança, os formulários não aceitarão qualquer parâmetro da cadeia de caracteres de consulta desconhecido. Use esta lista de parâmetros para especificar parâmetros que esse formulário deve aceitar para apoiar o código que irá transmitir os dados para os formulários usando uma cadeia de caracteres de consulta. O nome e o tipo de dados serão verificados e o formulário não será aberto se os parâmetros da cadeia de caracteres de consulta válidos forem transmitidos. Observação O nome não pode começar com um sublinhado (_) ou com crm_. Ele deve começar com caracteres alfanuméricos seguidos de um sublinhado (_). Por exemplo, parâmetro_1 ou 1_parâmetro. O nome não pode conter hífen (-), dois pontos (:), ponto e vírgula (;), vírgula (,) ou ponto (.). Para obter mais informações, consulte o tópico Abrir formulários, exibições, caixas de diálogo e relatórios com uma URL no SDK do Microsoft Dynamics CRM.
Dependências Fora do Evento	Campos Dependentes	Cada manipulador de eventos tem uma propriedade Campos dependentes semelhantes para que qualquer campo necessário pelo script possa ser registrado. Qualquer pessoa que tentar remover campos dependentes não poderá. Alguns scripts funcionam no formulário, mas não estão configurados em um manipulador de eventos. Os scripts iniciados na barra de comandos não têm um local onde os campos dependentes possam ser registrados. Esta propriedade de formulário fornece um local para que os campos dependentes desses scripts sejam registrados.

Opções de visibilidade

Vários tipos de elementos de formulário têm a opção de ser exibido ou oculto por padrão. Guias, seções, campos, IFRAMEs e recursos da Web fornecem essa opção. Usando scripts de formulário ou regras de negócios, a visibilidade desses elementos pode ser controlada para criar um formulário dinâmico para fornecer uma interface do usuário que se adapta às condições no formulário.

Observação

Ocultar elementos do formulário não é uma forma recomendável de garantir a segurança. Há várias maneiras que as pessoas podem exibir todos os elementos e dados no formulário quando os elementos forem ocultos.

A apresentação do painel de leitura do Microsoft Dynamics CRM para Outlook não oferece scripts de formulário. Essa apresentação usará as opções de visibilidade padrão definidas para o formulário.

Em vez de criar formulários que dependem de scripts para controlar a visibilidade das opções, considere se um fluxo do processo empresarial, uma caixa de diálogo ou alterar para um formulário diferente pode ser mais adequado para atender seus requisitos. Se você usar scripts, certifique-se de que qualquer elemento que pode estar oculto, esteja oculto por padrão. Exibir somente com scripts quando sua lógica solicitar. Dessa forma, não será exibido em apresentações que não suportam scripts.

Propriedades da Guia

No corpo do formulário, as guias fornecem uma separação horizontal. As guias têm uma etiqueta que pode ser exibida. Se a etiqueta forem exibidas, as guias podem ser recolhidas ou expandidas para mostrar ou ocultar o conteúdo selecionando a etiqueta.

As guias contêm até três colunas e a largura de cada coluna pode ser definida como uma porcentagem do total. Ao criar uma nova guia, cada coluna é preenchida previamente com uma seção.

A tabela a seguir mostra as propriedades que podem ser definidas para guias no formulário.

Guia	Propriedade	Descrição
Exibição	Nome	Necessário: O nome exclusivo da guia usada ao fazer referências em scripts. O nome pode conter somente caracteres alfanuméricos e sublinhados.
	Etiqueta	Necessário: A etiqueta localizável da guia visível para os usuários.
	Exibir a etiqueta nesta guia no formulário	Quando a etiqueta é exibida, as pessoas podem clicar para alterar se a guia é expandida ou recolhida. Escolha se deseja mostrar a etiqueta.
	Expandir essa guia por padrão	O estado da guia pode ser alternado entre expandida ou recolhida usando scripts de formulário ou por pessoas clicando na etiqueta. Escolha o estado padrão para a guia.
	Visível por padrão	Mostrar a guia é opcional e pode ser controlado usando scripts. Escolha se deseja tornar a guia visível.Para obter mais informações:Opções de visibilidade
	Bloquear a guia no formulário	Isso impedirá que a guia seja removida acidentalmente e impede que os usuários alterem o conteúdo. Remover uma guia não removerá apenas a guia, mas também todos os manipuladores de eventos do scripts para a guia ou campos na guia. Recriar todo esse trabalho pode ser um esforço substancial. Uma pessoa que deseja remover essa guia precisa alterar essa configuração antes de removê-la.
Formatação	Layout	Guias podem ter até três colunas. Use essas opções para definir o número de guias e a porcentagem da largura total que devem preencher.
Eventos	Bibliotecas de formulários	Especifique os recursos da Web JavaScript que serão usados no manipulador de eventos da guia TabStateChange. Consulte o tópico do SDK Referência de eventos do formulário: Evento TabStateChange da guia
	Manipuladores de Eventos	Configurar as funções das bibliotecas que devem ser chamadas para o evento TabStateChange da guia.Para obter mais informações:Configurar manipuladores de eventos

Propriedades da seção

Uma seção ocupa o espaço disponível em uma coluna da guia. As seções com uma etiqueta podem ser exibidas e uma linha pode ser exibida abaixo da etiqueta.

As seções podem ter até 4 colunas e incluem opções para exibir como as etiquetas dos campos na seção são exibidas.

Os cabeçalhos e rodapés são semelhantes às seções, mas não podem ser removidos. Se não conterem nada, não serão exibidos.

Guia	Propriedade	Descrição
Exibição	Nome	Necessário: O nome exclusivo da seção usada ao fazer referências em scripts. O nome pode conter somente caracteres alfanuméricos e sublinhados.
	Etiqueta	Necessário: A etiqueta localizável da seção visível para os usuários.
	Exibir a etiqueta nesta seção no formulário	As seções são usadas frequentemente sem etiquetas para controlar a formatação dos campos nelas.
	Mostrar uma linha na parte superior da seção	Uma linha na parte superior de uma seção pode ajudar a dividir o layout do formulário.
	Largura da Etiqueta do Campo	Necessário: Defina o valor entre 50 e 250 para especificar o espaço permitido para etiquetas do campo. Elementos de cabeçalho e rodapé também têm essa propriedade.
	Visibilidade	Mostrar a seção é opcional e pode ser controlado usando scripts.Para obter mais informações:Opções de visibilidade
	Bloquear a seção no formulário	Isso impedirá que a seção seja removida acidentalmente e impede que os usuários removerem o conteúdo. Remover uma seção não removerá apenas a seção, mas também todos seus campos. Uma pessoa que deseja remover essa seção precisa alterar essa configuração antes de removê-la.
Formatação Componentes de cabeçalho e rodapé também têm essa propriedade.	Layout	Especifique até quatro colunas para estar na seção.
	Alinhamento das Etiquetas do Campo	As etiquetas dos campos na seção podem ser alinhadas à esquerda, direita ou centro.
	Posição das Etiquetas do Campo	As etiquetas dos campos na seção podem ser posições no lado ou no topo dos campos.

Propriedades do campo comum

Os campos exibem controles que as pessoas usam para exibir ou editar dados em um registro da entidade. Os campos podem ser formatados para ocupar até quatro colunas em uma seção.

A tabela a seguir descreve as propriedades que todos os campos têm. Determinados tipos de campos têm propriedades especiais. Eles estão descritos em Propriedades do campo especial.

Guia	Propriedade	Descrição
Exibição	Etiqueta	Necessário: Por padrão, a etiqueta corresponderá ao nome de exibição do campo. Você pode substituir o nome para o formulário inserindo uma etiqueta diferente.
	Exibir rótulo no formulário	Você também pode optar por não exibir a etiqueta.
	O campo é somente leitura	Você pode especificar que o campo não é editável. Usando scripts de formulários, é possível alterar isso para habilitar ou desabilitar a edição com base nos critérios avaliados no script.
	Bloquear o campo no formulário	Isso impedirá que o campo seja removido do formulário acidentalmente. Isso impedirá qualquer configuração aplicada no campo, como manipuladores de eventos, seja desmarcada se o campo for removido. Para remover este campo, um personalizador precisa ser primeiro desmarcar essa configuração.
	Visível por padrão	Mostrar o campo é opcional e pode ser controlado usando scripts.Para obter mais informações:Opções de visibilidade
Formatação	Selecione o número de colunas ocupadas pelo controle	Quando a seção que contém campos tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
Detalhes	Nome de Exibição, Nome e Descrição	Esses campos são somente leitura para referência. Selecione Editar para acesso conveniente à definição do campo para edição. Cada instância de um campo no formulário tem um nome de propriedade para que possam ser referenciados nos scripts de formulário, mas esse nome é gerenciado pelo aplicativo. A primeira instância do campo é o nome do campo especificado quando foi criado.Para obter mais informações:Criar e editar campos Para cada hora adicional que um campo é incluído em um formulário, o nome acrescenta um número que começa com 1 até o final. Caso o nome do campo seja "new_cost”, a primeira instância é "new_cost”, a segunda é “new_cost1", e assim por diante, para cada instância do campo no formulário. Observação O valor do campo Descrição oferece o texto da dica de ferramenta para o campo quando as pessoas colocam o cursor sobre ele.
Eventos	Bibliotecas de formulários	Especifique os recursos da Web JavaScript que serão usados no manipulador de eventos do campo OnChange. Consulte o SDK Referência de eventos de formulário: Evento OnChange de campo
	Manipuladores de eventos	Configure as funções das bibliotecas de formulário que devem ser chamadas para o evento OnChange do campo.Para obter mais informações:Configurar manipuladores de eventos
Regras de Negócios	Regras de Negócios	Exibir e gerenciar todas as regras de negócios que fazem referência ao campo.Para obter mais informações:Criar e editar regras de negócios

Propriedades do campo especial

Todos os campos têm propriedades listadas no Propriedades do campo comum, mas determinados campos têm propriedades adicionais.

Propriedades do campo de pesquisa

Na guia Exibir, os campos de pesquisa apresentam algumas propriedades adicionais. Alguns campos do sistema que parecem campos de pesquisa e têm comportamentos semelhantes são Proprietário, Cliente, Lista de Pagamento e Pesquisas relacionadas. Esses campos são diferentes das pesquisas porque permitem configurar vários valores ou vários tipos, ou ambos. Esses campos têm apenas as duas primeiras propriedades: Desativar resoluções automáticas no campo e Desabilitar os itens usados mais recentemente neste campo.

Esse é um exemplo da caixa de diálogo de pesquisa exibida quando as pessoas escolherem a opção Pesquisar Mais Registros ao configurar o valor da pesquisa.

Propriedade	Descrição
Desativar resoluções automáticas no campo	Somente os formulários principais que usam o Formulários clássicos suportam a resolução automática. Isso pode ser desabilitado por essa configuração.
Desabilitar os itens usados mais recentemente neste campo	Somente os formulários principais que usam o Formulários clássicos suportam os itens usados mais recentemente. Isso pode ser desabilitado por essa configuração.
Filtragem de Registros Relacionados	Quando isso estiver habilitado, os registros exibidos quando alguém procurar por um registro terão a filtragem adicional aplicada. Isso ajuda a fornecer pesquisas mais relevantes ao configurar o valor da pesquisa. Você também pode permitir que os usuários desativem o filtro.
Exibir a caixa de pesquisa na caixa de diálogo de pesquisa	Você pode especificar não exibir a caixa de pesquisa na caixa de diálogo de pesquisa.
Exibição Padrão	Essa exibição será usada para filtrar os resultados da pesquisa embutida e especificar a exibição padrão mostrada na caixa de diálogo de pesquisa se as pessoas escolherem a opção Pesquisar Mais Registros. A exibição padrão também controla quais campos são incluídos na pesquisa embutida. Para campos as permitem apenas a seleção de um único tipo de entidade, os campos exibidos na pesquisa embutida são definidos para os primeiros dois campos incluídos na exibição padrão. Neste exemplo, Telefone Principal e Email são as primeiras duas colunas na exibição padrão configuradas para uma pesquisa de conta. Para as pesquisas do sistema que permitem vários tipos de entidades, as duas primeiras colunas de exibição da pesquisa de entidade são mostradas.
Exibir Seletor	É possível escolher entre três opções: Desativado: Não permitir que os usuários escolham uma exibição diferente. Mostrar Todas as Exibições: Todas as exibições estão disponíveis. Mostrar Exibições Selecionadas: Ao escolher essa opção, é possível usar a tecla Ctrl e o cursor para escolher quais exibições mostrar. A exibição de pesquisa para a entidade não poderá ser desmarcada.

Propriedades do campo de duas opções

Na guia formatação, dois campos de opção têm as seguintes opções de formatação

• Dois botões de rádio: Dois controles etiquetados com etiquetas. Somente um pode ser selecionado.

• Caixa de seleção: Uma única caixa de seleção para definir o valor verdadeiro ou falso.

• Lista: Uma lista suspensa que contém valores.

Várias linhas das propriedades do campo de texto

Várias linhas de texto e uma linha única dos campos de texto que usam o formato Text Area têm uma propriedade Layout de Linhas. Com essa propriedade, é possível especificar um valor para Número de Linhas ou selecionar Expandir automaticamente para usar o espaço disponível.

Propriedades da subgrade

Você pode configurar uma subgrade para exibir uma lista de registros ou um gráfico. Selecione Mostrar Somente Gráfico na guia Exibir para mostrar um gráfico em vez de uma lista.

Guia	Propriedade	Descrição
Exibição	Nome	Necessário: O nome exclusivo da subgrade usado ao fazer referências em scripts. O nome pode conter somente caracteres alfanuméricos e sublinhados.
	Etiqueta	Necessário: A etiqueta localizável da subgrade visível para os usuários.
	Exibir etiqueta no formulário	Se a etiqueta deve ser exibida no formulário. Ela é necessária se você habilitar Exibir Caixa de Pesquisa.
	Registros	Escolha entre duas opções: Somente Registros Relacionados: A subgrade exibirá somente os registros relacionados ao registro atual. Todos os Tipos de Registro: A subgrade exibirá os registros filtrados apenas pela exibição padrão ou, se o seletor da exibição estiver habilitado, qualquer exibição que o usuário selecionar. A opção que você escolher afetará o comportamento do controle da lista de exibição.Para obter mais informações:Mostrar o comportamento da lista
	Entidade	Dependendo da opção escolhida para Registros, essa lista exibe: Somente Registros Relacionados: Uma lista de entidades relacionadas à entidade com o nome do campo de pesquisa na entidade que define o relacionamento entre parênteses. Todos os Tipos de Registro: Uma lista de todas as entidades.
	Exibição Padrão	Escolha a exibição que será aplicada por padrão. Se você não permitir nenhuma outra exibição usando a propriedade Exibir Seletor. Essa será a única exibição. Use o botão Editar para abrir a exibição padrão para edição. Use o botão Novo para criar uma nova exibição para usar na subgrade.
	Exibir a Caixa de Pesquisa	Exibir a caixa de pesquisa. Quando essa opção é escolhida, a opção Exibir Etiqueta no Formulário é obrigatória.
	Índice de Exibição	Apenas formulários usando o Formulários clássicos suportam o índice de exibição. Marque esta caixa de seleção se quiser que o índice alfabético fique disponível com a lista. Isso permite saltar para registros que comecem com uma letra ou um número específico.
	Exibir Seletor	Você tem três opções: Desativado: Somente a exibição padrão pode ser usada. Mostrar Todas as Exibições: Permitir que os usuários escolham qualquer exibição. Mostrar Exibições Selecionadas: Use a tecla Ctrl com seu cursor para selecionar quais exibições disponíveis mostrar.
	Gráfico Padrão	Selecione qual gráfico mostrar se Mostrar Somente Gráfico estiver selecionado.
	Mostrar Somente Gráfico	Em vez de uma lista de registros, um gráfico será exibido.
	Exibir Seleção de Gráfico	Se Mostrar Somente Gráfico estiver selecionado, permite que os usuários escolham diferentes gráficos.
Formatação	Layout	Selecione o número de colunas ocupadas pelo controle. Quando a seção que contém subgrades tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
	Layout de Linhas	Número de Linhas irá determinar quantos registros são exibidos em uma página de uma subgrade. Se Expandir automaticamente para usar o espaço disponível for escolhido, o formulário permitirá espaço para dois registros e expandirá o espaço conforme o número de registros aumenta. Se o número excede o Número de Linhas, as pessoas podem navegar até as páginas adicionais para exibir registros. Se Expandir automaticamente para usar o espaço disponível não for escolhido, o formulário fornecerá espaço para o número de registros definido pelo Número de Linhas e as pessoas podem navegar até as páginas adicionais para qualquer registros adicional.

Nos formulários usando o Formulários clássicos, as ações executadas em uma subgrade estão disponíveis apenas na faixa de opções. Os desenvolvedores podem personalizar o comportamento dessas ações ou adicionar ações personalizando a faixa de opções.

Nos formulários usando as ações Formulários atualizados para subgrades são colocados próximo à subgrade, facilitando de acesso. Sempre que a barra de comandos não permitir a adição de ações personalizadas. Os desenvolvedores podem editar a faixa de opções para alterar as ações das três ações restantes: mostrar a lista, adicionar registro e excluir registro.

Mostrar o comportamento da lista

Ao exibir uma lista nos formulários com o Formulários atualizados, cada subgrade no botão Abrir Exibição no canto superior direito da entidade quando a entidade também for exibida como uma das entidades incluídas na área de navegação do editor de formulários. Selecionar este botão abrirá a exibição. O comportamento será alterado dependendo da opção escolhida para a propriedade Registros.

Ao selecionar Somente Registros Relacionados, a exibição será aberta usando uma das exibições associadas na mesma janela. Para voltar ao formulário, use o botão voltar ou selecione o valor do nome do registro principal atual na barra de navegação.

Ao selecionar Todos os Tipos de Registro, a exibição será aberta em uma nova janela.

Adicionar o comportamento do registro

Para exibir uma lista de formulários com o Formulários atualizados, cada subgrade exibe o botão Adicionar registro no lado superior direito da subgrade. Selecione esse botão permite adicionar um registro. Esse comportamento será alterado dependendo da opção escolhida para a propriedade Registros e se a pesquisa for para registros da atividade.

Ao seleciona Somente Registros Relacionados, o comportamento padrão é o comportamento para adicionar registros existentes. Os usuários veem uma pesquisa embutida para procurar por um registro existente primeiro. Isso ajuda a evitar a criação de registros duplicados. Se não pode localizar um registro existente, podem escolher a opção Novo. Quando um novo registro é criado, qualquer um dos mapeamentos de campos definidos no relacionamento será aplicado.Para obter mais informações:Mapeando campos de entidades

Ao selecionar Todos os Tipos de Registro, o comportamento padrão é adicionar um novo registro. O formulário de criação rápida será exibido se a entidade de destino tiver um. Caso contrário, o formulário principal da entidade padrão será mostrado.

Se a subgrade exibir atividades, os usuários precisarão primeiro selecionar o tipo de atividade e verão o comportamento “adicionar novo registro” comportamento.

Excluir o comportamento do registro

Ao você seleciona um registro em uma subgrade, o botão Excluir aparece no lado direito da linha. O comportamento da ação de exclusão é diferente dependendo do tipo de relacionamento com a entidade atual.

Quando a subgrade usa um relacionamento 1:N (um-para-muitos), o comportamento de exclusão de um registro normal é exibir uma caixa de diálogo de confirmação antes de excluir o registro.

Quando a subgrade usa um relacionamento N:N (muitos-para-muitos), o registro na entidade de relacionamento (ou interseção) relacionado aos dois registros é excluído sem uma confirmação e o registro não será mais exibido na subgrade. Mas o registro exibido não será excluído.

Propriedades de controle de exibição rápida

Um controle de exibição rápida mostra dados de um registro selecionado em uma pesquisa no formulário. Os dados exibidos no controle são definidos usando um formulário de exibição rápida. Os dados exibidos não são editáveis, mas quando o campo primário for incluído no formulário de exibição rápida, se tornará um link para abrir o registro relacionado.Para obter mais informações:Criar e editar formulários de exibição rápida

Propriedade	Descrição
Nome	Necessário: O nome exclusivo para o formulário de exibição rápida usado ao fazer referências em scripts.
Etiqueta	Necessário: Uma etiqueta para exibir o formulário de exibição rápida.
Exibir etiqueta no formulário	Exibe a etiqueta no formulário.
Campo de Consulta	Escolha um dos campos de pesquisa incluídos no formulário.
Entidade relacionada	Esse valor depende do Campo de Consulta selecionado. Geralmente é a entidade principal do relacionamento de entidade 1:N para a pesquisa. Se a entidade contém uma pesquisa de Possível Cliente que pode aceitar uma conta ou um contato, no campo Formulário de Exibição Rápida, é possível escolher um formulário de exibição rápida para a conta e o contato alterando esse valor e escolhendo outro formulário de exibição rápida.
Formulário de Visualização Rápida	Se a Entidade relacionada possui formulários de exibição rápida, é possível selecioná-los. Caso contrário, selecione Novo para criar um. Selecione Editar para alterar o formulário da exibição rápida selecionado.

Propriedades do recurso da Web

Você pode adicionar ou editar recursos da Web em um formulário para torná-lo mais atraente ou útil para os usuários. Recursos da Web habilitados para formulário são imagens, arquivos HTML ou controles do Silverlight.

Para obter instruções detalhadas, consulte Adicionar ou editar um recurso da Web do formulário.

Guia	Propriedade	Descrição
Geral	recurso da web	Necessário: A imagem, HTML ou recurso da Web Silverlight desejo.
	Nome	Necessário: um nome exclusivo para o campo. O nome pode conter somente caracteres alfanuméricos e sublinhados.
	Etiqueta	Necessário: Uma etiqueta para exibir o recurso da Web.
	Visível por padrão	Mostrar o recurso da Web é opcional e pode ser controlado usando scripts.Para obter mais informações:Opções de visibilidade
	Parâmetro Personalizado	Um valor padrão para transmitir como o parâmetro de cadeia de caracteres de consulta do data.Para obter mais informações:Transmitir parâmetros para os recursos da Web
	Texto Alternativo	Quando um recurso da Web de imagem for exibido, esse valor fornecerá o texto da dica de ferramentas para as pessoas que usam leitores de tela.
	Restringir scripts de cross-frame, quando suportado.	Quando as páginas existirem em domínios diferentes, você pode evitar o acesso ao conteúdo de suas páginas de formulário. Os recursos da Web sempre estão no mesmo domínio, portanto, não deve ser um problema com recursos da Web.
	Transmitir código do tipo de objeto do registro e identificadores exclusivos como parâmetros	Os dados da organização, o usuário e o registro podem ser transmitidos para o recurso da Web para que possa se adaptar às configurações da organização.Para obter mais informações:Transmitir parâmetros para os recursos da Web
Formatação	Selecione o número de colunas ocupadas pelo controle	Quando a seção que contém o recurso da Web tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
	Selecione o número de linhas ocupadas pelo controle	Você pode controlar a altura de um recurso da Web especificando um número de linhas.
	Expandir automaticamente para usar o espaço disponível	Você pode permitir que a altura de recurso da Web expanda para o espaço disponível.
	Selecionar o tipo de rolagem do IFRAME	Um recurso da Web HTML é adicionado ao formulário usando um IFRAME. Conforme Necessário: Mostra a barra de rolagem quando o tamanho do recurso da Web for maior do que disponível. Sempre: Sempre mostra barras de rolagem. Nunca: Nunca mostra barras de rolagem.
	Exibir borda	Exibe uma borda ao redor do recurso da Web.
Dependências	Campos dependentes	Um recurso da Web pode interagir com os campos no formulário usando o script. Se um campo for removido do formulário, o script no recurso da Web pode romper. Adicione qualquer campo referenciado pelos scripts no recurso da Web para os Campos dependentes de forma que eles não possam ser removidos acidentalmente.

Transmitir parâmetros para os recursos da Web

Um recurso da Web Silverlight ou HTML pode aceitar que os parâmetros sejam transmitidos como parâmetros da cadeia de caracteres de consulta.

Informações sobre o registro podem transmitidas habilitando a opção Transmitir código de tipo do objeto de registro e identificadores exclusivos como parâmetros. Se as informações forem digitadas no campo Parâmetro Personalizado (dados), serão transmitidas usando o parâmetro de dados. Os valores transmitidos são:

Parâmetro	Descrição
data	Esse parâmetro é transmitido apenas quando o texto for fornecido para Parâmetro Personalizado (dados).
orglcid	O idioma padrão da organização LCID.
orgname	O nome da organização.
userlcid	O LCID do idioma preferido do usuário
type	O código do tipo de entidade. Esse valor pode ser diferente para entidades personalizadas em diferentes organizações. Use o nome do tipo de entidade.
typename	O nome do tipo de entidade.
id	O valor do ID do registro. Este parâmetro não possui nenhum valor até que o registro da entidade seja salvo.

Qualquer outro parâmetro não é permitido e o recurso da Web não será aberto se outros parâmetros forem usados. Se precisar transmitir vários valores, o parâmetro de dados pode ser sobrecarregado para incluir mais parâmetros. Consulte o SDK Exemplo: Transmitir vários valores para um recurso da Web com o parâmetro de dados

Propriedades do IFRAME

Você pode adicionar IFRAMEs a um formulário para integrar o conteúdo de outro site em um formulário.

Observação

Os formulários do Microsoft Dynamics 365 não foram criados para serem exibidos nos IFRAMEs.

Observação

Os formulários do Microsoft Dynamics 365 não foram criados para serem exibidos nos IFRAMEs.

Guia	Propriedade	Descrição
Geral	Nome	Necessário: Um nome exclusivo para o IFRAME. O nome pode conter somente caracteres alfanuméricos e sublinhados.
	URL	Necessário: A URL da página para exibir no IFRAME.
	Transmitir código do tipo de objeto do registro e identificadores exclusivos como parâmetros	Os dados da organização, do usuário e do registro podem ser transmitidos para o IFRAME.Para obter mais informações:Transmitir parâmetros para IFRAMES
	Etiqueta	Necessário: Uma etiqueta para exibir o IFRAME.
	Exibir etiqueta no formulário	Se a etiqueta deve ser exibida.
	Restringir o uso de scripts cross-frame, quando suportado	Considera-se um risco de segurança permitir que as páginas de um site diferente interajam com o aplicativo do Microsoft Dynamics CRM usando scripts. Use esta opção para restringir o script cross-frame para páginas sobre as quais você não tem controle. Para obter mais informações:Selecionar a restrição de scripts cross-frame
	Visível por padrão	Mostrar o IFRAME é opcional e pode ser controlado usando scripts.Para obter mais informações:Opções de visibilidade
Formatação	Selecione o número de colunas ocupadas pelo controle	Quando a seção que contém IFRAME tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
	Selecione o número de linhas ocupadas pelo controle	Você pode controlar a altura de um IFRAME especificando um número de linhas que o controle ocupa.
	Expandir automaticamente para usar o espaço disponível	Em vez de definir a altura com um número de linhas, será possível permitir que a altura do IFRAME expanda para o espaço disponível.
	Selecionar o tipo de rolagem do IFRAME	Você tem três opções: Conforme Necessário: Mostra a barra de rolagem quando o tamanho do IFRAME for maior do que o espaço disponível. Sempre: Sempre mostra barras de rolagem. Nunca: Nunca mostra barras de rolagem.
	Exibir borda	Exibe uma borda ao redor do IFRAME.
Dependências	Campos dependentes	Um IFRAME pode interagir com os campos no formulário usando o script. Se um campo for removido do formulário, o script no IFRAME pode romper. Adicione qualquer campo referenciado pelos scripts nos IFRAMES para os Campos dependentes de forma que eles não possam ser removidos acidentalmente.

Transmitir parâmetros para IFRAMES

Informações sobre o registro podem transmitidas habilitando a opção Transmitir código de tipo do objeto de registro e identificadores exclusivos como parâmetros. Os valores transmitidos são:

Parâmetro	Descrição
orglcid	O idioma padrão da organização LCID.
orgname	O nome da organização.
userlcid	O LCID do idioma preferido do usuário
type	O código do tipo de entidade. Esse valor pode ser diferente para entidades personalizadas em diferentes organizações. Use o typename em vez disso.
typename	O nome do tipo de entidade.
id	O valor do ID do registro. Este parâmetro não possui nenhum valor até que o registro da entidade seja salvo.

Controle de anotações

Nos formulários de determinadas entidades do sistema usando o Formulários atualizados, o controle de anotações oferece a capacidade de acessar as informações sobre POSTAGENS, ATIVIDADES e ANOTAÇÕES. Para as entidades personalizadas com anotações e atividades habilitadas, você verá apenas ANOTAÇÕES e ATIVIDADES. Para incluir POSTAGENS, você deve habilitá-los para a entidade personalizada.

Habilitar postagens para uma entidade personalizada

1. Vá para Configurações > Configurações de Postagem.

2. Localizar o registro da entidade personalizada.

3. Certifique-se de que Habilitar murais para esse tipo de formulário de registro esteja selecionado e salve o registro.

4. Na barra de comandos, selecione ATIVAR.

5. Se você precisar habilitar murais, é necessário publicar a entidade.

Por padrão, para entidades do sistema, o controle de anotações está posicionado em uma seção do painel social no centro da guia de três colunas na parte superior do formulário. Pode aparecer apenas em um formulário por vez. Você pode mover ou remover o controle de anotações. Para adicioná-lo de volta, use o botão Anotações no grupo Controle da guia Inserir.

A tabela a seguir descreve as propriedades do controle de anotações.

Guia	Propriedade	Descrição
Exibição	Etiqueta	Necessário: Embora a etiqueta não seja exibida por padrão, uma etiqueta é necessária.
	Exibir etiqueta no formulário	Você também pode escolher não exibir a etiqueta.
	Bloquear o campo no formulário	Isso impedirá que as anotações sejam removidas do formulário acidentalmente.
	Guia Padrão	Selecione a guia que deverá ser exibida por padrão. As opções são: Atividades Postagens Observações
Formatação	Selecione o número de colunas ocupadas pelo controle	Quando a seção que contém o controle de anotações tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
	Número de Linhas	Controle a altura do controle de anotações selecionando o número de linhas que o controle ocupa.
	Expandir automaticamente para usar o espaço disponível	Em vez de definir a altura com um número de linhas, será possível permitir que a altura do controle de anotações expanda para o espaço disponível.

Configurar o Bing maps

O Bing Maps pode ser exibido nos formulários da conta, contato, cliente potencial, cotação, pedido, fatura, concorrente e usuário do sistema. Você pode remover a área do Bing Maps no editor de formulários ou adicionar usando o botão Bing Maps na guia Inserir do editor de formulários.

Para habilitar o Bing Maps, a definição de sistema Mostrar Bing Maps nos formulários deve ser habilitado.Microsoft Dynamics 365as organizações locais precisarão fornecer uma Chave do Bing Maps e inseri-las na configuração sistema Insira a chave do Bing Maps. Obtenha uma chave do Bing Map: https://www.bingmapsportal.com/Microsoft Dynamics CRM Online assinantes não precisam de uma chave.

Guia	Propriedade	Descrição
Geral	Etiqueta	Necessário: Uma etiqueta para exibir o Bing Maps.
	Exibir rótulo no formulário	Se a etiqueta deve ser exibida.
	Escolha um endereço para uso com o controle do Bing Maps.	Escolha se o endereço deve ser usado para fornecer dados para o mapa.
	Visível por padrão	Mostrar o Bing Maps é opcional e pode ser controlado usando scripts.Para obter mais informações:Opções de visibilidade
Formatação	Selecione o número de colunas ocupadas pelo controle	Quando a seção que contém Bing Maps tiver mais de uma coluna, é possível definir o campo para ocupar o número de colunas da seção.
	Selecione o número de linhas ocupadas pelo controle	Você pode controlar a altura de um Bing Maps especificando um número de linhas.
	Expandir automaticamente para usar o espaço disponível	Você pode permitir que a altura do Bing Maps expanda para o espaço disponível.

Editar Navegação

A navegação no formulário permite que os usuários vejam listas de registros relacionados. Cada relacionamento de entidades tem as propriedades para controlar se deve ser exibido.Para obter mais informações:Item do painel de navegação para entidade principal

Todos os relacionamentos de entidades configurados para serem exibidos podem ser substituídos no editor de formulários. Você também pode incluir links de navegação para exibir recursos da Web ou outros sites na navegação do formulário.

Para obter instruções detalhadas, consulte Adicionar ou editar navegação do formulário para entidades relacionadas.

Para habilitar a navegação da edição, você deve selecionar primeiro o comando Navegação no grupo Selecionar da guia Início.

Em Gerenciador de Relacionamentos, você pode filtrar por relacionamentos 1:N (um-para-muitos) ou N:N (muitos para muitos) ou exibir todos os relacionamentos disponíveis. A caixa de seleção Apenas relacionamentos não utilizados estará desabilitada e selecionada. Portanto, é possível apenas adicionar um relacionamento por vez.

Para adicionar um relacionamento do Gerenciador de Relacionamentos, basta clicar duas vezes nele e ele será adicionado abaixo do relacionamento selecionado atualmente na área de navegação. Clique duas vezes em um relacionamento na área de navegação e você pode alterar a etiqueta na guia Exibir. Na guia Nome, você pode ver as informações sobre o relacionamento. Use o botão Editar para abrir a definição da entidade.

Há cinco grupos na área de navegação. Você pode arrastá-los para reposicionar e clicar duas vezes para alterar a etiqueta, mas não pode removê-los. Esses grupos serão exibidos somente quando há algo neles. Caso você não deseje que um grupo seja exibido, basta não adicionar nada.

Use o botão Link de Navegação no grupo Controle da guia Inserir para adicionar um link para um recurso da Web ou uma URL externa.

Propriedades do link de navegação

Os links de navegação têm as seguintes propriedades:

Propriedade	Descrição
Nome	Necessário: Texto a ser exibido como uma etiqueta.
Ícone	Use o recurso da Web de 32x32 pixels. O uso de uma imagem PNG com um plano de fundo transparente é recomendável.
Recurso da Web	Especifique um recurso da Web para exibir no painel principal do formulário.
URL externa	Especifique uma URL de uma página para exibir no painel principal do formulário.

Controle do timer

Use o controle de timer nos formulários em que os registros precisam atender a uma etapa baseada em tempo específica. Um controle de timer mostra para as pessoas quanto tempo está disponível para concluir uma ação na resolução de um registro ativo ou quanto tempo foi transcorrido desde a hora de conclusão da ação. No mínimo, os controles de timer devem ser configurados para mostrar sucesso ou falha ao concluir a ação. Além disso, eles podem ser configurados para exibir avisos quando as condições estão se aproximando de uma falha.

Um controle de timer pode ser adicionado a um formulário para qualquer entidade, mas são usados com mais frequência para a entidade de ocorrência, especialmente quando vinculados aos campos que rastreiam contratos de nível de serviço. Você pode adicionar vários controles de timer no corpo do formulário. Não é possível adicioná-los ao cabeçalho ou rodapé.

As propriedades Fonte de Dados do controle de timer utilizam os campos da entidade.

• O Campo de Tempo de Falha usa um campo de data-hora para definir a hora.

• Os três campos de condição usam um dos campos Conjunto de Opções, Duas Opções, Status ou Razão do Status para a entidade.

Propriedades de controle do timer

A tabela a seguir descreve as propriedades do controle de timer.

Grupo	Nome	Descrição
Nome	Nome	Necessário. Um nome exclusivo para o controle.
	Etiqueta	Necessário. O rótulo para exibir o controle de timer.
Fonte de Dados	Campo do Tempo de Falha	Necessário. Escolher um dos campos de data-hora para a entidade representar quando uma etapa deverá ser concluída com êxito.
	Condição de Êxito	Necessário. Selecione um campo da entidade para avaliar o êxito da etapa, e selecione qual opção indica o êxito.
	Condição de Aviso	Selecione um campo da entidade para avaliar se o sucesso da etapa está em risco para que o aviso deva ser exibido e selecione qual opção indica que um aviso deverá ser exibido.
	Cancelar Condição	Selecione um campo para a entidade avaliar se a realização da etapa deve ser cancelada e selecione qual opção indica que a etapa foi cancelada.

Configurar manipuladores de eventos

Manipuladores de eventos de formulário podem ser configurados nas seguintes áreas em um formulário:

Elemento	Evento	Descrição
Formulário	OnLoad	Ocorre quando o formulário é carregado.
	OnSave	Ocorre quando os dados são salvos.
Guia	TabStateChange	Ocorre quando a guia é expandida ou recolhida.
Campo	OnChange	Ocorre quando os dados no campo são modificados e o controle perde o foco.
IFRAME	OnReadyStateComplete	Ocorre quando o conteúdo de um IFRAME é carregado.

Um manipulador de eventos consiste de uma referência a um recurso da Web JavaScript e uma função definida dentro desse recurso da Web executará quando o evento ocorrer. Cada elemento pode ter até 50 manipuladores de eventos separados configurados.

Importante

Configurar um manipulador de eventos incorretamente pode causar erros de script que podem fazer com que o formulário falhe ao carregar ou funcionar corretamente. Se você não for o desenvolvedor do script, certifique-se de que entenda exatamente as opções de configuração que o script exige.

Não configure um manipulador de evento do script usando uma biblioteca que não seja fornecida de uma origem confiável. Os scripts podem ser usados para executar qualquer ação que um usuário pode realizar e um script mal escrito pode danificar significativamente o desempenho de um formulário.

Após configurar um manipulador de eventos, sempre teste-o para verificar está funcionando corretamente.

Para configurar um manipulador de eventos

No editor de formulários, selecione o elemento com o evento para o qual você deseja configurar um manipulador.

Na Guia Inicial, no grupo Editar , selecione Alterar Propriedades ou clique duas vezes no elemento.

Na caixa de diálogo de propriedades do elemento, selecione a guia Eventos.

Expanda a área Bibliotecas de Formulários. Se a biblioteca contendo a função que você deseja definir como o manipulador de eventos ainda não estiver listada, adicione a biblioteca.

Para adicionar uma biblioteca de formulários a um manipulador de eventos

Na seção Bibliotecas de Formulários da Lista de Eventos, selecione Adicionar.

Localize o recurso da Web JavaScript na lista de recursos da Web disponíveis. Selecione-o e selecione Adicionar.

Se o recurso da Web JavaScript que você precisa não existir, selecione Novo para abrir um novo formulário do recurso da Web e crie um.

Para criar um recurso da Web Javascript

1. No formulário do recurso da Web, defina as seguintes propriedades:

   Propriedade	Valor
   Nome	Necessário. Digite o nome do recurso da Web.
   Nome para exibição	Necessário. Digite o nome para exibição na lista de recursos da Web.
   Descrição	Opcional. Digite uma descrição do recurso da Web.
   Tipo	Necessário. Selecione Script (JScript).
   Idioma	Opcional. Escolha um dos idiomas disponíveis para a sua organização.

2. Se você foi fornecido com um script, é altamente recomendável usar o botão Procurar para localizar o arquivo e carregá-lo.

   Em alternativa, é possível selecionar o botão Editor de Texto e inserir ou digitar o conteúdo do script na caixa de diálogo Editar Conteúdo.

   Observação

   Como esse editor de texto simples não oferece recursos para verificar a exatidão do script, deve sempre deve tentar usar um aplicativo separado como o Microsoft Visual Studio para editar scripts e carregá-los.

3. Selecione Salvar e feche a caixa de diálogo do recurso da Web.

4. O recurso da Web criado está selecionado na caixa de diálogo Registro de Pesquisa. Selecione Adicionar para fechar a caixa de diálogo.

Na seção Manipuladores de Eventos, selecione o evento para o qual você deseja definir um manipulador de eventos.

Selecione Adicionar para abrir a caixa de diálogo Propriedades do Manipulador.

Na guia Detalhes, escolha a biblioteca apropriada e digite o nome da função que deve ser executada para o evento.

Por padrão, o manipulador de eventos está habilitado. Desmarque a caixa de seleção Habilitado se você não deseja habilitar esse evento.

Algumas funções exigem que um contexto de execução seja transferido para função. Selecione Transmitir o contexto de execução como o primeiro parâmetro, se for necessário.

Algumas funções podem aceitar um conjunto de parâmetros para controlar o comportamento de uma função. Se forem necessários, insira-os em Lista separada por vírgulas de parâmetros que serão transmitidos para a função.

Na guia Dependências, adicione todos os campos que o script depende na área Campos Dependentes.

Selecione OK para fechar a caixa de diálogo Propriedades do manipulador.

Quando o manipulador de eventos for inserido, pode ser necessário ajustar a odem na qual a função será executada em relação às outras funções usando as setas verdes para mover para cima ou para baixo.

Selecione OK para fechar a caixa de diálogo de propriedades do elemento.

Selecione Salvar para salvar as alterações. Selecione Publicar para publicar o formulário.

Observação

Embora a interface do usuário permita ajustar a ordem em que os scripts são carregados usando as setas verdes para cima e para baixo, na verdade os scripts não são carregados sequencialmente.Para obter mais informações:MSDN: Gerenciar dependências da biblioteca

Confira Também

Criar e desenvolver formulários
Considerações de criação para formulários principais
Criar e editar formulários móveis para o CRM para os telefones express
Criar e editar formulários de criação rápida
Criar e editar formulários de exibição rápida
Personalizar o CRM para telefones e tablets

© 2016 Microsoft Corporation. Todos os direitos reservados. Direitos autorais