【OrBit】StartRuleSNDoMethod / StartRuleSN_BatchDoMethod（序列号接口） - .Net 平台标准存储过程&函数&CLR方法

**1.概述**
该接口用于根据规则 生成序列号，<span style="color:red;font-weight: bold;">如何维护序列号的规则，请查看对应的文档！</span>

预留字符有2种配置方式：
   ①一种是 @RCharStr，直接根据实际传入的值进行填充，比如工单号、版本号
   ②另外一种是@RCharQTable，一般用于根据不同的序列号规则生成序列号，此时预留字符很难指定（可能是工单号、可能是版本号...），此时可以通过@RCharQTable表传入查询参数，由具体的序列号规则去获取。@RCharQTable可以理解为一个程序可能会有哪些信息用于组成序号，可能用到的，都插入到此表。
   
**2.场景**
  各种类型的序列号都可以，比如：物料批号、物料箱号、成品批号、半成品批号、设备编号、周转工具编号、系统单据（有的时候使用通过接口“Txn_BillNewSN”生成的单据号可能不满足需求，可以通过此接口生成）等等。

**3.接口1**
3.1.场景：一次单个SN生成
3.2.特点：单个、序号可能不连续（多个用户在调用）、多种进制编码、动态长度、高并发

```sql
EXEC @return_value=dbo.StartRuleSNDoMethod 
	@I_ReturnMessage = @I_ReturnMessage OUTPUT,--返回的信息
	@SNRuleId = @SNRuleId,--序列号规则
	@JumpQty = @JumpQty,--跳号数量
	@IsPreview = @IsPreview,--是否只是预览，预览时不会更新计数器
	@RCharStr = @RCharStr,--预留字符,多个用分号隔开
	@RCharQTable = @RCharQTable,--用于查询预留字符的表，可以从这个表中获取数据。这个参数会传给动态数据源
	@NewSN = @NewSN OUTPUT--序列号
```

如果不需要@RCharQTable，可以不传。@RCharQTable是表类型，不能赋null
```sql
EXEC @return_value=dbo.StartRuleSNDoMethod 
	@I_ReturnMessage = @I_ReturnMessage OUTPUT,--返回的信息
	@SNRuleId = @SNRuleId,--序列号规则
	@JumpQty = @JumpQty,--跳号数量
	@IsPreview = @IsPreview,--是否只是预览，预览时不会更新计数器
	@RCharStr = @RCharStr,--预留字符,多个用分号隔开
	@NewSN = @NewSN OUTPUT--序列号
```
 
**4.接口2**
4.1.场景：SN批量生成，比如：物料批号生成、工单批号生成...
4.2.特点：批量、快速、序号连续、多种进制编码、动态长度、高并发
4.3.测试：5万个序列号，1秒之内完成（不含插入表保存，仅直接调用接口返回），相比使用“接口1”循环生成，速度提升87倍以上
4.4.前提：跳号数量 必须为1
```sql
DECLARE @return_value int=-1 
DECLARE @I_ReturnMessage nvarchar(max)=''
DECLARE @SNRuleId char(12)='SNRU100000TS'
DECLARE @BatchQty int=50000 --例如
DECLARE @RCharStr NVARCHAR(50)=''
DECLARE @RCharQTable RCharQTable

DECLARE @OutPut TABLE(
	Id BIGINT ,
	SN NVARCHAR(100)
)

INSERT INTO @OutPut
     (
		 Id,
         SN
     )
EXEC @return_value=dbo.StartRuleSN_BatchDoMethod 
	@I_ReturnMessage = @I_ReturnMessage OUTPUT,
	@SNRuleId = @SNRuleId,
	@BatchQty = @BatchQty,
	@RCharStr = @RCharStr,
	@RCharQTable = @RCharQTable

SELECT * FROM @OutPut ORDER BY [@OutPut].Id
```
4.4.本接口需要使用SN计数容量器（即一次最大能批量生成多少个SN），所有序列号规则共用，计数容量可以使用插件“序列号规则”插件调整

![](/media//202305/2023-05-10_162313.png)