自定义模型驱动应用中的表单

模型驱动应用中的窗体提供用户用来创建、查看或编辑表记录的用户界面(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 文件。

创建和设计窗体
SystemForm 表
表单 XML 架构
使用客户端 API 在对话框中打开主窗体