表单
并非所有信息都来自传感器或自动化系统。有时您需要人工输入——这正是表单组件发挥作用的地方。可以将它看作 IronFlock 中的数字记录板。当您需要手动采集数据时使用它,例如:
- 在生产线上记录废品数量
- 输入传统 pH 传感器的读数
- 在工厂巡检期间记录检查笔记
表单如何工作
当有人提交表单时,数据会存储在应用数据库的指定表中。表单中的每个字段映射到该表的一个列,提交表单时所有字段作为新行一起保存。
您在表单组件中配置的内容:
- 表单标题
- 一个或多个字段,每个字段包含标签、输入类型以及要写入的表列
- 可选的验证规则和每个字段的默认值
- 按钮的可选文字(Button Labels,例如用 保存 代替 Submit),以及保存后打开的页面(Post-Submit Navigation)
可用字段类型: 下拉菜单(从列表中选择)、文本、数字、复选框和日期/时间选择器。
排列字段
默认情况下,每个字段占满一整行,依次上下排列。把相关字段并排放置并归入标题之下,较长的表单会更容易填写:
- Width: 每个字段可以占一整行,或一行的四分之三、三分之二、一半、三分之一或四分之一。字段从左到右依次填满每一行,放不下的字段会从下一行开始。在 Field Layout 中设置 Default Field Width,可让所有字段使用相同的宽度,然后再根据需要调整单个字段。
- Start a New Row: 即使该字段还能放在上一个字段旁边,它也会另起一行。
- 分组: 类型为 section 的字段会添加一个标题,并可在其下方显示提示。它会把随后的字段归为一组,直到下一个分组为止。通过它的 Field Width in Group 可以一次性设置这些字段的宽度,通过它的 Conditional Display 可以显示或隐藏整个分组,例如只适用于某一类设备的设置。
- Density: 新表单默认使用 Compact,字段较小,适合用鼠标操作的桌面端 Board。选择 Comfortable 可获得更大的字段,适合触摸屏。
表单会根据可用空间自动调整。在较小的组件或手机上,字段会逐步变宽,直到排成一列,确保每个字段都清晰易读。Minimum Field Width 用于设置字段在此之前最窄可以缩到多少。
数据存储在哪里?
每次表单提交都会在表中添加一行新记录。这为您提供了所有输入的完整历史记录——不会覆盖或丢失任何数据。
请确保配置所有必填字段,使每条新记录完整且一致。
跟踪最新状态
如果您使用表单来跟踪设备或资产的当前状态——例如每台设备的最新检查结果——IronFlock 可以只向您展示每个项目的最新条目。应用开发者通过告诉表哪些列用于标识一个实体(例如设备名称)来启用此功能。
设置完成后,在组件的过滤设置中打开 latest 开关,该组件就只显示每台设备或资产的当前记录。每次组件读取该表时,IronFlock 都会重新确定哪一条是当前记录,而每一次新提交到达时都会替换 Board 上该项目的那一行,因此迟到的或更正后的提交绝不会让 Board 上显示过时的数值。同时,完整的提交历史记录仍然可供查阅。
在这样的表中,表单需要为标识实体的列提供字段,此外只需为它所编辑的列提供字段。每次提交时,表单未写入的每一列都会保留其当前值。表单上的字段总会被写入:清空的数字字段会清空其列,清空的文本字段会存储空文本,被显示条件隐藏的字段会清空其列。设有默认值的字段会写入默认值,而不是让该列为空。
从表格编辑记录
要让用户打开并修改现有记录,请在同一页面上组合使用表格和表单:
- 为表格添加一个 Edit button 类型的列,绑定到标识记录的列(例如机器名称),并设置其 URL Parameter Key,例如
edit。每一行随即显示一个铅笔图标。点击后,该行的键会写入页面 URL(?edit=press-1),与筛选器组件设置参数的方式相同。 - 在同一页面上添加一个表单,开启其 Form Open Button,并将 Open on URL parameter 设置为相同的名称。在 Board 上,表单不显示自己的按钮:只要 URL 带有该参数,它就以对话框形式打开;当用户保存或取消时再次关闭,并从 URL 中移除该参数。
- 将每个字段的 Pre-filled Value 绑定到记录的列,对标识列设置一个筛选条件,其值来自 筛选参数
edit,并开启 Latest 开关。写入标识列的字段是一个具有相同绑定的 Hidden Field,这样保存就会作用于同一条记录。与上一节相同,表单不写入的列保留其值。
对话框会显示进度条,直到记录的值到达。开启 latest 开关后,保存的更改一经存储,表格就会立即显示。带参数的书签 URL 会立即打开对话框,浏览器的后退按钮会将其关闭。
带有自己打开按钮的单独表单仍然用于创建新记录。在 Board 之外,即组件编辑器的预览中,表单会保留其按钮,以便您试用。
删除数据
IronFlock 对删除也采用追加方式。不是直接删除某行,而是由表单提交一条新条目,在表的 deleted 列中将该记录标记为已删除;deleted 是应用开发者添加到表中的布尔列。为此没有专门的删除按钮:删除表单就是提交按钮上显示 删除 的表单。
要让用户在确认后从表格中删除记录:
- 给表格添加第二个类型为 Edit button 的列,绑定到标识记录的列,将 URL Parameter Key 设为
delete,Icon 设为delete。 - 在同一页面上添加一个表单,开启其 Form Open Button,将 Open on URL parameter 设为
delete,并为它设置一个标题,例如“删除这条记录?”。在 Button Labels 中将 Submit Label 设为删除,将 Cancel Label 设为保留,并选择红色的 Highlight Color。 - 给表单恰好两个字段,两者都开启 Hidden Field:一个写入标识列,其 Pre-filled Value 的绑定方式与上面的编辑表单相同,但按
delete参数过滤;另一个是写入deleted列的复选框,开启其 Default Value。
点击某行的删除图标会打开对话框,删除 会将该记录的键连同值为 true 的 deleted 一起保存。若要改为在记录自己的详情页上删除,请把同一个表单放到该页,并将其 Post-Submit Navigation 设为列表页,例如 /machines。
列出记录的组件将 latest 开关与 deleted 列上的过滤条件(deleted 为空或为 false)结合使用。已删除的记录在条目到达时立即从 Board 上消失,并保留在数据库中用于历史和审计。为此无需任何视图或转换;参见软删除记录。若要让编辑表单恢复已删除的记录,请给它添加一个写入 deleted 列、Default Value 关闭的隐藏复选框。
使用 2.0 之前版本的表单组件创建的表单具有 Show Delete Button 和 Delete-Flag Column 设置。2.0 版本不再有这些设置:将此类表单迁移到 2.0 或更高版本时,请按此处所述重新构建其删除功能。
总结
通过表单组件,您可以获得:
- 直接从 Board 进行便捷的手动数据输入
- 每次提交的自动历史记录跟踪
- 显示当前状态和隐藏已删除记录的清晰模式
- 在同一页面的对话框中,从表格编辑现有记录
所有这些都无需离开您的 IronFlock Board。