Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Los formularios en aplicaciones controladas por modelos proporcionan la interfaz de usuario (UI) que los usuarios usan para crear, ver o editar registros de tabla. En este artículo se explica cómo crear o editar formularios mediante programación mediante el uso de la tabla y el SystemForm diseñador de formularios en las herramientas de personalización. Aprenderá a acceder a definiciones de formulario, comprender las propiedades del formulario e implementar formularios mediante ejemplos de código.
Definiciones de formulario de acceso
La SystemForm tabla almacena formularios junto con paneles y visualizaciones. Puede inspeccionar las definiciones de formulario de una tabla de dos maneras:
Incluya la tabla en una solución no administrada y exporte la solución.
Consulte la tabla
SystemForm.
Ver FormXML desde una tabla exportada
Una solución administrada exportada incluye solo definiciones de formularios del sistema que personalice. Para ver la definición de un formulario del sistema, debe cambiar el formulario o crear uno nuevo guardando el formulario existente con un nuevo nombre.
Después de exportar la solución, extraiga el contenido y vea el customizations.xml archivo. Encontrará la definición de los formularios en ImportExportXml>Entities>Entity>FormXml.
En el <FormXml> nodo, cada tipo de formulario se agrupa en un <forms> elemento con el type parámetro que especifica el tipo de formulario.
Propiedades del formulario de tabla SystemForm
La siguiente tabla describe atributos clave de las columnas de tabla 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. Establezca esta propiedad cuando cree un nuevo formulario mediante Guardar como para un formulario existente o mediante el SDK para la clase CopySystemFormRequest de .NET o la acción CopySystemForm de la API web. |
CanBeDeleted |
<CanBeDeleted> |
Información que especifica si se puede eliminar este componente. Esta propiedad administrada solo se aplica si crea el formulario mediante 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.Puede recuperar las etiquetas localizadas mediante el RetrieveLocLabelsRequest. |
FormActivationState |
<FormActivationState> |
Especifica el estado del formulario. Solo los formularios de tipo "principal" se pueden desactivar. Valores válidos: -0: Inactive-1: Active |
FormId |
<formid> |
Identificador único del formulario |
FormPresentation |
<FormPresentation> |
Especifica si este formulario está en el diseño de interfaz de usuario actualizado en Microsoft Dataverse. |
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/A | Especifica si este formulario se combina con el diseño actualizado de la UI en Dataverse. |
IsCustomizable |
<IsCustomizable> |
Información que especifica si este componente se puede personalizar. Esta propiedad administrada solo se aplica si crea el formulario mediante 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.Puede recuperar las etiquetas localizadas mediante el RetrieveLocLabelsRequest. |
ObjectTypeCode |
El formulario es un descendiente del Entity elemento . |
El valor de ObjectTypeCode es el nombre lógico de la tabla. |
Type |
Parámetro <forms> del elemento type |
Los valores válidos para los formularios son: -2: main-5: mobile-6: quick-7: quickCreate |
Crear y editar formularios
Solo puede crear formularios nuevos para tablas en las que EntityMetadata.CanCreateForms lo permita.
Cree nuevos formularios creandolos directamente o mediante el CopySystemForm mensaje. Use el SDK para la clase CopySystemFormRequest de .NET o la acción CopySystemForm de la API web. Al usar el CopySystemForm mensaje o Guardar como en el editor de formularios, no hay herencia entre formularios. Por lo tanto, los cambios en el formulario base no se aplican automáticamente a ningún formulario creado a partir de él.
Puede editar las definiciones de formulario exportando una solución administrada, editando las definiciones de formulario y volviendo a importar la solución. Al editar manualmente formularios, use un editor XML que admita la validación de esquemas. Para obtener más información, vea Editar el archivo XML de personalizaciones con validación de esquemas.
Contenido relacionado
Crear y diseñar formularios
Tabla SystemForm
Esquema XML de formulario
Apertura del formulario principal en un cuadro de diálogo mediante la API de cliente