表单#

概述#

表单小组件显示一组可用于收集输入或显示数据的字段。下面显示了UI页面的示例，其中使用表单小组件收集条码。

要在UI页面中使用表单小组件，请执行以下步骤。

1. 在处于构建模式的任何UI页面中，从页面右侧的“小组件”列表中选择表单小组件，然后将其拖放到UI页面中的正确位置。
2. 进入小组件的“设置”部分。
3. 在“常规”选项卡中，提供小组件的名称、说明，并指定是否应显示标题以及用户是否可以激活全屏模式。
4. 在字段选项卡中，配置要在小组件中显示的字段。 添加新字段后，必须定义名称（这将是字段的标识和表单中显示的文本）和类型（从显示的列表中选择）。选择性地将集合类型从“无”更改为“数组”或“映射”。 然后，必须为将应用于该字段的以下属性选择正确的状态：
5. 禁用
6. 必需
7. 隐藏标签
8. 只读
9. 隐藏
10. 定义此小组件和UI页面的其他元素之间的链接。
11. 通过保存并关闭设置，小组件将相应地进行更改。

实施示例：将表单字段配置为实体查找#

表单字段可以轻松调整以用作实体查找，帮助用户提供正确的条目。

步骤#

1. 将类型设置为ReferenceType

2. 选择EntityType作为ReferenceType，然后在ReferenceType名称字段中选择实体

3. （可选）如果用于选择的可能实体需要进一步过滤，则可以使用查询。

1. 然后，在UI页面上，此类型的表单字段将显示如下：

实施示例：将表单小组件用作查询参数的用户输入#

如果查询是使用参数设置的，则可以通过表单小组件等方式轻松提供这些参数。每个参数都可以链接到不同的表单字段。

根据查询中的参数设置，有不同的可能性。以下是一些重要示例：

名称#

如果查询中的参数是为实体名称配置的，则必须通过以下两种方式之一将字符串值传递给查询：

• 不需要转换器的字符串字段（充当“自由文本用户输入”）
• 如先前示例所示的选定实体。

在后一种情况下，需要使用转换器entityName，该转换器将转换选定实体以检索实体名称，然后以字符串形式提供该名称。

实体#

如果参数是实体本身，则必须使用另一个转换器。在本例中，查询需要数据库实体ID（通常用户不知道）而不是熟悉的实体名称。必须使用anyToAnyProperty转换器从选定的实体对象中恢复实体ID。这仅适用于告诉转换器要检索哪个属性的转换器参数。（在本示例中，我们希望获取数据库实体ID并将其传递给查询）。

1. 在页面属性中添加一个值为“ID”的附加字符串属性：

1. 使用anyToAnyProperty转换器以及刚刚创建的属性，将实体表单字段链接到查询：