录入控件
1 - 单行文本
1. 控件介绍
录入单行文本数据。需要绑定实体字段。
2. 控件特性
2.1 绑定字段
可绑定字段数据类型：文本、流水号、长整数。
注意：如果绑定的是长整数类型字段，该控件默认是只读状态，不能录入数据，因为正常情况下长整数对应的是ID，ID是系统生成的且不允许修改。
2.2 校验内容
对输入的内容可以进行是否文本、身份证号码、手机号码、邮箱的校验。
也可以自定义正则表达式、自定义错误提示。
2.3 字数统计
当绑定的文字类型字段时， 可开启显示字数统计，可实时统计录入的字数。
2 - 多行文本
1. 控件介绍
录入多行文本数据，需要绑定实体字段。
2. 控件特性
2.1 绑定字段
可绑定字段数据类型：多行文本。
2.2 校验内容
对输入的内容可以进行是否文本、身份证号码、手机号码、邮箱的校验。
也可以自定义正则表达式、自定义错误提示。
2.3 字数统计
当绑定的文字类型字段时， 可开启显示字数统计，可实时统计录入的字数。
2.4 设置文本框高度
（1）设置固定高度，可配置固定行数。 当内容超过固定高度时，文本框出现滚动条。
（2）动态适应文本高度，可配置最小高度和最大高度。
- 当实际内容小于最小高度时，有有最小高度的行高占位
- 当实际内容大于最小高度小于最大高度，超出部分自适应
- 当实际内容大于最大高度，内部出现滚动条
- 例如，设置最小高度为4行，最大高度为7行。当输入内容小于4行时，仍然会有4行的占位；当输入内容大于4行小于7行，实际高度会自适应；当输入内容大于启航，实际高度为7行，文本框内出现滚动条。
2.5 设置文本内容的行数
默认情况下不限制文本内容的行数，也可限制文本内容的行数。
如果要限制文本内容的字数，可以通过设置最大长度或最小长度。
3 - 数字
1. 控件介绍
录入整数和小数，需要绑定实体字段。
2. 控件特性
2.1 绑定字段
可绑定字段数据类型：小数、整数、长整数。
2.2 设置显示格式
如果绑定的是小数，可配置显示格式：百分号、千分号、千位分隔符
如果绑定的是整数， 可配置显示格式：千位分隔
2.3 设置小数位数
可设置页面上控件的小数位数。
注意：实体中可设置字段的小数位数，页面上可设置控件的小数位数，保存后，数据库会按实体的小数保存数据，当控件小数位数超过实体小数位数时，会截断后保存，不会做四舍五入。但渲染页面时，会按控件的小数位数显示，即当后端数据位数小于控件位数时，控件渲染时会自动补零。
2.4 值为0时不显示
使用场景：
（1）当录入数字是0时，希望查看或编辑数据时显示为空
（2）当未录入数据，保存数据，希望查看或编辑数据时显示为空。
以上两个场景，可以开启“值为0时不显示"。
2.5 进度条样式
数字控件还可以展示成进度条的样式，
注意：使用进度条样式，需要设置最小和最大值，进度条在最小值和最大值的区间内拖动。
2.6 设置单位
当展示样式为数值，支持输入单位。
4 - 货币
1. 控件介绍
录入金额数据，需要绑定实体字段。
2. 控件特性
2.1 绑定字段
可绑定字段数据类型：货币
2.2 显示大写金额
录入数字后，失焦将显示为金额大写
2.3 设置小数位数
可设置页面上控件的小数位数。
注意：实体中可设置字段的小数位数，页面上可设置控件的小数位数，保存后，数据库会按实体的小数保存数据，当控件小数位数超过实体小数位数时，会截断后保存，不会做四舍五入。但渲染页面时，会按控件的小数位数显示，即当后端数据位数小于控件位数时，控件渲染时会自动补零。
2.4 值为0时不显示
使用场景：
（1）当录入数字是0时，希望查看或编辑数据时显示为空
（2）当未录入数据，保存数据，希望查看或编辑数据时显示为空。
以上两个场景，可以开启“值为0时不显示"。
5 - 日期
6 - 时间
7 - 日期区间
8 - 参照
1. 控件介绍
参照控件用于在当前页面中引用实体数据。控件需要绑定实体类型的字段，参照控件只能引用这个实体字段关联实体的数据。
2. 使用场景
场景举例：在费控应用中，成本中心、费用报销单是两个实体，在填写费用报销单时需要选择成本中心， 选择后在控件中回显成本中心名称。 选择成本中心就是使用参照控件。
3. 控件特性
3.1 绑定字段
可绑定字段数据类型：实体
参照单选或多选：绑定的字段如果是多选，那么该参照控件可选择多条数据，否则只能单选。可在实体的字段列表中确认配置的是否多选。
3.2 选择参照方案
3.2.1 选择参照方案
参照方案实质是数据查询方案。参照控件绑定参照方案，运行态可以选择该参照方案查询的数据。
每个实体可以创建多个参照方案。请查看参照方案的详细介绍
参照控件只能选择绑定字段关联的实体的参照方案。比如参照控件绑定了字段“采购物品"，该字段关联了实体"物品"，那么参照控件可选到实体“物品"的参照方案。
当关联实体创建了多个参照方案，此处会默认使用第一个参照方案，可以手动选择其他方案。也可以点击”新建"跳转到实体中创建参照方案。
3.2.2 页面自定义参照方案
点击选择参照方案旁边的
自定义参照方案说明：
- 自定义参照方案仅当前参照控件可用，而实体中创建的参照方案是整个应用中都可以使用。
- 生成自定义参照方案，并不会对原实体的参照方案产生影响。
- 参照方案名称后有”自定义"标识，表示是自定义参照方案。
- 在PC转移动时，自定义参照方案不会转换。
- 在属性区修改参照显示字段、参照下拉字段，实际和进入弹窗修改是一样的，该参照方案会自动变成自定义参照方案。
3.3 参照显示字段
参照显示字段是指选择了参照数据后，回写到控件中的字段。
默认使用该参照方案中配置的显示字段，也可以在控件中自定义。
3.4 参照下拉字段
参照下拉字段是指选择参照数据时，下拉框中显示的数据。未设置时默认使用参照显示字段。
举例：下图中，设计态参照控件的下拉字段配置的是商品编号、商品名称两个字段。
运行态，可以看到下拉框中显示的是商品编号和商品名称。
3.5 参照携带
3.5.1 使用场景
参照携带是指将关联实体的某些数据带到页面控件中。
场景举例1：报销单中选择报销人，希望在其他控件中展示报销人的所属部门和所属岗位。
场景举例2：请购单中选择请购物品，希望在其他控件中展示物品编号和物品分类。
3.5.2 配置说明
（1）选择携带到控件
携带到控件是指将数据携带到当前页面中的哪个数据控件中。
可选范围：当前参照控件所在的数据控件和下一级数据控件（不是绑的孙实体及以下实体)。
举例说明：页面中有单一记录绑定主表，有重复表绑定子表，重复表就算是下一级数据控件。如果参照控件在单一记录中，那么可以往单一记录和重复表中携带数据； 如果参照控件在重复表中，那么只能往重复表中携带数据。
（2）携带映射
左侧：关联实体、关联实体的上级实体、关联实体的下一级实体的字段。
右侧：携带到数据控件中的子控件
将左侧数据携带到右侧控件中。比如将物品信息实体中的编码，携带到页面中的物品编码[单行文本]。
（3）携带映射匹配规则
参照映射时，左右值类型必须匹配，平台已做了自动过滤：
- 右侧可选项必须匹配左侧的数据类型，平台已经做了自动过滤。
- 左侧枚举、选项集、实体类型字段只能映射给右侧绑定了相同枚举、选项集、实体的控件。
- 左侧数据多选的字段不能映射给右侧数据单选的控件。
- 当前参照控件多选且要同级携带（同级携带是指参照控件在要携带到的数据控件中），左侧字段类型只能是文本、实体、长整数。
（4）携带映射条件
参照携带支持条件配置，当满足条件时才会执行。
如下图：携带到控件这里可配置映射条件，单条映射也可以配置条件。前者是前置条件，如果都无法满足，不会执行后面的单条映射。
当需要携带的控件很多时， 我们提供了自动映射功能，会根据左右值类型匹配规则做自动映射。
自动映射时，需要选择映射来源实体（关联实体、关联实体的上级实体、关联实体的下一级实体)， 默认是关联实体。
自动映射时，如果发现右值的控件已经配置了映射，可以选择保留已有的映射或者覆盖已有的映射。
3.6 选多个插入多行
使用场景：参照单选，且在重复表中。运行态支持选择多条数据，在重复表中插入多行，插入时可复制上一行的内容。
前置条件：参照单选，且在列表中。
配置方式：开启属性“允许选多个插入多行"，如果插入行时复制当前行其他列的数据，可以开启属性“插入行时复制当前行"。
运行态效果：
3.7 清空携带
使用场景：主表中选择参照，并携带数据到子表的多记录控件中。
开启“清空携带"：表示修改参照，清空之前携带到多记录控件的数据。
不开启“清空携带"：表示修改参照，不清空之前携带到多记录控件的数据，继续追加携带数据。
注意：清空携带是前端行为，如果携带数据已经保存，修改参照是不会清空携带数据的。
运行态效果如下：修改进货商品，删除之前已经携带的内容。
3.8 删除标识
当开启后，参照控件已选项后有“X"删除图标；如果不开启, 可通过快捷键delete删除
3.9 仅显示参照图标
参照控件配置中，可以设置开启仅显示参照图标，打开后，参照控件隐藏，仅图标显示。
9 - 下拉
使用场景
主要用于选择数据项。
数据源
只能绑定枚举、选项集类型字段。
下拉选择是单选还是多选，是根据绑定的字段的属性决定的，如下图，如果在实体中枚举类型字段勾选了多选， 则绑定了该字段的下拉控件就可以多选。
控件特性
标签显示
仅当控件绑定的数据源是选项集类型字段时可设置。
必须选择末级节点
仅当控件绑定的数据源是枚举类型字段时可设置，只能选择末级节点。
显示路径
仅当控件绑定的数据源是枚举类型字段，且为多级枚举时可设置，比如选择高新区时，显示效果为：四川省/ 成都市/高新区
自定义范围
1.支持自定义选择范围，全部可选，或自定义可选范围或不可选范围，支持表达式。不可选的选项在运行态是默认隐藏不显示， 也可以配置为显示但禁用效果。
2.下拉控件在值操作节点中自定义可选或不可选范围时，支持选择前序节点出参， 支持表达式。
（1）枚举支持的前序节点出参数据结构为：文本、文本list、长整数、长整数list ，实体对象中的枚举。
选项集支持的前序节点出参数据结构为：实体对象中的选项集。
（2）支持表达式
（3）当前序节点传入的选项和正常选项有差异时，不可选范围不受影响， 可选范围是传入选项和正常选项取交集
10 - 开关
11 - 单选
使用场景
主要用于数据项单选。
数据源
只能绑定枚举、选项集类型字段。
控件特性
设置多种显示样式
横向排列、纵向排列、胶囊按钮（移动端无该样式）
自定义选择范围
1.属性设置中可自定义选择范围，全部可选，或自定义可选范围或不可选范围，支持表达式。不可选的选项在运行态是默认隐藏不显示，也可以配置为显示但禁用效果。
2.单选控件在值操作节点中自定义可选或不可选范围时，支持选择前序节点出参， 支持表达式。
详细请看下拉控件值操作自定义范围。
一键全选
开启后，支持一键全选，可一键勾选所有可选项。
12 - 多选
使用场景
主要用于数据项多选。
数据源
只能绑定枚举、选项集类型字段。
控件特性
设置显示样式
横向排列、纵向排列。
自定义可选范围
1.属性设置中可自定义选择范围，全部可选，或自定义可选范围或不可选范围，支持表达式。不可选的选项在运行态是默认隐藏不显示，也可以配置为显示但禁用效果。
2.单选控件在值操作节点中自定义可选或不可选范围时，支持选择前序节点出参， 支持表达式。
详细请看下拉控件值操作自定义范围。
13 - 附件
1. 控件介绍
附件控件主要用于文件上传、下载、预览等。需要绑定实体字段。
2. 控件特性
2.1 基础
2.1.1 绑定字段
可绑定字段数据类型：附件
绑定的字段如果是多选，那么该附件控件可上传多个文件， 否则只能上传一个。
可在实体的字段列表中确认配置的是否多选。
2.1.2 设置控件样式
附件控件提供4种样式：上传按钮、照片墙式、拖拽区域式、照片列表式。 还可以修改上传按钮的文字、图标、按钮样式。
设计态效果如下：
运行态效果如下：
补图
2.1.3 控件样式适配列表
使用场景：在列表中，希望附件控件只占单行。
配置：开启适配列表
样式效果：
2.2 设置
2.2.1 设置附件表格样式
使用场景：希望上传后的文件展示成表格样式。
在表格样式中会展示上传附件的附件名称、附件大小、上传时间、上传人、上传人部门，最后一列为附件的操作列，比如预览、下载、删除等操作，操作列可配置显示为仅文字、仅图标、文字+图标。
配置如下：
设计态效果：
2.2.2 设置附件个数和大小
当绑定的附件字段是多选时，可以配置上传附件的个数上限，在运行态上传文件时会做校验提示。
可以配置单个附件文件的大小。配置如下：
2.2.3 设置附件文件类型
可以限制可上传文件的类型， 图片、视频、文件，也支持自定义格式。
以下是各种类型支持文件格式。
图片：.jpg,.jpeg,.png,.gif
视频：.mp4,.rmvb,.avi,.wmv,.mov
文件：.docx,.doc,.pptx,.ppt,.pdf,.txt,.xlsx,.ofd
配置如下：
2.2.4 设置附件模板
使用场景： 设计态搭建应用时上传附件文件，终端用户只是下载和查看文件。
配置如下：
小技巧：在属性区上传附件模板文件，选中文件可以拖动调整文件排序。
设计态配合了附件模板后的效果：
运行态效果：
补图
2.2.5 设置隐藏内容
隐藏文件信息课勾选隐藏附件大小、上传时间、上传人、上传部门，勾选后运行态隐藏对应信息。
2.3 附件操作
2.3.1 附件下载支持水印
水印范围可选择跟随系统和无水印。
跟随系统：跟随平台的水印设置，包括场景、水印内容和样式。
2.3.2 设置附件批量操作
（1）批量上传：
- 本地选中多个文件，批量上传
- 开启上传文件夹，本地选中文件夹，批量上传文件夹中的文件。
-
（2）批量删除：开启批量删除的开关，可选中多个已上传的文件进行批量删除。
（3）批量下载：开启批量下载的开关，可选中多个已上传的文件进行批量下载。如果文件是多个，会打包下载，可设置打包文件的文件名。
（4）批量设置密级：开启批量设置密级的开关，可选中多个已上传的文件进行批量设置密级。
2.3.3 转PDF下载
附件支持转PDF下载，输入需要转PDF下载的文件格式，多个以英文逗号分隔（如doc,txt,docx），在文档下载时会将指定格式的文档转为PDF下载。
2.3.4 预览时可复制
开启预览时可复制后，运行态文件预览时支持复制内容。
2.3.5 附件重命名
开启后，对于运行态上传的附件文件，上传人可以对已上传的附件进行重命名操作。
2.4 附件操作控制
针对附件文件，可执行扫码上传、本地上传、下载、预览、删除、编辑、设置密级等操作。
可根据实际业务需求，控制这些操作的状态（正常、禁用、隐藏），支持条件表达式。
注意：目前只有WPS(V6)通道可编辑文件。
2.4.1 操作权限控制
开启后，在【角色权限】中可以给角色授权附件“扫码上传、本地上传、下载文件、预览文件、删除文件”等操作权限。
注意：角色权限中授权仍然会遵循控件状态优先级比较。
2.4.2 附件编辑
集成平台提供通道支持，对授予了文档编辑权限的附件，支持在线编辑。
设计态编辑文件默认隐藏，点击改为正常即可在运行态进行附件在线编辑。
运行态:
2.4.3 密级设置
附件开启了密级设置，在运行态上传附件，可以设置密级属性
运行态附件使用时，根据系统三员的总体规则配置，控制那些用户最终权限，如：低密级人员不允许查看高密级附件
运行态:
2.5 设置附件控件状态
附件的控件状态实际控制的是附件操作，对应关系如下表：
| 附件控件状态 | 操作状态 |
|---|---|
| 附件正常 | –操作项正常：预览、下载、删除、设置密级 –操作项隐藏：编辑 |
| 附件只读 | –操作项正常：预览、下载 –操作项隐藏：删除、上传、编辑、设置密级 |
| 附件禁用 | 所有操作项禁用 |
| 附件隐藏 | 整个控件隐藏 |
注意：附件的操作状态是可以单独配置状态的，在2.7中已经说明。那么最终运行态的操作究竟是什么状态呢？
前文中我们已经说明过，当控件嵌套控件时，当前控件会受上级控件状态的影响，两种会比较状态的优先级（正常<只读<禁用<隐藏），决定当前控件最终运行时是什么状态。
所以，附件控件状态下对应操作的状态， 会和该操作本身配置的状态做比较，决定该操作最后运行时的状态。
比如：附件控件只读时，预览和下载默认是正常的。 如果设计态单独将预览和下载设置为禁用， 因为禁用优先级高于正常，所以，在运行态看到的效果是预览和下载是禁用的。
特别说明：以上只是为了给大家介绍背后的逻辑， 实际搭建时，只需要调整附件控件的状态，该状态下操作的状态是满足绝大多数场景的，不用单独再去配置某个操作的状态。只有不满足场景需求时，再单独调整操作的状态。
- 功能权限：开启后，在【角色权限】中可以给角色授权该控件
2.6 附件预览打印
运行态附件支持预览打印。
