控件

文本

控件属性

①. 基本属性

• 标题：显示的标签内容。
• 引入字段：选择库表中的字段。表单不支持库表类型为二进制的字段。
• 控件类型：默认选中为当前控件的类型，可切换控件类型。
• 默认值：控件的默认值。
  • 自定义默认值：手动输入默认值。
  • 公式计算。详见公式计算
  • 默认常量。
    • 用户ID
    • 用户中文名
    • 用户登录名
    • 用户所属部门名称
    • 用户所属部门ID
    • 用户的所属部门、兼职部门、角色、群组、用户ID集合
    • 用户的所有相关ID(所属部门、上级部门、角色、群组、用户ID)
    • 用户所属的根部门(组织)名称
    • 用户所属的根部门(组织)ID
    • 当前日期时间
    • 当前时间
    • 当前日期
    • 当前时间日
    • 当前时间月
    • 当前时间年
    • 租户标识
    • 根路径
• 必填：是否必填。
• 提示信息：用于显示文本框的提示信息。
• 列宽：仅当控件为动态表格列时有效，默认为等分显示。
• 操作权限：只读、编辑、隐藏。默认为编辑。
• 显示标题：是否显示标题。
• 标题位置：标题显示的位置。
• 控件尺寸：配置控件标题和控件显示的宽度。
  • 标题位置为上时：仅有一个滑块，用于控制控件显示的宽度。
  • 标题位置为左时：有两个滑块，前一个用于控制控件标题显示的宽度，后一个用于控制控件显示的宽度。
• 描述：备注信息。

②. 高级属性

• 控件事件
  • 事件类型：包括onclick,onchange,onblur等事件，在搜索框里输入自定义的事件类型，回车可添加自定义类型。
  • 回调函数：事件代码。
• 添加属性：允许自定义添加控件属性。在预览界面中，添加的属性将添加到控件的HTML标签内。

文本域

控件属性

①. 基本属性

• 默认行数：文本域的默认行数为3行。

数值

控件属性

①. 基本属性

• 小数位数：小数位数为0时，为整数。

日期

控件属性

①. 基本属性

• 格式：日期格式。
  • Year-Month-Day
  • Year年Month月Day日
  • Year-Month-Day Hour24:Minute:Second
  • Year年Month月Day日 Hour24时Minute分Second秒

如若扩展详见参数配置。

选项按钮

控件属性

①. 基本属性

• 字典：选择已存在的字典。

• 选项：可在设计器中添加选项列表，勾选选项列表前的选项框可设置默认值。可拖动选项排序。在设计器中不能修改字典的属性，只能查看。
• 水平显示:设置选项列表的显示方式。
• 允许多选：勾选时为多选按钮，否则为单选按钮。

②. 高级属性

• 字典类型：保存业务数据时，实际保存的值。id、name、value。只有选择了字典，字典类型才能选择id类型。
• 级联字典：是否添加多级联动。
• 级联字段：选择下级联动的字段。
• 下级动态字典的关系列：下级动态字段的关系列，用于指定动态字典的上下级关系，不区分大小写。

注：

• 字典和自定义选项可以混合使用。
• 多级联动的设置详见字典的多级联动。

下拉框

控件属性

①. 基本属性

• 字典：选择已存在的字典。
• 选项：可在设计器中添加选项列表，勾选选项列表前的选项框可设置默认值。可拖动选项排序。在设计器中不能修改字典的属性，只能查看。
• 允许多选：勾选时可以多选。

①. 高级属性

• 允许录入新增：下拉框允许录入新值。
• 字典类型：保存业务数据时，实际保存的值。id、name、value。
• 级联字典：是否添加多级联动。
• 显示所有下级：级联字段是否在一个控件里显示。

提示

仅支持静态字典

• 存储方式： 显示所有下级为是时，选择存储方式：存储最后选择的值/存储每一级选择的值。
• 级联字段：当显示所有下级为否时，选择下级联动的字段。
• 下级动态字典的关系列：下级动态字段的关系列，用于指定动态字典的上下级关系，不区分大小写。
• 分隔符：存储方式为存储所有选择时用分隔符隔开。

多级联动的设置详见字典的多级联动

附件

控件属性

①. 基本属性

• 允许多选：可同时上传多个附件，允许多选时，在弹出的Windows打开窗口中可同时选择多个文件上传。

②. 高级属性

• 附件类型：普通附件、图片。
• 附件类型格式：上传文件的格式, 允许多选。
  • 不设置附件类型，附件格式按照配置文件内普通附件和图片附件格式的合并！
  • 设置附件类型，不设置附件格式，就按配置文件内对应的附件格式为准！
  • 设置附件类型，并设置附件格式，就按设置的附件格式为准！
• 附件大小：单个文件上传的附件大小，最大不能大于配置文件内配置的大小。单位KB。
• 附件大小总和：允许多选时，控件上传附件大小的总和不能超过该值。单位KB。
• 显示缩略图：附件类型为图片时，可选择是否显示缩略图。
  • 是：在附件控件的上方用列表方式显示上传图片的缩略图。
  • 否：在附件控件的上方用列表方式显示标识图片的图标。
• 图片的位置：当不显示缩略图时，允许自定义图片显示的位置。例如：#id或.class。
• 图片大小：用于显示图片的宽度和高度。宽*高。例如： 500px*500px 。

如若扩展详见设计器参数配置。

文本编辑器

控件属性

①. 基本属性

• 高度：设置编辑器的高度。默认150px。

②. 高级属性

• 文本编辑器类型：大文本、百度编辑器。默认为大文本。

组织机构

控件属性

①. 基本属性

• 自定义类型：自定义组织机构类型。在根节点内输入对应的id，可从此节点开始展示组织机构树。
• 允许多选：可同时选择多个组织机构。

②. 高级属性

• 存储类型：保存业务数据时实际存储的值。（ID、名称、登录名称）。仅当只能选择人员时，存储类型才可以为登录名称。

警告

组织机构的存储类型为名称时，在回显业务数据的时候回显不出来。

自动编号

控件属性

①. 基本属性

• 编号类型：自动编号、手动编号。
  • 自动编号：表单打开时就会根据编号规则生成编号。一旦表单保存过业务数据后，自动编号就无法修改。
  • 手动编号：点击编号按钮时根据编号规则生成编号。
• 编号规则

• 编码：规则编码。只能输入字母和数字。必填。不能重复。
• 规则名称: 必填，不能重复。
• 规则内容：必填。
• 流水号：流水号位数。1~9之前的整数。必填。
• 备注：备注信息。

规则内容示例：

 HZ|TITLE||{year}{month}{day}*
 HZ：规则中固定内容
 |TITLE|：从表单TITLE字段获取数据
 {year}：年(两位)
 {Year}：年(四位)
 {month}：月(两位)
 {day}：日(两位)
 *：流水号的位置

警告

规则内容 * 为必填。

动态表格

控件属性

①. 基本属性

• 展示方式：表格、块。块：动态表格内的列用div的方式展示。
• 显示表头：是否显示表头。
• 默认行数：动态表格添加默认行数。
• 引入表单：可将已存在的表单引入到动态表格内。
• 关联字段：动态表格引入的子表与主表关联的字段名。
• 必填：必填校验。

②. 高级属性

• 表格类型：引入表单、自定义。默认为引入表单。
• 数据源：自定义动态表格的数据源。默认为当前表单的数据源，可切换其他数据源。
• 所属库表：自定义动态表格的库表。点击右侧的按钮，当前选择的库表中所有字段根据字段的数据类型转换为对应的控件类型引入动态表格。
• 关联字段：动态表格引入的子表与主表关联的字段名。
• 添加字段：可添加动态表格列。
• 字段列表：动态表格列的列表。单击列表可编辑当前列。可拖动列表中的列改变列表顺序。可删除列表中的列。
• 是否设置中间关联表：允许设置动态表格中间关联表。
• 动态表格中间关联表

• 编码：只能输入字母和数字。必填。不能重复。
• 关联表名称：必填。不能重复。
• 中间表：选择中间关联表。
• 与主表关联字段：关联表中与主表关联的字段。
• 与子表关联表字段：关联表中与动态表格子表关联的字段。
• 备注：备注信息。

提示

动态表格内也可以使用多级联动。

签名

控件属性

①. 基本属性

• 签名类型：签名、签名图片。默认为签名。

签名图片具体实现详见签名图片实现 。

意见

控件属性

①. 基本属性

• 意见类型：意见、会签意见。默认为意见。

警告

意见类型如需图片签名意见时请在 designer-context.xml 中，加以下代码，并实现签名图片接口：

<bean id="opinionServiceImpl" class="com.horizon.designer.common.service.impl.OpinionServiceImpl">
    <property name="iUserSignPicService" ref="userSignPicServiceImpl" />
</bean>

签名图片实现类详见签名图片实现 。

自定义控件

自定义控件配置文件用于自义定表单录入类型, 名称为 formElement.json , 位于Web工程中的 \assets\designer\json\form 路径下

配置说明

• title 控件标题
• type 控件类型
• placeholder 输入预期值的提示信息
• size
  • label 标题占比
  • widget 控件占比
• dictOption
  • id 引用字典id
  • type 控件保存字典值id、name、value
  • list 字典id
  • linkageField 级联字典
  • trendsConnected 字典关联字段
• isDict 是否是字典项
• isOption 是否是选项
• attributes 其它属性
• multi 是否多选
• addNew 是否新增
• template 定制页面显示模板

{
    "title": "密级",
    "type": "secretLevel",
    "placeholder": "请选择密级",
    "size": {
        "label": 0,
        "widget": 12
    },
    "dictOption": {
        "id": "HZ2881c33bcb7be8013bcb8f5a3c00fe",
        "type": "value",
        "list":[],
        "linkageField": "",
        "trendsConnected": ""
    },
    "isDict": false,
    "isOption": false,
    "attributes": {},
    "multi": false,
    "addNew": false,
    "template": "<widget-select></widget-select>"
}