自動採番プラグイン

Index

• 注意事項
• 概要
• プラグインを利用する
• サンプルプラグイン
• 制限事項
• 利用している OSS のライセンス情報

注意事項

• サンプルプラグインは、その動作を保証するものではありません。
• サンプルプラグインの技術的なサポート等は行っていません。
• APIトークン設定機能は、セキュアアクセスおよびIPアドレス制限を利用しない環境でのみ動作します。
• 本プラグインをv1.1以前のプラグインからアップデートする際はプラグインの設定画面より設定を再保存する必要があります。
• kintoneプラグインはスタンダードコースでのみご利用いただけます。ライトコースではご利用いただけませんのでご注意ください。

概要

顧客管理、日報、案件管理等々・・・日ごろ利用している様々なアプリに一意のIDをつけたい、という方向けのプラグインです。

本プラグインは年次ごとの自動採番を行うワザ　、自動採番して、レコード登録する　をプラグイン化したものになります。

2017/04/20：設定項目に「APIトークン」と「採番の桁数」を追加しました。その他変更点は「更新履歴」よりご参考ください。

設定画面（設定例）

レコード詳細画面（レコード登録後）

プラグイン を利用する

STEP1:フォームを設定する

アプリのフォームを設定します。次のフィールドを配置します。

• 自動採番用のフィールド
  採番対象のフィールドを配置します。文字列（1行）フィールドを使用します。
  ※テーブルに設定したフィールドは使用できません。

ほかのフィールドの配置は任意です。

STEP2:アプリにプラグインを追加する

アプリに自動採番プラグインを追加します。プラグインの追加方法は、kintone ヘルプを参照してください。

STEP3:プラグインを設定する

1. アプリ管理画面の「詳細設定」＞「プラグイン」を開き、自動採番プラグインの歯車マークをクリックします。
2. 各項目を設定します。
   

   項目名	説明
   自動採番フィールド選択	採番を設定するフィールドを選択します。
   採番の桁数	採番の桁数を指定します。1以上を指定する必要があります。 ※「採番の桁数」は、採番の最大桁数を設ける機能ではなく、桁が足りない場合に、指定した桁数まで桁を補完するものです。 例、「採番の桁数」に4を指定した場合の自動採番： 　0001 　0002 　0003 　←　４桁になるように補完 　．．． 　9999 　10000　←4桁を超える
   採番書式選択	採番する際の書式を以下から選択します。 連番 日付+連番 日付+テキスト+連番 テキスト+連番 テキスト+日付+連番
   日付書式選択	採番書式選択で日付を選択している場合、日付の書式を以下から選択します。 年月日(YYYYMMDD) 年月(YYYYMM) 月日(MMDD) 月日年[西暦４桁](MMDDYYYY) 月日年[西暦2桁](MMDDYY) 月年[西暦４桁](MMYYYY) 月年[西暦２桁](MMYY) 年[西暦4桁](YYYY) 年[西暦2桁](YY)
   テキスト入力	採番書式選択でテキストを選択している場合、テキストの内容を入力します。
   接続語設定	接続語を以下から選択します。 -(ハイフン) _(アンダースコア)
   プレビュー	上記項目で選択した内容の採番をプレビューで表示します。（入力不可）
   連番リセットタイミング	連番をリセットするタイミングを以下から選択します。 ※採番書式選択で日付を選択していない場合、設定することはできません。 なし 年毎 月毎 日毎
   APIトークン	アクセス権の設定により、一部レコードの閲覧権限がないユーザーがレコードを登録した場合でも、正しい連番を採番するためにAPIトークンを入力します。

3. [保存]をクリックします。
4. 「アプリの設定」画面で[設定完了]をクリックすると、プラグインの設定がアプリに反映されます。

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

こちらの手順を参考にパッケージングします。

パッケージングしたサンプル

プラグイン開発のためのサンプルであり、サポート対象外であることをご理解の上、ダウンロードしてください。

SAMPLE_autonum.plugin_v2.4.3.zip

更新履歴

• 2016/03/24 v1.0 を公開しました
• 2016/06/09 v1.1 を公開しました。
  • ゲストスペース対応を行いました。
• 2017/04/20 v2.0 を公開しました。次の修正・機能追加を行いました。
  • 採番の桁数を指定できるように変更
  • 「日付書式選択」項目に次の４パターンを追加
    • 月日年[西暦４桁](MMDDYYYY)
    • 月日年[西暦2桁](MMDDYY)
    • 月年[西暦４桁](MMYYYY)
    • 月年[西暦２桁](MMYY)
  • プラグイン設定画面での採番プレビューの表示場所と表示形式を変更
  • トークン認証項目を追加（レコードのアクセス権を設定しているユーザー向け）
  • 自動採番フィールド選択、採番書式選択と接続語設定の設定を変更したタイミングで入力チェックを行うように変更
  • 画面の高さにより、ボタンとスクロールバーの表示場所が変わるように変更
    • 画面の高さ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/04/06 v2.3 を公開しました。
  • プラグイン設定画面の言語に中国語を追加しました。「ログインユーザーの言語」が中国語の場合、中国語で表示されます。
• 2021/03/03 v2.4 を公開しました。次の修正を行いました。
  • タイムゾーンが異なるユーザーやPCのシステム設定が実際の時間とずれているユーザーがレコードを登録すると、発番できずにレコード登録できないことがある現象を修正
• 2021/08/13 v2.4.1 を公開しました。次の修正を行いました。
  • 使用している外部ライブラリーのファイルをプラグイン内にバンドル化
• 2022/06/16 v2.4.2 を公開しました。次の修正を行いました。
  • 自動採番されるフィールドが空のレコードを登録すると、次に登録したレコードで正しく採番されない現象を解消
• 2022/09/06 v2.4.3を公開しました。次の変更を行いました。
  • JavaScriptソースコードをES6以降の記法に書き換えました。

制限事項

• モバイルからはプラグインを利用できません。

利用している OSS のライセンス情報

このプラグインで利用している OSS のライセンスは次のとおりです。

• Moment.js - MIT License
• jQuery - MIT License
• JsRender - MIT License
• SweetAlert - MIT License
• 51-modern-default - MIT License