> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 流水号
> 本文档详细介绍了流水号组件在不同版本中的支持情况，以及如何在表单中设置和使用流水号来生成自动编号。包括了流水号的规则定义、属性配置、重置方法等，并提供了具体的使用场景示例。
| 能力 | 免费版 | 轻享版 | 专业版 | 专属版 |
| ----- | --- | --- | --- | --- |
| 流水号组件 | 不支持 | 支持 | 支持 | 支持 |
## 使用场景：
* 系统自动生成字段，根据预设规则生成流水号信息的场景，例如采购单、项目单等，一个表单只能有一个【流水号】控件。
* 表单设计中经常涉及编码的制作问题，通过流水号字段即可轻松实现编码的自动生成。如：进销存管理中，通过流水号设置订单编号、库存编号等；商品管理中，通过流水号字段为商品编号；
## 字段简介
流水号字段是指，在表单中设置固定规律的序列号，用户无需手动录入，表单数据提交后按序自动生成编号。
**组件功能使用范围说明：**
适用于宜搭普通表单、流程表单页面类型，且每个表单只能使用一个流水号组件。暂不支持在自定义页面内使用。
## 字段属性
### 通用属性
流水号组件 通用属性包括：
* 标题：支持修改
* 描述信息：支持自定义
* 状态：普通、只读、隐藏
### 流水号规则
您可以根据业务需求，自定义流水号的生成规则。流水号规则中可以添加**固定字符**、**自动计数**、**提交日期**和**表单字段**四种规则，具体设置方法如下：
流水号规则定义支持手动添加、删除、排序、编辑
* 默认规则 ：默认提供「自动计数」规则，不可删除
* 添加 ：点击「添加规则」按钮，选择要添加的规则，支持「自动计数」、「提交日期」和「表单字段」
* 排序 ：支持拖拽排序规则定义，即可对流水号的显示内容进行排序；
* 删除 ：点击流水号规则后的删除按钮，可删除 除 「自动计数」 之外的规则；
* 编辑 ：点击对应的流水号规则，可按需配置。
#### 自动计数
自动计数是流水号默认预置的规则，相关属性说明如下：
* 计数位数 ：默认为4位，从1开始的递增序号，例如：1、2、3…… 99、1000……。设置范围为 2～5 ； 计数位数可以限制流水号最大值（上限设置为实例数据为5w），当达到计数位数最大值时则重新开始计数。如，当设置的计数位数为 4，当计数达到 9999 时，则从 0 开始计数。
* 位数固定 ：默认开启，点击可切换开启/关闭状态，开启后则显示固定的位数。如，当计数位数为 4，当前计数为 1 时，开启位数固定时，流水号显示为 0001；未开启时，则流水号显示为 1。
* 重置周期 ：重置周期是指流水号重新计数的条件，默认为不支持自动重置，支持按日、按月、按年重置 。
说明：
* 重置周期下，如计数达到最大值，则从 0 开始重新计数。
* 即便重新设置了初始值，只要没有触发重置逻辑，那么新增流水号仍然按照当前规则继续递增，手动或者满足重置条件之后，触发重置，才会从新的初始值开始计数。
* 初始值 ：初始值指的是计数的初始数值，也就是从哪一个数字开始计数。系统初始值默认为 1。
#### 提交日期
提交日期的格式支持系统**预定义格式**，你可以在下拉框中直接选择预定义的 5 种日期格式（年、年月、年月日、年月日时分、年月日时分秒），同时支持时区配置。
该规则在流水号组件内仅支持配置一个，不可重复配置。
#### 固定字符
固定字符可以用于区分不同业务的流水号。在流水号规则中添加固定字符，在固定字符后的文本框中手动录入要添加的字符即可，同时该规则支持添加多个定义。
* 固定字符主要有两种用途：
* 特殊字符支持 \_ - + = / ( ) \< > \[ ] \{ } . \~ 、# % & \* 其他暂不约束，字符总计长度 10 字符。
#### 表单字段
在使用流水号设计中，可能需要使用到表单中的字段来作为流水号的组成部分，那么添加表单字段即可实现。目前支持表单中的**单行文本、日期、数值、下拉单选、单选、日期、地址、国家/地区**作为流水号组成成分。该规则支持添加多个定义。
### 流水号重置
当表单中已有提交数据时，支持对流水号手动重置，重置后流水号将按照设置的初始值重新开始计数
注意：
重置后，流水号将会按照设置的规则从初始值重新开始计数，可能会出现流水号重复的情况，且只对新建数据生效，此操作不可逆，请谨慎操作。
| **重置前**
 | **重置后**
 |
| ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
## 注意事项
* 一个表单只能添加一个流水号字段。
* 批量编辑/导入不支持，流水号可重复（允许重置）。
* 流水号字段仅支持添加在主表中添加，不支持在子表单中添加。
* 流水号字段不管是否隐藏，均会始终提交数据。
* 流水号不支持通过业务规则、js来修改流水号值。
* 免费版暂不支持流水号组件。
* 流水号组件功能适配范围说明如下：
| **宜搭以下功能模块支持流水号组件** | **适配范围说明** |
| ------------------- | ---------------------------------------------------------------------------------------- |
| **关联表单** | • 支持同步显示、排序、筛选及同步更新
• 支持关联表单引用流水号
• 支持设置为主要/次用信息字段，支持数据填充 |
| **数据管理页** | • 支持显示、排序、筛选
• 支持excel导出
• 批量编辑/导入暂不支持，流水号可重复（允许重置） |
| **表单设置** | • 支持默认值数据联动
• 业务规则可以填充流水号到目标表单
• 支持表单公式校验
• 支持权限字段配置
• 打印设计器内支持流水号组件 |
| **流程设计器** | • 支持字段权限控制
• 支持节点提交规则 - 校验规则 / 关联操作 |
| **集成自动化** | • 新增数据、更新数据、获取单条/获取多条数据节点支持流水号组件，即通过集成自动化产生的表单支持自动填充流水号
• 支持连接器参数配置、消息通知 |
| **报表** | • 支持在报表、视图表内显示 |
### 旧版系统流水号支持升级为流水号组件
针对存量表单且已开启系统流水号设置的表单，支持将系统流水号替换为流水号组件，同时扩大流水号的消费使用范围。
点击**同步表单系统流水号**，系统流水号升级为流水号组件后，可在集成自动化等功能范围内使用该组件。
但此操作不可逆且只对当前表单的新增数据有效，同时流水号计数逻辑将会根据组件配置规则重新计算生成，请谨慎操作。
| **升级前：表单设置 > 系统流水号**
系统流水号配置
系统流水号详情 | **升级后：表单设计器 > 流水号组件**
系统流水号升级
升级为流水号组件 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |