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

生徒

「Office Scriptsを始めてみたんですが、TypeScriptのエラーがたくさん出てしまって、何が悪いのか分からなくなりました…」

先生

「それは多くの初心者が通る道ですね。TypeScriptには、最初につまずきやすいポイントがいくつかあります。」

生徒

「パソコンもあまり触ったことがないので、専門用語も難しく感じます…」

先生

「大丈夫です。今日は、Office ScriptsでTypeScriptを使うときに、初心者がつまずきやすい点を一つずつ整理して説明します。」

1. Office Scriptsとは？

Office Scriptsは、Excel Onlineで使える自動化スクリプト機能です。Excelの「自動化」タブからスクリプトを実行でき、セルの値の変更、シートの作成、表の編集などをまとめて行えます。

Office Scriptsでは、TypeScriptというプログラミング言語を使います。TypeScriptは、Excel自動化を安全に行うための仕組みが多く用意されている反面、初心者が戸惑いやすいポイントもあります。

2. 型という考え方でつまずく

TypeScript初心者が最初につまずくのが「型」です。型とは、「この変数には何が入るのか」を決めるルールのことです。

Excelで言えば、「数値用のセル」「文字用のセル」を分けて考える感覚に近いです。TypeScriptでは、文字はstring、数字はnumberと書きます。これを意識しないと、エラーが出てしまいます。


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

最初は難しく感じますが、「Excelの値の種類を決めているだけ」と考えると理解しやすくなります。

TypeScriptでは、コードを書いている途中で赤い線や警告が表示されます。これに驚いてしまい、「何も書けない」と感じる初心者の方も多いです。

しかし、このエラー表示は「失敗」ではありません。むしろ、「実行する前に間違いを教えてくれる親切な機能」です。Office Scriptsでは、この仕組みのおかげでExcel自動化の失敗を減らせます。

Office Scriptsでは、必ずmain関数から処理が始まります。この仕組みが分からず、「どこにコードを書けばいいのか分からない」とつまずくことがあります。

main関数は、「Excel自動化のスタート地点」です。料理で言えば、レシピの一番最初の手順だと考えると分かりやすいです。


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

まずは、すべての処理がmain関数の中から始まる、と覚えておきましょう。

Office Scriptsでは、ドットがたくさん並ぶコードがよく出てきます。これは「メソッドチェーン」と呼ばれる書き方です。

「Excel全体からシートを取得して、セルを選んで、値を書く」という操作を、順番につなげて書いています。Excel操作を文章のように読める書き方だと考えると、理解しやすくなります。


function main(workbook: ExcelScript.Workbook) {
  workbook.getActiveWorksheet().getRange("B1").setValue("完了");
}

最初は長く見えますが、慣れるととても分かりやすい書き方です。

変数と関数の違いが分からず、混乱してしまう初心者も多いです。変数は「データを入れる箱」、関数は「作業をまとめたもの」です。

Office Scriptsでは、Excelの操作を関数にまとめることで、コードが読みやすくなります。最初は「変数は値、関数は処理」と覚えるだけで十分です。

TypeScriptやOffice Scriptsでは、Workbook、Worksheet、Rangeなど英語の単語が多く出てきます。これが原因で「自分には向いていない」と感じてしまうこともあります。

しかし、これらはExcelの部品の名前に過ぎません。「WorkbookはExcel全体」「Worksheetはシート」「Rangeはセル範囲」と、日本語で意味が分かれば十分です。

TypeScript初心者がつまずくのは、決して珍しいことではありません。特にOffice Scriptsは、Excelという身近なツールと組み合わせて学ぶため、理解が追いつくまで時間がかかることもあります。

大切なのは、「一度で完璧に理解しようとしないこと」です。エラーが出たら読み、少しずつ意味を知っていけば、必ずExcel自動化のコードが読めるようになります。