Personalizar los formularios de entidad
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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:TechNet: 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.
En este tema
Definiciones de formulario de acceso
Propiedades del formulario
Crear y editar formularios
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 solución, extraiga el contenido y vea el archivo customizations.xml. Encontrará la definición de los formularios en el ImportExportXml > Entities > Entity > FormXml. En el nodo de <FormXml> (FormXml), verá que cada tipo de formulario se agrupa en un elemento de <forms> (FormXml) con el atributo de type especificando el tipo de formulario.
Propiedades del formulario
La siguiente tabla describe atributos clave de 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 |
Identificador único del formulario primario. Esto se establece cuando crea un formulario nuevo mediante Guardar como para un formulario existente o mediante CopySystemFormRequest. |
|
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 |
Description es una cadena y <Descriptions> (FormXml) contiene las etiquetas localizadas para la descripción del formulario. Las etiquetas localizadas se pueden recuperar mediante RetrieveLocLabelsRequest. |
|
FormActivationState |
Especifica el estado del formulario. Solo los formularios de tipo "principal" se pueden desactivar. Valores válidos:
|
|
FormId |
Identificador único del formulario |
|
FormPresentation |
Especifica si este formulario está en el diseño actualizado de la interfaz de usuario en Microsoft Dynamics 365 (en línea y local). |
|
FormXml |
Representación XML del diseño de formularios. Para obtener más información acerca de la estructura del formulario, consulte <form> (FormXml). |
|
IntroducedVersion |
Versión de la solución en la que se agregó el formulario. |
|
IsAIRMerged |
N/A |
Especifica si este formulario se combina con el diseño actualizado de la interfaz de usuario en Microsoft Dynamics 365 (en línea y local). |
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 |
Name es una cadena y <Descriptions> (FormXml) 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> (FormXml) |
Los valores válidos para los formularios son:
|
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 permite la validación de esquema.Más información:Editar el archivo XML de personalizaciones con la validación de esquema
Ver también
Personalizar aplicaciones de Microsoft Dynamics 365
TechNet: Crear y diseñar formularios
Mensajes y métodos de la entidad SystemForm (panel del sistema)
Crear o editar el modo de iniciación de las reglas de negocio
Form XML reference
Form XML schema
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright