このプラグインでできること
「サブテーブル自動行追加プラグイン」は、条件に合うときに、レコードのテーブル(サブテーブル)へ行を自動で追加するプラグインです。
対象月の1日〜末日の日付を1行ずつ作ったり、いつも同じ内容の行をまとめて追加したりできます。日付や番号だけでなく、ほかの列の値も行ごとに入れられます。
主な機能は次のとおりです。
- 日付や番号を、開始・終了・間隔を決めて1行ずつ連続で作る(例:対象月の1日〜末日、今日から毎週5回、1〜12回)
- 土日などの曜日や、国民の祝日(2025〜2030年)を飛ばして作る
- いつも同じ内容の行を、まとめて追加する
- 作る行のほかの列に、式・ほかのフィールドの値・固定の値・ログインユーザーを入れる
- すでに行があるときの動き(空のときだけ/後ろに追加/作り直す)を選べる
- PC版・モバイル版の追加・編集画面で動作する
プラグインを入れる前。対象月を入れても、予定のテーブルは空の1行のまま
プラグインを入れた後。対象月(2026-12-01)を入れた時点で、12/1〜12/31の31行が並び、回と内容も入る
こんな場面で役立ちます。
- 月ごとの作業予定や日報で、日付の行を毎回1行ずつ追加している
- 営業日だけの予定表を、カレンダーを見ながら作っている
- 定期訪問や分割払いのように、決まった間隔の行を並べたい
- 案件や手続きで、いつも同じ明細の行から始める
動作環境・前提条件
2-1. 事前に必要な設定
行を追加するテーブルを、アプリのフォームに用意しておきます。
日付や番号を連続で作るときは、テーブルの中に日付か数値の列が必要です。対象月や開始日をフィールドから取るときは、そのフィールドもテーブルの外に用意します。
⚠️ アプリにテーブルが無いと、設定画面に「このアプリにはテーブルがありません。フォームにテーブルを追加し、アプリを更新してから設定してください。」と表示されます。
2-2. 必要な権限
| 対象 | 必要な権限 |
|---|---|
| プラグインを設定する人 | アプリの管理権限 |
| レコードを入力する人 | テーブルを編集できる権限(kintone 標準のフィールドの権限に従います) |
2-3. 対応する画面
| 画面 | 対応 |
|---|---|
| レコード追加・編集画面(PC版・モバイル版) | 対応 |
| レコード詳細画面・一覧のインライン編集 | 対象外 |
| CSVの読み込み、API・ほかのプラグインによる更新 | 対象外 |
設定手順
3-1. プラグインを追加する
- アプリの設定画面を開き、「設定」タブの「プラグイン」をクリックします。
- 「追加する」をクリックし、「サブテーブル自動行追加プラグイン」にチェックを入れて「追加」をクリックします。
- プラグインの一覧で、サブテーブル自動行追加プラグインの歯車のアイコンをクリックすると、設定画面が開きます。
3-2. ルールを作る
- タブの「+」をクリックして、ルールを追加します。
- 「ルール名」を入力します。右のスイッチで、ルールの有効・無効を切り替えられます。
- 「行を追加するテーブル」を選びます。
- 「実行するタイミング」を選びます(3-3 を参照)。
- 必要なら「条件」を設定します。条件が無いときは、いつも実行します。
- 「すでに行があるとき」を選びます(3-4 を参照)。
- 「行の作り方」を選び、内容を設定します(3-5・3-6 を参照)。
ルールの設定画面。行を追加するテーブル、実行するタイミング、条件を設定する
ルールは左のタブから順に実行します。タブはドラッグで並べ替えられます。
3-3. 実行するタイミング
複数選べます。
| タイミング | 動くとき |
|---|---|
| 追加画面を開いたとき | レコードの追加画面を開いたとき(再利用は含みません) |
| レコードを再利用したとき | 「再利用する」で追加画面を開いたとき |
| 編集画面を開いたとき | レコードの編集画面を開いたとき |
| 値が変わったとき | 開始・終了・条件・式で参照している、テーブルの外のフィールドが変わったとき |
| 保存するとき | 保存ボタンを押したとき(保存の直前) |
💡 「値が変わったとき」は、行を作るテーブル自身の列が変わっても動きません。対象月などのテーブルの外のフィールドを参照しているルールで使います。
3-4. すでに行があるとき
| 選択肢 | 動き |
|---|---|
| 行が空のときだけ追加する | 入力済みの行が1つでもあれば、何もしません。追加画面に最初からある空の1行は、空として扱います |
| いまの行の後ろに追加する | いまの行の後ろに追加します。実行するたびに行が増えます |
| いまの行を消して作り直す | いまの行を消して作り直します。手で入力した行も消えます。作る内容がいまの行と同じときは、何もしません |
「いまの行を消して作り直す」では、「入力済みの行が消えるときは、確認を出す」にチェックを入れると、消す前に確認が出ます(初めからチェックが入っています)。
⚠️ 「いまの行の後ろに追加する」を「編集画面を開いたとき」「値が変わったとき」「保存するとき」と組み合わせると、そのたびに行が増えます。設定画面にも注意が出ます。
3-5. 日付や番号を連続で作る
「行の作り方」で「日付や番号を連続で作る」を選び、次の項目を設定します。
連続させる列に予定日、開始に「対象月」のその月の1日、終了に開始日のその月の末日を設定したところ
| 項目 | 設定する内容 |
|---|---|
| 連続させる列 | テーブルの中の日付か数値の列 |
| 開始 | 日付:「今日」「フィールドの日付」「日付を指定」/数値:「数値を指定」「フィールドの値」 |
| 終了 | 「行数で決める」(行数を指定/フィールドの値)か、「終わりの日で決める」(日付)・「終わりの値で決める」(数値)。終わりの日・値も含めて作ります |
| 間隔 | 日付:○日ごと・週ごと・か月ごと・年ごと/数値:○ずつ増やす(マイナスで減らす) |
| 飛ばす日 | 日付のときだけ。曜日(日〜土)と「祝日(2025〜2030年の国民の祝日・振替休日)」 |
日付の開始・終了には、次の補正とずらしを付けられます。補正を先に、ずらしをあとに使います。
- 補正:「そのままの日」「その月の1日」「その月の末日」「その年の1月1日」「その年の12月31日」「その週の日曜日」
- ずらし:「から ○ 日後」(日後・週後・か月後・年後)。マイナスにすると前の日になります(例:その月の1日 から -1 日後 = 前の月の末日)
💡 か月ごと・年ごとの間隔は、毎回開始日から数え直します。月末を超える日は月末にそろえます(例:1/31 始まりで 1/31、2/28、3/31、4/30)。
飛ばした日は行数に数えません。「行数で決める」で10行にすると、飛ばした分だけ先まで進めて10行作ります。
設定欄の下には、いま実行した場合に何行できるかのプレビューが表示されます。
土日と祝日を飛ばすと、プレビューが19行(2026-11-02〜2026-11-30)になる。下は、ほかの列に入れる値の設定
ほかの列に入れる値
「+ 列を追加」をクリックし、値を入れる列と入れる値を設定します(30件まで)。
- 入れる値は「式の結果」「ほかのフィールドの値」「固定の値」「ログインユーザー」(ユーザー選択の列のみ)から選べます。
- 式では、作っている行の値(連続させる列など)と、行番号の ROW_NO() が使えます。例:
会社名 & "(" & DATE_FORMAT(予定日,"m/d") & ")" - 値を入れない列は、フォームで行を追加したときと同じ初期値になります。
3-6. 決めた行を追加する
「行の作り方」で「決めた行を追加する」を選び、次の項目を設定します。
- 「値を入れる列」で、値を入れる列を選びます(20列まで)。
- 「追加する行」の表に、追加する行の値を入力します。「+ 行を追加」で行を増やせます(100行まで)。
値を入れる列に品名・数量・種別を選び、追加する行を2行入力したところ
- 入力した文字がそのまま入ります。
=で始めると式になります(例:=TODAY()、=ROW_NO()+3)。- チェックボックスなど複数選べる列は、
,で区切ります。 - 空欄の列は、フォームの初期値のままです。
- 値に誤りがあるセルは赤くなり、マウスを重ねると理由が表示されます。
3-7. 式の書き方
式は kintone の計算式と同じ書き方です。設定画面の「式の書き方と、使える関数」でも確かめられます。
- フィールドの値は、フィールドコードをそのまま書きます(例:
単価*ROW_NO())。 - 文字は
""で囲み、文字をつなげるときは&を使います。+は数値の足し算だけです。 - 使える関数は、IF・AND・OR・NOT・LIKE、TODAY・NOW・DATE_CALC・DATE_DIFF・DATE_FORMAT・DATE_STRING(和暦)・AGE・WEEK_CALC、LEFT・RIGHT・MID・LEN・LPAD・RPAD・REPLACE・SUBSTITUTE・ASC・TRIM など、自動入力プラグインと同じ42種類です。
3-8. 保存する
「設定保存」をクリックします(Ctrl+S でも保存できます)。設定の確認のあと、アプリの更新まで自動で行います。
「設定を保存して、アプリを更新しました」と表示されたら完了です。
「設定出力」で設定を JSON ファイルに保存し、「設定読込」でほかのアプリに読み込めます。読み込んだあとは「設定保存」を押して確定します。
使い方
4-1. 行を作る
設定したアプリでレコードを追加・編集すると、ルールのタイミングで行が追加されます。
- 「追加画面を開いたとき」のルールは、画面を開いた時点で行が並びます。
- 「値が変わったとき」のルールは、対象月などを入力して、カーソルがほかへ移った時点で行が並びます。
作った行は、ふつうの行と同じように手で直したり、削除したりできます。
4-2. 作り直すときの確認
「いまの行を消して作り直す」のルールで、入力済みの行が消えるときは、次の確認が出ます(確認を出す設定のとき)。
「「ルール名」:テーブルの行を作り直します。入力済みの ○ 行は消えます。よろしいですか?」
「キャンセル」を押すと、行はそのまま残ります。
4-3. スマートフォンで使う
kintone のモバイル版の追加・編集画面でも、PC版と同じように動きます。
制限事項・注意点
- 一度に作る行は366行までです。 超えるときは366行までを作り、「行数が上限(366行)を超えるため、366行までを作成しました。」と表示します。
- 決めた行は100行まで、値を入れる列は20列までです。
- 祝日は2025〜2030年の国民の祝日・振替休日(国民の休日を含む)です。 2031年以降の日や、会社独自の休日は飛ばせません。
- 連続させる列に選べるのは、日付と数値の列だけです。
- 行を作るテーブル自身の列は、条件に使えません。
- 詳細画面、一覧のインライン編集、CSVの読み込み、API・ほかのプラグインによる更新では動きません。
- 計算フィールド、ルックアップのコピー先、自動計算を設定した文字列(1行)の列には、値を入れられません。 ルックアップの列に値を入れると、参照先のデータの取得まで行います。
- 開始日や行数のフィールドが空のとき、終了が開始より前のときは、行を作りません。
- 値を入れられない列は、初期値のままにします。 選択肢にない値、日付として読めない値などは入れません。レコードの保存は止めません。
- 設定のあとでフォームのテーブルの列を消したときは、いまのフォームに合わせて行を作ります。 消した列を使っていた設定は、設定画面を開いて保存し直してください。
困ったときは
6-1. 表示されるメッセージ
| メッセージ | 内容 |
|---|---|
| 「ルール名」:テーブルの行を作り直します。… | 入力済みの行を消して作り直す前の確認です |
| 「ルール名」:行数が上限(366行)を超えるため、366行までを作成しました。 | 上限の366行で打ち切りました。開始・終了・間隔を確かめてください |
| この設定では行を作れません。開始・終了・間隔を確認してください。(設定画面) | プレビューで行が作れない設定です |
| 設定は保存しましたが、アプリを更新できませんでした(設定画面) | アプリの設定画面で「アプリを更新」を押してください |
6-2. 確認ポイント
| 症状 | 確認すること |
|---|---|
| 行が追加されない | ルールが「有効」か。タイミングと条件が合っているか |
| 「行が空のときだけ追加する」で追加されない | 入力済みの行が残っていないか(初期値と違う値の列が1つでもあれば入力済みとみなします) |
| 対象月を入れても行が並ばない | タイミングに「値が変わったとき」が入っているか。開始・終了でそのフィールドを参照しているか |
| 再利用したときに動かない | 「レコードを再利用したとき」にチェックが入っているか |
| 行が増え続ける | 「いまの行の後ろに追加する」を、編集・保存・値の変更と組み合わせていないか |
| 手で入れた行が消えた | 「いまの行を消して作り直す」になっていないか。確認を出す設定になっているか |
| 祝日が飛ばされない | 2031年以降の日付ではないか。「祝日」にチェックが入っているか |
| 一部の列が空・初期値のまま | 入れようとした値が選択肢にあるか、日付として読めるか |
6-3. よくある質問
Q. 営業日(平日)だけの行を作りたい
A. 「飛ばす日」で「日」「土」と「祝日」にチェックを入れてください。
Q. 毎月同じ日の行を12回分作りたい
A. 連続させる列を日付の列にし、間隔を「1か月ごと」、終了を「行数で決める」の12行にします。月末を超える日は月末にそろえます。
Q. ほかのアプリにも同じ設定を使いたい
A. 「設定出力」で保存したファイルを、ほかのアプリの設定画面の「設定読込」で読み込みます。フィールドコードが違う箇所は、設定し直してください。