开发者中心

本节包括以下主题：

# 通用属性参考

以下列出在各个控件上普遍使用的属性。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
计算公式 计算表达式，运算结果作为控件值
禁用条件 禁用表达式，运算结果为true时控件禁用
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
提示语 提示文本，比如请选择…，请填写...
字段描述 控件填写说明，比如：填写时的注意事项等
必填项 进行非空验证时勾选此项
高级验证 包含：必填验证、业务规则验证、自定义验证

必填验证：可以设置在特定步骤验证、可以根据表单数据动态启用验证

业务规则验证：可以书写规则表达式、可以设置在特定步骤验证、可以根据表单数据动态启用验证、可以设置错误提示

自定义验证：可以调用自定义验证函数、可以设置在特定步骤验证、可以根据表单数据动态启用验证

# 单行文本

单行文本控件是最基础的控件，用于填写文本，数字等信息。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
提示语 提示文本，比如请选择XXX，请填写XXX
字段描述 控件填写说明，比如：填写时的注意事项等
输入类型 普通文本

手机号码

固话号码

固话号码（必须带区号）

电话号码（手机/固话）

邮箱地址

邮政编码

网站地址

身份证号码
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 多行文本

多行文本控件，用于表单中录入多行数据的场景。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
可见行数 默认显示几行
最大可见行数 最多显示的行数
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
提示语 提示文本，比如请选择XXX，请填写XXX
字段描述 控件填写说明，比如：填写时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 日期

日期控件，用于表单选择日期和时间的场景。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
显示格式 时间输入类型

年-月-日(默认值)

年-月

年-月-日 时:分

时:分
字段描述 控件填写说明，比如：填写时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 数字

数字控件，用于表单中数值记录或计算的场景，只允许填写数字。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
提示语 提示文本，比如请选择XXX，请填写XXX
字段描述 控件填写说明，比如：填写时的注意事项等
千分位 显示千位分隔符，可将数字用逗号分开，适用于大的数值
小数位数 可设置数字后的小数点显示几位
显示币种 可设置币种，比如：人民币，美元等，会在数字面前显示对应的货币符号
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 单选框

单选框控件，用于多选一的场景。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
选项/值 选项：显示值

值：数据库中保存的值

删除按钮右侧的拖拽按钮可以调整选项的顺序
排列 单选按钮的排布格式，支持横排、竖排
字段描述 控件填写说明，比如：填写时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 下拉框

下来框控件，用于少量数据选择。可通过设置数据源，动态的呈现下拉列表；也可手动录入选择项。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
数据源 数据源：下拉内容数据源

值列：指定值列

显示列：指定显示列

数据带出：带出数据到表单
选项 选项：显示值

值：数据库中保存的值

删除按钮右侧的拖拽按钮可以调整选项的顺序
提示语 提示文本，比如请选择XXX，请填写XXX
字段描述 控件填写说明，比如：填写时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 是/否

是/否控件，用于表单中进行确认的场景，勾选选项即为是，不勾选即为否，如：是否同意等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值
字段描述 控件填写说明，比如：填写时的注意事项等

# 附件

附件控件，用于表单中上传文件的场景，例如：合同等，该控件对文件格式没有限制，可以对上传附件大小限制，默认10MB。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
文件大小限制（M） 默认10MB，可根据需要设置上传文件的最大限制。
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 图片

图片控件，用于表单中上传图片的场景。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 地址

地址控件，用于表单中选择地址的场景，比如：快递地址、公司地址等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
格式 地址的范围格式，支持：

省-市-县

省-市

省
详细地址 默认开启【显示详细地址】，可以填写除省市县外的详细地址，也可以点击右上角的定位图标，地位当前地址。
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 位置

位置控件，用于用于在移动设备进行定位功能场景，比如：外出考勤等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
限定附近地址 位置限定可选的范围：

勾选：仅限于选择当前地图可见范围内的位置

不勾选：允许任意位置，可选择地图上任一区域的位置
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 人员单选

人员单选控件，用于表单中读取企业组织机构中姓名的场景，如：负责人、离职者等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 人员多选

人员多选控件，用于表单中读取企业组织机构中姓名的场景，如：负责人、离职者等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 部门单选

部门单选控件，用于表单中读取企业组织机构中部门的场景，如：入职部门、调岗部门等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 部门多选

部门多选控件，用于表单中读取企业组织机构中部门的场景，如：入职部门、调岗部门等。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 值列转换

值列转换控件，主要用于根据字段转换存储值和显示值的场景，比如，根据供应商编号，进行值列转换，显示供应商名称。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
值列转换 数据源：设置值列转换使用的数据源

值匹配：要过滤的字段

显示列：要显示的字段

数据带出：要带出哪些字段到表单
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值，值列转换这里一般用其他控件值。
提示语 提示文本，请填写XXX
字段描述 控件上传说明，比如：上传时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 开窗查询（基础字段）

开窗查询控件，通过开窗搜索、选择数据回填表单。

属性名称
 说明
字段名称 控件的显示名，也是存储到数据库的名称
数据源 数据源：开窗数据源

值列：保存到数据库的列

视图：开窗弹出的面板显示哪些字段

数据带出：带出哪些字段数据到表单
值列转换 数据源：设置值列转换使用的数据源

值匹配：要过滤的字段

显示列：要显示的字段

数据带出：要带出哪些字段到表单
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
计算公式 计算表达式，运算结果作为控件值，值列转换这里一般用其他控件值。
提示语 提示文本，比如请选择XXX，请填写XXX
字段描述 控件填写说明，比如：填写时的注意事项等
必填项 进行非空验证时勾选此项
高级验证（扩展） 需要在进行比如：特定步骤验证，业务验证或自定义验证时，启用此项。

# 开窗查询（高级字段）

开窗查询控件，通过开窗搜索、选择数据回填表单。高级字段下面的开窗查询，主要用于明细表中，选择数据，回填到明细表栏位。

属性名称
 说明
按钮文字 开窗按钮的名称，比如：选择物品等
数据源 数据源：开窗数据源

视图：开窗弹出的面板显示哪些字段

数据带出：带出哪些字段数据到表单
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用

# Excel导入

Excel导入控件，用于将Excel中的数据导入到表单中（主要是明细表）。

属性名称
 说明
按钮文字 Excel导入按钮的名称，比如：Excel导入物品列表等
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用
Excel数据列数 Excel中要导入数据的列数
标题行号 数据标题对应的行号
数据开始行 导入的数据从哪一行开始算
数据带出 将Excel列和要填充的明细表列建立对应关系，其中ABC...列表示Excel对应的数据列。

# 按钮

按钮控件，提供一种自定义按钮功能的入口，用户可以根据业务需要，切换源码实现按钮功能。

属性名称
 说明
按钮文字 按钮的名称
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
禁用条件 禁用表达式，运算结果为true时控件禁用

# 分组标题

分组标题，用于表单中的内容块的分割，如：基本信息、入职信息。

# 栅格布局

栅格布局，用于表单中字段布局排列，默认为一行两列。可增减列，不可增减行。

可选中格子，设置格子的长短。

# 表格布局

表格布局，多用于多行列的布局。

默认为一行三列。可增减列，可增减行，可合并单元格。布局更加灵活。

选中整个表格，可设置控件在表格布局中的对齐方式。

# 子表

子表，用于表单中填写数据的格式固定但数据条数不定的情况，如：物料信息等。

属性名称
 说明
字段名称 子表的名称，比如：采购明细
隐藏条件 隐藏表达式，运算结果为true时控件隐藏
空表格 勾选自动增加一行，明细表默认有一行
分页 启用分页：和页行数配合，数据多时，按照页行数分页

页行数：指定一页显示多少行
列锁定 启用列锁定：勾选此项，可进行列锁定

锁定列数：设置此项，可对指定列数锁定
自动带出 数据源：设置数据源

填充：要带出哪些字段到表单

此功能可实现，打开表单即可显示数据源数据在明细表

# 标签页

标签页控件，用于将表单控件分类放入到多个标签中，使页面更易于查看。

一个标签页控件，可添加多个页签。可通过页签前面的拖拽按钮可以调整页签的顺序。

# 描述说明

描述说明，用于表单中说明或提醒的描述，描述说明可以修改显示内容和对齐方式。

属性名称
 说明
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

# 流水号

流水号，系统自动生成字段，根据预设规则生成流水号信息的场景，例如采购单等。

属性名称
 说明
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

# 创建人

创建人，系统自动生成字段，显示提交表单的人，无法修改。

属性名称
 说明
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

# 拥有者

拥有者，系统自动生成字段，表单默认拥有者为当前表单的创建人，可修改。表单的所属部门会自动随着拥有者的改变而改变。

属性名称
 说明
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

# 所属部门

所属部门，系统自动生成字段，表单默认所属部门为拥有者的所属部门。

属性名称
 说明
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

# 创建时间

创建时间，系统自动生成字段，表单提交时间，无法修改。

属性名称
 说明
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

# 拥有者属性

拥有者属性，所属部门是拥有者属性之一，其他属性都在拥有者属性控件上选择，比如职位、员工编号等。

属性名称
 说明
属性名称 包含：

成本中心

员工编号

办公室电话

移动电话

电子邮件

家庭电话

出生日期

性别

入职日期

职位

职级

业务部门名称

部门名称

部门编号

部门类别

账号扩展属性.账号扩展属性

成员扩展属性.成员扩展属性

部门扩展属性.部门扩展属性
隐藏条件 隐藏表达式，运算结果为true时控件隐藏

← 基本功能 →