创建新表单

基本属性

参见表单属性

创建表单说明文档创建表单说明

高级选项

概述：用于基于已创建表单来创建相同表单(做简单修改)。

使用方法：创建表单页面点击显示高级选项选择要复制的表单：

属性

修改表单名称、表单数据表、权限、提交后执行工具等配置；

编辑表单
ID：表单 id，唯一不可修改
名称：表单名称，可修改
数据表：表单字段所在数据表，编辑表单字段所在数据表，修改后表单素有字段将在新指定的数据表生成
描述：添加对此表单的备注信息

高级工具

详细文档：高级工具详细介绍文档

树状查看

概述：用于快速总览、修改当前表单的逻辑和设计；

可以修改表单、分区、列、字段的属性；

具体参见高级工具详细介绍文档

权限

概述：为应用程序设计人员提供了对当前表单中每个单独元素的权限控制。

具体参见高级工具详细介绍文档

可以有多套权限方案(供不同权限用户查看)。

引用查询

概述：可以快速查看当前表单都在哪里被引用。

具体参见高级工具详细介绍文档

当需要删除表单或对当前表单做大的修改前可以查看都在那里引用，防止影响系统其它设计。

数据表

概述：可以查看当前表单指向的数据表都被哪些表单引用(还可以查看其它应用的表单的引用)，还可以查看当前表单指向的数据表的所有字段(并不一定是当前表单的字段)。

具体参见高级工具详细介绍文档

i18N

概述：列出当前表单的所有标签，方便可以对标签做国际化

具体参见高级工具详细介绍文档

注意:

选择一个语言定义后切换另一个语言继续定义，所有都生效，并不需要必须选中

提示

概述：列出当前表单的所有标签，方便对标签做提示。

具体参见高级工具详细介绍文档

注意：

选择一个语言定义后切换另一个语言继续定义，所有都生效，并不需要必须选中

差异检查

概述：检查当前表单是否有人在自己保存前做了修改并且可以合并修改(不会自动保存表单)。

具体参见高级工具详细介绍文档

注意：

差异检查页面不会实时加载信息，需要再次点击的差异检查选项

JSON代码

概述：可以查看当前表单的json代码，也可以直接修改json代码

具体参见高级工具详细介绍文档

设计表单

编辑分区

添加分区：光标移动到分区下方

分区说明文档：分区官方说明文档

编辑分区选项页

概述：分区主要属性配置页面。

属性：

id：分区的ID(必填)，方便自定义样式(css)或js事件。
标签：分区的标签，可不必填
只读：勾选时该分区只读不可编辑。
只读时一标签方式显示：勾选时在只读的前提下该分区只显示标签和值，没有文本框/时间选择器等元素的的样式。
例图2：

具体参见分区设置详细文档

图一

图2.

数据绑定器

概述：默认是不必填的。如果未设置，它将使用父级(当前表单)的数据绑定器。可以定义自己的指定绑定器来覆盖父级数据绑定器。

属性：

加载绑定器：选择要加载数据的方法。
存储绑定器：选择要存储数据的方法。

数据绑定器参考文档：数据绑定器说明文档

注意：

一般不做设置遵循当前表单的数据表定期，如有特定需求可按需选择绑定器

高级选项

可见性控制

链接类型：
1. 与(And) - 并且
2. 或(Or)) - 或者
相反值：勾选时定义为：不为当前条件；如图不勾选时为当id=1时显示此分区，勾选时为当id不等于1时显示次分区
控制本分区的字段ID：当前表单的数据表字段ID;
显示本分区的字段值：可以为数字、字母、汉字，也可以用标准的Hash变量调用当前环境的任意信息
使用正则表达式？：勾选后在显示本分区的字段值列可以使用正则表达式进行匹配

具体参见分区设置详细文档

注意：

- 图2等同于：("1" && "show") || "5" ；可以使用 ( ) 进行优先级设置

权限

如果图1、图3

概述：管理谁可以看到此部分的权限。

当没有权限时，显示为只读？：当用户没有上面所选的权限时，以只读的形式显示元素的值。

权限控制文档：权限控制使用说明文档链接

开发备注

概述：对当前分区进行备注，方便识别内容

图1

图2

图3

编辑列

分区下默认为一列，可以进行分列；

属性：

标签
宽
水平布局：元素水平罗列显示；

表单元素

表单元素是一种joget插件类型，可以通过Joget的插件结构进行扩展。表单元素为最终用户提供与之交互的表单输入元素。

属性编辑器中的“ID”和“标签”是大多元素共有的属性，其中ID是唯一标识符，Joget核心会以此ID在数据建立字段，注意：建立字段会在此ID前加“c_”，如图name在数据库字段为 c_name。

详细文档参考链接：表单元素介绍

隐藏字段

与“文本字段”不同，“隐藏字段”不会显示在页面上，而是对用户隐藏。它通常用于传值/设置临时值。

属性：

ID
默认值：找不到现有值时的默认值（接受Hash变量）。

高级选项：

数据优先级：加载数据的优先级。
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

文本字段

文本字段是标准的HTML Input元素。

参考链接：文本字段说明

高级选项：

值：指定默认值（在字段数据库已有值时是不会覆盖数据库的值，优先加载数据库）
最大长度：允许的最大字符长度。
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
加密：对字段进行加密存储。参考：加密使用说明
提示值 (Placeholder)：描述输入字段的简短提示，在用户输入值之前，简短提示会显示在输入字段中。
文本框宽度：设置宽度
只读
只读时以标签方式显示
工作流变量名

数字值格式

格式类型：
- 美国风格：1,000.00
- 欧洲风格：1.000.00
- 选择此选项后，可以进一步定义以下属性
小数点位数：保留小数点后几位
前缀：在输入内容前面加上前缀例如￥100
后缀：在输入内容后面加上前缀例如 100 kg
使用千位分隔符？：是否启用千分位符
存储数值?：应用格式化时，值将按原样存储。您可以选中此选项以删除格式并将其仅存储为数值。

密码字段

密码字段是标准的HTML Input元素，但是输入内容以*号显示。

属性：

ID
标签
值：指定默认值（在字段数据库已有值时是不会覆盖数据库的值，优先加载数据库）
最大长度：允许的最大字符长度。
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
文本框填写宽度
只读
只读时以标签方式显示

多行文本区域

文本区域是通用HTML表单输入元素之一，可以多行输入文本。

属性：

ID
标签
值：指定默认值（在字段数据库已有值时是不会覆盖数据库的值，优先加载数据库）
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
提示值 (Placeholder)：描述输入字段的简短提示，在用户输入值之前，简短提示会显示在输入字段中。
列数：多行本文框的宽例：20 表示20列之后换行
行数：多行本文框的高例：6 表示多行文本框只有六行多出之后出现进度条(在页面可拖动右下角符号调整高度)
只读
只读时以标签方式显示
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

下拉选项

下拉选项是通用的HTML元素

属性：

ID
标签
选项
- 值：存进数据库的值
- 标签：下拉选选项看到的值
- 分组：根据控制分组字段进行分组显示
选择选项绑定器：选项绑定器使用说明
值；默认值，多个时以 ‘ ; ’ 英文分号拼接
多选：勾选后可以选择多个
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
控制分组的字段ID：指定一个字段的ID会根据这个字段进行分组(做级联功能)
显示行数：多选时显示格式需要为整数
只读
只读时以标签方式显示
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

注意

当数据量非常大的时候不建议用，可以替换为弹出式选择

复选框

下拉选项是通用的HTML元素（selectbox）

属性：

ID
标签
选项
- 值：存进数据库的值
- 标签：选选项看到的值
- 分组：根据控制分组字段进行分组显示
选择选项绑定器：选项绑定器使用说明
值；默认值，多个时以 ‘ ; ’ 英文分号拼接
多选：勾选后可以选择多个
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
控制分组的字段ID：指定一个字段的ID会根据这个字段进行分组(做级联功能)
只读
只读时以标签方式显示
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

参考下拉选项视频说明

单选项

下拉选项是通用的HTML元素（radio）

属性：

ID
标签
选项
- 值：存进数据库的值
- 标签：选选项看到的值
- 分组：根据控制分组字段进行分组显示
选择选项绑定器：选项绑定器使用说明
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
控制分组的字段ID：指定一个字段的ID会根据这个字段进行分组(做级联功能)
只读
只读时以标签方式显示
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

参考下拉选项视频说明

日期选择

通过日期选择器库扩展了普通文本字段的功能。

文档地址：日期选择元素详细说明

属性：

ID
标签
允许手工输入：勾选后可以手动输入
字段类型：
- 仅限日期：选择范围 - 年月日
- 日期和时间：选择范围 - 年月日时分
- 仅时间：选择范围 - 时分
值：指定默认值（在字段数据库已有值时是不会覆盖数据库的值，优先加载数据库）
数据存储格式：存到数据库的格式（Java日期格式如：yyyy-MM-dd）
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
最小日期字段（默认不能小于该日期）：指定一个日期字段作为最小值；选择后可选范围不小于指定字段
最大日期字段（默认不能大于该日期）指定一个日期字段作为最大值；选择后可选范围不大于指定字段
设置当前日期为：
- 最大日期：选范围不大于当前日期
- 最小日期：选范围不小于当前日期
提示值：描述输入字段的简短提示，在用户输入值之前，简短提示会显示在输入字段中。
显示格式：显示格式使用jQuery日期语法如：yy-M-dd显示为2019-10-23
日期年份范围：候选日期范围的年份格式为正负各多少年
只读
只读时以标签方式显示
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

文件上传

上传文件到表单

详细文档链接：文件上传详细文档

文件存储位置：[Joget安装目录]/wflow/app_formuploads

属性：

ID
标签
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
单个文件最大值：例 2048 代表2M
错误信息(文件超出最大限制)：自定义文件超出最大限制时的提示信息
文件类型：指定可以上传的文件类型多个以英文分号拼接文件后缀
错误信息(文件类型不匹配)：自定义文件类型不匹配时的提示信息
当移除或覆盖时, 删除原文件?：终端用户界面点击删除或单个文件上传覆盖后是否删除服务器上的原文件
最大宽度 (px)：如果设置，则在上传之前将图像调整为这些尺寸，如果默认不设置保留文件的原始宽高比
最大高度 (px)：如果设置，则在上传之前将图像调整为这些尺寸，如果默认不设置保留文件的原始宽高比
质量 (最大值 1.0)：设置调整大小后的图像的质量。
方法：默认情况下，它将设置为包含。设置在提供最大宽度（px）和最大高度（px）的情况下应如何缩小图像。
- 容纳
- 修剪
权限：
- 登录用户只有登录用户可见
- 公开
- 客户化自定义权限
  - 权限控制文档：权限控制使用说明文档链接
文件大小：总共可上传的大小
启用多个文件上传：勾选后可以一次上传多个文件
只读
放置区内边距：如图视图的样式调整
作为附件下载：可以作为附件下载

图内边距

子表单

可以在当前表单显示另一个表单，可以是同数据表也可以是不同数据表。

详细文档链接：子表单详细介绍文档

属性：

ID
标签
表单：选择要显示的表单
只读
只读时以标签方式显示
不显示边框：默认不勾选终端用户界面子表单会有个边框，勾选后不显示边框
父表中字段ID(关联子表ID)：数据关联时使用 - 父表上的外键（和关联的子表中的ID主外键关联）
子表字段ID(关联父表ID)：子表中的外键字段
数据绑定器：参见数据绑定器

表格

以表格的形式录入或展示数据

详细文档链接：表格详细介绍文档

属性：

ID
标签：表格的标签
选项
- 字段ID：当前表单数据表除外的另一张数据表的内容
- 标签
只读
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
最小行数：最少添加行数
最大行数：最多添加行数
错误信息：不满足最/小行数或存储异常时的提示
数据绑定器：参见数据绑定器

功能单一，如果是单纯的录入数据不做复杂运算等操作可以使用。

客户化HTML

自定义HTML可用于实现高级表单设计，用于自定义样式或逻辑。

详细文档地址：客户化HTML文档

属性：

id
自定义HTML：书写HTML、CSS、JavaScript、jQuery代码
标签
自动填充保存？切换到自动填充的保存值

注意：

不用写<html>标签
需要模拟字段只读字段只展示当前的某些值时可以在自定义HTML 中写要展示的值在标签中写上标签就可以模拟制度字段的样式

流水码字段

创建基于一个累加数字的环境变量的字段。

详细文档地址：流水码字段详细文档

属性：

ID
标签
环境变量名：指定环境变量的明后才能
格式：流水码格式定义 ? 代表一位数字
隐藏：不在终端用户界面显示
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

企业版插件

多页式表单

在一个页面用导航栏显示多个表单并且可单独保存。

详细文档地址：多页式表单详细介绍文档

属性：

Id
页码
使用AJAX
页码*
- 标签：页面名称选项的形式显示
- 表单：选择该页的表单
- 只读
- 只读时以标签方式显示
- 父表记录子表ID的字段：数据关联时使用 - 父表上的外键（和关联的子表中的ID主外键关联）
- 子表记录父表ID的字段：子表中的外键字段
- 换页时进行验证：勾选后换页会校验当前页表单
当切换页面时部分保存表单：勾选后在换页时只保存当前页的表单
当使用部分保存时，也保存主表单。
显示形式
- 向导式
- 标签式
“上一页”标签：自定义上一页的标签
“下一页”标签：自定义下一页的标签
只在最后一页启用提交按钮？：勾选后开启
CSS：自定义css

自动补全选择

允许您选择使用模糊搜索行为的选择框。特别是当有很长的选项可供选择时。根据用户输入显示选项。

详细文档地址：自动补全选择详细说明

参考下拉选项说明

弹出式选择

弹出式选择是点击选择后弹出列表选择内容，为了避免大量数据影响下拉框加载效率。

详细文档链接：弹出式选择详细说明文档

属性

Id
标签
数据列表：选择一个列表供选择
显示字段：选择后需要显示的内容，输入一个列表的字段id
默认值
ID字段：数据列表的ID，默认为id如果需要存的不是id则自定义一个字段作为存到数据库的值
多选
数据列表URL请求参数：弹出列表时传入的参数
- 参数：列表上的参数
- 字段id：当前表单上的字段id，不必填
- 默认值：自定义值，不必填
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
只读
只读时以标签方式显示
“选择按钮”标签：自定义选择按钮
弹出对话框高度：弹出的列表对话框高度
弹出对话框宽度：弹出的列表对话框宽度
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

自动计算字段

可以对一组字段做计算

详细文档地址：自动计算字段详细文档

属性：

Id
标签
变量
方程式
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
格式类型：
- 美国风格：1,000.00
- 欧洲风格：1.000.00
- 选择此选项后，可以进一步定义以下属性
小数点位数，保留小数点后几位
前缀：在输入内容前面加上前缀例如￥100
后缀：在输入内容后面加上前缀例如 100 kg
使用千位分隔符？：是否启用千分位符
存储数值?：应用格式化时，值将按原样存储。您可以选中此选项以删除格式并将其仅存储为数值。
隐藏
显示为标签
工作流变量名：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

表单验证码

随机生成验证码，每个验证码有十分钟有效时长

详细文档地址：表单验证码详细说明文档

属性：

Id：元素Id，不会在数据库生成字段
标签

签名

生成一个可以手写签名的画板

详细文档地址：签名详细说明文档

属性：

ID
标签
加密：加密存到数据库
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
宽度：画板宽度
高度：画板高度
只读

时间选择器

选择时间

详细文档地址：时间选择器详细文档

属性：

ID
标签
值：默认值，支持hash变量
24小时制：勾选后为24小时制
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
只读
只读时以标签方式显示
工作流变量：如果表单时流程上的表单则可以定义一个工作流变量在流程中使用。

AJAX子表单

通过将监听器监听到另一个表单字段，灵活地动态加载子表单。

详细文档地址：AJAX子表单

属性：

ID
标签
表单：选择要显示的表单
当父表字段值变化时更新子表单：动态根据福表单值变化加载对应内容
只读
只读时以标签方式显示
不显示边框：默认不勾选终端用户界面子表单会有个边框，勾选后不显示边框
可显示或隐藏：勾选后子表单生成一个收起展开的按钮，可以隐藏子表单
展开时的标签：表单显示时的隐藏按钮标签
收缩时的标签：表单隐藏时的展开按钮标签
默认为展开：勾选后默认显示子表单
无值时隐藏：表单没有值时默认隐藏表单
隐藏时，不加载子表单：隐藏时后台不加载子表单，提高父表单加载速度
父表中字段ID(关联子表ID)：数据关联时使用 - 父表上的外键（和关联的子表中的ID主外键关联）
子表字段ID(关联父表ID)：子表中的外键字段
数据绑定器：参见数据绑定器

图片上传

上传图片到表单，可以根据设置大小来显示图片

详细文档链接：文件上传详细文档

文件存储位置：[Joget安装目录]/wflow/app_formuploads

属性：

ID
标签
启用多个文件上传：勾选后可以一次上传多个文件
只读
放置区内边距：参考文件上传附图
宽：页面图片显示的宽度
高：页面图片显示的高度
创建缩略图：确定元素是否将创建缩略图，并在上传图像后将其显示在上传文件元素下方
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
单个图片最大值：例 2048 代表2M
错误信息(文件超出最大限制)：自定义文件超出最大限制时的提示信息
图片类型：指定可以上传的文件类型多个以英文分号拼接文件后缀
错误信息(文件类型不匹配)：自定义文件类型不匹配时的提示信息
当移除或覆盖时, 删除原文件?：终端用户界面点击删除或单个文件上传覆盖后是否删除服务器上的原文件
最大宽度 (px)：如果设置，则在上传之前将图像调整为这些尺寸，如果默认不设置保留文件的原始宽高比
最大高度 (px)：如果设置，则在上传之前将图像调整为这些尺寸，如果默认不设置保留文件的原始宽高比
质量 (最大值 1.0)：设置调整大小后的图像的质量。
方法：默认情况下，它将设置为包含。设置在提供最大宽度（px）和最大高度（px）的情况下应如何缩小图像。
- 容纳
- 修剪
权限：
- 登录用户只有登录用户可见
- 公开
- 客户化自定义权限
  - 权限控制文档：权限控制使用说明文档链接

富文本编辑器

提供了用于在Web浏览器中编辑富文本的界面，该界面向用户显示“所见即所得”（WYSIWYG）编辑区域。

详细文档地址：富文本编辑器详细说明文档

属性：

ID
标签
编辑器
- TinyMCE
- Quill
模式
- 简单
- 完整
- 行内编辑(仅Quill时)
启用与行内编辑之间的切换
Placeholder：描述输入字段的简短提示，在用户输入值之前，简短提示会显示在输入字段中。
值：默认值
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
只读
高度(px) ：文本框的高度
权限(图像上载)：具体参见高级工具详细介绍文档

注意

在邮件中需要显示富文本字段中的图片时，需要将图片上载中的权限选为公开，且在调用 hash 变量时需要在变量中加入 img2base64 转义

例如：#form.testPicEmail.test?img2base64#

高级表格

高级表格元素模仿原始字段类型，以提供准确和丰富的数据输入功能。

详细文档地址：高级表格详细说明文档

属性：

Id
标签
表单：罗列的字段所在的表单
列：定义列表要显示的信息
查找：在表格数据本身内启用搜索功能。
只读
禁用新增功能：禁止新增行
禁用删除功能：禁止删除行数据
默认排序列数（从1开始）
删除确认信息：删除行时的提示信息
显示行数：表格左侧显示当前行数
保存键：用于爆粗您当前表格的按键
编辑提示信息：在表格下方对于表格的说明内容
每页记录数：定义后超过的会在下一页显示
翻页数量：定义每页的显示数量
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
唯一列：选择一列作为唯一列，作用：此列不可重复
最少行数校验(整数)：最少需要填多少行
最多行数校验(整数)：最多增加多少行
错误信息：不符合最少/多行数校验(整数)时的提示信息
数据绑定器：参见数据绑定器

表单表格

通过引用另一个表单页面捕获数据并在当前表单以表格显示

详细文档地址：表单表格信息说明文档

属性：

Id
标签
表单：选择用来新增/编辑数据的表单
列：需要在表格上显示的字段(表格不显示的表单字段也会存值)
启用排序功能
表单提交按钮标签(正常模式)：可编辑弹出框的提交按钮标签
表单提交按钮标签(只读模式)：只读弹出框的提交按钮标签
只读时以标签方式显示
弹出对话框高度
弹出对话框宽度
禁用新增功能：禁止新增行
禁用删除功能：禁止删除行数据
删除确认信息：删除行时的提示信息
显示行数：表格左侧显示当前行数
分页大小：定义后超过的会在下一页显示
最少行数校验(整数)：最少需要填多少行
最多行数校验(整数)：最多增加多少行
错误信息：不符合最少/多行数校验(整数)时的提示信息
数据绑定器：参见数据绑定器
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)

列表表格

从已有数据(一个列表)中选取数据进行编辑、另存等操作；

详细文档地址：列表表格详细说明文档

属性：

Id
标签
数据列表：选取一个供选择用的列表
列：定义需要在表格显示的列表内容
启用排序功能
用于排序的字段Id：指定用于排序的字段，需要时表格上有的字段
插入按钮标签：弹出框选择数据后的提交按钮标签
用于编辑行的表单：选择编辑数据用的表单
表单提交按钮标签(正常模式)：可编辑弹出框的提交按钮标签
表单提交按钮标签(只读模式)：只读弹出框的提交按钮标签
只读时以标签方是显示
只读
禁用新增功能：禁止新增行
禁用删除功能：禁止删除行数据
删除确认信息：删除行时的提示信息
显示行数：表格左侧显示当前行数
分页大小：定义后超过的会在下一页显示
弹出对话框高度
弹出对话框宽度
验证器：附加一个Validator插件以提交表单时进行验证。(保存草稿时不验证)
唯一列：选择一列作为唯一列，作用：此列不可重复
最少行数校验(整数)：最少需要填多少行
最多行数校验(整数)：最多增加多少行
错误信息：不符合最少/多行数校验(整数)时的提示信息
数据绑定器：参见数据绑定器
Child Form Data Deletion Options
- 删除相关表格（Grid）数据：如果弹出表单具有表格元素，则此选项将删除内部表格数据。
- 删除相关子表单数据：如果弹出表单具有子元素，则此选项将删除子数据
- 删除已上传文件：如果弹出表单包含文件上载元素，则此选项将删除实际上载的文件
- 中断运行中的相关流程：如果存在与已删除行相关的流程实例，则这些选项将中止那些流程实例。
数据列表URL请求参数：定义打开列表时传过去的参数