GAS Webアプリに編集・論理削除・ステータス変更を追加する

この記事では、GAS(Google Apps Script)のWebアプリに編集機能を追加し、一覧画面から詳細画面へ移動して、作業依頼の内容やステータスを更新します。削除時は行を消さず、削除区分を付けて一覧から除外する論理削除を実装します。
対象データは受付番号ではなく内部IDで特定し、画面とサーバーの両方で入力を検証します。Googleスプレッドシートをデータベースとして使うときの更新処理、削除済みデータの扱い、Webアプリの再デプロイまで、コードと画面例を交えて紹介します。
シリーズ全体の構成と完成画面は第0回で紹介しています。
1. 今回作るもの
| ファイル | 用途 |
|---|---|
Code.gs | getRequestById()、updateRequest()、deleteRequest() を追加する |
list.html | 大きな変更なし(一覧テーブルは script.html で動的生成) |
detail.html | 詳細・編集画面を新規作成する |
style.html | 詳細画面と削除ボタンのCSSを追加する |
script.html | 一覧に詳細リンクを追加し、詳細読み込み・保存・削除の処理を追加する |
2. 完成イメージ
- 一覧の各行に「詳細」リンクが表示される
- 詳細画面で受付番号、顧客名、登録日時、更新日時を確認できる
- 件名・依頼内容・担当者・ステータスを編集できる
- 削除ボタンで確認ダイアログの後、論理削除できる
- 削除後のデータは一覧に表示されない

3. 前回までの状態
前回は、一覧画面に検索機能を追加しました。
4. 使用するファイル
今回使用するファイルは Code.gs、list.html、detail.html、style.html、script.html の5つです。
5. 更新・削除の方針
内部IDで対象を特定する
updateRequest() や deleteRequest() では、受付番号ではなく内部ID(UUID)で対象行を特定します。
行番号に依存しない更新
内部IDから該当する行番号を探し、その行の値を更新します。これにより、行の並び順が変わっても正しいデータを更新できます。
論理削除
deleteRequest() は、該当行の 削除区分 列に '削除' を設定するだけです。実際に行を削除する物理削除ではありません。
削除日時や削除したユーザーは記録しません。削除履歴も管理する場合は、日時列や操作ログを別途追加してください。
削除日時や削除したユーザーは記録しません。削除履歴も管理する場合は、日時列や操作ログを別途追加してください。

6. 貼り付けるコード
Code.gs
doGet(e) を修正します。
function doGet(e) {
const page = e && e.parameter && e.parameter.page;
const templateFile = page === 'list' ? 'list' : page === 'detail' ? 'detail' : 'index';
const template = HtmlService.createTemplateFromFile(templateFile);
template.requestId = (e && e.parameter && e.parameter.id) || '';
return template
.evaluate()
.setTitle('作業依頼受付フォーム')
.addMetaTag('viewport', 'width=device-width, initial-scale=1');
}getRequestById(id) を追加します。
function getRequestById(id) {
if (!id) return null;
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheetByName('作業依頼');
if (!sheet || sheet.getLastRow() < 2) return null;
const values = sheet.getDataRange().getValues();
const headers = values[0];
const columnMap = createHeaderMap_(headers);
const rowIndex = findRowIndexById_(values, id, columnMap);
if (rowIndex < 0) return null;
const row = values[rowIndex - 1];
if (isRequestDeleted_(row, columnMap)) return null;
return {
id: row[columnMap['内部ID']],
receiptNumber: row[columnMap['受付番号']],
createdAt: formatDateForDisplay_(row[columnMap['登録日時']]),
updatedAt: formatDateForDisplay_(row[columnMap['更新日時']]),
customerCode: row[columnMap['顧客コード']],
customerName: row[columnMap['顧客名']],
title: row[columnMap['件名']],
description: row[columnMap['依頼内容']],
status: row[columnMap['ステータス']],
assignee: row[columnMap['担当者']],
};
}updateRequest(data) を追加します。
function updateRequest(data) {
const lock = LockService.getScriptLock();
try {
validateUpdateData_(data);
if (!lock.tryLock(5000)) throw new Error('別の更新処理が実行中です。少し待ってから再試行してください。');
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheetByName('作業依頼');
if (!sheet) {
return { success: false, message: '作業依頼シートが見つかりません。' };
}
const values = sheet.getDataRange().getValues();
const headers = values[0];
const columnMap = createHeaderMap_(headers);
const rowIndex = findRowIndexById_(values, data.id, columnMap);
if (rowIndex < 0 || isRequestDeleted_(values[rowIndex - 1], columnMap)) {
return { success: false, message: '対象データが見つからないか、削除済みです。' };
}
const now = new Date();
const newRow = values[rowIndex - 1].slice();
newRow[columnMap['件名']] = data.title.trim();
newRow[columnMap['依頼内容']] = data.description.trim();
newRow[columnMap['担当者']] = data.assignee ? data.assignee.trim() : '';
newRow[columnMap['ステータス']] = data.status;
newRow[columnMap['更新日時']] = now;
sheet.getRange(rowIndex, 1, 1, newRow.length).setValues([newRow]);
SpreadsheetApp.flush();
return { success: true, message: '更新しました。', updatedAt: formatDateForDisplay_(now) };
} catch (error) {
return { success: false, message: error.message };
} finally {
if (lock.hasLock()) lock.releaseLock();
}
}deleteRequest(id) を追加します。
function deleteRequest(id) {
const lock = LockService.getScriptLock();
try {
if (typeof id !== 'string' || !id.trim()) throw new Error('削除対象のIDがありません。');
if (!lock.tryLock(5000)) throw new Error('別の更新処理が実行中です。少し待ってから再試行してください。');
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheetByName('作業依頼');
if (!sheet) {
return { success: false, message: '作業依頼シートが見つかりません。' };
}
const values = sheet.getDataRange().getValues();
const headers = values[0];
const columnMap = createHeaderMap_(headers);
const rowIndex = findRowIndexById_(values, id, columnMap);
if (rowIndex < 0 || isRequestDeleted_(values[rowIndex - 1], columnMap)) {
return { success: false, message: '対象データが見つからないか、削除済みです。' };
}
sheet.getRange(rowIndex, columnMap['削除区分'] + 1).setValue('削除');
SpreadsheetApp.flush();
return { success: true, message: '削除しました。' };
} catch (error) {
return { success: false, message: error.message };
} finally {
if (lock.hasLock()) lock.releaseLock();
}
}補助関数
取得・更新・削除で共通して使う行検索、削除判定、サーバー側の入力検証も追加します。
function findRowIndexById_(values, id, columnMap) {
for (let i = 1; i < values.length; i++) {
if (values[i][columnMap['内部ID']] === id) return i + 1;
}
return -1;
}
function isRequestDeleted_(row, columnMap) {
const deleted = row[columnMap['削除区分']];
return deleted === '削除' || deleted === true;
}
function validateUpdateData_(data) {
if (!data || typeof data.id !== 'string' || !data.id.trim()) throw new Error('更新対象のIDがありません。');
if (typeof data.title !== 'string' || !data.title.trim()) throw new Error('件名を入力してください。');
if (typeof data.description !== 'string' || !data.description.trim()) throw new Error('依頼内容を入力してください。');
if (data.assignee != null && typeof data.assignee !== 'string') throw new Error('担当者は文字列で入力してください。');
if ([data.title, data.description, data.assignee || ''].some((value) => value.trim().startsWith('='))) {
throw new Error('件名・依頼内容・担当者の先頭に = は入力できません。');
}
if (!['未対応', '対応中', '完了'].includes(data.status)) throw new Error('ステータスを選択してください。');
}detail.html(新規作成)
<!doctype html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<base target="_top">
<?!= include('style'); ?>
</head>
<body data-web-app-url="<?= ScriptApp.getService().getUrl() ?>">
<main class="page">
<section class="form-panel">
<p class="eyebrow">作業依頼・受付管理Webアプリ</p>
<h1>作業依頼詳細</h1>
<nav class="page-nav">
<a href="<?= ScriptApp.getService().getUrl() ?>?page=list" class="nav-link">一覧へ戻る</a>
</nav>
<div id="detailContent">
<p class="message">読み込んでいます。</p>
</div>
</section>
</main>
<script>var requestId = '<?= requestId ?>';</script>
<?!= include('script'); ?>
</body>
</html>list.html
list.html 自体には大きな変更はありません。一覧のテーブルは script.html の renderRequestList() で動的に生成しているため、詳細リンクもそこに追加します。
script.html — 一覧に詳細リンクを追加
list.html 自体には大きな変更はありません。一覧のテーブルは script.html の renderRequestList() で動的に生成しているため、詳細リンクもそこに追加します。
const webAppUrl = document.body.dataset.webAppUrl || '';
function renderRequestList(requests) {
if (!requests || requests.length === 0) {
listContent.innerHTML = '<p class="message is-empty">該当する作業依頼はありません。<br><a href="' + webAppUrl + '?page=form">新規登録</a>から作業依頼を登録してください。</p>';
return;
}
var html = '<p class="result-count">該当件数: ' + requests.length + '件</p>';
html += '<table class="request-table"><thead><tr>';
html += '<th>受付番号</th>';
html += '<th>登録日時</th>';
html += '<th>顧客名</th>';
html += '<th>件名</th>';
html += '<th>ステータス</th>';
html += '<th>担当者</th>';
html += '<th>詳細</th>';
html += '</tr></thead><tbody>';
requests.forEach(function(request) {
html += '<tr>';
html += '<td>' + escapeHtml(request.receiptNumber) + '</td>';
html += '<td>' + escapeHtml(request.createdAt) + '</td>';
html += '<td>' + escapeHtml(request.customerName) + '</td>';
html += '<td>' + escapeHtml(request.title) + '</td>';
html += '<td>' + statusBadge(request.status) + '</td>';
html += '<td>' + escapeHtml(request.assignee || '') + '</td>';
html += '<td><a class="detail-link" href="' + webAppUrl + '?page=detail&id=' + encodeURIComponent(request.id) + '">詳細</a></td>';
html += '</tr>';
});
html += '</tbody></table>';
listContent.innerHTML = html;
}encodeURIComponent(request.id) は、内部IDをURLのクエリパラメータとして渡すためのエンコードです。UUIDに特殊文字が含まれない場合でも、URLを組み立てるときはこの関数を使うと、値に区切り文字が含まれるケースにも対応できます。
webAppUrl は、<body data-web-app-url> に埋め込んだWebアプリのURLです。一覧から詳細、新規登録、一覧への戻り先を同じデプロイURLから組み立てます。
style.html
削除ボタンと詳細画面用のCSSを追加します。
.button-danger {
background: #dc2626;
color: #ffffff;
}
.detail-link {
color: #2563eb;
text-decoration: none;
font-weight: 700;
}
.detail-section {
margin-bottom: 24px;
padding-bottom: 20px;
border-bottom: 1px solid #e5e7eb;
}
.detail-grid {
display: grid;
grid-template-columns: repeat(2, 1fr);
gap: 12px;
}
.form-actions {
display: flex;
gap: 12px;
margin-top: 24px;
}
.form-actions button {
flex: 1;
}script.html — 詳細画面の処理
script.html の一番最後、</script> の直前に追加します。すでに if (typeof requestId !== 'undefined' && requestId) { ... } がある場合は、そのブロック全体を次のコードに置き換えてください。if (form) や if (listContent) の中には入れません。詳細画面では form と listContent が存在しないためです。
if (typeof requestId !== 'undefined' && requestId) {
const detailContent = document.getElementById('detailContent');
loadRequestDetail();
function loadRequestDetail() {
detailContent.innerHTML = '<p class="message">読み込んでいます。</p>';
google.script.run
.withSuccessHandler(renderRequestDetail)
.withFailureHandler(handleDetailLoadFailure)
.getRequestById(requestId);
}
function renderRequestDetail(request) {
if (!request) {
detailContent.innerHTML = '<p class="message is-error">作業依頼が見つかりません。</p>';
return;
}
var html = '';
html += '<div class="detail-section">';
html += '<div class="detail-grid">';
html += '<div class="detail-item"><div class="detail-label">受付番号</div><div class="detail-value">' + escapeHtml(request.receiptNumber) + '</div></div>';
html += '<div class="detail-item"><div class="detail-label">顧客名</div><div class="detail-value">' + escapeHtml(request.customerName) + '</div></div>';
html += '<div class="detail-item"><div class="detail-label">登録日時</div><div class="detail-value">' + escapeHtml(request.createdAt) + '</div></div>';
html += '<div class="detail-item"><div class="detail-label">更新日時</div><div id="updatedAtValue" class="detail-value">' + escapeHtml(request.updatedAt) + '</div></div>';
html += '</div>';
html += '</div>';
html += '<form id="editForm">';
html += '<div class="field"><label for="editTitle">件名</label><input id="editTitle" name="title" type="text" value="' + escapeHtml(request.title) + '" required></div>';
html += '<div class="field"><label for="editDescription">依頼内容</label><textarea id="editDescription" name="description" rows="6" required>' + escapeHtml(request.description) + '</textarea></div>';
html += '<div class="field"><label for="editAssignee">担当者</label><input id="editAssignee" name="assignee" type="text" value="' + escapeHtml(request.assignee || '') + '"></div>';
html += '<div class="field"><label for="editStatus">ステータス</label><select id="editStatus" name="status">' + statusOptions(request.status) + '</select></div>';
html += '<div class="form-actions"><button id="saveButton" type="submit">保存する</button><button type="button" id="deleteButton" class="button-danger">削除する</button></div>';
html += '<p id="detailMessage" class="message">内容を編集して保存ボタンを押してください。</p>';
html += '</form>';
detailContent.innerHTML = html;
document.getElementById('editForm').addEventListener('submit', handleEditSubmit);
document.getElementById('deleteButton').addEventListener('click', handleDeleteClick);
}
function statusOptions(selected) {
var options = ['未対応', '対応中', '完了'];
var html = '';
options.forEach(function(status) {
html += '<option value="' + escapeHtml(status) + '"' + (status === selected ? ' selected' : '') + '>' + escapeHtml(status) + '</option>';
});
return html;
}
function handleEditSubmit(event) {
event.preventDefault();
const saveButton = document.getElementById('saveButton');
const detailMessage = document.getElementById('detailMessage');
const data = {
id: requestId,
title: document.getElementById('editTitle').value.trim(),
description: document.getElementById('editDescription').value.trim(),
assignee: document.getElementById('editAssignee').value.trim(),
status: document.getElementById('editStatus').value,
};
if (!data.title || !data.description) {
detailMessage.textContent = '件名と依頼内容を入力してください。';
detailMessage.className = 'message is-error';
return;
}
saveButton.disabled = true;
saveButton.textContent = '保存中...';
detailMessage.textContent = '保存しています。';
detailMessage.className = 'message';
google.script.run
.withSuccessHandler(function(result) {
saveButton.disabled = false;
saveButton.textContent = '保存する';
detailMessage.textContent = result.message;
detailMessage.className = result.success ? 'message is-success' : 'message is-error';
if (result.success && result.updatedAt) {
document.getElementById('updatedAtValue').textContent = result.updatedAt;
}
})
.withFailureHandler(function(error) {
saveButton.disabled = false;
saveButton.textContent = '保存する';
detailMessage.textContent = error && error.message ? error.message : '保存中にエラーが発生しました。';
detailMessage.className = 'message is-error';
})
.updateRequest(data);
}
function handleDeleteClick() {
if (!confirm('この作業依頼を削除してもよろしいですか?')) {
return;
}
const deleteButton = document.getElementById('deleteButton');
const detailMessage = document.getElementById('detailMessage');
deleteButton.disabled = true;
google.script.run
.withSuccessHandler(function(result) {
if (result.success) {
detailContent.innerHTML = '<p class="message is-success">' + result.message + '<br><a href="' + webAppUrl + '?page=list">一覧へ戻る</a></p>';
} else {
deleteButton.disabled = false;
detailMessage.textContent = result.message;
detailMessage.className = 'message is-error';
}
})
.withFailureHandler(function(error) {
deleteButton.disabled = false;
detailMessage.textContent = error && error.message ? error.message : '削除中にエラーが発生しました。';
detailMessage.className = 'message is-error';
})
.deleteRequest(requestId);
}
function handleDetailLoadFailure(error) {
detailContent.innerHTML = '<p class="message is-error">' + (error && error.message ? escapeHtml(error.message) : '詳細の読み込みに失敗しました。') + '</p>';
}
function escapeHtml(text) {
if (!text) return '';
return text.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"');
}
} else if (document.getElementById('detailContent')) {
document.getElementById('detailContent').innerHTML = '<p class="message is-error">作業依頼IDが指定されていません。</p>';
}詳細画面では、JavaScriptでフォームを動的に生成し、保存ボタンと削除ボタンのイベントを設定します。
7. コードの解説
内部IDによる行特定
findRowIndexById_() は、作業依頼シートの全データを取得し、内部IDが一致する行を探します。配列の添字は0から始まりますが、シートの行番号は1から始まるため、戻り値では見出し行の分を加えています。
行全体を更新する理由
該当行の配列をコピーして必要な列だけ更新し、setValues() で行全体を書き戻します。列の位置をヘッダー名から求めるため、列順を変えてもコード内の固定列番号を修正する必要がありません。
更新・削除の読み書きには LockService のスクリプトロックを使います。同じApps Scriptプロジェクト内の処理を順番に実行し、同時更新時に削除区分を古い値で上書きするリスクを抑えます。ただし、古い画面からの保存による編集競合や、シートを直接変更する操作までは検知しません。
テンプレート変数でIDを渡す
detail.html では、<script>var requestId = '<?= requestId ?>';</script> を使って、URLの id パラメータをJavaScriptに渡しています。
論理削除
deleteRequest() は 削除区分 列に '削除' を設定します。一覧・検索だけでなく、詳細取得・更新・削除の各サーバー処理でも削除済み行を除外するため、古い詳細URLから内容を再取得したり更新したりできません。
このコードは削除日時や削除した人を記録しません。削除履歴が必要な業務では、削除日時列や操作ログを追加してください。
入力検証と数式としての保存
画面側の必須チェックに加え、サーバー側でID、文字列、ステータスの許可値を確認します。また、件名・依頼内容・担当者が = で始まる場合は保存を拒否します。Apps Scriptの Range.setValues() は = から始まる文字列を数式として解釈するためです。第3回の登録処理にも同じ確認を加え、完成版では全ての書き込み経路をそろえています。
const textValues = [data.customerCode, data.customerName, data.title, data.description, data.assignee || ''];
if (textValues.some((value) => value.trim().startsWith('='))) {
throw new Error('入力値の先頭に = は使用できません。');
}内部IDは認証ではない
内部IDは行を特定する識別子で、利用者の閲覧・更新権限を判定するものではありません。Webアプリの公開範囲はデプロイ設定で制限し、利用者ごとにアクセス範囲を変える場合は認証・認可処理を別途設計します。
8. 導入手順
- 第9回までのファイルを用意する
Code.gsに取得・更新・削除関数を追加するdoGet(e)を修正するdetail.htmlを新規作成するstyle.htmlに詳細画面用CSSを追加するscript.htmlのrenderRequestList()に「詳細」リンク列を追加するscript.htmlに詳細読み込み・保存・削除処理を追加する- 保存後、テストデプロイ(URL末尾が
/dev)で画面を確認する - 公開中のWebアプリは「デプロイ」→「デプロイを管理」から既存デプロイを編集し、新しいバージョンを選んで再デプロイする
/execのURLを開き、一覧から「詳細」リンクを開いて編集・削除を試す
テストデプロイは保存済みの最新コードを使います。公開中のWebアプリは特定バージョンを使うため、コードを保存しただけでは反映されません。既存デプロイを更新すると、通常は同じWebアプリURLを引き続き使えます。詳しくはApps Scriptのデプロイ管理を確認してください。
9. 動作確認
一覧の「詳細」リンクから詳細画面を開き、件名・依頼内容・担当者・ステータスを編集して保存します。更新日時が画面上ですぐに変わること、一覧にも変更が反映されることを確認します。削除後は一覧に表示されず、古い詳細URLを開いても内容が表示されないことも確認してください。

削除ボタンを押すと、確認ダイアログが表示されます。

保存後、一覧に戻ると更新内容が反映されています。

10. よくあるエラー
対象データが見つかりませんと表示される
URLの id パラメータが正しく渡っているか、該当IDの行が削除されていないか確認してください。
更新しても反映されない
updateRequest() 内で findRowIndexById_() が正しい行番号を返しているか確認してください。内部IDの比較が文字列と文字列で行われているか確認してください。
削除後も一覧に表示される
削除区分 列に '削除' が設定されているか、一覧側の filter() で除外しているか確認してください。
参考資料
11. starter.zipの案内
starter.zip には、第9回完了時点のファイルを入れています。
12. complete.zipの案内
complete.zip には、Code.gs、index.html、list.html、detail.html、style.html、script.html、README.txt を入れています。
13. 次回追加する機能
次回は、作業依頼データからPDF受付票を作成し、Googleドライブへ保存します。



Your Message