【GAS入門#90】スプレッドシートをデータベースにする方法!WebアプリからのCRUD(登録・検索・更新・削除)完全攻略

「日々の請求データや売上実績を、チームのメンバーみんなで安全に管理したい」
「でも、スプレッドシートを全員に直接触らせると、関数をうっかり消されたり、行を間違えて上書きされたりしてヒヤヒヤする……」

業務でGoogleスプレッドシートを共有していると、こんな悩みに直面したことはありませんか?

そんな悩みを根本から解決するのが、今回マスターする「スプレッドシートをデータベース(DB)にしたデータ連携(CRUD:クラッド)」です!

前回(第87回・第88回)は google.script.run を使って画面のボタンから請求書を自動発行する方法を、第89回では外部からのデータを受信する doPost(e) を学びました。
そして今回の第90回は、全10回にわたってお届けしてきた「フェーズ9:Webアプリ化編(第81回〜第90回)」の集大成となります!

Webアプリの画面から、スプレッドシートの中にあるデータを「検索(Read)」「新しく追加(Create)」「修正・更新(Update)」「削除(Delete)」という、システム開発のすべてが詰まったフルスタックなダッシュボードを完成させます。プログラミング初心者の方でも絶対に迷わないよう、1行ずつ丁寧に噛み砕いて解説していきますね!

1. そもそも「CRUD(クラッド)」とは?Web開発の最重要概念

Webアプリケーションやシステム開発の世界に足を踏み入れると、必ず耳にするのが「CRUD(クラッド)」という言葉です。なんだか難しそうな専門用語に見えますが、意味はとてもシンプルです。

CRUDの4文字を分解してみよう!

CRUDとは、データ管理システムに必要な「4つの基本機能」の頭文字を並べたものです。

頭文字英語日本語今回のダッシュボードでの具体的な操作
CCreate作成・登録画面の入力フォームから、新しい請求・案件データをスプレッドシートへ追加する
RRead参照・検索スプレッドシートに保存されたデータを読み込み、画面の一覧表に綺麗に表示・キーワード検索する
UUpdate更新・編集すでに登録されている金額やステータス(例:「未請求」→「入金済」)を画面から書き換える
DDelete削除・消去誤って登録したデータやキャンセルになった案件を行ごと安全に削除する

世の中にあるほぼすべてのWebサービス(Twitter/Xの投稿・タイムライン表示・プロフ編集・ツイ消し、Amazonのカート追加や注文履歴確認など)は、突き詰めればすべてこの「CRUD」の組み合わせでできています。

つまり、今回の講義でスプレッドシートをデータベースに見立てたCRUDをマスターできれば、あなたは「世の中のあらゆるWebシステムを自分でゼロから構築できる土台」を手に入れたことになります!

2. スプレッドシートを「データベース」として使うための設計鉄則

普段使っているスプレッドシートは「人間の目で見るための表計算シート」ですが、プログラムから安全にデータを出し入れする「データベース(DB)」として扱うには、守らなければならない3つの鉄則があります。

鉄則①:1行目に必ず重複しない「管理ID(主キー)」を持たせる

これが最も大切です!
人間は「株式会社札幌スープカレー本舗の行」と目で探せますが、プログラムにとっては「同じ会社名で別の請求」が複数あった場合、どれを更新してどれを消せばいいか区別がつきません。

そのため、INV-1001、INV-1002 のように、絶対に世界で1つしか存在しない「ユニークな管理ID(主キー / Primary Key)」を1列目に必ず割り振ります。更新も削除も、すべてこの「ID」を手がかりにして行います。

鉄則②:行番号(Row Index)を信用しすぎない

初心者が一番やってしまう事故が、「3行目にあるデータを更新しよう!」と行番号を直接コードに書いてしまうことです。
もし別の人が手作業で1行挿入したり、並び替え(ソート)をしたりすると、3行目にあったデータが4行目や5行目にズレてしまい、全く関係ない他社のデータが上書き破壊されてしまいます。

「行番号」ではなく、「管理IDが一致する行をプログラムで検索して特定する」のがプロの設計です。

鉄則③:1行=1件のデータ(見出し以外の余計な装飾を入れない)

セル結合をしたり、途中に空行を挟んだり、「合計」などのメモ行をデータエリアの真ん中に挟むと、GASがデータを読み取る際に大パニックを起こします。シートは「1行目が見出し、2行目以降はひたすらデータが縦に並ぶ」という美しい長方形をキープしましょう。

3. 全体設計図:ブラウザとスプレッドシートがどう対話するか

今回作成するシステムの全体像を頭に入れておきましょう。
第87回・第88回で学んだ google.script.run が、手元のブラウザ画面(HTML)とクラウド上のGoogleサーバー(GAS & スプレッドシート)の間を縦横無尽に走り回ります!

【ブラウザ画面(index.html)】
│
├── ① 検索窓に入力 / 画面を開く ──> [ google.script.run.getRecords(keyword) ] ──> 【スプレッドシートから抽出】 (Read)
├── ② 新規登録ボタンをクリック ───> [ google.script.run.addRecord(newRow) ] ────> 【最下行へ追記】 (Create)
├── ③ 編集して保存をクリック ─────> [ google.script.run.updateRecord(data) ] ───> 【ID一致行を上書き】 (Update)
└── ④ 削除ボタンをクリック ───────> [ google.script.run.deleteRecord(id) ] ─────> 【ID一致行を削除】 (Delete)
│
▼
【結果を withSuccessHandler で受け取り、画面全体をリロードせずに一覧テーブルを即座に再描画!】

Webページ全体が真っ白になって再読み込みされる昔ながらのWebサイトではなく、画面がその場にとどまったままデータだけがサクサク入れ替わるSPA(シングルページアプリケーション)のような快適な操作感を実現します!

STEP 1:準備!データベース用スプレッドシートを作成しよう

それでは、手元に練習用のGoogleスプレッドシートを用意していきましょう!

スプレッドシートの作成手順

  1. ブラウザで Googleドライブ を開き、新しいGoogleスプレッドシートを作成します。
  2. ファイル名を 「札幌オフィス統合管理簿」 に設定します。
  3. 画面下のシートタブ名を 「請求業績DB」 に変更します。
  4. 1行目に見出し(ヘッダー)、2行目以降に初期テスト用データを入力します。
A列(ID)B列(取引先名)C列(案件名)D列(請求金額)E列(ステータス)F列(最終更新日時)
INV-1001株式会社札幌スープカレー本舗ECサイト改修・決済連携165,000請求済2026/11/01 10:00:00
INV-1002道産子フーズ株式会社GAS業務自動化ツール導入220,000未請求2026/11/02 14:30:00
INV-1003北海ITソリューションズクラウドサーバー保守(11月)55,000入金確認済2026/11/03 09:15:00
INV-1004大通デジタルマーケティング札幌イベントLP制作132,000未請求2026/11/03 11:20:00

入力が完了したら、上部メニューの 「拡張機能」 > 「Apps Script」 をクリックして、GASのエディタ画面を開いておきましょう!

STEP 2:【サーバー側】コード.gs にCRUDのバックエンド処理を実装!

まずはGoogleサーバー側(バックエンド)のプログラムから組んでいきます。
ここには、画面を表示する doGet(e) と、CRUDを担当する4つの主要関数を配置します。

エディタ内の既存コードをすべて消去し、以下のスクリプトを貼り付けてください。

/**
* 札幌オフィス統合ダッシュボード Webアプリケーション
* 第90回:スプレッドシートをデータベースにしたCRUD完全連携
*/

// ① Webアプリのトップ画面を表示する(第81回〜第86回の集大成)
function doGet(e) {
var htmlOutput = HtmlService.createTemplateFromFile('index').evaluate();
htmlOutput.setTitle('【札幌オフィス】請求・業績データ統合管理ダッシュボード');
htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1');
return htmlOutput;
}

// 共通ヘルパー:データベース用シートを取得する
function getDbSheet() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("請求業績DB");
if (!sheet) {
throw new Error("シート「請求業績DB」が見つかりません。");
}
return sheet;
}

// ==============================================================
// 1. 【Read & Search】データを検索・全件取得する関数
// ==============================================================
function getRecords(searchKeyword) {
var sheet = getDbSheet();
var lastRow = sheet.getLastRow();

// データが1件もない(見出し行のみ)場合
if (lastRow < 2) {
return [];
}

// A2からF列の最終行まで一括取得(第13回 Range.getValues の復習!)
var values = sheet.getRange(2, 1, lastRow - 1, 6).getValues();
var records = [];

var keyword = (searchKeyword || "").trim().toLowerCase();

for (var i = 0; i < values.length; i++) {
var id = String(values[i][0]);
var company = String(values[i][1]);
var project = String(values[i][2]);
var amount = Number(values[i][3]) || 0;
var status = String(values[i][4]);
var rawDate = values[i][5];

// 日付のフォーマット整形(第29回 Utilities.formatDate の復習!)
var formattedDate = "";
if (rawDate instanceof Date) {
formattedDate = Utilities.formatDate(rawDate, "Asia/Tokyo", "yyyy/MM/dd HH:mm");
} else {
formattedDate = String(rawDate);
}

// 検索キーワードでフィルタリング(会社名、案件名、ステータス、IDのいずれかにヒットすればOK)
if (keyword === "" ||
company.toLowerCase().indexOf(keyword) !== -1 ||
project.toLowerCase().indexOf(keyword) !== -1 ||
status.toLowerCase().indexOf(keyword) !== -1 ||
id.toLowerCase().indexOf(keyword) !== -1) {

records.push({
id: id,
company: company,
project: project,
amount: amount,
status: status,
updatedAt: formattedDate
});
}
}

return records;
}

// ==============================================================
// 2. 【Create】新しい請求レコードを新規登録する関数
// ==============================================================
function addRecord(data) {
// 同時書き込みを防ぐロック(第89回の復習!)
var lock = LockService.getScriptLock();
lock.waitLock(10000);

try {
var sheet = getDbSheet();
var lastRow = sheet.getLastRow();

// ① 新しいユニークIDの自動採番(例: INV-1005)
var newIdNumber = 1001;
if (lastRow >= 2) {
var idValues = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
var maxNum = 1000;
for (var i = 0; i < idValues.length; i++) {
var match = String(idValues[i][0]).match(/INV-(\d+)/);
if (match) {
var num = parseInt(match[1], 10);
if (num > maxNum) maxNum = num;
}
}
newIdNumber = maxNum + 1;
}
var newId = "INV-" + newIdNumber;

// ② 更新日時の生成
var nowStr = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");

// ③ 最下行に追記(第7回 appendRow の復習!)
sheet.appendRow([
newId,
data.company,
data.project,
Number(data.amount) || 0,
data.status || "未請求",
nowStr
]);

return { success: true, message: "管理番号「" + newId + "」で新規登録しました!", newId: newId };

} finally {
lock.releaseLock();
}
}

// ==============================================================
// 3. 【Update】既存のレコードをIDで検索して更新する関数
// ==============================================================
function updateRecord(data) {
var lock = LockService.getScriptLock();
lock.waitLock(10000);

try {
var sheet = getDbSheet();
var lastRow = sheet.getLastRow();
if (lastRow < 2) throw new Error("更新対象のデータが存在しません。");

var idList = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
var targetRowIndex = -1;

// 管理ID(A列)を検索して、何行目にあるかを特定する
for (var i = 0; i < idList.length; i++) {
if (String(idList[i][0]) === String(data.id)) {
targetRowIndex = i + 2; // スプレッドシートの実行番号(2行目スタート)
break;
}
}

if (targetRowIndex === -1) {
throw new Error("指定されたID(" + data.id + ")が見つかりませんでした。");
}

var nowStr = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");

// B列〜F列(取引先名、案件名、金額、ステータス、更新日時)を一括更新!
// 第14回 Range.setValues の復習!
sheet.getRange(targetRowIndex, 2, 1, 5).setValues([[
data.company,
data.project,
Number(data.amount) || 0,
data.status,
nowStr
]]);

return { success: true, message: "管理番号「" + data.id + "」のデータを更新しました!" };

} finally {
lock.releaseLock();
}
}

// ==============================================================
// 4. 【Delete】既存のレコードをIDで検索して削除する関数
// ==============================================================
function deleteRecord(id) {
var lock = LockService.getScriptLock();
lock.waitLock(10000);

try {
var sheet = getDbSheet();
var lastRow = sheet.getLastRow();
if (lastRow < 2) throw new Error("削除対象のデータがありません。");

var idList = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
var targetRowIndex = -1;

for (var i = 0; i < idList.length; i++) {
if (String(idList[i][0]) === String(id)) {
targetRowIndex = i + 2;
break;
}
}

if (targetRowIndex === -1) {
throw new Error("削除対象のID(" + id + ")が見つかりませんでした。");
}

// 指定した行をまるごと削除(第19回 Sheet.deleteRow の復習!)
sheet.deleteRow(targetRowIndex);

return { success: true, message: "管理番号「" + id + "」を正常に削除しました。" };

} finally {
lock.releaseLock();
}
}

コードの解説:これまでの連載知識がフル活用されている点に注目!

  • getRecords():第13回の Range.getValues() で全データを一括取得し、第15回の配列検索(filter的アプローチ)を使ってキーワード部分一致の検索処理を行っています。
  • addRecord():既存の最大IDを正規表現で探して新しい番号(INV-1005 など)を自動生成し、第7回の Sheet.appendRow() で一番下の行に安全追記します。
  • updateRecord():A列のIDを1行ずつ探して目的の行番号を見つけたら、第14回の Range.setValues() で横一列のセルをサッと上書きします。
  • deleteRecord():IDで特定した行番号に対して、第19回で学んだ Sheet.deleteRow() を実行して綺麗にだるま落とし削除します。
  • LockService:第89回でも登場した同時書き込みガードです。誰かが追加・更新・削除している最中に別の人がボタンを押しても、データが壊れないよう順番待ち(ロック)をかけています。

コードが貼り付けられたら、フロッピーアイコンを押して保存しておきましょう!

STEP 3:【フロント側】index.html にダッシュボード画面とCRUD操作UIを実装!

続いて、ブラウザ側の画面となる index.html を作成します。
エディタ左側のファイル一覧横にある「+」アイコン > 「HTML」をクリックし、ファイル名を index にしてください(すでに存在する場合はそのまま開きます)。

中身をすべて消去し、以下の完全版コードで上書きして保存しましょう!

<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<base target="_top">
<title>札幌オフィス 請求・業績データ管理ダッシュボード</title>
<style>
/* --- リセット & 基本設計 --- */
* { box-sizing: border-box; margin: 0; padding: 0; }
body {
font-family: "Helvetica Neue", Arial, "Hiragino Kaku Gothic ProN", sans-serif;
background-color: #f4f7f6;
color: #2d3748;
padding: 24px;
}
.container {
max-width: 1080px;
margin: 0 auto;
}

/* --- ヘッダー --- */
.header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 24px;
background: #ffffff;
padding: 20px 24px;
border-radius: 10px;
box-shadow: 0 2px 6px rgba(0,0,0,0.04);
border-left: 5px solid #1a365d;
}
.header h1 {
font-size: 20px;
color: #1a365d;
display: flex;
align-items: center;
gap: 8px;
}

/* --- コントロールバー(検索 & 新規ボタン) --- */
.toolbar {
display: flex;
justify-content: space-between;
align-items: center;
gap: 16px;
margin-bottom: 16px;
flex-wrap: wrap;
}
.search-box {
flex: 1;
min-width: 260px;
position: relative;
}
.search-input {
width: 100%;
padding: 10px 16px;
border: 1px solid #cbd5e0;
border-radius: 6px;
font-size: 14px;
outline: none;
transition: border 0.2s;
}
.search-input:focus {
border-color: #3182ce;
box-shadow: 0 0 0 3px rgba(49, 130, 206, 0.15);
}
.btn {
padding: 10px 18px;
border: none;
border-radius: 6px;
font-size: 14px;
font-weight: 700;
cursor: pointer;
display: inline-flex;
align-items: center;
gap: 6px;
transition: all 0.2s;
}
.btn-primary {
background-color: #dd6b20; /* 札幌オレンジ */
color: #ffffff;
}
.btn-primary:hover { background-color: #c05621; }
.btn-secondary {
background-color: #edf2f7;
color: #4a5568;
}
.btn-secondary:hover { background-color: #e2e8f0; }

/* --- メッセージ通知トースト --- */
.toast {
display: none;
padding: 12px 18px;
border-radius: 6px;
font-size: 14px;
font-weight: 600;
margin-bottom: 16px;
animation: fadeIn 0.3s ease;
}
.toast-success { background: #c6f6d5; color: #22543d; border: 1px solid #9ae6b4; }
.toast-error { background: #fed7d7; color: #9b2c2c; border: 1px solid #feb2b2; }
@keyframes fadeIn { from { opacity: 0; transform: translateY(-6px); } to { opacity: 1; transform: translateY(0); } }

/* --- データテーブル --- */
.table-card {
background: #ffffff;
border-radius: 10px;
box-shadow: 0 4px 6px rgba(0,0,0,0.04);
overflow-x: auto;
}
table {
width: 100%;
border-collapse: collapse;
text-align: left;
font-size: 13px;
}
th {
background-color: #1a365d;
color: #ffffff;
padding: 12px 16px;
font-weight: 600;
white-space: nowrap;
}
td {
padding: 12px 16px;
border-bottom: 1px solid #edf2f7;
vertical-align: middle;
}
tr:hover td { background-color: #f7fafc; }

/* ステータスバッジ */
.badge {
display: inline-block;
padding: 3px 8px;
border-radius: 12px;
font-size: 11px;
font-weight: 700;
}
.badge-unpaid { background: #feebc8; color: #7b341e; } /* 未請求: 橙 */
.badge-invoiced { background: #bee3f8; color: #2b6cb0; } /* 請求済: 青 */
.badge-paid { background: #c6f6d5; color: #22543d; } /* 入金済: 緑 */

/* アクションボタン(小) */
.action-btn {
padding: 4px 10px;
border-radius: 4px;
font-size: 12px;
font-weight: 600;
border: 1px solid transparent;
cursor: pointer;
margin-right: 4px;
}
.action-edit { background: #e2e8f0; color: #2d3748; }
.action-edit:hover { background: #cbd5e0; }
.action-delete { background: #fff5f5; color: #e53e3e; border-color: #fed7d7; }
.action-delete:hover { background: #fed7d7; }

/* --- 入力・編集用モーダルウィンドウ --- */
.modal-overlay {
display: none;
position: fixed;
top: 0; left: 0; width: 100%; height: 100%;
background: rgba(0,0,0,0.45);
z-index: 1000;
justify-content: center;
align-items: center;
padding: 20px;
}
.modal-content {
background: #ffffff;
width: 100%;
max-width: 480px;
border-radius: 10px;
box-shadow: 0 10px 25px rgba(0,0,0,0.2);
overflow: hidden;
animation: modalPop 0.2s ease-out;
}
@keyframes modalPop { from { transform: scale(0.95); opacity: 0; } to { transform: scale(1); opacity: 1; } }
.modal-header {
background: #1a365d;
color: #ffffff;
padding: 16px 20px;
display: flex;
justify-content: space-between;
align-items: center;
}
.modal-header h3 { font-size: 16px; }
.modal-close {
background: none; border: none; color: #ffffff; font-size: 20px; cursor: pointer;
}
.modal-body { padding: 20px; }
.form-group { margin-bottom: 14px; }
.form-group label {
display: block; font-size: 12px; font-weight: 700; color: #4a5568; margin-bottom: 4px;
}
.form-control {
width: 100%; padding: 8px 12px; border: 1px solid #cbd5e0; border-radius: 6px; font-size: 14px;
}
.modal-footer {
padding: 12px 20px; background: #f7fafc; display: flex; justify-content: flex-end; gap: 10px;
}

.loading-state {
padding: 40px; text-align: center; color: #718096; font-size: 14px;
}
</style>
</head>
<body>

<div class="container">

<!-- ヘッダー -->
<div class="header">
<div>
<h1>🏢 札幌オフィス 請求・業績データ管理システム</h1>
<p style="font-size: 12px; color: #718096; margin-top: 4px;">Googleスプレッドシート(請求業績DB)リアルタイムCRUD連携</p>
</div>
<div style="font-size: 12px; color: #4a5568; font-weight: 600;" id="lastSyncText">同期準備完了</div>
</div>

<!-- 通知バナー -->
<div id="toastMessage" class="toast"></div>

<!-- コントロールツールバー -->
<div class="toolbar">
<div class="search-box">
<input type="text" id="searchInput" class="search-input" placeholder="🔍 取引先名・案件名・ステータスで検索..." oninput="onSearchInput()">
</div>
<button class="btn btn-primary" onclick="openCreateModal()">
<span>➕ 新規案件を登録</span>
</button>
</div>

<!-- データ一覧テーブル -->
<div class="table-card">
<table>
<thead>
<tr>
<th>管理ID</th>
<th>取引先名</th>
<th>案件名</th>
<th style="text-align: right;">請求金額</th>
<th style="text-align: center;">ステータス</th>
<th>最終更新日時</th>
<th style="text-align: center;">操作</th>
</tr>
</thead>
<tbody id="tableBody">
<tr><td colspan="7" class="loading-state">⏳ データを読み込んでいます...</td></tr>
</tbody>
</table>
</div>

</div>

<!-- 登録・編集用モーダルダイアログ -->
<div id="recordModal" class="modal-overlay">
<div class="modal-content">
<div class="modal-header">
<h3 id="modalTitle">新規案件の登録</h3>
<button class="modal-close" onclick="closeModal()">&times;</button>
</div>
<div class="modal-body">
<input type="hidden" id="formId">

<div class="form-group">
<label>取引先名(必須):</label>
<input type="text" id="formCompany" class="form-control" placeholder="例:株式会社札幌スープカレー本舗">
</div>

<div class="form-group">
<label>案件名・業務内容:</label>
<input type="text" id="formProject" class="form-control" placeholder="例:ECサイト決済機能改修">
</div>

<div class="form-group">
<label>請求金額(円):</label>
<input type="number" id="formAmount" class="form-control" placeholder="例:165000">
</div>

<div class="form-group">
<label>ステータス:</label>
<select id="formStatus" class="form-control">
<option value="未請求">未請求</option>
<option value="請求済">請求済</option>
<option value="入金確認済">入金確認済</option>
</select>
</div>
</div>
<div class="modal-footer">
<button class="btn btn-secondary" onclick="closeModal()">キャンセル</button>
<button id="modalSaveBtn" class="btn btn-primary" onclick="onSaveRecord()">保存する</button>
</div>
</div>
</div>

<script>
// 現在手元でキャッシュしているデータ配列
var currentRecords = [];

// 画面が開いたときに自動でデータを取得(Read)
window.addEventListener("load", function() {
loadTableData("");
});

// ==============================================================
// 1. 【Read / 検索】データをGASから取得してテーブル描画
// ==============================================================
function loadTableData(keyword) {
document.getElementById("tableBody").innerHTML = '<tr><td colspan="7" class="loading-state">⏳ データを同期中...</td></tr>';

google.script.run
.withSuccessHandler(renderTable)
.withFailureHandler(showErrorToast)
.getRecords(keyword);
}

function renderTable(records) {
currentRecords = records;
var tbody = document.getElementById("tableBody");

if (records.length === 0) {
tbody.innerHTML = '<tr><td colspan="7" class="loading-state">該当するデータが見つかりませんでした。</td></tr>';
return;
}

var html = "";
for (var i = 0; i < records.length; i++) {
var r = records[i];

// バッジのクラス判定
var badgeClass = "badge-unpaid";
if (r.status === "請求済") badgeClass = "badge-invoiced";
if (r.status === "入金確認済") badgeClass = "badge-paid";

// 金額を3桁カンマ区切りに
var formattedAmount = Number(r.amount).toLocaleString() + " 円";

html += '<tr>' +
'<td><strong style="color:#1a365d;">' + r.id + '</strong></td>' +
'<td>' + escapeHtml(r.company) + '</td>' +
'<td>' + escapeHtml(r.project) + '</td>' +
'<td style="text-align: right; font-weight: bold;">' + formattedAmount + '</td>' +
'<td style="text-align: center;"><span class="badge ' + badgeClass + '">' + r.status + '</span></td>' +
'<td style="color: #718096; font-size: 12px;">' + r.updatedAt + '</td>' +
'<td style="text-align: center;">' +
'<button class="action-btn action-edit" onclick="openEditModal(\'' + r.id + '\')">編集</button>' +
'<button class="action-btn action-delete" onclick="onDeleteClick(\'' + r.id + '\')">削除</button>' +
'</td>' +
'</tr>';
}

tbody.innerHTML = html;
document.getElementById("lastSyncText").innerText = "最終同期: " + new Date().toLocaleTimeString();
}

// 検索入力時のリアルタイム連動(文字入力で即座に絞り込み)
var searchTimer = null;
function onSearchInput() {
clearTimeout(searchTimer);
searchTimer = setTimeout(function() {
var keyword = document.getElementById("searchInput").value;
loadTableData(keyword);
}, 300); // 300ミリ秒待ってから検索を実行(入力負荷軽減)
}

// ==============================================================
// 2. 【Create & Update】モーダルの開閉と保存処理
// ==============================================================
function openCreateModal() {
document.getElementById("modalTitle").innerText = "➕ 新規案件の登録";
document.getElementById("formId").value = "";
document.getElementById("formCompany").value = "";
document.getElementById("formProject").value = "";
document.getElementById("formAmount").value = "";
document.getElementById("formStatus").value = "未請求";

document.getElementById("recordModal").style.display = "flex";
}

function openEditModal(id) {
// キャッシュから該当IDのレコードを検索
var target = currentRecords.find(function(item) { return item.id === id; });
if (!target) return;

document.getElementById("modalTitle").innerText = "✏️ 案件データの編集 (" + id + ")";
document.getElementById("formId").value = target.id;
document.getElementById("formCompany").value = target.company;
document.getElementById("formProject").value = target.project;
document.getElementById("formAmount").value = target.amount;
document.getElementById("formStatus").value = target.status;

document.getElementById("recordModal").style.display = "flex";
}

function closeModal() {
document.getElementById("recordModal").style.display = "none";
}

function onSaveRecord() {
var id = document.getElementById("formId").value;
var company = document.getElementById("formCompany").value.trim();
var project = document.getElementById("formProject").value.trim();
var amount = document.getElementById("formAmount").value;
var status = document.getElementById("formStatus").value;

if (company === "") {
alert("取引先会社名は必須です!");
return;
}

var saveBtn = document.getElementById("modalSaveBtn");
saveBtn.disabled = true;
saveBtn.innerText = "通信中...";

var payload = {
id: id,
company: company,
project: project,
amount: amount,
status: status
};

if (id === "") {
// IDが空 ➔ 新規登録(Create)
google.script.run
.withSuccessHandler(function(res) {
closeModal();
showToast(res.message, true);
loadTableData(document.getElementById("searchInput").value);
saveBtn.disabled = false;
saveBtn.innerText = "保存する";
})
.withFailureHandler(function(err) {
showErrorToast(err);
saveBtn.disabled = false;
saveBtn.innerText = "保存する";
})
.addRecord(payload);
} else {
// IDが存在 ➔ 更新(Update)
google.script.run
.withSuccessHandler(function(res) {
closeModal();
showToast(res.message, true);
loadTableData(document.getElementById("searchInput").value);
saveBtn.disabled = false;
saveBtn.innerText = "保存する";
})
.withFailureHandler(function(err) {
showErrorToast(err);
saveBtn.disabled = false;
saveBtn.innerText = "保存する";
})
.updateRecord(payload);
}
}

// ==============================================================
// 3. 【Delete】削除処理
// ==============================================================
function onDeleteClick(id) {
if (!confirm("本当に管理番号「" + id + "」を削除しますか?\n※スプレッドシートから行が完全に消去されます。")) {
return;
}

google.script.run
.withSuccessHandler(function(res) {
showToast(res.message, true);
loadTableData(document.getElementById("searchInput").value);
})
.withFailureHandler(showErrorToast)
.deleteRecord(id);
}

// ==============================================================
// UI通知トースト & エスケープ共通関数
// ==============================================================
function showToast(msg, isSuccess) {
var toast = document.getElementById("toastMessage");
toast.className = "toast " + (isSuccess ? "toast-success" : "toast-error");
toast.innerText = msg;
toast.style.display = "block";
setTimeout(function() { toast.style.display = "none"; }, 4000);
}

function showErrorToast(err) {
showToast("エラー: " + err.message, false);
}

function escapeHtml(str) {
return String(str)
.replace(/&/g, "&amp;")
.replace(/</g, "&lt;")
.replace(/>/g, "&gt;")
.replace(/"/g, "&quot;");
}
</script>

</body>
</html>

STEP 4:【動作確認】開発用URL(/dev)でCRUDの全機能を体感しよう!

コードの保存が完了したら、第81回からおなじみの開発用テストURL(末尾が /dev のURL)を開いてみましょう!

  1. エディタ右上の青い 「デプロイ」 > 「デプロイをテスト」 をクリックします。
  2. 「ウェブアプリのURL」(末尾が /dev のURL)をコピーし、ブラウザの新しいタブで開きます。

実験①:Read(読み込み・検索)を試す!

画面が開いた瞬間、スプレッドシートの「請求業績DB」シートからデータが読み込まれ、4件の案件が一覧表として綺麗に表示されたはずです!
上の検索バーに「スープカレー」や「未請求」と入力してみてください。ページ全体を再読み込みすることなく、一瞬で該当する行だけに絞り込まれます。

実験②:Create(新規登録)を試す!

右上の「➕ 新規案件を登録」ボタンを押します。

  • 取引先名:札幌時計台前不動産
  • 案件名:基幹システムDXコンサルティング
  • 請求金額:500000
  • ステータス:未請求

上記のように入力して「保存する」を押してみましょう!
数秒後、モーダルが閉じて画面の上に緑色のバナー「管理番号『INV-1005』で新規登録しました!」が表示され、テーブルの一番下に新しい案件が自動追加されます。
スプレッドシートを確認すると、A列に自動採番された INV-1005 と共に、新しい行がバッチリ追記されているのが確認できます!

実験③:Update(更新・編集)を試す!

いま登録した INV-1005 の行にある「編集」ボタンを押します。
先ほど入力した内容がモーダルに自動でセットされますので、ステータスを「未請求」から「請求済」に変えて「保存する」を押してみます。
画面上のバッジの色がオレンジ(未請求)から爽やかな青色(請求済)にパッと切り替わり、スプレッドシートのE列とF列(更新日時)も同時に書き換わります!

実験④:Delete(安全削除)を試す!

最後に、不要になった行の「削除」ボタンをクリックしてみます。
「本当に管理番号『INV-1005』を削除しますか?」と確認ダイアログ(confirm)が出るので、「OK」を押します。
画面からその行がスッと消え、スプレッドシート側でも deleteRow によって行ごと綺麗にだるま落とし削除されます!

ブラウザの画面上ですべてのデータ操作が完結し、スプレッドシートと双方向で完全に同期している感覚——これぞ、Webエンジニアとして最もワクワクする瞬間ですね!

4. 初心者が絶対につまずく「5大トラブル」と完全対処法

スプレッドシートをDBにしたCRUDシステムを開発する際、誰もが一度は遭遇する「典型的な5大トラップ」と解決策をまとめました。エラーが出たときはここを確認してください!

トラップ1:行番号だけで更新しようとして他人のデータが上書きされる(行ズレ大事故)

「テーブルの3行目を編集したから、スプレッドシートの4行目を更新すればいいや」と行番号で処理してしまうと、別の人が手前を削除した瞬間に1行ずつズレてしまい、大惨事を引き起こします。
【解決策】 必ず今回のコードのように、A列の id をループで照合し、「現在のシート内でそのIDが何行目に存在するか」をリアルタイムに検索してから getRange(targetRowIndex, ...) を呼び出しましょう!

トラップ2:LockService を入れ忘れて同じ管理IDが重複採番される

2人の社員がほぼ同時に「新規登録」を押したとき、同時に getLastRow() を見に行くと、両方に INV-1005 という同じIDが発行されてしまいます。
【解決策】 第89回や今回のコードのように、データの書き込みを行う処理には必ず LockService.getScriptLock() を挟んで「1人ずつ順番に処理させる」排他制御を行いましょう。

トラップ3:数値のつもりが文字列になっていて計算がバグる

HTMLのフォーム(<input type="number">)から取得した値は、JavaScript内部では「文字列(”165000″)」として届くことがあります。そのままシートに書き込むとスプレッドシート側で「文字」と認識され、SUM関数の合計から除外されてしまう事故が起きます。
【解決策】 GAS側で受け取った際、Number(data.amount) || 0 のように明示的に数値型へキャスト(変換)してからセルに流し込みましょう。

トラップ4:データ件数が増えたときに画面の読み込みが激重になる

データが数千行、数万行に増えてくると、getValues() で全行を毎回読み込む処理に数秒〜十数秒かかるようになります。
【解決策】 過去ログ(昨年度の請求済データなど)は別シートにアーカイブして現行シートの行数を1,000行前後に保つか、フェーズ10(第98回)で学ぶ CacheService を活用して高速化を図りましょう!

トラップ5:XSS(クロスサイトスクリプティング)対策の漏れ

取引先名や案件名に <script> などの悪意あるタグが入力された場合、画面にそのまま innerHTML で流し込むと不正なコードが実行されてしまいます。
【解決策】 今回のフロント側コードに入れた escapeHtml() 関数の処理を必ず通し、記号を安全な文字列に変換してからテーブルに描画する癖をつけましょう!

5. まとめ&フェーズ9(Webアプリ化編)完結!

今回は、スプレッドシートをデータベースに見立てた完全なCRUD連携システムの構築手法を徹底解説しました!

本日の重要ポイントおさらい

  1. CRUD は Create(作成)、Read(読込)、Update(更新)、Delete(削除)の4大基本機能!
  2. スプレッドシートをDB化するなら、絶対に重複しない管理ID(主キー) を1列目に置く!
  3. 行番号(Row)に依存せず、IDを手がかりに対象行を検索 してから更新・削除を行う!
  4. LockService を挟むことで、複数人の同時アクセスによる重複採番やデータ破壊を防ぐ!
  5. フロントエンドとバックエンドの役割分担を明確にし、画面全体をリロードしない快適なUIを提供する!

🎉 祝・フェーズ9「Webアプリ化編(第81回〜第90回)」完修!!

第81回から始まったWebアプリ化編も、今回の第90回で見事にゴールを迎えました!
ここで一度、あなたが身につけた驚異的なWeb開発スキルを振り返ってみましょう。

  • 第81回:doGet(e) でWebアプリの正面玄関を開設する
  • 第82回:createHtmlOutput() でシステムメンテナンス画面をサッと表示する
  • 第83回:createHtmlOutputFromFile() でHTML/CSSを分離したモダン画面を描画する
  • 第84回:createTemplateFromFile() でスプレッドシートの生データを画面にリアルタイム展開する
  • 第85回:e.parameter でURLパラメータ(?view=…)による動的画面ルーティングを組む
  • 第86回:htmlOutput.setTitle() でブラウザのタブ名を動的に変化させる
  • 第87回:google.script.run で画面のボタンからGoogleサーバーのDocs生成を遠隔起動する
  • 第88回:withSuccessHandler / withFailureHandler で成功通知やエラー画面を制御する
  • 第89回:doPost(e) & ContentService で打刻端末や外部フォームからのAPI受信用窓口を開設する
  • 第90回(今回):スプレッドシートをDBにして、Web画面から検索・登録・更新・削除(CRUD) を自由自在に操る!

たった10回前までは「GASのエディタ画面で実行ボタンを押していた」のが、今や「ブラウザから誰でも操作できる本格的な社内業務Webシステム」 を自分の手で一人で作り上げられるまでになりました。これはエンジニアとして本当に大きなステップアップです!

🚀 次回予告:いよいよ最終章!「フェーズ10:Web API連携 & 最適化編」へ突入!

100回連載ロードマップも、残すところ最後の10回となりました!
次回からは、これまでに学んだすべての技術をさらに強固にし、外部サービス(Googleフォーム、Slack、外部API)と密接に連携させながらパフォーマンスを極限までチューニングする【フェーズ10:Web API連携 & 最適化編(第91回〜第100回)】がスタートします!

次回(第91回)のテーマは、
「onFormSubmit × 札幌オフィス設備利用申請フォーム送信時にダッシュボードへ自動反映」 です!

Googleフォームから「札幌オフィスのプロジェクターや社用車を使いたい!」と申請が届いた瞬間、今回作成したダッシュボードへリアルタイムにデータを自動反映させる実践テクニックをお届けします。最終フェーズもワクワクしながら一緒に駆け抜けていきましょう!お楽しみに!