# 本番スプレッドシートに「新しいレコードの列ブロック」を安全に増やす型（GAS） 横並び（wide format）で 1 レコード = N 列のブロックが並ぶ運用シートに、**新しいレコードのブロックを プログラムから追加する**ための型。現場が毎日使っている本番シートに、人の手コピペを廃止して 「フォームに入力 → ブロックが自動でできる」を実現する。 対象: Google Apps Script（clasp 管理 / AI から関数を呼べる構成）。 似た型に「既存セルを一括更新する」ものがあるが、本書は**列を増やす**側の落とし穴に絞る。 --- ## 0. まず実測する（推測でレイアウトを決めない） wide format のシートは「何行目が何か」がドキュメント化されていないことが多い。 **書き込みコードを1行も書く前に、読み取り専用のプローブ関数で実形状を取る。** ```javascript /** 指定ブロックの実形状を返す（読み取り専用） */ function debug_blockShape(blockStart) { const sheet = SpreadsheetApp.openById('<スプレッドシートID>').getSheetByName('<シート名>'); const lastCol = sheet.getLastColumn(); const blocks = []; for (let bs = FIRST_COL; bs + (BLOCK_WIDTH - 1) <= lastCol; bs += BLOCK_WIDTH) blocks.push(bs); const target = Number(blockStart) || blocks[blocks.length - 1]; return { lastCol: lastCol, maxCols: sheet.getMaxColumns(), blockCount: blocks.length, blockStarts: blocks, target: target, // 見出し行の値と数式を両方返す（値だけ見ると数式の存在に気付けない） headValues: sheet.getRange(1, target, HEAD_ROWS, BLOCK_WIDTH).getValues(), headFormulas: sheet.getRange(1, target, HEAD_ROWS, BLOCK_WIDTH).getFormulas(), // ドロップダウンの有無（コピーで運ばれるか判断するため） validation: String((sheet.getRange(20, target + BLOCK_WIDTH - 1).getDataValidation() || {}).getCriteriaType ? sheet.getRange(20, target + BLOCK_WIDTH - 1).getDataValidation().getCriteriaType() : ''), columnWidths: [0, 1, 2].map(function (i) { return sheet.getColumnWidth(target + i); }), frozenRows: sheet.getFrozenRows(), frozenCols: sheet.getFrozenColumns() }; } ``` 実測でよく判明すること（どれも推測だと外す）: - 本体データが終わる行と、その下に**集計対象外の旧行**が残っている（`getLastRow()` を信じると件数が倍になる） - 見出しに見えるセルが実は数式（`COUNTIF` / `IMPORTRANGE`） - ブロック先頭列が「N 列おき」の規則から外れている列がある - URL セルが `HYPERLINK` 数式ではなく**素の文字列** --- ## 1. 新ブロックは「既存ブロックの複製」で作る（自前で組み立てない） ```javascript sheet.getRange(1, templateStart, COPY_ROWS, BLOCK_WIDTH) .copyTo(sheet.getRange(1, newStart, COPY_ROWS, BLOCK_WIDTH), SpreadsheetApp.CopyPasteType.PASTE_NORMAL, false); ``` `PASTE_NORMAL` は **書式・数式・データ検証（プルダウン）・条件付き書式**をまとめて運ぶ。 自前で `setFormula` を書き直すと、表記ゆれ（全角/半角、集計範囲の行数違い）で既存ブロックと 微妙に違う式ができ、**集計だけが静かにズレる**。 複製したあとに消すもの・直すもの: | 対象 | 処理 | 理由 | |---|---|---| | データ行 | `clearContent()` | 検証と書式は残す（`clear()` だとプルダウンごと消える） | | 見出し行 | `clearContent()` → 新しい値を `setValues` | | | **相対参照の集計式**（`=COUNTIF(X15:X234,"済")`） | **触らない** | コピーで新しい列へ自動追従する | | **絶対URLを持つ数式**（`IMPORTRANGE("https://…")`） | URL を差し替える。無ければ `clearContent()` | **コピー元のレコードを指したまま残る**＝他レコードのデータが混ざる | | 列幅 | `setColumnWidth()` で別途コピー | `copyTo` は列幅を運ばない | ```javascript // IMPORTRANGE の URL だけを差し替える純粋関数（テスト可能） function rewriteImportrange(formula, newUrl) { if (!newUrl) return ''; // 空 = クリア指示 return String(formula || '').replace( /(IMPORTRANGE\s*\(\s*)(["'])([^"']*)(\2)/i, function (_, prefix, quote, oldUrl, close) { return prefix + quote + newUrl + close; }); } ``` --- ## 2. 列を増やす方向のガード（これが無いと全レコードがズレる） ```javascript const newStart = lastBlockStart + BLOCK_WIDTH; if ((newStart - FIRST_COL) % BLOCK_WIDTH !== 0) throw new Error('ブロック位置が不正: ' + newStart); if (sheet.getMaxColumns() < newStart + BLOCK_WIDTH - 1) { sheet.insertColumnsAfter(sheet.getMaxColumns(), BLOCK_WIDTH); // 追加は右端だけ } ``` - **追加は右端のみ**。中間への `insertColumns` は右側の全ブロックの列番号を変え、 他システムが保存している「レコード → 列番号」の対応を一斉に壊す - **削除も最終ブロックのみ**許可し、期待するキー（レコード名など）の一致を関数側で検証する - 冪等性: 同じキーのブロックが既にあれば**新規作成せず再利用**する。 「押すたびにブロックが増える」が最悪の事故 --- ## 3. 日付書式セルの read-back を文字列で照合しない（実害あり） 書き込み後の `flush()` → 読み直し照合は必須だが、**日付の表示形式が付いたセル**に `setValue('2026/12/01')` すると **Sheets 側が Date 値に変換して保存する**。 読み戻すと `Date` オブジェクトなので、素朴な `String(actual) !== expected` は必ず不一致になる。 ``` mismatches: [{ row: 4, expected: "2026/12/01", actual: "Tue Dec 01 2026 00:00:00 GMT+0900" }] ← 値は正しいのに不一致 ``` 値は正しいのに毎回「不一致」が出ると、**本物の書き込み失敗（保護範囲やデータ検証による silent ignore）を見逃す**。照合側を日付に対応させる: ```javascript function sameCell(actual, expected) { const norm = function (v) { if (v instanceof Date && !isNaN(v.getTime())) { const jst = new Date(v.getTime() + 9 * 60 * 60 * 1000); // タイムゾーンは自環境に合わせる const pad = function (n) { return ('0' + n).slice(-2); }; return jst.getUTCFullYear() + '/' + pad(jst.getUTCMonth() + 1) + '/' + pad(jst.getUTCDate()); } const s = String(v == null ? '' : v).trim(); const m = s.match(/^(\d{4})[/-](\d{1,2})[/-](\d{1,2})$/); // 2026/12/1 と 2026/12/01 を同一視 return m ? m[1] + '/' + ('0' + m[2]).slice(-2) + '/' + ('0' + m[3]).slice(-2) : s; }; return norm(actual) === norm(expected); } ``` 日付として解釈できない値は**従来どおり厳密比較**する。緩めすぎると照合の意味が無くなる。 --- ## 4. 本番で検証するための「撤去コマンド」を先に作る 本番シートでしか再現しない問題（数式の追従・プルダウン・条件付き書式）があるので、 **本番で1件登録して検証する**のが正しい。そのために**撤去コマンドを先に用意**する。 ```javascript /** テスト登録を丸ごと撤去する。dryRun 既定 true */ function admin_removeTestRecord(recordId, opts) { const dryRun = !(opts && opts.dryRun === false); // ① キーが "__TEST__" で始まるレコードしか消せない（誤爆の上限を関数で縛る） if (String(clientName).indexOf('__TEST__') !== 0) return { ok: false, reason: 'テストレコードではありません' }; // ② 最終ブロックであることを確認してから deleteColumns(blockStart, BLOCK_WIDTH) // ③ 付随して作られたシート/行/フォルダも消す（フォルダは削除ではなく setTrashed(true)） // ④ 消したあと read-back して残骸ゼロを確認し、残っていたら ok:false で残骸を返す } ``` 検証の流れ: 1. `register(payload, {dryRun:true})` … **1セルも書かず**に「何列目に作るか」を返す 2. `register(payload)` … 実行 3. `debug_blockShape(newBlockStart)` … 見出し・数式・プルダウン・空のデータ行を**実測で確認** 4. `admin_removeTestRecord(id, {dryRun:true})` → `{dryRun:false}` … 撤去 5. `debug_blockShape()` … **元のブロック数・最終列に戻ったこと**を確認 戻り値の `ok:true` だけを信じない。**同じデータを別コマンドで読み直す**まで検証は終わっていない。 --- ## 5. AI に渡すときのチェックリスト - [ ] 読み取り専用プローブで実形状を取り、**その数値を仕様書に貼ってから**実装を依頼したか - [ ] 新ブロックは既存ブロックの `copyTo(PASTE_NORMAL)` で作る指示になっているか - [ ] 絶対URL入り数式（`IMPORTRANGE` 等）の差し替え／クリアを明記したか - [ ] 「既存ブロックには絶対に書かない」「中間への列挿入・削除は禁止」を明記したか - [ ] キー重複時に再利用する（増殖させない）冪等性を明記したか - [ ] `dryRun` と撤去コマンドを**実装と同じ依頼**に含めたか - [ ] 日付セルの照合を文字列比較にしていないか - [ ] レコード名・ラベルの生成規則が、**既存の同期処理と1文字も違わない**ことをテストで固定したか ---