Personalizar los formularios de entidad

Se aplica a Dynamics 365 (en línea), versión 9.x

Los formularios ofrecen la interfaz de usuario (UI) que los usuarios usan para crear, ver, o editar registros de la entidad. Use el diseñador de formulario en las herramientas de personalización para crear y modificar formularios de entidad. Más información: Crear y diseñar formularios para obtener información acerca de las tareas relacionadas con el trabajo con formularios en la aplicación.

Este tema le confiere la información necesaria para crear o editar formularios mediante programación.

Definiciones de formulario de acceso

Los formularios de entidad se almacenan en la entidad SystemForm junto con paneles y visualizaciones. Hay dos formas para inspeccionar las definiciones de formularios para una entidad:

  • Incluya la entidad en una solución no administrada y exporte la solución.

  • Consulte la entidad SystemForm

Ver FormXML desde una entidad exportada

Sólo las definiciones de los formularios de entidad del sistema que se hayan personalizado se incluyen en la solución administrada exportada. Para ver la definición de un formulario de entidad del sistema, debe cambiarlo de alguna forma, o crear un nuevo formulario guardando el formulario existente con un nuevo nombre.

Tras exportar la solución, extraiga el contenido y vea el archivo customizations.xml. Encontrará la definición de los formularios en ImportExportXml > Entities > Entity > FormXml. En el nodo de <FormXml>, verá que cada tipo de formulario se agrupa en un elemento de <forms> con el atributo de type especificando el tipo de formulario.

Propiedades del formulario

La siguiente tabla describe atributos clave de la entidad SystemForm y los datos correspondientes incluidos en los elementos XML exportados con la solución.

Propiedad de SystemForm Elemento de FormXML Descripción
AncestorFormId <ancestor> Identificador único del formulario primario. Esto se establece cuando crea un formulario nuevo mediante Guardar como para un formulario existente o mediante CopySystemFormRequest.
CanBeDeleted <CanBeDeleted> Información que especifica si se puede eliminar este componente. Esta propiedad administrada se aplica únicamente si el formulario se creó con la importación de una solución administrada.
Description <Descriptions> Description es una cadena y <Descriptions> contiene las etiquetas localizadas para la descripción del formulario.

Las etiquetas localizadas se pueden recuperar mediante RetrieveLocLabelsRequest.
FormActivationState <FormActivationState> Especifica el estado del formulario.

Solo los formularios de tipo "principal" se pueden desactivar.

Valores válidos:

- 0: Inactivo
- 1: Activo
FormId <formid> Identificador único del formulario
FormPresentation <FormPresentation> Especifica si este formulario está en el diseño actualizado de la UI en Dynamics 365 (online) Customer Engagement.
FormXml <form> Representación XML del diseño de formularios.
IntroducedVersion <IntroducedVersion> Versión de la solución en la que se agregó el formulario.
IsAIRMerged N/D Especifica si este formulario se combina con el diseño actualizado de la interfaz de usuario en Dynamics 365 (online).
IsCustomizable <IsCustomizable> Información que especifica si se puede personalizar este componente.

Esta propiedad administrada se aplica únicamente si el formulario se creó con la importación de una solución administrada.
IsDefault N/A Información que especifica si el formulario o el panel es el predeterminado del sistema.
Name <LocalizedNames> Name es una cadena y <LocalizedNames> contiene las etiquetas localizadas para el nombre del formulario.

Las etiquetas localizadas se pueden recuperar mediante RetrieveLocLabelsRequest.
ObjectTypeCode El formulario es un elemento secundario del elemento de Entity. El valor de ObjectTypeCode es el nombre lógico de la entidad.
Type Atributo de type del elemento de la <forms> Los valores válidos para los formularios son:

- 2: main
- 5: mobile
- 6: quick
- 7: quickCreate

Crear y editar formularios

Solo puede crear nuevos formularios para una entidad donde EntityMetadata. CanCreateForms lo permite.

Puede crear formularios nuevos con CreateRequest o CopySystemFormRequest. Cuando usa CopySystemFormRequest o Guardar como en el editor de formularios, tenga en cuenta que no hay datos heredados entre los formularios. Por lo tanto, los cambios en el formulario base no se aplican automáticamente a los formularios creados a partir de él.

Editar las definiciones del formulario desde una solución administrada exportada y después reimportar la solución es un método compatible para editar formularios de entidad. Al editar manualmente los formularios recomendamos usar un editor XML que permita la validación de esquema. Más información: Editar el archivo XML de personalizaciones con la validación de esquema

Vea también

Personalizar Microsoft Dynamics 365
Crear y diseñar formularios
Entidad SystemForm
Crear o editar el modo de iniciación de las reglas de negocio
Esquema XML de formulario