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

生徒

「Office ScriptsでExcelを自動化できるようになってきたんですが、長く使えるコードってどう書けばいいんですか？」

先生

「毎日使うExcelだからこそ、あとから見ても分かりやすく、壊れにくいコードを書くことが大切ですね。」

生徒

「プログラミング初心者でも、そんな書き方はできますか？」

先生

「できますよ。今日はOffice Scriptsで長期運用に耐えるコード設計の考え方を、基本から説明していきましょう。」

1. 長期運用に耐えるコードとは何か

Office Scriptsで作るExcel自動化のコードは、一度動けば終わりではありません。毎日使ったり、何か月も同じスクリプトを実行したりすることが多くあります。長期運用に耐えるコードとは、時間がたっても内容が理解でき、少し修正したいときにも安心して直せるコードのことです。

プログラミング未経験の人に例えると、これは「自分だけが分かるメモ」ではなく、「誰が読んでも分かる説明書」を作るイメージです。Office ScriptsはTypeScriptという言語を使いますが、難しく考えず、読みやすさと安全さを意識することが第一歩になります。

2. 処理を小さく分けて考える設計

長く使えるOffice Scriptsを書くための基本は、処理を小さく分けることです。Excelでの作業を思い出してください。「シートを選ぶ」「セルに値を書く」「結果を確認する」といった作業を、一気にやるのではなく、順番に行います。コードも同じ考え方です。

ひとつの関数に多くの作業を詰め込むと、あとから見たときに何をしているのか分かりにくくなります。短くて役割がはっきりした処理を積み重ねることで、壊れにくいOffice Scriptsになります。


function main(workbook: ExcelScript.Workbook) {
  writeTitle(workbook);
}

function writeTitle(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("A1").setValue("売上一覧");
}

3. 名前の付け方でコードの寿命が決まる

Office Scriptsでは、変数や関数に名前を付けます。この名前が分かりにくいと、数週間後に自分で見返したときでも理解できなくなります。初心者の人ほど、意味が分かる日本語のイメージで名前を付けることが大切です。

たとえば「a」や「x」ではなく、「sheet」や「totalValue」のように役割が分かる名前にします。これはExcelのセルに見出しを書く感覚と同じです。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const totalCell = sheet.getRange("B2");
  totalCell.setValue(1000);
}

4. コメントを書く習慣を身につける

コメントとは、コードの横に書く説明文のことです。Office Scriptsは自動化の内容を忘れやすいため、なぜその処理を書いたのかを残すことが重要です。コメントはコンピューターではなく、人のために書きます。

パソコンに触ったことがない人が見ても、処理の流れが想像できるくらい丁寧に書くと、長期運用でも安心です。


function main(workbook: ExcelScript.Workbook) {
  // アクティブなシートを取得する
  const sheet = workbook.getActiveWorksheet();
  // A1セルにメッセージを表示する
  sheet.getRange("A1").setValue("処理完了");
}

5. エラーが起きにくい安全な書き方

Office Scriptsを長く使っていると、Excelの状態が毎回同じとは限らないことに気づきます。シート名が違ったり、セルが空だったりすると、エラーが発生することがあります。これを防ぐには、「存在する前提で書かない」ことが大切です。

初心者の人は、まず「必ず同じシートを使う」「決まったセルだけ操作する」というルールを決めるだけでも、安定したコードになります。


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