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

生徒

「Office Scriptsでいくつもスクリプトを書いていたら、どれが何の処理かわからなくなってきました…」

先生

「それはプロジェクト構造を意識していないことが原因ですね。整理の考え方を知るだけで、管理がとても楽になります。」

生徒

「プロジェクト構造って、難しそうな言葉ですが初心者でも必要なんですか？」

先生

「もちろんです。ファイルや書類を整理する感覚と同じなので、順番に見ていきましょう。」

1. Office Scriptsのプロジェクト構成とは何か

Office Scriptsのプロジェクト構成とは、「Excelを自動化するためのコードが、どのような形でまとめられているか」という考え方です。難しく聞こえますが、実際はとてもシンプルです。Office Scriptsでは、1つの自動化処理を1つのスクリプトとして管理します。このスクリプトの中に、Excelを操作するための命令が順番に書かれています。

プログラミング未経験の方は、「プロジェクト」という言葉に身構えてしまうかもしれません。ですが、Office Scriptsではフォルダを自分で作ったり、複雑な設定をしたりする必要はありません。 Excel Onlineの画面上で、スクリプトを作成し、その中にコードを書く、という流れだけで完結します。

2. スクリプト1本＝1つの作業という考え方

Office Scriptsでは、「1つのスクリプトが1つの仕事を担当する」という考え方が基本です。たとえば、「A1セルに文字を書く」「新しいシートを作る」といった作業を、それぞれ独立したスクリプトとして保存できます。これは、家電のリモコンに例えると分かりやすいです。電源ボタン、音量ボタン、チャンネルボタンが分かれているように、スクリプトも役割ごとに分けておくと管理が楽になります。

このように分けておくことで、あとから修正するときも「どのスクリプトを直せばいいか」がすぐに分かります。これがOffice Scriptsにおける基本的なコード管理の考え方です。

3. main関数が入口になる理由

Office Scriptsのコードには、必ずmainという名前の関数が登場します。関数とは、「やることをまとめた箱」のようなものです。 Excelがスクリプトを実行するとき、まずこのmain関数を探して、中に書かれている命令を上から順番に実行します。

これは、学校のチャイムのようなものだと考えてください。チャイムが鳴ると授業が始まるように、main関数があることで「ここから処理が始まりますよ」という合図になります。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("A1").setValue("はじめてのOffice Scripts");
}

このコードでは、現在開いているシートを取得し、A1セルに文字を書いています。プロジェクト構成としては、このmain関数がスクリプト全体の中心になります。

4. コードは上から下へ読む

Office Scriptsのコード管理で大切なのは、「上から下に順番に読む」という意識です。人が料理のレシピを読むとき、いきなり最後を見ることはありません。材料、手順1、手順2と順番に進めます。 Office Scriptsのコードも同じで、書いた順番に実行されます。

そのため、プロジェクト構成を考えるときは、「どの操作を先に行うか」を意識して並べることが重要です。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("A1").setValue("1行目");
  sheet.getRange("A2").setValue("2行目");
}

この場合、A1セルに文字を書いたあとで、A2セルに文字が書かれます。この順番が、コード管理の基本になります。

5. 変数を使ってコードを整理する

変数とは、「後で使うためのメモ」のようなものです。 Office Scriptsでは、シートやセルを変数に入れておくことで、コードが読みやすくなります。読みやすいコードは、管理しやすいコードでもあります。

プロジェクト構成を考えるうえで、「何を変数としてまとめるか」を意識するだけで、スクリプト全体がすっきりします。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const titleCell = sheet.getRange("B1");
  titleCell.setValue("タイトル");
}

このように名前を付けることで、「何のためのセルか」がすぐに分かります。これもコード管理の大切なポイントです。

6. スクリプト名で役割を分かりやすくする

Office Scriptsでは、スクリプト自体に名前を付けられます。この名前が、そのままプロジェクト構成の分かりやすさにつながります。たとえば、「売上表作成」「初期設定」など、何をするスクリプトかが分かる名前にすると便利です。

名前を適当に付けてしまうと、後から見たときに内容が分からなくなります。ノートの表紙にタイトルを書くのと同じ感覚で、スクリプト名も大切にしましょう。

7. Office Scriptsでのコード管理の考え方

Office Scriptsのコード管理は、「難しい管理ツールを使うこと」ではありません。シンプルなスクリプトを、役割ごとに分けて保存することが基本です。そして、main関数を入口として、上から下へ分かりやすく書くことが重要です。

プログラミングが初めての方でも、この考え方を押さえておけば、 Excel自動化のスクリプトを安心して増やしていくことができます。

まとめ

ここまで、Office Scriptsのプロジェクト構造とコード管理の基本について詳しく解説してきました。Excelの自動化と聞くと、膨大なプログラムを一つのファイルに詰め込むイメージを持つかもしれませんが、Office Scriptsの本質は「小さく分けて、分かりやすく管理する」ことにあります。初心者の方がプログラミング学習をスムーズに進めるためには、高度な構文を覚えることよりも、まずは「どこに何が書いてあるか」を自分自身で把握できる状態に整えることが大切です。

プロジェクト管理の3つの鉄則

Office Scriptsにおける効率的な管理には、いくつかの重要なポイントがあります。これらを意識するだけで、数ヶ月後の自分がコードを見直した際、迷うことなく修正や機能追加を行えるようになります。

単一責任の原則： 1つのスクリプトに「売上集計」「メール送信」「グラフ作成」など複数の役割を持たせないようにしましょう。役割を分けることで、エラーが発生した際の特定が容易になります。
命名規則の統一： スクリプト名や変数名には、一目で内容が分かる名前を付けます。例えば「Script1」ではなく「Daily_Sales_Update」のように、用途を明確に記述しましょう。
構造の可視化： main関数を起点として、処理の全体像を把握しやすいようにインデントや改行を適切に使い、コードの可読性を高めます。

実践的なサンプルコードで構造を再確認

プロジェクト構造を意識した具体的なコード例を見てみましょう。以下のコードは、シートの準備、データの入力、そして書式設定という3つのステップを、main関数の中で順番に実行する構造になっています。このように処理をブロックごとに考えるのが、きれいなプロジェクト管理の第一歩です。


/**
 * 定期報告書の雛形を作成するスクリプト
 * 役割：シートの初期化と基本項目の入力
 */
function main(workbook: ExcelScript.Workbook) {
  // 1. 操作対象のシートを取得（変数を使って整理）
  const targetSheet = workbook.getActiveWorksheet();

  // 2. データの入力（上から下への基本原則）
  targetSheet.getRange("A1").setValue("報告日");
  targetSheet.getRange("B1").setValue(new Date().toLocaleDateString());
  targetSheet.getRange("A2").setValue("作成者");
  targetSheet.getRange("B2").setValue("自動化スクリプト担当");

  // 3. 見た目の調整
  const headerRange = targetSheet.getRange("A1:A2");
  headerRange.getFormat().getFill().setColor("#D3D3D3"); // 薄いグレー
  headerRange.getFormat().getFont().setBold(true);

  console.log("プロジェクト構造に基づいた処理が完了しました。");
}

また、以前のVBA（Excelマクロ）に慣れている方のために、同じような処理をVBAで書いた場合の構造も比較として挙げておきます。VBAでは「標準モジュール」の中に「Sub」という単位で処理を記述しますが、Office Scriptsの「スクリプトファイル」と「main関数」の関係に近いことが分かります。


' VBAでの構造化例
' 標準モジュール内に記述
Public Sub CreateReportTemplate()
    Dim ws As Worksheet
    Set ws = ActiveSheet
    
    ' セルへの値入力
    ws.Range("A1").Value = "報告日"
    ws.Range("B1").Value = Date
    
    ' 書式の設定
    With ws.Range("A1:A2")
        .Interior.Color = RGB(211, 211, 211)
        .Font.Bold = True
    End With
    
    MsgBox "VBAでの処理が完了しました。"
End Sub