Index

• 注意事项

• 概要

• 使用自动编号插件

• 范例插件

• 限制事项

• 所使用的OSS许可证信息

注意事项

• 此插件是用于演示如何创建插件的范例，才望子不予以保证可正常运行。
  

• 不对此范例提供技术支持。

• API令牌功能仅可用于未设置SecureAccess和IP地址限制的环境。

• 此插件从1.1及更早的版本升级到当前版本时，需要在设置页面重新点击保存按钮。
  

• kintone的插件功能只可在标准版使用，简易版不可使用这点请大家注意一下。

概要

顾客管理、日报、案件管理等等・・・日常使用的插件中有不少需要给每条记录生成一个唯一的不重复的ID，使用此插件可在创建记录时自动生成类似的编号。

本插件是根据下面两篇Tips：按年自动编号的技巧（暂无中文页面）　、自动编号并且添加记录（暂无中文页面）作成的。

2017/04/20：添加了[API令牌]和[自动编号的长度]项。其他更改点请参考更改记录。

设置页面（设置范例）

记录详情页面（记录登记后）

使用自动编号插件

STEP1:设置表单

设置应用的表单。配置下面的字段。

• 自动编号用的字段
  配置待编号对象的字段。使用单行文本框。
  ※不能使用设置的表格里的字段。

可自由配置其他的字段。

STEP2:向应用里添加插件

在应用中追加自动编号的插件。插件的追加方法，请参照kintone 的帮助。
在应用中添加插件

STEP3:设置插件

1. 打开应用的设置页面的 “设置”＞“插件”，点击自动编号插件的齿轮图标。

2. 设置以下各个项目。
   

   项目名字	说明
   显示自动编号字段	选择需要进行编号的字段。
   自动编号的长度	指定自动编号的字符数。需要指定大于1的数字。 ※[自动编号的长度]不是指可生成的编号的最多字符数，而是指当编号的字符数小于所指定的的数值时，会自动在前面补零。 例，当自动编号的长度指定为4时，自定生成的编号如下：   0001   0002   0003  ← 补零使其够4位   ・・・   9999   10000 ← 可超过4位
   选择编号格式	选择以下编号的格式。 ○ 编号 ○ 日期+编号 ○ 日期+文本+编号 ○ 文本+编号 ○ 文本+日期+编号
   选择日期格式	当编号格式选择项里选择日期的时候，选择以下日期的格式。 ○ 年月日(YYYYMMDD) ○ 年月(YYYYMM) ○ 月日(MMDD) ○ 月日年[西历4位数](MMDDYYYY) ○ 月日年[西历2位数](MMDDYY) ○ 月年[西历4位数](MMYYYY) ○ 月年[西历2位数](MMYY) ○ 年[西历4位数](YYYY) ○ 年[西历2位数](YY)
   输入文本	当编号格式选择项里选择文本的时候，输入文本的内容。
   设置连接语	选择以下连接语。 ○ -(连接符) ○ _(下划线)
   编号预览	预览下面项目里选择的内容。（不可输入）
   定时重置编号	选择以下定时重置编号的选项。 ※当编号格式选择项里没有选择日期的时候，无法设置。 ○ 从不 ○ 每年 ○ 每月 ○ 每天
   API令牌	在访问权限的设置中，当设置部分用户无法权限查看部分记录时，如要让这些用户添加记录时也可自定生成新的编号，可输入API令牌。

1. 点击 “保存” 按钮。

2. 在 “应用的设置” 页面点击 “更新应用”，插件的设置就反映到应用里了。

STEP4:使用插件

1. 添加记录。点击保存按钮的时候，将会以插件里设置的格式对所选字段进行编码。

2. 以后每次添加记录的时候，编号会自增长。

范例插件

访问GitHub ，下载整个文件夹。文件夹内的 " examples/autonum " 是这次要使用的文件包。
文件结构如下图。

autonum/
 css/
   -51-modern-default.css
   -config.css
   -desktop.css
 html/
   -config.html
 img/
   -icon.png
 js/
   -config.js
   -desktop.js
manifest.json

请参考插件的开发步骤 此Tips的打包步骤 ，打包 “autonum” 。

更新履历

2016/03/24 v1.0 发布了
2016/06/09 v1.1 发布了：对应了来宾空间。

2017/04/20 v2.0发布了。添加/修改了以下功能。

• 更改为可指定自动编号的长度

• 「选择日期格式」中添加了以下内容

  • 月日年[西历4位数](MMDDYYYY)
    

  • 月日年[西历2位数](MMDDYY)
    

  • 月年[西历4位数](MMYYYY)
    

  • 月年[西历2位数](MMYY)

• 更改了插件设置页面中预览的显示位置和显示格式

• 添加了API令牌验证（针对设置了记录访问权限的环境）

• 更改为在更改了自动编号字段、编号格式和连接符时进行输入检查

• 更改为根据页面的高度自动调整按钮和滚动条的位置

  • 页面的高度小于750px时：
    [Save]按钮和[Cancel]按钮分别显示在页面的顶部和底部，滚动条小时在页面的外侧

  • 页面的高度大于750px时：
    [Save]按钮和[Cancel]按钮仅在页面的顶部显示，滚动条显示在页面的内测

• 设置页面根据用户自身环境的设置自动切换日语/英语
  

2017/08/16 v2.1发布了。更改了以下内容。

• 样式表单由[51-current-default.css]更改为[51-modern-default.css]。

• 其他细节的修改。

2017/11/22 v2.2发布了。修改了来宾空间内无法保存API令牌的缺陷。

2020/4/2 v2.3发布了。插件显示语言新增了中文，设置页面可根据用户自身环境的设置切换中文/日文/英文了。

2021/03/03 v2.4发布了。修正了以下内容。

• 时区不同的用户或系统时间不是实际时间的用户添加记录时，会发生不能生成编号导致不能添加记录的问题。

2021/08/13 v2.4.1发布了。修正了以下内容。

• 罗列了此插件使用的外部库的信息，并将此信息文件添加到插件中。

2022/06/16 v2.4.2 发布了。修改了以下内容。

• 修改了添加的记录里如果自定编号字段为空，那么下一条添加的记录无法正确编号的错误。
  

限制事项

• 移动端不可使用本插件。

所使用的OSS许可证信息

此插件使用的OSS许可证如下：

• Moment.js - https://momentjs.com/
  MIT License https://opensource.org/licenses/MIT

• jQuery - https://jquery.com/
  MIT License https://opensource.org/licenses/MIT

• JsRender - https://www.jsviews.com/
  MIT License https://opensource.org/licenses/MIT

• SweetAlert - https://sweetalert.js.org/
  MIT License https://opensource.org/licenses/MIT