Personalizar formularios de entidad
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: Inactivas - 1: Activas |
FormId |
<formid> |
Identificador único del formulario |
FormPresentation |
<FormPresentation> |
Especifica si este formulario está en el diseño actualizado de la UI en Dynamics 365 for 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 está en el diseño actualizado de la UI en Dynamics 365 for Customer Engagement. |
IsCustomizable |
<IsCustomizable> |
Información que especifica si este componente se puede personalizar. 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.
Consulte también
Personalizar Microsoft Dynamics 365 Customer Engagement
Crear y diseñar formularios
Entidad SystemForm
Crear o editar el modo de iniciación de las reglas de negocio
Esquema XML de formulario