Skip to Content

表单

并非所有信息都来自传感器或自动化系统。有时您需要人工输入——这正是表单组件发挥作用的地方。可以将它看作 IronFlock 中的数字记录板。当您需要手动采集数据时使用它,例如:

  • 在生产线上记录废品数量
  • 输入传统 pH 传感器的读数
  • 在工厂巡检期间记录检查笔记
Forms widget demo

表单如何工作

当有人提交表单时,数据会存储在应用数据库的指定表中。表单中的每个字段映射到该表的一个列,提交表单时所有字段作为新行一起保存。

您在表单组件中配置的内容:

  • 表单标题
  • 一个或多个字段,每个字段包含标签、输入类型以及要写入的表列
  • 可选的验证规则和每个字段的默认值
  • 按钮的可选文字(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 上显示过时的数值。同时,完整的提交历史记录仍然可供查阅。

在这样的表中,表单需要为标识实体的列提供字段,此外只需为它所编辑的列提供字段。每次提交时,表单未写入的每一列都会保留其当前值。表单上的字段总会被写入:清空的数字字段会清空其列,清空的文本字段会存储空文本,被显示条件隐藏的字段会清空其列。设有默认值的字段会写入默认值,而不是让该列为空。

从表格编辑记录

要让用户打开并修改现有记录,请在同一页面上组合使用表格和表单:

  1. 为表格添加一个 Edit button 类型的列,绑定到标识记录的列(例如机器名称),并设置其 URL Parameter Key,例如 edit。每一行随即显示一个铅笔图标。点击后,该行的键会写入页面 URL(?edit=press-1),与筛选器组件设置参数的方式相同。
  2. 在同一页面上添加一个表单,开启其 Form Open Button,并将 Open on URL parameter 设置为相同的名称。在 Board 上,表单不显示自己的按钮:只要 URL 带有该参数,它就以对话框形式打开;当用户保存或取消时再次关闭,并从 URL 中移除该参数。
  3. 将每个字段的 Pre-filled Value 绑定到记录的列,对标识列设置一个筛选条件,其值来自 筛选参数 edit,并开启 Latest 开关。写入标识列的字段是一个具有相同绑定的 Hidden Field,这样保存就会作用于同一条记录。与上一节相同,表单不写入的列保留其值。

对话框会显示进度条,直到记录的值到达。开启 latest 开关后,保存的更改一经存储,表格就会立即显示。带参数的书签 URL 会立即打开对话框,浏览器的后退按钮会将其关闭。

带有自己打开按钮的单独表单仍然用于创建新记录。在 Board 之外,即组件编辑器的预览中,表单会保留其按钮,以便您试用。

删除数据

IronFlock 对删除也采用追加方式。不是直接删除某行,而是由表单提交一条新条目,在表的 deleted 列中将该记录标记为已删除;deleted 是应用开发者添加到表中的布尔列。为此没有专门的删除按钮:删除表单就是提交按钮上显示 删除 的表单。

要让用户在确认后从表格中删除记录:

  1. 给表格添加第二个类型为 Edit button 的列,绑定到标识记录的列,将 URL Parameter Key 设为 delete,Icon 设为 delete。
  2. 在同一页面上添加一个表单,开启其 Form Open Button,将 Open on URL parameter 设为 delete,并为它设置一个标题,例如“删除这条记录?”。在 Button Labels 中将 Submit Label 设为 删除,将 Cancel Label 设为 保留,并选择红色的 Highlight Color。
  3. 给表单恰好两个字段,两者都开启 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。

Last updated on