Usar o formulário Principal - Experiência interativa e seus componentes

 

Publicado: fevereiro de 2017

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

Os formulários interativos com uma nova experiência do usuário que salva alguns clique de usuários e os ajuda a manter contexto enquanto trabalham em registros relacionados. É possível ver os formulários interativos listados na lista de outros formulários no gerenciador de soluções na área de Personalização. O tipo de formulário de formulários interativos é Principal - Experiência interativa.

Este tópico explica como editar um formulário Principal - Experiência interativa e como adicionar ou alterar vários elementos do formulário.

Neste tópico

Abrir o editor de formulários

Publicar as alterações para uso no hub de serviços interativos

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

Editar Navegação

Configurar manipuladores de eventos

Abrir o editor de formulários

Para editar um formulário ou adicionar ou alterar elementos, use o editor de formulários.

Se você criar qualquer novo componente de solução no processo de edição do formulário, 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, abra o editor de formulários através dessa solução não gerenciada.

Acesse o editor de formulários pela solução padrão

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

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

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

4. Na lista de formulários, abra o formulário do tipo Principal - Experiência interativa.

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

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

2. Clique em 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, clique em 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 clique em OK.

   3. Se a caixa de diálogo Componentes Necessários Ausentes aparecer, você pode clicar em 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, abra o formulário do tipo Principal - Experiência interativa.

Publicar as alterações para uso no hub de serviços interativos

Determinadas personalizações que fazem alterações na interface do usuário exigem que sejam publicadas antes que as pessoas possam usá-las no aplicativo. Para publicar sua personalização, no gerenciador de soluções, clique em Publicar Todas as Personalizações.

Com o Atualização 0.1 do Microsoft Dynamics CRM 2016 ou posterior, você pode aperfeiçoar o desempenho do primeiro usuário clicando no botão Preparar Personalizações do Cliente depois de publicar suas personalizações. Isso solicita que o Dynamics 365 prepare o pacote de metadados imediatamente, em vez de aguardar que o primeiro usuário inicie o hub de serviços interativos.Para obter mais informações:Conceitos de personalização

Importante

A preparação das personalizações do cliente pode demorar algum tempo. Se você vir uma mensagem informando que a página do navegador está sem resposta, espere até que a página responda e não a encerre.

Interface do usuário do editor de formulários

O editor de formulários exibe comandos em duas guias: Início e Inserir.Para obter mais informações:Guia Inicial, Guia Inserir

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

• Navegação
  Localizada no lado esquerdo, use a área de navegação para controlar o acesso às entidades relacionadas ou adicionar links para 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 interativos fornecem opções de navegação na barra de navegação, mas usam os mesmos dados na área de navegação para controlar quais opções de navegação estão disponíveis.Para obter mais informações:Editar Navegação

• 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.

  • Por padrão, os formulários interativos de Ocorrência, Contato e Conta, a primeira seção na guia Resumo exibe o formulário de cartão de conta ou contato do tipo Visualização Rápida. Para entidades personalizadas que são habilitadas para a experiência interativa, esta seção não está disponível por padrão. Você pode inserir uma nova seção e um formulário de exibição rápida nele. O formulário de cartão exibe um máximo de cinco campos. Diferente dos campos, não é possível exibir outros controles no bloco Azul mesmo se o formulário de visualização rápida o contiver.

    Dica

    Para preservar o formato do cartão (conforme mostrado na imagem), recomendamos não transferir o formulário da exibição rápida a qualquer outra seção no formulário.

    

    Para obter mais informações:Criar e editar formulários de visualização rápida

  • 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. Os campos no cabeçalho e rodapé são mostrados no cartão do cliente (bloco Azul) em tempo de execução.

• Explorer
  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 listados 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
	Remover	Remove o item selecionado.
	Desfazer (Ctrl+Z)	Desfaz 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	Edite 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. Dica Para os formulários interativos, somente os formulários do escopo "Entidade" e "Todos formulários" são suportados. 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
	Habilitar Direitos de Acesso	Use essa opção para definir os direitos de acesso 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 os direitos de acesso 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

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 incluir uma seção com uma das quatro colunas. Você também pode inserir um painel de Referência nos formulários interativos. O painel de referência também é adicionado como uma seção ao formulário Principal - Experiência interativa. Por padrão a seção do painel de Referência é adicionada à Ocorrência, Conta, Contato e formulários de entidade personalizados. Para obter mais informações:Propriedades da seção
3 Guia	Três Colunas	Inserir 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	Insira um recurso da Web para inserir conteúdo de outros locais em uma página. Para obter mais informações:Propriedades de controle de exibição rápida
	Mural de Interação	Insira um controle de parede de interação (linha do tempo) no formulário. Este controle mostra a linha do tempo de atividades relacionadas à entidade em um formulário. Para obter mais informações:Mural de Interação
	Pesquisa da Base de Dados de Conhecimento	Inserir um controle de pesquisa que os usuários podem usar para pesquisar artigos de conhecimento.Para obter mais informações:Adicionar o controle de Pesquisa da Base de Dados de Conhecimento a formulários do Microsoft Dynamics 365

Dica

Os seguintes componentes não são suportados em formulários interativos:

• Bing Mapas

• Yammer

• Feeds de Atividades

Propriedades do formulário

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

Tabulação	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.
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 aceitam 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. 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 365.
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 e campos 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.

Dica

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.

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 das guia do formulário oferece uma maneira de organizar campos. Cada guia que você cria aparece horizontalmente no topo de um formulário de entidade no hub de serviço interativo. Em tempo de execução, guias adicionais abrem como um submenu.

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.
	Visibilidade	Especifique se a guia deve estar visível por padrão em tempo de execução.
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.

Propriedades da seção

Uma seção ocupa o espaço disponível em uma coluna da guia. As seções têm uma etiqueta que pode ser exibida.

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

Um novo tipo de seção chamada "painel de referência" também pode ser adicionado. Um painel de referência é uma seção de coluna única. Você pode inserir grades secundárias, controle de exibição rápida, ou um controle de Pesquisa de Base de Dados de Conhecimento em uma seção de um painel de referência. Cada controle que você adiciona no painel de referência aparece como uma guia vertical dentro do painel de referência no tempo de execução. Você pode arrastar e soltar vários controles na seção do painel de referência. A guia padrão em tempo de execução é o primeiro controle adicionado no painel de referência. Outras guias aparecem na ordem na qual foram adicionadas no editor de formulários. Para excluir uma guia, use a tecla Delete no teclado.

Quando você insere um painel de referência por padrão, ele é adicionado à última seção na guia. Só é possível adicionar uma referência por um painel do formulário.

Importante

Por padrão a seção do painel de referência é bloqueada nos formulários fora de contexto: Ocorrência, Conta e Contato. Para removê-lo ou alterá-lo, você deve desbloqueá-lo.

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.

Tabulação	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.
	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	Altura do Layout	Defina a altura do layout em termos de número de linhas.

Mural de Interação

O mural de interação (ou a linha do tempo) mostra atividades relacionadas a uma entidade específica.

Os seguintes tipos de atividades têm suporte: Tarefa, Compromisso, Telefonema, e-mail, atividade social, atividade personalizada.

O mural de interação também mostra as anotações do sistema. Mostra as atividades que tem o campo Referente a definido para a entidade que você está exibindo. Para anotações, o campo Referente a não será exibido ao usuário; É criado implícito ao mural de interação.

Cada atividade que é mostrada no mural de interação terá as mesmas ações rápidas que estão disponíveis na barra de comandos de atividade.

Dica

Não é possível criar uma nova atividade personalizada usando a ação no mural de interação.

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 impede que o campo seja removido do formulário acidentalmente. Isso também impede que 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 o 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. Clique no botão 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

Duas seções na guia Exibir são relevantes para campos de pesquisa.

Dica

As opções descritas na tabela a seguir estão disponíveis somente para campos de pesquisa de entidade única.

Seção	Propriedade	Descrição
Filtragem de Registros Relacionados	Mostrar recursos apenas onde	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. Por padrão, isso está desativado. As combinações de relacionamento possíveis quando você filtra registros relacionados são listadas na seguinte tabela. Relacionamento da primeira lista Relacionamento da segunda lista Disponível? N:1 1:N Sim N:1 N:1 Sim N:1 N:N Sim 1:N 1:N Sim 1:N N:1 Não 1:N N:N Não N:N 1:N Sim N:N N:1 Não N:N N:N Não A primeira lista é preenchida com todos os relacionamentos potenciais que você pode usar para filtrar essa pesquisa. Clique em uma opção. A segunda lista é preenchida com todos os relacionamentos que conectam a entidade relacionada (selecionada na primeira lista) à entidade de destino. Clique em uma opção. Marque a caixa de seleção Permitir que os usuários desativem o filtro para dar aos usuários a opção de desativar o filtro definido aqui. Quando os usuários clicam na opção Pesquisar Mais Registros ao definir o valor da pesquisa, consulte a caixa de diálogo. Se você selecionou a opção Permitir que os usuários desativem o filtro ao configurar o campo de pesquisa usuários, verá a caixa de seleção para desativar o filtro. Isso permite que eles exibam uma ampla gama de registros. Para ter certeza de que os usuários visualizarão apenas a gama limitada de registros definidos por esse filtro, desmarque essa caixa de seleção Permitir que os usuários desativem o filtro.
Propriedades Adicionais	Exibir a Caixa de Pesquisa no diálogo de consulta	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 clicarem na 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 e-mail 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. Essa propriedade está disponível na guia Formatação.

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.

Tabulação	Propriedade	Descrição
Exibição	Ícone de Guia	Clique no ícone que será usado na guia. Os ícones são adicionados como recursos Web em Microsoft Dynamics 365. Essa opção só estará disponível quando você adicionar uma subgrade a um painel de referência.
	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	Clique dentre 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 clicar. A opção que você clica afeta 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	Clique na 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.
	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 cliquem em qualquer exibição. Mostrar Exibições Selecionadas: Use a tecla Ctrl com seu cursor para selecionar quais exibições disponíveis mostrar.
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.

Mostrar o comportamento da lista

Ao exibir uma lista nos formulários, 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. Clique neste botão para 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 clique no 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

Ao exibir uma lista em formulários, cada subgrade exibe o botão Adicionar registro no lado superior direito da subgrade. Clique neste botão para 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 clicar na opção Novo. Quando um novo registro é criado, qualquer um dos mapeamentos de campos definidos no relacionamento será aplicado.Para obter mais informações:Campos de entidades de mapa

Ao selecionar Todos os Tipos de Registro, o comportamento padrão é adicionar um novo registro. O formulário de criação rápida é 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 clicar no tipo de atividade e verão o comportamento “adicionar novo registro”.

Excluir o comportamento do registro

Quando 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. Os formulários de visualização rápida fora de contexto especialmente criados para o painel de referência também são usados para exibir registros de entidade relacionada.Para obter mais informações:Criar e editar formulários de visualização rápida

Propriedade	Descrição
Ícone de guia	Selecione um ícone a ser usado para as guias verticais. Você pode usar imagens como recursos Web. Essa opção só estará disponível quando você inserir um controle de visualização rápida para uma seção de Painel de Referência.
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 rótulo no Formulário	Exibe a etiqueta no formulário.
Campo de Consulta	Clique em um dos campos de pesquisa incluídos no formulário.
Entidade relacionada	Esse valor depende do Campo de Consulta clicado. 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 clicar em 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, clique em Novo para criar um. Clique em 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.

Dica

• Só é possível adicionar recursos da Web do tipo HTML em um formulário do tipo Principal - Experiência interativa. Os recursos da Web JavaScript podem ser adicionados usando o botão Propriedades de Formulário no grupo Formulário da guia Início.Para obter mais informações:Propriedades do formulário

• Não é possível incluir um recurso da Web no cabeçalho ou rodapé de um formulário.

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

Tab	Propriedade	Descrição
Geral	Recurso da Web	Necessário: o recurso da Web HTML que você deseja.
	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
	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 HTML pode aceitar que os parâmetros sejam passados como parâmetros da cadeia de caracteres da 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.

Dica

• Não é possível incluir um IFRAME no cabeçalho ou rodapé de um formulário.

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

Tab	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. Importante No Microsoft Dynamics 365 (online), use uma URL com protocolo HTTPS. No Microsoft Dynamics 365 local, se o domínio do Dynamics 365 for HTTPS, use uma URL com protocolo HTTPS. Se o domínio do Dynamics 365 for HTTP, use uma URL com protocolo HTTP.
	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 365 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.

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.

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 são exibidos somente quando há algo neles. Caso você não deseje que um grupo seja exibido, basta não adicionar nada.

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.

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.

Configure apenas um manipulador de evento do script usando uma biblioteca 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 , clique em 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, clique em Adicionar.

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

Se o recurso da Web JavaScript que você precisa não existir, clique em Novo para criar um novo formulário do recurso da Web.

Para criar um recurso da Web Javascript

1. No formulário do recurso da Web defina propriedades listadas na tabela a seguir.

   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. Clique em 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 clicar no botão Editor de Texto e inserir ou digitar o conteúdo do script na caixa de diálogo Editar Conteúdo.

   Dica

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

3. Clique em Salvar e feche a caixa de diálogo do recurso da Web. O recurso da Web criado está selecionado na caixa de diálogo Registro de Pesquisa.

4. Clique em 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.

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

Na guia Detalhes, clique na 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. Se for necessário, selecione Transmitir o contexto de execução como o primeiro parâmetro.

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.

Clique em OK para fechar a caixa de diálogo Propriedades do Manipulador.

Quando o manipulador de eventos for inserido, pode ser necessário ajustar a ordem 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.

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

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

Dica

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 projetar formulários interativos para o hub de serviço interativo
Criar e editar formulários de criação rápida
Criar e editar formulários de visualização rápida

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais