Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os formulários fornecem a interface do usuário que as pessoas usam para criar, exibir ou editar registros de entidade. Use o designer de formulários nas ferramentas de personalização para criar e editar formulários de entidade. Mais informações: Criação e design de formulários para obter informações sobre tarefas relacionadas ao trabalho com formulários no aplicativo.
Este tópico fornecerá informações necessárias para criar ou editar formulários programaticamente.
Definições de formulário de acesso
Os formulários de entidades são armazenados na SystemForm entidade, juntamente com dashboards e visualizações. Há duas maneiras de inspecionar as definições de formulário para uma entidade:
Inclua a entidade em uma solução não gerenciada e exporte a solução.
Consultar a entidade
SystemForm
Exibir FormXML de uma entidade exportada
Somente as definições de formulários de entidade do sistema que foram personalizados são incluídas na solução gerenciada exportada. Para exibir a definição de um formulário de entidade do sistema, você deve alterá-lo 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 exiba o arquivo customizations.xml. Você encontrará a definição dos formulários em ImportExportXml>Entities>Entity>FormXml.
No nó <FormXml>, você encontrará cada tipo de formulário agrupado dentro de um elemento <forms> com o atributo type especificando o tipo de formulário.
Propriedades do formulário
A tabela a seguir descreve os principais SystemForm atributos de entidade e os dados correspondentes incluídos nos elementos XML exportados com a solução.
| Propriedade SystemForm | Elemento FormXML | Description |
|---|---|---|
AncestorFormId |
<ancestor> |
Identificador exclusivo do formulário pai. Isso é definido quando você cria um novo formulário usando Salvar como para um formulário existente ou usando CopySystemFormRequest. |
CanBeDeleted |
<CanBeDeleted> |
Informações que especificam se esse componente pode ser excluído. Essa propriedade gerenciada só será aplicada se o formulário tiver sido criado importando uma solução gerenciada. |
Description |
<Descriptions> |
Description é uma cadeia de caracteres e <Descriptions> contém quaisquer rótulos localizados para a descrição do formulário.Os rótulos localizados podem ser recuperados usando o RetrieveLocLabelsRequest. |
FormActivationState |
<FormActivationState> |
Especifica o estado do formulário. Somente formas do tipo "principal" podem ser desativadas. Valores válidos: - 0: Inativo - 1: Ativo |
FormId |
<formid> |
Identificador exclusivo do formulário |
FormPresentation |
<FormPresentation> |
Especifica se esse formulário está no layout de interface do usuário atualizado no Dynamics 365 for Customer Engagement. |
FormXml |
<form> |
Representação XML do layout do formulário. |
IntroducedVersion |
<IntroducedVersion> |
Versão da solução na qual o formulário foi adicionado. |
IsAIRMerged |
N/A | Especifica se esse formulário é mesclado com o layout de interface do usuário atualizado no Dynamics 365 for Customer Engagement. |
IsCustomizable |
<IsCustomizable> |
Informações que especificam se esse componente pode ser personalizado. Essa propriedade gerenciada só será aplicada se o formulário tiver sido criado importando uma solução gerenciada. |
IsDefault |
N/A | Informações que especificam se o formulário ou o painel é o padrão do sistema. |
Name |
<LocalizedNames> |
Name é uma cadeia de caracteres e <LocalizedNames> contém quaisquer rótulos localizados para o nome do formulário.Os rótulos localizados podem ser recuperados usando o RetrieveLocLabelsRequest. |
ObjectTypeCode |
O formulário é um descendente do elemento Entity. |
O ObjectTypeCode valor é o nome lógico da entidade. |
Type |
<forms>atributo de elemento type |
Os valores válidos para formulários são: - 2: main- 5: mobile- 6: quick- 7: quickCreate |
Criar e editar formulários
Você só pode criar novos formulários para uma entidade em que EntityMetadata. CanCreateForms permite.
Você pode criar novos formulários usando um CreateRequest ou o CopySystemFormRequest. Ao usar CopySystemFormRequest ou usar Salvar como no editor de formulários, observe que não há herança entre formulários. Portanto, as alterações no formulário base não são aplicadas automaticamente a nenhum formulário criado a partir dele.
Editar as definições de formulário de uma solução gerenciada exportada e, em seguida, importar novamente a solução é um método com suporte para editar formulários de entidade. Ao editar formulários manualmente, recomendamos que você use um editor XML que permita a validação do esquema. Mais informações: Editar o arquivo XML de personalizações com validação de esquema
Consulte também
Personalizar o Envolvimento do Cliente do Microsoft Dynamics 365
Criar e projetar formulários
Entidade SystemForm
Criar ou editar como as regras de negócios são iniciadas
Esquema XML do formulário