自動採番プラグイン

特徴

自動採番プラグインは、レコードの指定したフィールドに自動採番した値を設定します。
cybozu 提供の[自動採番プラグイン]を拡張したものです。

• テキスト、日付、連番を組み合わせて自動採番した値を指定したフィールドに設定します。
  [拡張機能]フィールドの値と連番の組み合わせを追加しました。
• テキスト、日付、連番を繋ぐ接続語（`-`、`_`）を設定することができます。
  [拡張機能]接続語無しも選択できるようにしました。 また、最大2か所の接続語はそれぞれ別の値を設定できるようにしました。
• 日付のフォーマットは”西暦年4桁”（または西暦年下2桁）、"月"、"日"の組み合わせから選択できます。
  [拡張機能]`年月日[西暦2桁](YYMMDD)`、`年月[西暦2桁](YYMM)`を追加しました。
• 連番は指定した桁数で0埋めを行うことができます。
• 連番リセットのタイミングは"なし"、"年毎"、"月毎"、"日毎"を選択できます。日付のフォーマットと連動しています。
  [拡張機能]"年度毎"を追加しました。"年度毎"を指定した場合、年度の開始月（デフォルトでは4月）を指定することが可能です。
• レコード追加画面で保存ボタンを押下した際に自動採番を行います。
  [拡張機能]レコード編集画面、レコード一覧画面のレコード編集モードで保存ボタンを押した際に、指定したフィールドに値がなければ自動採番ができるようにしました。
  日付入りのフォーマットで採番する場合は「レコード作成日付」を使うか「編集している日付」を使うか選択できます。

• 一つのアプリで自動採番のできるフィールドは一つだけです。
• 途中で採番ルールを変更した場合、動作を保証するものではありません。
• 採番対象として指定できるフィールドは「文字列（1行）」のみです。
• 採番対象として指定されたフィールドは変更不可となります。
• 指定された桁数を超える場合はそのまま設定されます。
  例）桁数指定:2桁の場合
  01 → 02 → … → 99 → 100
• レコード編集画面、レコード一覧画面で自動採番を行う場合は設定オプションの指定が必要です。
• セキュアアクセス時のAPIトークン使用についてはこちらをご確認ください。

関連ブログ

• kintone プラグインを使ってみよう！
• kintone プラグインをバージョンアップしよう！
• kintone プラグイン設定を開発環境から本番環境へ簡単デプロイ！
• 自動採番プラグインで登録済みレコードの採番ができるようになりました！

機能

■自動採番について

設定画面で採番を設定するフィールドの指定と採番のフォーマット作成を行います。
レコード登録画面で保存ボタンを押下した際に自動採番を行います。
レコード編集画面で保存ボタンを押下した際に、採番フィールドに値がない場合に自動採番を行うことが可能です。（オプション）
レコード一覧画面のレコード編集モードで保存ボタンを押下した際に、採番フィールドに値がない場合に自動採番を行うことが可能です。（オプション）
設定画面で作成したフォーマットに沿ってレコード"連番を含む文字列"の作成と登録を行います。

※注意事項：採番対象として指定されたフィールドは変更不可となります。

■採番のフォーマットについて

以下のフォーマットが指定できます

■日付のフォーマットについて

以下のフォーマットが指定できます

■採番のフォーマットで使用するフィールドについて

採番のフォーマットで"フィールド＋連番"を指定した場合には、フォームに設定されているフィールドのうち「文字列（1行）」「数値」「ラジオボタン」「ドロップダウン」タイプのフィールドを"書式用フィールド"として指定することができます。

イメージ

■連番リセットタイミング選択について

連番は「採番書式選択」で日付を含む書式を選択した場合にリセットのタイミングを指定することができます。
リセットのタイミングは以下から選択することが可能です。

※注意事項：フィールドを含む書式の場合はフィールドの値ごとにリセットされます。

セキュアアクセス時のAPIトークン使用について

プラグインの設定

セキュアアクセスした状態でプラグインのAPIトークンの設定はできません。
プラグインの設定を変更する場合は、セキュアアクセスを解除した状態で行ってください。

APIトークンを使用した自動採番

セキュアアクセスでAPIトークンを使用した自動採番を行う場合、
IPアドレス制限の許可リストにcybozu.comが使用するIPアドレスのアウトバウンドIPアドレスを設定する必要があります。
※cybozu.comが使用するIPアドレス についてはこちらを参照ください。

使い方

設定画面

「自動採番フィールド選択」でフィールドの指定を行います。

※注意事項：採番対象として指定できるフィールドは"文字列（1行）"のみです。

「採番の桁数」で1以上の桁数を指定します。

「採番書式選択」で採番のフォーマットを選択します。

フォーマットに日付を含めた場合は「日付書式選択」で日付のフォーマットを選択します。

フォーマットにテキストを含めた場合は「テキスト入力」で設定したい文字列を入力します。

フォーマットにフィールドを含めた場合は「書式用フィールド選択」でフィールドを選択します。
※ここで選択できるフィールドのタイプは「文字列（1行）」「数値」「ラジオボタン」「ドロップダウン」です。

「接続語設定」を行います。必要のない場合は"なし"を選択します。

ここまですべてを設定すると「プレビュー:」にサンプルフォーマットが表示されます。

「連番リセットタイミング選択」を設定します。
年毎、月毎などにリセットを行いたい場合は指定します。リセットの必要が無い場合は"なし"を選択してください。
"年度"を指定した場合、年度開始月は初期値が4月になっていますので必要に応じて変更してください。

※注意事項：フォーマットにフィールドを含めた場合は連番のリセットタイミングは"フィールド毎"になります。

■設定オプション

編集画面で自動採番を行う場合は「編集画面の保存時に自動採番を行う（フィールドが未設定の場合のみ）」にチェックを入れてください。

一覧画面のレコード編集モードで自動採番を行う場合は「一覧画面の保存時に自動採番を行う（フィールドが未設定の場合のみ）」にチェックを入れてください。

レコード編集時に日付入りのフォーマットで自動採番を行う場合は「レコード作成日付」を使うか「編集している日付」を使うか選択できます。

レコードにアクセス権設定を行う場合は「APIトークン」を設定することが可能です。

※注意事項：セキュアアクセス時のAPIトークン使用についてはこちらをご確認ください。

最初に「アプリの設定」画面から「APIトークン」に移動し、「生成する」をクリックした後、アクセス権で「レコード編集」にチェックを入れます。
有効になった「APIトークン」を設定画面の「APIトークン」に入力します。

※注意事項：「APIトークン」は生成した後に一度「アプリを更新」することで有効になります。

「保存する」で設定画面を終了します。

レコード追加/編集画面

※注意事項：採番対象として指定されたフィールドは変更不可となります。

レコード追加画面

レコード編集画面

レコード詳細画面