模型驱动应用中的窗体提供用户用来创建、查看或编辑表记录的用户界面(UI)。 本文介绍如何在自定义工具中使用 SystemForm 表和表单设计器以编程方式创建或编辑表单。 了解如何通过代码示例访问表单定义、了解表单属性和实现表单。
访问表单定义
SystemForm 表用于存储表单以及仪表板和可视化内容。 您可以通过两种方式检查数据表定义:
将表包含在非托管解决方案中并导出解决方案。
查询
SystemForm表。
从导出的表中查看 FormXML
导出的托管解决方案仅包含您自定义的系统窗体定义。 若要查看系统窗体的定义,必须更改窗体,或者通过保存具有新名称的现有窗体来创建新窗体。
导出解决方案后,提取内容并查看 customizations.xml 文件。 可在其中ImportExportXml>Entities>Entity>FormXml找到表单的定义。
在节点中 <FormXml> ,每种类型的窗体都分组在一个 <forms> 元素中,其中包含 type 指定窗体类型的参数。
SystemForm 表窗体属性
下表描述了使用解决方案导出的 XML 元素中包含的键 SystemForm 表列和相应数据。
| SystemForm 属性 | FormXML 元素 | Description |
|---|---|---|
AncestorFormId |
<ancestor> |
父窗体的唯一标识符。 当您通过使用现有窗体的另存为或通过使用 .NET SDK 的CopySystemFormRequest 类或 Web API 的CopySystemForm 操作来创建新窗体时,设置此属性。 |
CanBeDeleted |
<CanBeDeleted> |
指定是否可以删除此组件的信息。 此托管属性仅在通过导入托管解决方案创建表单时适用。 |
Description |
<Descriptions> |
Description 是一个字符串,包含 <Descriptions> 表单说明的任何本地化标签。可以使用 RetrieveLocLabelsRequest 获取本地化标签。 |
FormActivationState |
<FormActivationState> |
指定窗体的状态。 只能停用类型为“main”的表单。 有效值: -0: Inactive-1: Active |
FormId |
<formid> |
窗体的唯一标识符 |
FormPresentation |
<FormPresentation> |
指定此窗体是否位于 Microsoft Dataverse 中更新的 UI 布局中。 |
FormXml |
<form> |
窗体布局的 XML 表示形式。 |
IntroducedVersion |
<IntroducedVersion> |
添加表单所在的解决方案版本。 |
IsAIRMerged |
N/A | 指定此窗体是否与 Dataverse 中更新后的 UI 布局合并。 |
IsCustomizable |
<IsCustomizable> |
指定是否可以自定义此组件的信息。 此托管属性仅在通过导入托管解决方案创建表单时适用。 |
IsDefault |
N/A | 用于指定窗体或仪表板是否为系统默认的信息。 |
Name |
<LocalizedNames> |
Name 是一个字符串,<LocalizedNames> 其中包含窗体名称的任何本地化标签。可以使用 RetrieveLocLabelsRequest 获取本地化标签。 |
ObjectTypeCode |
该表单是 Entity 元素的子元素。 |
该值 ObjectTypeCode 是表逻辑名称。 |
Type |
<forms> element type 参数 |
表单的有效值为: -2: main-5: mobile-6: quick-7: quickCreate |
创建和编辑表单
您只能为那些被 EntityMetadata.CanCreateForms 允许的表创建新窗体。
可通过直接创建或使用 CopySystemForm 消息来创建新表单。 使用 SDK for .NET CopySystemFormRequest 类 或 Web API CopySystemForm 操作。 在窗体编辑器中使用 CopySystemForm 消息或 另存为 时,窗体之间没有继承关系。 因此,对基窗体的更改不会自动应用于从其创建的任何表单。
可以通过导出托管解决方案、编辑表单定义,然后重新导入解决方案来编辑表单定义。 手动编辑表单时,请使用支持架构验证的 XML 编辑器。 有关详细信息,请参阅 使用架构验证编辑自定义 XML 文件。