# 动态字段

动态字段的定义过程包含两个步骤

  1. 创建动态字段定义,动态字段定义主要包含动态字段存储相关的信息,如数据类型、可选项等
  2. 创建动态字段实例,动态字段实例主要包含动态字段的显示相关的信息,如显示名称、显示控件类型等

系统支持在如下场景下创建动态字段实例以在前后端传递、保存数据:

  • 创建与某种 Domain Class 关联的动态字段,以给对象增加属性。
  • 创建与某个 Action 关联的动态字段,以实现在执行 Action 时,显示参数输入表单,并传递参数。
  • 创建与某个 Wizard 关联的动态字段,以实现在显示向导表单时,显示参数输入表单,并传递参数。
  • 创建与某种 Domain Instance 关联的动态字段,以实现通过某个类型控制对象实例的属性列表。

多个动态字段实例可以关联到同一个动态字段定义。

创建与 Domain Instance 关联的动态字段的详情请参考

Domain Instance 动态字段支持

# 创建动态字段

系统支持通过界面操作直接创建动态字段,具体操作步骤为:

  • 在界面上,使用开发人员帐号(默认系统为 [email protected])登陆系统,创建一 个Dynamic Field Definition定义,示意如下:

Create Dynamic Field

  • 通过创建 Dynamic Field Instance 对象,将新创建的动态字段与某个 action 或 wizard 关联,这样在运行 action 或 wizard 时,系统就会显示该字段。

Create Dynamic Field Instance

当前支持的动态字段及界面显示控件类型如下所述:

数据类型 描述 显示控件
STRING 字符 长文本输入框
单行字符输入框
多选输入框
单选输入框
单选或输入 未实现
多选或输入 未实现
Checkbox
Radio Button
DATETIME 日期+时间 日期+时间输入
DATE 日期 日期输入
INTEGER 整数 输入
多选输入框
单选输入框
单选或输入 未实现
多选或输入 未实现
Checkbox
Radio Button
DECIMAL 小数 输入框
多选输入框
单选输入框
单选或输入 未实现
多选或输入 未实现
Checkbox
Radio Button
百分比
货币
BOOLEAN 布尔 Switch
FILE 附件 单文件上传
多文件上传
IMAGE 图片 单图片上传及预览
多图片上传及预览
OBJECT 对象关联 关联到一个对象
关联到多个对象

系统限制

当前系统中,针对货币类型,显示的货币符号全部为 $,暂未实现多语言支持

动态字段也可以通过 CSV 导入 的方式进行创建

# 选择字段备选项设定

选择字段的备选项在创建 Dynamic Field Definition时,通过 options JSON字段进行 设定,设定后的所有备选项,会以 JSON 字符串的形式,保存在系统中。

# Action 及 Wizard 字段客制化支持

Action 及 Wizard 字段也支持使用 fieldhook 进行客制化,设定及默认值、字段级联,显 影等,具体信息可参考 action 及 wizard 字段客制化 部分。

Last Updated: 2024/12/4 13:00:56