1. 概述
1.1 版本
报表服务器版本 | 插件版本 |
---|---|
11.0 | V1.0 |
1.2 应用场景
在填报时,如果需要同时填入两个以上的表,并且这些表需要共用 ID,无法通过填报属性或 SQL 自增 ID 的方式设置 ID ,这种情况下可以通过「流水号函数」插件生成唯一ID 。
2. 插件介绍
3. 示例
3.1 ID生成规则管理
管理员登录数据决策系统后,点击「管理系统 > 系统管理 > 唯一ID管理」,可以对 ID 进行新增、编辑、删除操作,如下图所示:
3.2 新增ID生成规则
在「添加>规则添加」中可设置「规则名称」、「ID生成规则」、「规则描述」三个属性。
各属性具体校验逻辑如下表所示:
设置 | 说明 |
---|---|
规则名称 | 不能为空,不能重复 |
ID生成规则 | 可以为空,为空时生成默认的 Snowflakeid 不为空时,需按照 JSON 格式填写,内容包含三个属性: mode:
reset:
figures:代表位数,如果设置为 10,那么第一个 ID 返回:0000000001
正常示例: {mode:"inc",reset:"day",figures:10} 这是一个连续的每天重置的自动填充10位的id生成器 注:如果对已建立的规则进行了修改,保存后可能导致历史数据被改写,请谨慎修改。 |
规则描述 | 可以为空 |
3.3 ID函数
ID( ):生成默认 Snowflakeid
ID(“规则名称”):按照规则生成 id(规则名称为 3.2 节中自定义的规则名称)
注:连续自增是指每次调用返回值符合连续自增,并非业务实际的连续自增。例如:填报预览获得的 id 为 0001,入库也是 0001,再两次重新整理模板,id 为 0003,而不是 00002。
规则名称不存在时,报错:ID生成规则不存在!