Office Scriptsの基本！Excel自動化で使うインターフェイスとスクリプト設計の考え方

1. Office ScriptsとTypeScriptの関係

1. Office ScriptsとTypeScriptの関係

Office Scriptsは、Excel Onlineで動く自動化ツールです。Excelの操作を手作業ではなく、プログラムでまとめて実行できるのが大きな特徴です。そのときに使われているプログラミング言語がTypeScriptです。

TypeScriptは、JavaScriptをもとに作られた言語で、「データの種類」や「形」をしっかり決めてから書くことができます。これにより、間違いに気づきやすく、初心者でも安全にExcel自動化スクリプトを書けるようになります。Office Scriptsでは、このTypeScriptの考え方がとても重要になります。

2. インターフェイスとは何かを超やさしく説明

2. インターフェイスとは何かを超やさしく説明

インターフェイスとは、「このデータは、こういう項目を持っていますよ」と決めるためのルール表です。たとえば、紙の申込書を想像してください。名前を書く欄、住所を書く欄、電話番号を書く欄がありますよね。インターフェイスは、これとまったく同じ役割をします。

Office ScriptsでExcelを自動化するときも、「このデータには、どんな情報が入るのか」を先に決めておくと、スクリプトがとても読みやすくなります。特に初心者の方にとっては、迷子にならないための地図のような存在です。

3. インターフェイスの基本的な書き方

3. インターフェイスの基本的な書き方

では、実際にOffice Scriptsで使えるTypeScriptのインターフェイスを見てみましょう。ここでは「Excelの1行分のデータ」を表す簡単な例を使います。

interface RowData {
  name: string;
  age: number;
}

この例では、「nameは文字」「ageは数字」と決めています。stringは文字、numberは数字という意味です。これを使うことで、Excelのセルから取得したデータが、どんな形なのかを明確にできます。インターフェイス自体は処理を実行しませんが、スクリプト全体のルールを支える重要な存在です。

4. Office Scriptsでインターフェイスを使う理由

4. Office Scriptsでインターフェイスを使う理由

「なくても動くなら、なぜインターフェイスを使うの？」と思うかもしれません。理由はとてもシンプルで、ミスを減らし、後から見ても理解しやすくするためです。

Excel自動化のスクリプトは、少し長くなると「どこで何をしているのか」が分かりにくくなりがちです。インターフェイスを使うと、「この処理は、この形のデータを扱っている」と一目で分かります。これは、将来スクリプトを修正するときにも大きな助けになります。

5. インターフェイスを使った簡単なスクリプト例

5. インターフェイスを使った簡単なスクリプト例

次に、インターフェイスを使ってExcelのセルに値を書き込むOffice Scriptsの例を見てみましょう。ここでは、固定のデータをシートに表示します。

interface Person {
  name: string;
  message: string;
}

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const data: Person = {
    name: "田中",
    message: "こんにちは"
  };
  sheet.getRange("A1").setValue(data.name);
  sheet.getRange("B1").setValue(data.message);
}

このようにインターフェイスを使うと、「dataには何が入っているのか」がすぐに分かります。Excelの自動化処理を考えるときも、頭の中が整理しやすくなります。

6. スクリプト設計の考え方（初心者向け）

6. スクリプト設計の考え方（初心者向け）

スクリプト設計と聞くと難しそうですが、考え方はとても簡単です。「最初に何を扱うか決める」「次に処理を書く」という順番を守るだけです。インターフェイスは、この最初の段階で使います。

たとえば、「Excelの表から名前とメッセージを扱う」と決めたら、その形をインターフェイスで表します。そうすると、後の処理はその設計図に沿って書くだけになります。これは、料理で言えばレシピを先に確認してから調理するのと同じです。

7. 別パターンのインターフェイス活用例

7. 別パターンのインターフェイス活用例

最後に、数値を扱う別のパターンを見てみましょう。Excelの計算結果をセルに表示する例です。

interface Result {
  total: number;
}

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const result: Result = {
    total: 100
  };
  sheet.getRange("A2").setValue(result.total);
}

このように、インターフェイスは文字だけでなく数字にも使えます。Office ScriptsとTypeScriptの基礎として、インターフェイスを理解しておくと、Excel自動化の幅が大きく広がります。

まとめ

まとめ

ここまで、Office Scriptsにおけるインターフェイスの役割と、TypeScriptを用いたExcel自動化の基礎について詳しく解説してきました。Excelの作業を自動化するというと、どうしても「どのようにセルを操作するか」という「動き」の部分ばかりに目が行きがちです。しかし、実際にエラーが少なく、メンテナンスのしやすいスクリプトを作成するためには、今回ご紹介した「インターフェイスによるデータの型定義」が欠かせない要素となります。

Office Scripts習得の鍵は「設計図」にあり

プログラミング初学者の方がOffice Scriptsに触れる際、TypeScript特有の「型」の概念に戸惑うこともあるでしょう。しかし、インターフェイスを使って「名前は文字列（string）」「金額は数値（number）」といったルールを事前に定義することは、実は近道になります。なぜなら、ルールが決まっていることで、コードを書いている最中にエディタがミスを教えてくれるようになるからです。これは、真っ暗な道を進むよりも、街灯が整備された道を進むほうが安全であるのと似ています。

実戦で役立つ！さらに一歩進んだデータ管理の例

より実務に近い形でのインターフェイス活用例を見てみましょう。例えば、複数の在庫情報を一括で処理する場合、以下のようにインターフェイスを定義して配列として扱うことが一般的です。

/**
 * 商品情報を管理するためのインターフェイス
 */
interface StockItem {
  id: string;      // 商品ID
  name: string;    // 商品名
  quantity: number; // 在庫数
  isLowStock: boolean; // 在庫不足フラグ
}

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  
  // インターフェイスに基づいたデータの作成
  const item: StockItem = {
    id: "A001",
    name: "ワイヤレスマウス",
    quantity: 5,
    isLowStock: true
  };

  // Excelの特定のセルへ情報を書き込む
  sheet.getRange("A4").setValue(item.id);
  sheet.getRange("B4").setValue(item.name);
  sheet.getRange("C4").setValue(item.quantity);
  
  // 条件に応じてセルの色を変えるなどの応用も可能
  if (item.isLowStock) {
    sheet.getRange("C4").getFormat().getFill().setColor("yellow");
  }
}

このように、`boolean`（真偽値）などを使って「在庫が足りないかどうか」といった状態を持たせることもできます。インターフェイスがあることで、`item.`と打ち込んだ瞬間に、使える項目がリストアップされるため、タイピングミスによる実行エラーを劇的に減らすことができます。

VBAからOffice Scripts（TypeScript）への移行を考えている方へ

これまでExcel VBAを使ってきた方にとって、Office Scriptsの書き方は少し独特だと感じるかもしれません。VBAでも「構造体（Type）」という似た機能がありますが、TypeScriptのインターフェイスはより柔軟で強力です。ウェブ版のエクセルで動作し、クラウド環境との相性も良いOffice Scriptsは、これからの業務効率化において標準的なスキルになっていくでしょう。

まずは小さなスクリプトからで構いません。「このデータには何が含まれているべきか」をインターフェイスで書き出し、それに沿ってセルに値を出し入れする練習を繰り返してみてください。その積み重ねが、複雑な業務システムを自動化する大きな力へと変わっていきます。

参考：VBAでのデータ定義（構造体の例）

比較のために、VBAで似たようなデータ構造を作る場合のコードも紹介しておきます。Office Scriptsのインターフェイスがいかにスッキリしているかが分かります。

' VBAでデータを定義する場合の例
Public Type UserInfo
    UserName As String
    UserAge As Integer
End Type

Sub SampleVBA()
    Dim user As UserInfo
    user.UserName = "佐藤"
    user.UserAge = 30
    
    Range("A1").Value = user.UserName
    Range("B1").Value = user.UserAge
End Sub

実行結果は以下のようになります。

（ExcelシートのA1セルに「佐藤」、B1セルに「30」と出力されます）

Office Scripts（TypeScript）は、こうしたデータの定義が非常に洗練されており、モダンな開発環境を提供してくれます。ぜひ、今回学んだインターフェイスの考え方を活用して、日々の業務改善に役立ててください。