# 自動採番＆一括採番 詳細マニュアル | 設定リファレンス・トラブルシューティング - KINTAUROS > kintoneプラグイン「自動採番＆一括採番」の詳細マニュアル。全設定項目のリファレンス(意味・制約値)、動作条件・制限事項、エラーコード別のトラブルシューティングを掲載。対象バージョン: v2.4.0。 元ページ: https://kintauros.com/plugins/autonum/manual/ 自動採番＆一括採番は、レコード保存時に「A-2026-0001」のような書式で自動採番し、既存レコードへの一括採番にも対応するプラグインです。採番の現在値は採番マスタアプリで一元管理します。このマニュアルでは、設定項目のリファレンスと、動作仕様・制限事項・トラブルシューティングを説明します。 機能紹介・画面イメージ・導入手順は[プラグイン紹介ページ](https://kintauros.com/plugins/autonum/)を、ダウンロードは[ダウンロードページ](https://kintauros.com/download/)をご覧ください。このマニュアルは[Markdown版](index.md)でも提供しており、全プラグインのメタ情報と設定スキーマは機械可読な[catalog.json](https://kintauros.com/catalog.json)から取得できます。 ## 基本情報 - **プラグインID**: autonum - **対象バージョン**: v2.4.0(配布中の最新版) - **カテゴリ**: 帳票・自動化 - **説明**: 保存時に自動で採番し、一覧画面から一括採番も実行します。 ## 動作条件 - **対応環境**: kintone スタンダードコース(デスクトップ版UI)。最新版の Chrome / Edge / Safari / Firefox に対応。 - **動作画面**: レコードの新規保存時(自動採番)と、レコード一覧画面の「一括採番」ボタン。 - **必要なアプリ**: 採番の現在値を管理する「採番マスタアプリ」が別途必要です(「ターゲットアプリID」「現在の最新番号」「現在のプレフィックス」フィールドを使用)。 - **必要な権限**: 保存するユーザーにマスタアプリの閲覧・更新権限が必要です。権限を付与しない場合は、APIトークンによるプロキシ連携(設定画面のAPIトークン設定)を使用できます。 ## 設定項目リファレンス プラグイン設定の全項目です。「項目」は設定データ(エクスポートファイルの config)のキーを表し、[] は配列の要素を意味します。設定画面での入力項目と1対1に対応します。この構造の正式な定義はJSON Schema([catalog.json](https://kintauros.com/catalog.json) の configSchema)として公開しています。 - **項目**: 型 / 必須 / 説明・制約 - **managerAppId**: 文字列 / 必須 / マスタアプリID / 採番の現在値を管理するアプリのID。 / 形式: ^[0-9]+$ - **initialNumber**: 文字列 / 任意 / 採番の初期値 / マスタアプリに採番レコードが既にある場合は無視される(isInitialNumberDisabled=1)。 / 形式: ^[0-9]+$ - **isInitialNumberDisabled**: 文字列 / 任意 / 初期値入力が無効か(保存時に自動判定。手で編集しない) / 値: 0 | 1 - **autoNumberingFieldcode**: 文字列 / 必須 / 採番結果を保存するフィールドコード / 1文字以上 / 対応フィールド型: SINGLE_LINE_TEXT - **format**: 文字列 / 必須 / 採番書式 / numbering=番号のみ / dateNumbering=日付+番号 / dateTextNumbering=日付+テキスト+番号 / textNumbering=テキスト+番号 / textDateNumbering=テキスト+日付+番号。 / 値: numbering | dateNumbering | dateTextNumbering | textNumbering | textDateNumbering - **format1**: 文字列 / 任意 / 書式の第1要素(保存時に自動算出。手で編集しない) - **format2**: 文字列 / 任意 / 書式の第2要素(保存時に自動算出。手で編集しない) - **format3**: 文字列 / 任意 / 書式の第3要素(保存時に自動算出。手で編集しない) - **dateFormat**: 文字列 / 任意 / 日付書式 / YYYY / YY / MM / DD の組み合わせ(例: YYYYMMDD)。日付を使わない書式では "null"。 - **text**: 文字列 / 任意 / テキスト(プレフィックス) / 連結記号(-, _)と HTML 特殊文字は使用不可。 - **preview**: 文字列 / 任意 / 採番例のプレビュー(保存時に自動算出。手で編集しない) - **timing**: 文字列 / 任意 / 採番リセットのタイミング / none=リセットしない / yearly=年ごと / monthly=月ごと / daily=日ごと。 / 値: none | yearly | monthly | daily - **connective**: 文字列 / 必須 / 連結記号 / 値: - | _ - **useProxy**: 文字列 / 任意 / APIトークン連携を使うか(保存時に自動判定。手で編集しない) / 1 のとき一括採番が kintone のプロキシ設定に登録された API トークンを使う。 / 値: 0 | 1 - **numOfDigit**: 文字列 / 任意 / 採番の桁数(ゼロ埋め) / 形式: ^[0-9]+$ - **useBulkNumberingButton**: 文字列 / 任意 / 一覧の一括採番ボタンを使うか / use=使用する / notUse=使用しない(値は camelCase)。 / 値: use | notUse ## 設定のポイント - 採番マスタアプリには、このアプリ用のレコードを1件登録します。1つのマスタアプリで複数アプリの採番を一元管理できます。 - 採番結果を保存するフィールドは「文字列(1行)」フィールドを指定します。保存すると自動で編集不可になり、手入力による重複・欠番を防ぎます。 - isInitialNumberDisabled・format1〜format3・preview・useProxy は設定保存時に自動算出される内部項目です。設定ファイルを直接編集する場合も、これらは手で変更しないでください。 - テキスト(プレフィックス)には連結記号(-, _)とHTML特殊文字は使用できません。 ## 動作仕様 - レコードの新規保存時に、マスタアプリの「現在の最新番号」を+1した番号を採番してセットします。 - 書式は「番号のみ」「日付+番号」「日付+テキスト+番号」「テキスト+番号」「テキスト+日付+番号」の5種類。日付書式(YYYY/YY/MM/DD)・連結記号(- または _)・連番桁数(ゼロ埋め)を組み合わせられます。 - プレフィックス(番号より前の部分)が変わると連番は自動で1から振り直されます。採番リセットのタイミング(年ごと・月ごと・日ごと)も指定できます。 - 一覧画面の「一括採番」ボタンは、採番フィールドが空のレコードを対象に100件ずつまとめて採番・更新します。 ## 制限事項・既知の仕様 - モバイルアプリの画面では動作しません(デスクトップ版UIのみ)。 - REST APIやCSV読み込みによるレコード登録では採番されません(画面での保存操作に対して動作します)。番号が空のまま登録されたレコードには一括採番を使用してください。 - 採番フィールドに指定できるのは文字列(1行)フィールドのみです。 ## 設定のインポート / エクスポート プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定をJSONファイルとして書き出し(エクスポート)、別のアプリで読み込み(インポート)できます。検証用アプリから本番アプリへの設定コピーや、バックアップ・復元にご利用ください。 - インポートは取り込む内容の差分を確認してから「設定画面に反映」し、最後に「保存」を押して確定します(反映しただけでは保存されません)。 - 読み込んだファイルはブラウザ内で処理され、KINTAUROSのサーバーには送信されません。 - 別のアプリの設定を取り込んだ場合、このアプリに存在しないフィールドは警告として一覧表示されるので、反映後に該当箇所を選び直してください。 エクスポートファイルは次の形式(封筒形式)です。config の中身が設定本体で、その構造は上の設定項目リファレンスのとおりです。 ``` { "kintauros": "config/v1", "plugin": "<プラグインID>", "pluginName": "<プラグイン名>", "pluginVersion": "<バージョン>", "exportedAt": "<書き出し日時(ISO 8601)>", "sourceApp": "<書き出し元アプリID>", "config": { ... 設定本体 ... } } ``` ### AIエージェント向け: ブラウザコンソールAPI 各プラグインは共通ランタイム window.KINTAUROS を搭載しており、ブラウザの開発者コンソールから設定の読み取り・検証・保存ができます。設定の保存(save: true)はkintoneの制約上、プラグイン設定画面でのみ成功します。 ``` KINTAUROS.config.plugins() // このページのKINTAUROSプラグインID一覧 KINTAUROS.config.describeAll() // 同居プラグインすべての設定サマリ KINTAUROS.config.of('<プラグインID>').schema() // 設定のJSON Schema KINTAUROS.config.of('<プラグインID>').export() // 現在の設定(封筒つき) KINTAUROS.config.of('<プラグインID>').validate(x) // 保存せず検証 KINTAUROS.config.of('<プラグインID>').diff(x) // 現在の設定との差分 await KINTAUROS.config.of('<プラグインID>').import(x, { save: true }) // 検証して保存(設定画面のみ) ``` 登録が1件だけのページでは of(...) を省略できます(例: KINTAUROS.config.export())。 ## トラブルシューティング **「マスタアプリへの連携に失敗しました」と表示される** (1)設定のマスタアプリIDが正しいか、(2)マスタアプリにこのアプリ用のレコード(ターゲットアプリID=このアプリのID)が登録されているか、(3)保存するユーザーにマスタアプリの閲覧・更新権限があるか(またはAPIトークンが設定済みか)を確認してください。 **一括採番で「対象レコードがありません」と表示される** 一括採番の対象は採番フィールドが空のレコードのみです。すでに全レコードに番号が入っている場合は対象0件になります。 **一括採番でAPIトークンが無効と表示される** 設定画面でマスタアプリのAPIトークンを設定し直してください。トークンにはマスタアプリのレコード閲覧・編集権限が必要です。 **採番をやり直したい・初期値を変えたい** マスタアプリの「現在の最新番号」を直接編集すると次の採番値を調整できます。設定画面の「採番の初期値」は、マスタアプリに採番レコードが既にある場合は無視されます。 ## エラーコードと診断情報 自動採番＆一括採番を含むKINTAUROSプラグインは、エラー発生時にブラウザのコンソールへ統一形式のログを出力します。人間向けの1行に続けて、機械可読なJSON(code / plugin / version / appId / message / doc)を出力し、doc には該当エラーの解説ページのURLが入ります。 ``` [KINTAUROS <プラグインID>@<バージョン>] E001: 設定されたフィールドが見つかりません: ... {"kintauros":{"code":"E001","plugin":"...","version":"...","appId":"...","message":"...","doc":"https://kintauros.com/docs/errors/E001"}} ``` 各エラーコードの意味と対処は[エラーコード一覧](https://kintauros.com/docs/errors/)を参照してください。また、プラグイン設定画面の「サポート用情報をコピー」から、環境・バージョン・ライセンス状態・直近のエラーを含む診断情報をコピーできます(レコードの内容や個人情報は含まれません)。お問い合わせの際はこの情報を添えてください。 ## ライセンスについて - 初回利用時は、プラグイン設定画面の「利用開始」ボタンから60日間の無料トライアルを開始できます(カード登録不要)。 - トライアル・契約の期限が切れるとプラグインの動作は停止し、画面に案内が表示されます。[料金プラン](https://kintauros.com/#pricing)から契約すると同じ設定のまま再開できます。 - ライセンス確認のための外部通信で送信されるのは、kintoneドメイン名・プラグインID・バージョンのみです。レコードの内容や個人情報が外部に送信されることはありません。 - ライセンスサーバーに一時的に接続できない場合も、プラグインは一定期間動作を継続する設計です。 ## サポート 解決しない場合は[お問い合わせ](https://kintauros.com/contact/)からご連絡ください。その際、プラグイン設定画面の「サポート用情報をコピー」でコピーした診断情報を添えていただくと、調査がスムーズです。 最終更新: 2026-08-14 / 対象バージョン: v2.4.0