株式会社XenoX

マニュアル›サブテーブル自動行追加プラグイン

サブテーブル自動行追加プラグイン マニュアル

このプラグインでできること

「サブテーブル自動行追加プラグイン」は、条件に合うときに、レコードのテーブル(サブテーブル)へ行を自動で追加するプラグインです。
対象月の1日〜末日の日付を1行ずつ作ったり、いつも同じ内容の行をまとめて追加したりできます。日付や番号だけでなく、ほかの列の値も行ごとに入れられます。

サブテーブル自動行追加プラグインの紹介ページを見る

主な機能は次のとおりです。

  • 日付や番号を、開始・終了・間隔を決めて1行ずつ連続で作る(例:対象月の1日〜末日、今日から毎週5回、1〜12回)
  • 土日などの曜日や、国民の祝日(2025〜2030年)を飛ばして作る
  • いつも同じ内容の行を、まとめて追加する
  • 作る行のほかの列に、式・ほかのフィールドの値・固定の値・ログインユーザーを入れる
  • すでに行があるときの動き(空のときだけ/後ろに追加/作り直す)を選べる
  • PC版・モバイル版の追加・編集画面で動作する

プラグインを入れる前。対象月を入れても、予定のテーブルは空の1行のまま

プラグインを入れる前。対象月を入れても、予定のテーブルは空の1行のまま

プラグインを入れた後。対象月(2026-12-01)を入れた時点で、12/1〜12/31の31行が並び、回と内容も入る

プラグインを入れた後。対象月(2026-12-01)を入れた時点で、12/1〜12/31の31行が並び、回と内容も入る

こんな場面で役立ちます。

  • 月ごとの作業予定や日報で、日付の行を毎回1行ずつ追加している
  • 営業日だけの予定表を、カレンダーを見ながら作っている
  • 定期訪問や分割払いのように、決まった間隔の行を並べたい
  • 案件や手続きで、いつも同じ明細の行から始める

動作環境・前提条件

2-1. 事前に必要な設定

行を追加するテーブルを、アプリのフォームに用意しておきます。
日付や番号を連続で作るときは、テーブルの中に日付か数値の列が必要です。対象月や開始日をフィールドから取るときは、そのフィールドもテーブルの外に用意します。

⚠️ アプリにテーブルが無いと、設定画面に「このアプリにはテーブルがありません。フォームにテーブルを追加し、アプリを更新してから設定してください。」と表示されます。

2-2. 必要な権限

対象必要な権限
プラグインを設定する人アプリの管理権限
レコードを入力する人テーブルを編集できる権限(kintone 標準のフィールドの権限に従います)

2-3. 対応する画面

画面対応
レコード追加・編集画面(PC版・モバイル版)対応
レコード詳細画面・一覧のインライン編集対象外
CSVの読み込み、API・ほかのプラグインによる更新対象外

設定手順

3-1. プラグインを追加する

  1. アプリの設定画面を開き、「設定」タブの「プラグイン」をクリックします。
  2. 「追加する」をクリックし、「サブテーブル自動行追加プラグイン」にチェックを入れて「追加」をクリックします。
  3. プラグインの一覧で、サブテーブル自動行追加プラグインの歯車のアイコンをクリックすると、設定画面が開きます。

3-2. ルールを作る

  1. タブの「+」をクリックして、ルールを追加します。
  2. 「ルール名」を入力します。右のスイッチで、ルールの有効・無効を切り替えられます。
  3. 「行を追加するテーブル」を選びます。
  4. 「実行するタイミング」を選びます(3-3 を参照)。
  5. 必要なら「条件」を設定します。条件が無いときは、いつも実行します。
  6. 「すでに行があるとき」を選びます(3-4 を参照)。
  7. 「行の作り方」を選び、内容を設定します(3-5・3-6 を参照)。

ルールの設定画面。行を追加するテーブル、実行するタイミング、条件を設定する

ルールの設定画面。行を追加するテーブル、実行するタイミング、条件を設定する

ルールは左のタブから順に実行します。タブはドラッグで並べ替えられます。

3-3. 実行するタイミング

複数選べます。

タイミング動くとき
追加画面を開いたときレコードの追加画面を開いたとき(再利用は含みません)
レコードを再利用したとき「再利用する」で追加画面を開いたとき
編集画面を開いたときレコードの編集画面を開いたとき
値が変わったとき開始・終了・条件・式で参照している、テーブルの外のフィールドが変わったとき
保存するとき保存ボタンを押したとき(保存の直前)

💡 「値が変わったとき」は、行を作るテーブル自身の列が変わっても動きません。対象月などのテーブルの外のフィールドを参照しているルールで使います。

3-4. すでに行があるとき

選択肢動き
行が空のときだけ追加する入力済みの行が1つでもあれば、何もしません。追加画面に最初からある空の1行は、空として扱います
いまの行の後ろに追加するいまの行の後ろに追加します。実行するたびに行が増えます
いまの行を消して作り直すいまの行を消して作り直します。手で入力した行も消えます。作る内容がいまの行と同じときは、何もしません

「いまの行を消して作り直す」では、「入力済みの行が消えるときは、確認を出す」にチェックを入れると、消す前に確認が出ます(初めからチェックが入っています)。

⚠️ 「いまの行の後ろに追加する」を「編集画面を開いたとき」「値が変わったとき」「保存するとき」と組み合わせると、そのたびに行が増えます。設定画面にも注意が出ます。

3-5. 日付や番号を連続で作る

「行の作り方」で「日付や番号を連続で作る」を選び、次の項目を設定します。

連続させる列に予定日、開始に「対象月」のその月の1日、終了に開始日のその月の末日を設定したところ

連続させる列に予定日、開始に「対象月」のその月の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)になる。下は、ほかの列に入れる値の設定

土日と祝日を飛ばすと、プレビューが19行(2026-11-02〜2026-11-30)になる。下は、ほかの列に入れる値の設定

ほかの列に入れる値

「+ 列を追加」をクリックし、値を入れる列と入れる値を設定します(30件まで)。

  • 入れる値は「式の結果」「ほかのフィールドの値」「固定の値」「ログインユーザー」(ユーザー選択の列のみ)から選べます。
  • 式では、作っている行の値(連続させる列など)と、行番号の ROW_NO() が使えます。例:会社名 & "(" & DATE_FORMAT(予定日,"m/d") & ")"
  • 値を入れない列は、フォームで行を追加したときと同じ初期値になります。

3-6. 決めた行を追加する

「行の作り方」で「決めた行を追加する」を選び、次の項目を設定します。

  1. 「値を入れる列」で、値を入れる列を選びます(20列まで)。
  2. 「追加する行」の表に、追加する行の値を入力します。「+ 行を追加」で行を増やせます(100行まで)。

値を入れる列に品名・数量・種別を選び、追加する行を2行入力したところ

値を入れる列に品名・数量・種別を選び、追加する行を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. 「設定出力」で保存したファイルを、ほかのアプリの設定画面の「設定読込」で読み込みます。フィールドコードが違う箇所は、設定し直してください。

« マニュアルの一覧に戻る