前回(第83回)は、Google Apps Script(GAS)のエディタ内に独立したHTMLファイルを作成し、モダンで洗練された「札幌オフィス統合ダッシュボード」の外観を描画する HtmlService.createHtmlOutputFromFile() の使い方を学びましたね!
画面を見て、「おお、自分の手で本格的なWebアプリの画面が作れた!」と感動した方も多かったのではないでしょうか。しかし、前回のコードを動かしながら、こんな疑問が頭をよぎりませんでしたか?
「画面のデザインは綺麗だけど、表示されている『売上達成率120.4%』や『会議室の予約状況』って、HTMLに直接書いたダミーの固定文字のままだよね……?」
「スプレッドシートのデータが更新されたら、画面を開いた瞬間に自動で最新の数字に切り替わるようにしたい!」
まさにその通りです!実務で本当に役立つWebシステムを作るには、デザインという「器(うつわ)」の中に、スプレッドシートやデータベースから取り出した「本物の生データ」をリアルタイムに流し込む必要があります。
そこで第84回となる今回は、スプレッドシートのデータをHTML画面へ動的に埋め込むための最強メソッド HtmlService.createTemplateFromFile() と、HTMLの中でGASの変数を展開する魔法の構文「スクリップレット(Scriptlet)」を徹底解説します!
札幌オフィスの現場で毎日更新される「売上実績データ」と「会議室のリアルタイム予約状況」を題材に、手作業の更新が一切不要な『真の動的ダッシュボード』を完成させていきましょう!
1. そもそも HtmlService.createTemplateFromFile() とは?
まずは、今回登場する HtmlService.createTemplateFromFile() の役割と、前回のメソッドとの決定的な違いを紐解いていきましょう。
HtmlService.createTemplateFromFile() は、指定したHTMLファイルを単なる完成品のWebページとして読み込むのではなく、「GASプログラムからデータを受け取って加工できる『テンプレート(雛形・鋳型)』」として読み込む命令です。
静的HTMLと動的テンプレートの違い(印刷チラシ vs 穴埋め賞状)
初心者の方が一番理解しやすいように、身近な例えで比較してみましょう。
| 比較項目 | createHtmlOutputFromFile(第83回) | createTemplateFromFile(今回:第84回)★ |
|---|---|---|
| 例え | 印刷済みのカラーチラシ | 名前や日付が空欄の「賞状の台紙」 |
| データの性質 | 静的(Static):誰がいつ見ても同じ文字 | 動的(Dynamic):状況に応じて中身が変わる |
| GASの変数 | HTML側へ渡せない(受け取れない) | GASの変数を自由に渡して埋め込める! |
| 処理の手順 | ファイルを読んでそのままブラウザへ出力 | ファイルを読み込み ➔ データを代入 ➔ 評価(evaluate)して出力 |
| 主な用途 | 固定の会社概要、利用規約、メンテナンス画面 | 売上ダッシュボード、予約システム、マイページ |
前回の createHtmlOutputFromFile は、文字がすべて印刷された「完成品のチラシ」を配るようなものでした。内容を書き換えるには、チラシの原稿(HTML)そのものを直接修正しなければなりません。
一方、今回の createTemplateFromFile は、「枠線やタイトルだけが印刷された賞状の台紙(テンプレート)」を用意しておき、表彰する瞬間にGASがスプレッドシートから受賞者の名前や日付を読み取って、毛筆でササッと名前を書き込んでから相手に手渡すような仕組みです。
だからこそ、スプレッドシート側で売上金額や会議室の予定がどれだけ更新されても、画面を開いたその瞬間の最新データが自動的に画面へ反映されるのです!
超重要!テンプレートは「evaluate()」して初めて画面になる
createTemplateFromFile() を使う上で、絶対に忘れてはならない超重要キーワードが .evaluate()(エバリュエート / 評価する) です。
// 1. HTMLファイルを「テンプレート(台紙)」として読み込む
var template = HtmlService.createTemplateFromFile('index');
// 2. テンプレートにGASのデータを渡す(賞状に名前を書き込む)
template.salesTotal = 1500000;
// 3. 【最重要】テンプレートを「評価」して、完成したHTML画面に変換する!
var htmlOutput = template.evaluate();
// 4. ブラウザへ返却する
return htmlOutput;
「テンプレート」の状態のままでは、まだブラウザが理解できる純粋なHTMLではありません。中に埋め込まれたプログラムを実行し、データを流し込んで「普通のHTML」に焼き上げる作業が必要です。その焼き上げボタンこそが .evaluate() なのです。
2. HTML側でGASのデータを展開する「3大スクリップレットタグ」完全攻略
GASからテンプレート(HTML)にデータを渡せるようになったら、次は「HTML側でそのデータをどうやって受け取って画面に表示するか」を覚える必要があります。
HTMLファイルの中にGAS(JavaScript)のコードを直接埋め込むための特別な記号を「スクリップレット(Scriptlet)」と呼びます。覚えるべきタグは以下の3種類だけです!
| タグの種類 | 記号 | 役割・動作 | 主な使用シーン |
|---|---|---|---|
| 出力スクリップレット (HTMLエスケープあり) |
<?= 変数 ?> |
変数の値を安全にエスケープして画面に文字として表示する | 金額、氏名、日付、売上数値の表示【基本はこれ!】 |
| 強制出力スクリップレット (HTMLエスケープなし) |
<?!= コード ?> |
変数の値をHTMLタグのまま生で画面に出力する | 第83回の include('stylesheet') などの部品合体 |
| 標準スクリップレット (処理実行のみ) |
<? 処理 ?> |
画面には何も出力せず、裏でfor文やif文などのロジックを実行する | 一覧データの繰り返しループ展開、条件による分岐 |
① 最もよく使う基本形:<?= 変数 ?>
GAS側で用意した変数の値を、画面上に文字としてポンと表示させたいときは <?= ... ?>(イコール付き)を使います。
<!-- GAS側で template.userName = "道産子花子"; と渡した場合 -->
<h1>ようこそ、<?= userName ?> さん!</h1>
<!-- 画面の表示結果 ➔ ようこそ、道産子花子 さん! -->
末尾にイコール = を付けると、「この中身を画面に出力(Print)してね!」という合図になります。悪意のあるスクリプトを無害化する「HTMLエスケープ」が自動で行われるため、セキュリティ的にも極めて安全です。
② 部品合体で大活躍:<?!= コード ?>
イコールの後ろにエクスクラメーションマーク !(感嘆符)がついた <?!= ... ?> は、エスケープを行わずに「HTMLやCSSコードを生のまま埋め込む」ときに使います。
<!-- 第83回で学んだCSSファイルのインクルード処理 -->
<head>
<?!= include('stylesheet'); ?>
</head>
もしここを <?= include('stylesheet') ?> にしてしまうと、せっかくの <style> タグが文字列として無害化(エスケープ)されてしまい、画面にCSSのコードが文字としてそのまま丸見えになってしまいます。外部ファイルの読み込みには <?!= を使うと覚えておきましょう!
③ ループや条件分岐を操る:<? 処理 ?>
イコールを付けないプレーンな <? ... ?> は、画面に文字を出すのではなく、JavaScriptの「繰り返し処理(for文)」や「条件分岐(if文)」をHTMLの途中で動かしたいときに使います。
<!-- 配列に入った会議室リストを1行ずつHTMLの表にする例 -->
<ul>
<? for (var i = 0; i < roomList.length; i++) { ?>
<li><?= roomList[i] ?></li>
<? } ?>
</ul>
HTMLタグの合間に波カッコ { と } を挟むように記述することで、スプレッドシートの行数に合わせてHTMLの要素を自由自在に増殖させることができます!
3. STEP1:準備!「札幌オフィス統合管理簿」に最新データを入力しよう
それでは、実際に手元のスプレッドシートを使って実践していきましょう!
今回は、第81回〜第83回で作成した「札幌オフィス統合管理簿」のスプレッドシートの中に、ダッシュボードへリアルタイム反映させるための2枚のシートを用意します。
1. 「売上実績」シートの作成
スプレッドシートの画面下部にあるシートタブの名前を 「売上実績」 に変更(または新規追加)し、以下のデータを入力してください。
| A列(項目名) | B列(当月数値) | C列(前年比・備考) | |
|---|---|---|---|
| 1行目 | 指標名 | 実績値 | 前年比 |
| 2行目 | 売上目標達成率 | 124.8% | +18.5% |
| 3行目 | 当月売上合計 | 18,720,000円 | 目標:1,500万円 |
| 4行目 | 稼働プロジェクト数 | 14件 | 全件オンスケジュール |
| 5行目 | 残業削減率 | -22.4% | GAS自動化推進の効果 |
2. 「会議室予約」シートの作成
画面左下の「+」ボタンを押し、もう1枚のシートを追加して名前を 「会議室予約」 にします。以下のように、第76回〜第80回のカレンダー編でも登場した札幌オフィスの会議室状況を入力しておきましょう。
| A列(施設・ブース名) | B列(予約時間帯) | C列(利用用途・会議名) | D列(ステータス) | |
|---|---|---|---|---|
| 1行目 | 施設名 | 時間 | 会議名 | 状況 |
| 2行目 | 第1会議室(テレビ会議) | 13:00 – 14:30 | 東京・札幌DX合同定例会 | 利用中 |
| 3行目 | 第2ミーティングスペース | 15:00 – 16:30 | 秋のセコマ新商品コラボ企画 | 予約あり |
| 4行目 | 集中作業ポッドA(1人席) | 終日フリー | もくもく開発・オンライン面談 | 即時利用可 |
| 5行目 | 集中作業ポッドB(1人席) | 16:00 – 18:00 | AWSアーキテクチャ設計レビュー | 予約あり |
準備ができたら、上部メニューの 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開きましょう!
4. STEP2:【実践:Code.gs】スプレッドシートからデータを取得しテンプレートへ渡そう!
まずは、バックエンド(GAS側)の処理から作成します。
スプレッドシートの各シートからデータを取得し、createTemplateFromFile() で生成したテンプレートオブジェクトへデータを流し込んでブラウザに返却する doGet(e) 関数を書いていきましょう。
コード.gs の入力
左側のファイル一覧から コード.gs を開き、中身をすべて消去して以下のコードを貼り付けてください。
/**
* 札幌オフィス統合ダッシュボード Webアプリケーション
* スプレッドシートの最新データを読み込み、HTMLテンプレートへ渡して描画する
*/
function doGet(e) {
// ① スプレッドシートから最新データを取得する
var ss = SpreadsheetApp.getActiveSpreadsheet();
// 1. 売上実績データの取得(第5回 getValue / 第13回 getValues の復習!)
var salesSheet = ss.getSheetByName("売上実績");
var kpiData = {
achievementRate: salesSheet.getRange("B2").getValue(), // 達成率
achievementSub: salesSheet.getRange("C2").getValue(), // 前年比
totalSales: salesSheet.getRange("B3").getValue(), // 売上合計
activeProjects: salesSheet.getRange("B4").getValue(), // 稼働プロジェクト数
overtimeCut: salesSheet.getRange("B5").getValue() // 残業削減率
};
// 2. 会議室予約一覧データの取得(2次元配列で一括取得!)
var roomSheet = ss.getSheetByName("会議室予約");
var lastRow = roomSheet.getLastRow();
// ヘッダーを除いた2行目から最終行までのデータを取得(A2:D5)
var roomReservations = roomSheet.getRange(2, 1, lastRow - 1, 4).getValues();
// ② 【本日の主役!】HTMLファイルを「テンプレート」として読み込む
var template = HtmlService.createTemplateFromFile('index');
// ③ テンプレートオブジェクトへ、取得したデータをプロパティとして手渡す!
template.kpi = kpiData;
template.reservations = roomReservations;
template.updatedTime = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
// ④ テンプレートを評価(evaluate)して、完成したHTMLを出力する
var htmlOutput = template.evaluate();
// ⑤ ページタイトルとモバイル用メタタグを設定する
htmlOutput.setTitle('【札幌オフィス】リアルタイム統合ダッシュボード');
htmlOutput.addMetaTag('viewport', 'width=device-width, initial-scale=1');
// ⑥ ブラウザへHTMLを返却!
return htmlOutput;
}
/**
* 外部CSSやJSファイルをインクルードするための共通部品関数(第83回参照)
*/
function include(filename) {
return HtmlService.createHtmlOutputFromFile(filename).getContent();
}
コードの重要ポイントを1行ずつ解説!
初心者の方がスムーズに理解できるよう、データの流れを紐解いてみましょう。
var kpiData = { ... };
B2セルの達成率やB3セルの売上合計を、扱いやすいようにJavaScriptのオブジェクト(連想配列)にまとめています。roomSheet.getRange(2, 1, lastRow - 1, 4).getValues();
第13回で学んだ高速化テクニックです!会議室予約の表全体を「2次元配列」として一括取得しています。template.kpi = kpiData;/template.reservations = roomReservations;
ここが最も重要な架け橋です!createTemplateFromFile('index')で作ったtemplateというダンボール箱の中に、.kpiや.reservationsという新しいラベルを貼り、そこにスプレッドシートのデータを詰め込んでいます。ここで名付けた名前(kpiやreservations)を使って、次のステップでHTML側からデータを呼び出します。template.evaluate();
データを詰め終えたテンプレートを評価し、ブラウザで表示できる完全なHtmlOutputに変換しています。
5. STEP3:【実践:index.html】テンプレートタグで画面にデータを埋め込もう!
GAS側から kpi、reservations、updatedTime という3つのデータが送られてくる準備が整いました!
次は、受け取り手である index.html を開き、スクリップレットタグを使ってデータを画面へ美しく流し込みましょう。
index.html の入力
左側のファイル一覧から index.html を選択し、コードを以下のように書き換えて保存してください。
<!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", "BIZ UDPGothic", sans-serif;
background-color: #f0f4f8;
color: #2d3748;
display: flex;
min-height: 100vh;
}
/* サイドバー */
.sidebar {
width: 240px;
background-color: #1a365d;
color: #ffffff;
padding: 24px 16px;
display: flex;
flex-direction: column;
}
.sidebar h2 { font-size: 16px; font-weight: 700; margin-bottom: 24px; }
.nav-menu { list-style: none; }
.nav-item { margin-bottom: 8px; }
.nav-link {
display: block;
padding: 10px 14px;
color: #cbd5e0;
text-decoration: none;
border-radius: 6px;
font-size: 14px;
}
.nav-link.active { background-color: #2b6cb0; color: #ffffff; font-weight: bold; }
/* メインコンテンツ */
.main-content { flex: 1; padding: 32px; overflow-y: auto; }
.header {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 24px;
}
.header h1 { font-size: 24px; font-weight: 700; color: #1a202c; }
.sync-time { font-size: 12px; color: #718096; margin-top: 4px; }
.badge-live {
background-color: #c6f6d5;
color: #22543d;
padding: 6px 14px;
border-radius: 20px;
font-size: 12px;
font-weight: 700;
}
/* KPIカード グリッド */
.kpi-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
gap: 20px;
margin-bottom: 32px;
}
.kpi-card {
background-color: #ffffff;
padding: 20px;
border-radius: 10px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.04);
border-left: 4px solid #3182ce;
}
.kpi-card.highlight { border-left-color: #dd6b20; /* 札幌オレンジ */ }
.kpi-title { font-size: 13px; color: #718096; font-weight: 600; margin-bottom: 8px; }
.kpi-value { font-size: 26px; font-weight: 700; color: #1a202c; }
.kpi-sub { font-size: 12px; color: #38a169; margin-top: 4px; font-weight: 600; }
/* ダッシュボード2カラム */
.dashboard-grid {
display: grid;
grid-template-columns: 2fr 1fr;
gap: 24px;
}
.widget-panel {
background-color: #ffffff;
padding: 24px;
border-radius: 10px;
box-shadow: 0 4px 6px rgba(0, 0, 0, 0.04);
}
.widget-panel h3 {
font-size: 16px;
font-weight: 700;
margin-bottom: 16px;
border-bottom: 2px solid #edf2f7;
padding-bottom: 8px;
}
/* 会議室リストスタイル */
.room-item {
display: flex;
justify-content: space-between;
align-items: center;
padding: 14px 0;
border-bottom: 1px solid #edf2f7;
}
.room-item:last-child { border-bottom: none; }
.room-title { font-weight: bold; font-size: 14px; }
.room-desc { font-size: 12px; color: #718096; margin-top: 2px; }
/* 状況バッジの動的カラー */
.status-badge {
font-size: 11px;
padding: 4px 10px;
border-radius: 12px;
font-weight: 700;
}
.status-inuse { background-color: #fed7d7; color: #9b2c2c; } /* 利用中:赤 */
.status-reserved { background-color: #feebc8; color: #7b341e; } /* 予約あり:橙 */
.status-available { background-color: #c6f6d5; color: #22543d; } /* 即時利用可:緑 */
.info-list { list-style: none; font-size: 13px; line-height: 1.8; color: #4a5568; }
.info-list li { margin-bottom: 10px; }
@media (max-width: 768px) {
body { flex-direction: column; }
.sidebar { width: 100%; }
.dashboard-grid { grid-template-columns: 1fr; }
}
</style>
</head>
<body>
<!-- 左側ナビゲーション -->
<aside class="sidebar">
<h2>🏢 札幌オフィス DX</h2>
<ul class="nav-menu">
<li class="nav-item"><a href="#" class="nav-link active">📊 統合ダッシュボード</a></li>
<li class="nav-item"><a href="#" class="nav-link">📅 施設・会議室予約</a></li>
<li class="nav-item"><a href="#" class="nav-link">📑 請求・売上台帳</a></li>
<li class="nav-item"><a href="#" class="nav-link">⚙️ システム設定</a></li>
</ul>
</aside>
<!-- メインダッシュボードエリア -->
<main class="main-content">
<div class="header">
<div>
<h1>札幌オフィス リアルタイムダッシュボード</h1>
<!-- GASから渡された更新時刻を動的出力! -->
<p class="sync-time">最終データ同期日時:<strong><?= updatedTime ?></strong></p>
</div>
<div class="badge-live">● スプレッドシート同期中</div>
</div>
<!-- ① KPIカードエリア:GASの kpi オブジェクトの値を埋め込み! -->
<div class="kpi-grid">
<div class="kpi-card highlight">
<div class="kpi-title">当月売上目標達成率</div>
<div class="kpi-value"><?= kpi.achievementRate ?></div>
<div class="kpi-sub">▲ 前年比 <?= kpi.achievementSub ?></div>
</div>
<div class="kpi-card">
<div class="kpi-title">当月売上合計金額</div>
<div class="kpi-value"><?= kpi.totalSales ?></div>
<div class="kpi-sub" style="color: #3182ce;">好調に推移中</div>
</div>
<div class="kpi-card">
<div class="kpi-title">稼働中DXプロジェクト</div>
<div class="kpi-value"><?= kpi.activeProjects ?></div>
<div class="kpi-sub"><?= kpi.activeProjects ?> 全案件進行中</div>
</div>
<div class="kpi-card">
<div class="kpi-title">業務効率化・残業削減率</div>
<div class="kpi-value"><?= kpi.overtimeCut ?></div>
<div class="kpi-sub">GAS自動化推進の成果</div>
</div>
</div>
<!-- ② 2カラムレイアウトエリア -->
<div class="dashboard-grid">
<!-- 会議室予約一覧:2次元配列を for ループで動的HTML生成! -->
<div class="widget-panel">
<h3>🕒 札幌オフィス 会議室・個別ブース稼働状況</h3>
<? for (var i = 0; i < reservations.length; i++) {
var roomName = reservations[i][0]; // A列: 施設名
var timeSlot = reservations[i][1]; // B列: 時間帯
var meeting = reservations[i][2]; // C列: 会議名
var status = reservations[i][3]; // D列: 状況
// ステータスに応じたバッジ色クラスを判定
var badgeClass = "status-available";
if (status === "利用中") {
badgeClass = "status-inuse";
} else if (status === "予約あり") {
badgeClass = "status-reserved";
}
?>
<div class="room-item">
<div>
<div class="room-title"><?= roomName ?></div>
<div class="room-desc"><?= timeSlot ?> 【<?= meeting ?>】</div>
</div>
<span class="status-badge <?= badgeClass ?>"><?= status ?></span>
</div>
<? } ?>
</div>
<!-- 右側お知らせパネル -->
<div class="widget-panel">
<h3>📢 道産子エンジニア通信</h3>
<ul class="info-list">
<li><strong>🏪 本日のセコマ当番:</strong><br>高橋エンジニア(ホットシェフのフライドチキン買出予定)</li>
<li><strong>🚇 交通・チカホ状況:</strong><br>札幌駅前通地下歩行空間・地下鉄南北線ともに混雑なし。</li>
<li><strong>💡 今日の心得:</strong><br>「自動化できる手作業はすべてGASに任せて、定時でサッと帰ろう!」</li>
</ul>
</div>
</div>
</main>
</body>
</html>
ここがスゴい!HTML側のスクリップレットの動きを徹底解剖!
コードの中で特に注目してほしい2つの神テクニックを解説します。
① オブジェクトのプロパティをピンポイント表示<?= kpi.achievementRate ?> や <?= kpi.totalSales ?> のように、GAS側で作成した kpi オブジェクトのキー名を指定するだけで、スプレッドシートのセルに入っていた「124.8%」や「18,720,000円」という数値がそのまま埋め込まれます。
② 表の行数に合わせてHTMLを自動増殖させるループ処理<? for (var i = 0; i < reservations.length; i++) { ... ?>
スプレッドシートの「会議室予約」シートから取得した2次元配列の長さ(reservations.length)だけ、ループ処理が回ります。明日の予約が10件に増えれば自動で10行分描画され、2件に減れば2行分だけ綺麗に描画されます!人間がHTMLの行数を書き直す必要は一切ありません。
さらに、if (status === "利用中") で条件分岐を行い、ステータスが「利用中」なら赤色のバッジ(status-inuse)、「予約あり」ならオレンジ、「即時利用可」なら緑色へと、CSSのクラス名までもプログラムが動的に切り替えています!
動作確認!ブラウザをリロードしてみよう!
コードを保存したら、さっそく動作確認をしてみましょう!
第82回・第83回と同様に、エディタ右上の 「デプロイ」 > 「デプロイをテスト」 から取得したテスト用URL(末尾が /dev のURL)をブラウザで開いてみてください。
スプレッドシートに入力した「124.8%」や「18,720,000円」、そして会議室の予約一覧が、色鮮やかなバッジと共にバッチリ表示されたはずです!
💡 ここで感動の実験!スプレッドシートを書き換えてみよう!
スプレッドシートの「売上実績」シートに戻り、B2セルの達成率を「150.0%」に書き換えてみてください。
その後、Webアプリのブラウザ画面に戻って 再読み込み(F5キー または Cmd + R) を押すと……?
一瞬でダッシュボードの数字が「150.0%」にリアルタイム更新されます!
これぞ、スプレッドシートをデータベースにした本格Webアプリケーションの真骨頂です!
6. STEP4:実務で差がつく!テンプレート開発のプロ技3選
基本が完璧に動いたところで、現場のエンジニアが開発で必ず取り入れている3つの発展テクニックを押さえておきましょう!
応用①:なぜ <?!= ?> ではなく <?= ?> を使うのか?(XSS脆弱性対策)
初心者のうちは「全部 <?!= ?> で出力しても動くし、どっちでもいいんじゃない?」と思いがちです。しかし、ここにはWebセキュリティ上の極めて重大な理由があります。
もしスプレッドシートのセルに、悪意のあるユーザーや外部フォームから <script>alert('攻撃成功!')</script> のような危険な文字列が入力されていたとします。
<?!= val ?>を使った場合(危険!)
スクリプトタグが生のまま実行されてしまい、勝手に不正なプログラムが動く「XSS(クロスサイトスクリプティング)」という深刻な脆弱性が発生します。<?= val ?>を使った場合(安全!)<や>が自動的に<や>という安全な文字に変換(HTMLエスケープ)されるため、攻撃を防いでただの文字として無害に表示してくれます。
「ファイル合体(include)のときだけ <?!= を使い、スプレッドシートのデータ出力には必ず <?= を使う!」 と心に誓っておきましょう。
応用②:三項演算子でステータスや表示を1行で切り替える
HTMLのテンプレート内で、簡単な条件分岐を行いたいときはJavaScriptの「三項演算子(条件 ? A : B)」を使うと、コードが驚くほどスッキリします。
<!-- 達成率が100%以上なら文字色を緑、未満なら赤にする例 -->
<span style="color: <?= kpi.achievementRate >= 100 ? '#38a169' : '#e53e3e' ?>;">
<?= kpi.achievementRate ?>%
</span>
わざわざ長々と <? if (...) { ?> ... <? } ?> と書かなくても、スタイル属性の中に直接色分けロジックをスマートに組み込めます!
応用③:日付や数値の整形は「GAS側(サーバー側)」で済ませてから渡す
スプレッドシートから日付を getValue() で取得すると、Sun Oct 04 2026 13:00:00 GMT+0900... のような長いDateオブジェクトになります。
これをHTMLテンプレート側で getFullYear() などを使って整形しようとすると、HTMLコードが乱雑になってバグの原因になります。
第29回で学んだ Utilities.formatDate() や、JavaScriptの toLocaleString()(3桁カンマ区切り)を使い、「GAS側で人が読みやすい文字列に綺麗にお化粧してから、テンプレートに手渡す」 のが実務における美しい設計の鉄則です!
7. 初心者が絶対につまずく!5大トラップと完全対処法
createTemplateFromFile() を使っているときに、誰もが一度は頭を抱える「典型的な5大トラブル」と解決策をまとめました。エラーが出たときはここをチェックしてください!
トラップ1:.evaluate() を呼び忘れてブラウザに何も表示されない!
// ✕ 間違い(.evaluate() を呼んでいない!)
function doGet(e) {
var template = HtmlService.createTemplateFromFile('index');
template.data = "テスト";
return template; // エラーになります!
}
【症状】「スクリプトが完了しましたが、何も返されませんでした」または HtmlTemplate cannot be returned というエラーが出る。
【原因と対策】createTemplateFromFile が返すのは「テンプレート(台紙)」であり、完成した「HTML画面」ではありません。必ず最後に return template.evaluate(); と評価メソッドを実行してください!
トラップ2:スクリップレットタグの閉じ忘れ(?> の抜け)で構文エラー
HTMLの中で <?= kpi.totalSales > のように、クエスチョンマーク ? を忘れて普通の山カッコだけで閉じてしまうミスが多発します。
タグが正しく閉じられていないと、テンプレート評価時に SyntaxError: Unexpected token という赤文字エラーが発生します。エディタのシンタックスハイライト(色分け)を確認し、必ず <? ... ?> で挟まれているか確認しましょう。
トラップ3:GAS側とHTML側で変数名・プロパティ名のスペルが一致していない
// GAS側
template.userList = users;
<!-- HTML側(大文字小文字が違う!) -->
<?= userlist ?> ➔ 画面には「undefined」と表示されてしまう!
JavaScriptは大文字と小文字を厳格に区別します。画面に undefined(未定義)と表示されてしまう場合は、GAS側で代入したプロパティ名と、HTML側で呼び出している単語が1文字違わず一致しているかチェックしてください。
トラップ4:2次元配列のインデックスを「1始まり」と勘違いしてズレる
スプレッドシートの感覚で、reservations[i][1] を「1列目(施設名)」だと思い込んでしまうパターンです。
配列のインデックスは必ず 0始まり です!
- A列(施設名)➔
reservations[i][0] - B列(時間帯)➔
reservations[i][1] - C列(会議名)➔
reservations[i][2] - D列(状況) ➔
reservations[i][3]
「1引いた数字を指定する!」と常に意識しましょう(第13回の復習ですね!)。
トラップ5:本番公開URL(/exec)でスプレッドシートの変更が反映されない?
スプレッドシートのデータを書き換えてWebアプリをリロードしたのに、数値が変わらない……という場合、原因は「ブラウザのキャッシュ」か「スプレッドシート側のセルの未確定」です。
- スプレッドシートで数値を打ち込んだ後、Enterキーを押してセル入力を確定させているか確認する。
- ブラウザで 強力な再読み込み(Ctrl + F5 / Macは Cmd + Shift + R) を試してみる。
なお、テンプレート(HTML)やGAS(.gs)の「プログラムコード自体」を書き換えた場合は、これまで通りテスト用URL(/dev)を使うか、本番URLならデプロイの新規バージョン更新を行ってくださいね!
8. 今回のまとめ&次回予告
今回は、スプレッドシートのリアルタイムデータをHTML画面へ動的に流し込む HtmlService.createTemplateFromFile() と、テンプレート内で大活躍する スクリップレット構文(<?= ?>, <? ?>) について徹底解説しました!
本日の重要ポイントおさらい
createTemplateFromFile('ファイル名')でHTMLを「動的テンプレート(台紙)」として読み込める!template.変数名 = データ;でGASからHTMLへ自由自在にデータを引き渡せる!- テンプレートは最後に必ず
template.evaluate()を実行してHTML画面に変換する! - HTML側では、値の安全な出力に
<?= 変数 ?>、for文やif文などのロジック実行に<? 処理 ?>を使い分ける! - スプレッドシートを更新してブラウザをリロードするだけで、最新データが瞬時に画面へ反映される!
これで、静的なWebサイトの枠を超え、業務データと完全に連動した「生きた社内Webアプリケーション」を構築できるようになりました!エンジニアとしての開発力が一気にプロレベルへと引き上がりましたね。
さて、リアルタイムなダッシュボードが完成したところで、次に欲しくなるのは「URLごとに表示する画面をパッと切り替える機能」です!
例えば、.../exec?view=kpi でアクセスしたら「売上KPI画面」、.../exec?view=room&dept=sales でアクセスしたら「営業部専用の会議室予約画面」というように、1つのWebアプリの中で複数の画面を動的に切り替えられたら、超本格的な業務ポータルになりますよね。
そこで次回(第85回)は、e.parameter を使ってURLパラメータから表示画面や部署別データを動的に切り替えるマルチビュー設計 を徹底解説します!
Webアプリのルーティング(画面遷移)の仕組みをマスターしていきますので、次回もどうぞお楽しみに!

