业务场景：

表单表单员进行设置表单如请假单的时候，需要使用到日期控件等。控件属性用于定义控件在当前表单中的特性，比如控件标题的显示位置，是否必输、是否显示在列表或任务标题中等，本文介绍常用的控件。

业务场景分析：

针对该场景，可以在YS系统中进行如下操作来查看：

1. 进入协同云 > 协同服务 > 审批 > 审批设置 > 表单管理；
2. 选中一个控件，在表单设计页面的属性区，点击控件，【控件设置】的页签下则会显示选中控件的属性。

操作步骤：

1、路径：进入协同云 > 协同服务 > 审批 > 审批设置 > 表单管理；

2、在表单设计页面，点击控件，控件设置页签则会显示该控件的属性。

控件的基本属性：

1、大部分控件具有一些相同的属性，我们称这些属性为基本属性。如下图中的基本设置，像标题、必填、标题在左边、隐藏标题、框内提示语等。

1. 标题： 是控件的名称，默认显示控件的类型，可以修改。
2. 隐藏标题： 设置运行态是否显示控件的标题。默认不勾选，勾选后显示控件的标题。
3. 标题在左边： 定义运行态控件标题文字的显示位置，在输入框的上方或左边，默认不勾选，标题显示在输入框的上方；
4. 在列表或任务标题中显示： 定义控件在表单的列表或工作台的任务标题中是否显示；默认不显示，列表界面不显示；
5. 框内默认提示语： 定义运行态显示在控件输入框内的提示性文字，默认为空；
6. 必填： 定义运行态控件的值是否必填，默认不勾选，保存时不会做必输的校验；
7. 只读： 定义运行态控件是否可编辑，默认不勾选。

2、拖入子表的控件，还会有一些特殊的属性，比如隐藏，是拖入子表控件的特有属性，控件拖入子表布局后，在“基本设置”中会出现这个属性，用于设置运行态子表需要隐藏的列。默认不勾选，子表显示。

3、控件样式中会涉及到控件间距设置、标题文字设置、输入框颜色和尺寸的设置。

1. 标题字体设置： 设置运行态控件标题文字的字号、字体及对齐方式，默认普通13号字，左对齐；
2. 尺寸： 定义运行态控件在布局中显示的大小，大、中、小分别对应控件布局占位的100%、75%和50%，默认为大；
3. 输入框颜色： 定义运行态控件输入框的颜色。

常用控件的属性：

1．数值/金额

数值和金额控件是两个具有计算能力的控件，位于主表和位于子表时的属性略有差异。下面以金额控件为例来查看其属性。

（1）控件在主表时的属性如下图所示：

小数位数： 金额控件0-2位小数，可修改，默认2位；

数值控件0-8位，可修改，默认2位；

显示金额大写： 金额控件独有，将金额控件的数据转换为中文大写显示；

计算： 金额和数值控件的特有属性。用于定义控件的值是否通过计算得出。默认不勾选；

默认值： 控件的默认取值；

最大值： 控件的最大取值；

最小值： 控件的最小取值；

若勾选了计算，系统提供两种公式的定义方式：快速定义和编辑公式。

快速定义适合于定义比较简单的四则运算，比如“金额=数量*单价”之类的。而编辑公式适用于比较复杂的场景，通过公式编辑器，使用条件、函数、运算符、字段等配置复杂公式，实现客户需求。

（2）控件在子表时的特有属性如下图：

列运算： 金额和数值控件的特有属性，控件放到明细子表中出现。用于计算数值/金额列的合计、最大值、最小值、平均数或行数统计。默认不勾选。勾选时默认计算列合计。

主表控件： 因为子表的列运算的结果是一个计算值，在表单上不会单独保存，但当有主表上需要显示子表的列合计的需求时，需要将这个合计值传到主表某个数值/金额字段上时，需要选择主表字段。待选值为主表上没有定义公式的数值/金额控件。

子表中显示合计： 金额和数值控件的特有属性，控件放到明细子表中出现。用于定义子表在进行列运算时，显示运算结果的合计行是否显示，默认勾选，显示合计行。

2．选项

选项控件是表单中常用的一个控件，用于显示布尔值、从多个待选值中选择其一，或者从多个待选值中选择多个等，多用于调查问卷。

1. 排列方式： 选项的展现样式：下拉/平铺，默认下拉。当选项位于明细子表时，不提供平铺样式。
2. 列表选项： 选项值的设置，提供快速编辑功能。
3. 其他： 当风格为平铺时，提供其他选项，即当设置选项值都不符合时，可以勾选其他，再填写原因。
4. 权限设置： 通过选项的取值来控制表单中的控件显示或隐藏，目前仅支持单选，多选时不支持。
5. 计算： 通过公式设置，实现自动获取选项值的功能。比如当选择的日期为周一至周五时，“日期类型”显示工作日，当选择的日期为周六或周日时，显示休息日。默认不勾选。

3．日期

日期控件是表单中常用的一个控件，用于显示日期。

日期控件的属性如下图所示：

1. 显示格式： 提供四种显示格式：年月日、年月、年月日时分和中文格式的年月日。默认年月日。
2. 最早日期： 日期控件的最早值；
3. 最晚日期： 日期控件的最晚值；
4. 系统时间： 显示当前系统时间；
5. 计算： 提供公式编辑器，用于日期的计算。默认不勾选。

当日期控件在子表时会有下面的属性：

1. 列运算： 按日期字段进行行数统计，提供去重和不去重两种方式。
2. 主表字段： 因为子表的行数统计的结果是一个计算值，在表单上不会单独保存，但当有主表上需要显示子表的行数统计的需求时，需要将这个行数值传到主表某个数值/金额控件上时，需要选择主表字段。待选值为主表上没有定义公式的数值/金额控件。
3. 子表中显示行数统计： 日期控件放到明细子表中出现。用于定义子表在进行行数统计时，显示运算结果的合计行是否显示，默认勾选，显示合计行。

4．日期差

日期计算控件，不同显示格式的日期之间可以计算，结果按选择的单位显示。

位于明细子表的日期差控件，同样会提供行数统计的列运算。

日期差的属性如下图所示：

1. 取值： 日期差的定义。当第一个日期小于第二个日期时，取值为负数 。默认为日。
2. 单位： 定义计算结果的显示单位。当两个日期的显示格式不同时，系统会自动转换计算，计算结果为“第一个日期-第二个日期+1”日（时、分）。

5．附件

附件控件用于上传图片或文件附件，可上传一个或多个，可控制附件上传的大小。

附件的属性如下图所示：

1. 可以上传多个附件： 默认不勾选，只能上传一个附件。勾选后可上传多个。
2. 图片附件： 是否仅上传图片附件，勾选了该选项后，运行时只能上传图片，以图片的方式展现。设置仅上传图片附件后，可以上传默认图片及设置只读属性。
3. 默认附件： 相当于预置文件，填写态默认显示。
4. 附件大小设置： 用于限制上传文件的大小。定义后，上传的文件不能超于设置的最大值，也不能小于设置的最小值。

6．用户

用户控件在表单设计中是一个非常常用的控件。当表单中涉及到填写系统内的预置的用户时均可使用。可以显示部分或全部的用户，在使用上可选择单个或多个用户。

用户控件的属性如下图所示：

1. 当前用户： 取当前登录用户。与只读属性联合使用，实现填单时自动取当前登录用户且不可编辑的功能，可取代原来制单人控件提供的功能。
2. 制单部门负责人： 取制单人部门负责人。
3. 制单人上级主管： 取制单人的上级主管 。
4. 制单人上级部门负责人： 取制单人的上级主管的部门负责人。
5. 部分数据： 按定义的范围取用户。提供按我的部门、我的组织、指定范围三种方式。其中还可以定义是否包含所有下级，即仅查一级，还是所有层级均查两方式。指定范围包括：指定用户、指定组织、指定岗位、指定职务和指定用户组。

7．部门

部门控件在表单设计中是一个非常常用的控件。当表单中涉及到填写系统内的组织/部门信息时均可使用。可以显示部分或全部的部门，在使用上可选择单个或多个部门。

1. 制单人所在部门： 取当前登录人所在部门。与只读属性联合使用，实现填单时自动取当前登录所在部门且不可编辑的功能，可取代原来制单人所在部门控件提供的功能。
2. 制单人所属组织： 取当前登录人所属组织。
3. 上级主管部门： 取当前登录人的上级主管部门。
4. 自动填充上次已提交数据： 部门控件支持设置“自动填充上次已提交数据”默认值，方便用户提交数据。
5. 选择范围： 部门/组织/部门&组织：定义部门控件显示的数据范围是仅显示部门、仅显示组织、或者是组织部门均显示。
6. 部分数据： 按定义的范围取部门。提供按我的部门、我的组织、指定范围三种定义范围。其中还可以定义是否包含所有下级，即仅查一级，还是所有层级均查两方式。指定范围包括：指定部门、指定组织。

8．自动编号

自动编号控件是表单设计中的一个常用控件。当表单涉及到自动编号时使用。

组成自动编号的元素包含常量、时间、字段（包括文本、选项）和流水号。时间和流水号在一个规则内只能出现一次，支持断号不补零和起始编码的设置。

自动编码控件的属性如下图所示：

如勾选流程结束编号，则在整个流程审批完成后才出现表单编号。

9．审批意见

审批意见控件是关联流程的表单中经常使用的一个控件。当审批人办理时的意见需要体现在单据上时使用此控件。

审批意见的属性如下图所示：

1. 审批环节： 指定一个或多个流程环节，将环节的审批意见回写到审批意见控件里。不能为空。
2. 意见格式： 系统提供了审批结果、审批意见、审批人、审批人所在部门、审批时间、审批日期、审批日期（中文）、审批时间（中文）八个设置项，在定义意见格式的时候，选择需要的进行拼接。
3. 追加方式： 追加/覆盖。当选了多个审批环节时，或者一个环节有多人审批时，需要定义多条审批意见之间是追加显示还是覆盖显示。默认为追加。
4. 排序方式： 升序/降序。当选了多个审批环节时，或者一个环节有多人审批时，再或者是有驳回撤回需要重复审批时，多条审批意见之间的显示顺序是按升序还是降序显示。
5. 重新审批时意见覆盖： 驳回后再提交，审批意见显示一次还是显示多次的设置。
6. 签名尺寸： 改变打印模板中签名图片的大小。默认90*65，修改后按修改后的大小显示。
7. 可接收推送数据： 用于设置数据推送中推送的审批意见的显示。默认不勾选，勾选后不会再校验审批环节不能为空。

10．关联

关联控件，在表单设计中使用非常频繁的一个控件。使用关联控件，可以关联到系统内的档案表单和当前表单相关的业务单据（比如报销单可以关联到之前的借款单）。

关联控件的属性如下图所示：

1. 选择要关联的表单或对象： 设置关联的表单。可选择审批的系统表单（系统）、自定义的可以被其他表单关联引用的表单（表单）、业务建模生成的单据（查询）以及集成的第三方系统中的单据（第三方）。
2. 关联的表单的字段显示范围： 设置表单上关联控件上显示的内容；
3. 待选字段： 设置关联控件选择时的弹出窗中，待选数据的显示字段。
4. 关联子表： 关联控件默认关联的主表上的数据。勾选关联子表后，可以将关联表上的子表数据关联到当前表中。支持三种场景的子表关联。
5. 允许新增： 设置关联控件选择数据时，在关联的待选数据窗口是否可以新增数据。
6. 设置联动控件： 设置多个关联控件之间的联动关系，可以和关联、文本、选项进行联动。
7. 自动填充： 提供三种方式的自动填充，默认值、按用户条件填充和按表单字段填充。
8. 部分数据： 默认显示全部数据。勾选部分数据后，可按定义的范围显示数据。支持按来源（我发起的、我部门发起的、指定范围、全部）、按状态（已完成、审批中、已提交、全部）、按条件来显示部分数据。

11．关联字段

关联字段控件，与关联控件配合使用的一个控件，用于显示关联表中的其他字段。

关联字段的属性如下图所示：

1. 选择要关联的表单或对象： 当前表单使用的所有关联控件，
2. 选择字段： 关联表中可显示的字段。

常见问题

Q：如何区分表单中用的是什么控件？

A：目前需对表单控件有一定了解，根据控件属性来判断，可以拉取一个控件对比看出。