自动编号插件

cybozu发表于:2017年01月06日 11:49:55更新于:2022年10月13日 17:06:35

Index

注意事项

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

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

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

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

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

概要

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

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

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

设置页面(设置范例)

0015e856ba8f3dadaf03eff0818b140

记录详情页面(记录登记后)

00158871491c3b13b7fca8bb0f21284

使用自动编号插件

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 " 是这次要使用的文件包。
文件结构如下图。

0015e85714d3eee74eda8097b480237

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 发布了。修改了以下内容。

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

2022/09/06 v2.4.3发布了。修改了以下内容。

  • 将JavaScript代码改写成ES6之后的写法。

限制事项

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

所使用的OSS许可证信息

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