Compartilhar via


Personalizar formulários de entidade

 

Publicado: janeiro de 2017

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

Os formulários oferecem a interface do usuário (UI) que as pessoas usam para criar, visualizar ou editar registros de entidade. Use o designer do formulário nas ferramentas de personalização para criar e editar formulários de entidade.Para obter mais informações:TechNet: Criar e projetar formulários para obter informações sobre as tarefas relacionadas ao trabalho com formulários no aplicativo.

Este tópico fornecerá as informações necessárias para criar ou editar formulários de forma programática.

Neste tópico

Acessar definições do formulário

Propriedades do formulário

Criar e editar formulários

Acessar definições do formulário

Os formulários de entidade são armazenados na entidade SystemForm junto com painéis e visualizações. Há duas maneiras que você pode inspecionar as definições do formulário de uma entidade:

  • Incluir a entidade em uma solução não gerenciada e exportar a solução.

  • Consultar a entidade SystemForm

Visualizar o FormXML a partir de uma entidade exportada

Somente as definições dos formulários de entidade do sistema que foram personalizados são incluídas na solução gerenciada exportada. Para visualizar a definição de um formulário de entidade do sistema, você deve alterá-la de alguma forma, ou criar um novo formulário salvando o formulário existente com um novo nome.

Depois de exportar a solução, extraia o conteúdo e visualize o arquivo customizations.xml. Você encontrará a definição dos formulários em ImportExportXml > em Entities > em Entity > FormXml. No nó <FormXml> (FormXml), você encontrará cada tipo de formulário que é agrupado em um elemento <forms> (FormXml) com o atributo type que especifica o tipo de formulário.

Propriedades do formulário

A tabela a seguir descreve os atributos principais da entidade SystemForm e os dados correspondentes incluídos nos elementos XML com a solução.

Propriedade do SystemForm

Elemento do FormXML

Descrição

AncestorFormId

<Ancestor> (FormXml)

Identificador exclusivo do formulário primário. Isso é definido quando você cria um novo formulário criando um formulário usando Salvar como para um formulário existente ou usando CopySystemFormRequest.

CanBeDeleted

<CanBeDeleted> (FormXml)

Informações que especifica se esse componente também pode ser excluído. Esta propriedade gerenciada é aplicada somente quando o formulário é criada pela importação de uma solução gerenciada.

Description

<Descriptions> (FormXml)

Description é uma cadeia de caracteres e <Descriptions> (FormXml) contém todas as tabelas localizadas para a descrição do formulário.

As tabelas localizadas podem ser recuperadas usando o RetrieveLocLabelsRequest.

FormActivationState

<FormActivationState> (FormXml)

Especifica o estado do formulário.

Somente os formulários do tipo “principal” podem ser desativados.

Valores válidos:

  • 0: Inativo

  • 1 : Ativo

FormId

<formid> (FormXml)

Identificador exclusivo do formulário

FormPresentation

<FormPresentation> (FormXml)

Especifica se este formulário está no layout atualizado da UI no Microsoft Dynamics 365 (online e local).

FormXml

<form> (FormXml)

XMLRepresentação do layout do formulário.

Para obter detalhes sobre a estrutura do formulário, consulte <form> (FormXml).

IntroducedVersion

<IntroducedVersion> (FormXml)

Versão da solução em que o formulário foi adicionado.

IsAIRMerged

N/D

Especifica se este formulário está mesclado com o layout atualizado da UI no Microsoft Dynamics 365 (online e local).

IsCustomizable

<IsCustomizable> (FormXml)

Informação que especifica se este componente pode ser personalizado.

Esta propriedade gerenciada é aplicada somente se o formulário tiver sido criado pela importação de uma solução gerenciada.

IsDefault

N/D

Informações que especificam se o formulário ou painel é o padrão do sistema.

Name

<LocalizedNames> (FormXml)

Name é uma cadeia de caracteres e <Descriptions> (FormXml) contém todas as tabelas localizadas para o nome do formulário.

As tabelas localizadas podem ser recuperadas usando o RetrieveLocLabelsRequest.

ObjectTypeCode

O formulário é um descendente do elemento Entity.

o valor ObjectTypeCode é o nome lógico da entidade.

Type

Elemento<forms> (FormXml) atributo type

Os valores válidos dos formulários são:

  • 2: main

  • 5: mobile

  • 6: quick

  • 7: quickCreate

Criar e editar formulários

Você só poderá criar novos formulários para uma entidade onde o EntityMetadata.CanCreateForms permitir.

Você pode criar novos formulários usando um CreateRequest ou o CopySystemFormRequest. Ao usar CopySystemFormRequest ou ao usar Salvar como no editor de formulários, observe se não há herança entre os formulários. Portanto, as alterações feitas no formulário base não são aplicadas automaticamente aos formulários criados a partir dele.

Editar as definições do formulário a partir de uma solução gerenciada exportada e depois reimportar a solução é um método com suporte para editar os formulários da entidade. Ao editar manualmente os formulários é extremamente recomendado que você use um editor XML que permita a validação do esquema.Para obter mais informações:Editar o arquivo de personalizações XML com a validação de esquema

Confira Também

Personalizar o aplicativo Microsoft Dynamics 365
TechNet: Criar e projetar formulários
Mensagens e métodos de entidade de SystemForm (painel do sistema)
Criar ou editar como as regras de negócios são iniciadas
Form XML reference
Form XML schema

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais