Office Scriptsの基本文法とAPI基礎！Range（セル範囲）操作で学ぶExcel自動化の第一歩

1. Range（セル範囲）とは何か？

1. Range（セル範囲）とは何か？

Office ScriptsにおけるRange（レンジ）とは、Excelのセルやセルのまとまりを指す仕組みです。普段ExcelでA1セルをクリックしたり、A1からD5までドラッグして選択したりしますが、その「選択した部分」をコードで表現したものがRangeです。

Excel自動化、Excelマクロ、Office Scripts、Excel Online、自動処理といったキーワードで検索されることが多く、Range操作は必ず最初に覚える重要なポイントです。パソコン初心者の方は「表のマス目をまとめて指定する方法」と考えると分かりやすいでしょう。

2. セルを1つ指定するRangeの基本

2. セルを1つ指定するRangeの基本

まずは一番シンプルな例です。A1セルだけを操作する場合、セル番号を文字で指定します。これはExcelを触ったことがない人でも、住所のようなものだと考えると理解しやすくなります。

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

このコードでは、A1セルに文字を入力しています。「setValue」は「値をセットする」という意味の命令です。難しい言葉に見えますが、「セルに文字を書くボタン」だと思ってください。

3. 複数セルをまとめて指定する方法

3. 複数セルをまとめて指定する方法

Rangeは1つのセルだけでなく、複数のセルも指定できます。例えばA1からA5までの縦一列をまとめて操作することが可能です。これはExcel作業の時短、自動入力、データ整理でよく使われます。

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("A1:A5").setValue("同じ文字を入力");
}

「A1:A5」は、A1からA5まで全部、という意味です。ドラッグ操作をコードに置き換えたイメージを持つと理解しやすくなります。

4. 行や列をまとめて操作する

4. 行や列をまとめて操作する

Office Scriptsでは、行や列をまとめてRangeとして扱うこともできます。たとえば、1行目すべて、A列すべて、という指定が可能です。これは表全体の見出し作成や、データ初期化によく使われます。

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("1:1").setValue("見出し行");
}

「1:1」は1行目すべてを意味します。Excel初心者の方は「横一列ぜんぶ」と覚えて問題ありません。

5. 数値を書き込んで計算の準備をする

5. 数値を書き込んで計算の準備をする

Range操作は文字だけでなく、数字も扱えます。Excel自動化では、数値を入れて計算の土台を作ることが多く、Office Scriptsの基本APIとして重要です。

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

数字はダブルクォーテーションを付けずに書きます。これは「数値」と「文字」を区別するためのルールです。パソコン操作が初めての方は、「数字はそのまま、文字はかぎかっこ」と覚えておくと便利です。

6. Rangeから値を読み取る考え方

6. Rangeから値を読み取る考え方

Rangeは書き込むだけでなく、セルの中身を読み取ることもできます。読み取った値を別のセルに使うことで、Excel作業の自動化が一気に広がります。ここでは仕組みの考え方だけを押さえます。

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

「getValue」は「中身を取り出す」という意味です。難しく考えず、「セルの中をのぞく命令」とイメージしてください。

7. Range操作を理解すると何ができる？

7. Range操作を理解すると何ができる？

Range操作を理解すると、Excel Onlineでの繰り返し作業、自動入力、表作成、データ準備が一瞬で終わるようになります。Office Scripts、Excel自動化、TypeScript基礎、セル操作、業務効率化といった検索キーワードに強く関係する内容です。

プログラミング未経験でも、「セルを指定して、値を入れる」「まとめて操作する」という考え方を覚えるだけで、Excel作業が大きく変わります。RangeはOffice Scriptsの中でも特に重要な基礎なので、ゆっくり何度も読み返してください。

まとめ

まとめ

今回の記事では、Office Scriptsにおける最重要項目の一つである「Range（範囲）」の基本操作について詳しく解説してきました。Excelの自動化を実現する上で、セルを指定して値を書き込んだり、逆にセルから値を読み取ったりする操作は、避けては通れない必須のスキルです。プログラミングと聞くと難しく感じるかもしれませんが、要は「どのマス目（Range）」に対して「何をする（メソッド）」かを指示しているだけなのです。

Office Scriptsで学んだ主要なポイントの振り返り

これまでに学んだ内容を整理してみましょう。まず、特定のセル一つを指定する場合は getRange("A1") のように記述しました。そして、複数のセルをまとめて操作したいときは getRange("A1:C5") のように、Excelの関数でおなじみの形式を使って範囲を指定できます。

また、Office Scripts（TypeScript）を用いてExcel Online上のデータを操作する際は、単に文字を書き込むだけでなく、数値の扱いにも注意が必要でした。文字列は " "（ダブルクォーテーション）で囲み、数値はそのまま記述するというルールは、今後の条件分岐や計算処理でも繰り返し登場する基本中の基本です。

応用：複数のセルに異なる値を一括で設定する

一歩進んだ操作として、二次元配列（データの塊）を使って複数のセルに一度に異なる値を流し込む方法もあります。これを使えるようになると、大量のデータ処理が劇的に高速化されます。業務効率化やDX（デジタルトランスフォーメーション）の現場で重宝されるテクニックです。

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  // A1からB2の範囲に、一気に値を設定する例
  const data = [
    ["項目名", "数値"],
    ["売上", 5000]
  ];
  sheet.getRange("A1:B2").setValues(data);
}

このように setValues（複数形）を使うことで、表形式のデータを一括で作成できます。手作業で一つずつ入力していた手間が、ボタン一つで完了するのは非常に爽快ですよね。

VBAとの違いを知る

以前からExcelマクロ（VBA）に触れていた方にとっては、書き方の違いに戸惑うこともあるかもしれません。参考までに、同じ「A1セルに値をいれる」という処理をVBAで書くと以下のようになります。

Sub WriteValue()
    Range("A1").Value = "VBAでの入力"
End Sub

Office ScriptsはWeb版のExcelでも動作し、クラウド環境との相性が抜群です。これからの時代のExcel自動化において、Range操作のマスターは最強の武器になるでしょう。