先生と生徒の会話形式で理解しよう

生徒

「Office ScriptsでExcelを自動化しているんですが、エラーが出たときに、どこが悪いのか分からなくなります…」

先生

「それは型設計が整理されていないのが原因かもしれません。TypeScriptでは、型の作り方次第でデバッグのしやすさが大きく変わります。」

生徒

「型をちゃんと決めると、エラーが分かりやすくなるんですか？」

先生

「はい。今日は、Office Scripts初心者向けに、デバッグしやすい型設計の考え方を丁寧に説明します。」

1. Office Scriptsとは？

Office Scriptsは、Excel Onlineで使える自動化スクリプトです。Excelの「自動化」タブから実行でき、セルへの書き込み、計算、シート操作などをコードで自動化できます。手作業で行っていたExcel操作を、正確かつ高速に実行できるのが大きな特徴です。

Office ScriptsではTypeScriptを使います。TypeScriptは「型」を使って、プログラムの間違いを事前に見つけやすくする言語です。この型の使い方が、デバッグのしやすさに直結します。

2. デバッグとは何かをやさしく説明

デバッグとは、「プログラムの間違いを見つけて直す作業」のことです。Excelで言えば、「計算結果がおかしい原因を探す作業」に近いです。

Office Scriptsでは、エラーが出たときに「どこで」「何が」間違っているかを見つける必要があります。そのとき、型がきちんと設計されていると、TypeScriptがヒントをたくさん出してくれます。

3. 型を決めないと何が困るのか

型を意識せずにコードを書くと、「何が入っている変数なのか」が分からなくなります。これは、ラベルのない箱をたくさん並べて作業している状態と同じです。

Office ScriptsでExcel自動化をしていると、文字なのか数字なのか分からず、エラーが起きた場所を特定しにくくなります。デバッグに時間がかかる原因の多くは、型があいまいなことです。

4. シンプルな型設計がデバッグを助ける

デバッグしやすい型設計の基本は、「シンプルに分ける」ことです。たとえば、数値用、文字用と役割をはっきりさせます。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const score: number = 90;
  sheet.getRange("A1").setValue(score);
}

このようにnumber型を明示しておくと、文字を入れようとした瞬間にエラーが出ます。これは「実行前に気づけるデバッグ」と言えます。

5. オブジェクト型で意味を分かりやすくする

複数のデータを扱う場合は、オブジェクト型を使うとデバッグが楽になります。オブジェクト型とは、「データのまとまりに名前を付ける仕組み」です。


type UserData = {
  name: string;
  score: number;
};

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const user: UserData = { name: "田中", score: 85 };
  sheet.getRange("A1").setValue(user.name);
  sheet.getRange("B1").setValue(user.score);
}

このように型を定義しておくと、「nameは文字」「scoreは数字」と一目で分かります。エラーが出たときも、どの項目がおかしいのか特定しやすくなります。