カテゴリ: Office Scripts 更新日: 2026/01/28

Office Scriptsの基本!TypeScriptの基本構文(変数・関数・return)から始めるExcel自動化入門

基本構文(変数・関数・return)の入門
基本構文(変数・関数・return)の入門

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

生徒

「Office Scriptsを始めたんですが、変数とか関数とか、言葉の意味がよく分からなくて……」

先生

「最初は誰でもそうですよ。Office ScriptsではTypeScriptの基本構文を少しずつ理解すれば、Excel操作が一気に楽になります。」

生徒

「returnって書いてあるコードも見たんですが、何をしているんですか?」

先生

「それも大事な基本です。今日は変数・関数・returnを、Excel操作と一緒にゆっくり説明します。」

1. Office Scriptsとは?

1. Office Scriptsとは?
1. Office Scriptsとは?

Office Scriptsは、Excel Onlineで使えるExcel自動化ツールです。 いつも手作業で行っているExcel操作を、あらかじめ書いたコードで自動実行できます。

セルへの入力、シートの作成、数値の計算などを、 ボタン一つで正確に行えるのが大きな特徴です。 プログラミング未経験者でも、Excel操作を文章のように書くだけで使えます。

2. TypeScriptの基本構文を学ぶ意味

2. TypeScriptの基本構文を学ぶ意味
2. TypeScriptの基本構文を学ぶ意味

Office Scriptsでは、TypeScriptというプログラミング言語を使います。 といっても、いきなり難しいことを覚える必要はありません。

まずは「変数」「関数」「return」という、 プログラムの土台になる考え方を理解するだけで十分です。 これは、料理でいう包丁・まな板・レシピのような基本道具です。

3. 変数とは何かをやさしく理解する

3. 変数とは何かをやさしく理解する
3. 変数とは何かをやさしく理解する

変数とは、「値を一時的にしまっておく箱」です。 Excelでいうと、セルに文字や数字を入れる感覚に近いです。

Office Scriptsでは、変数を使ってシートやセルを記憶させます。 名前を付けて保存しておくことで、後から何度も使えます。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("A1").setValue("変数の例");
}

ここでは、sheetという変数に「今使っているシート」を入れています。 このようにすると、同じシートを何度も指定しなくて済みます。

4. 関数とは何かを理解しよう

4. 関数とは何かを理解しよう
4. 関数とは何かを理解しよう

関数とは、「やることをひとまとめにしたもの」です。 電子レンジのスタートボタンを押すと温めが始まるように、 関数を呼ぶと決まった処理が実行されます。

Office Scriptsでは、必ずmainという関数から処理が始まります。 このmain関数が、Excel自動化の入り口になります。


function main(workbook: ExcelScript.Workbook) {
  const ws = workbook.getActiveWorksheet();
  ws.getRange("B1").setValue("関数の中の処理");
}

function main と書くことで、「これが実行される処理です」とExcelに伝えています。

5. returnの役割を知ろう

5. returnの役割を知ろう
5. returnの役割を知ろう

returnは、「結果を返す」ための命令です。 自動販売機でボタンを押したあとに飲み物が出てくるようなイメージです。

Office Scriptsの基本操作では、returnを使わない場合も多いですが、 考え方を知っておくとコードの理解が深まります。


function getMessage(): string {
  return "こんにちは";
}

この関数は、「こんにちは」という文字を返します。 returnは「この結果を使ってください」という合図です。

6. 変数・関数・returnのつながり

6. 変数・関数・returnのつながり
6. 変数・関数・returnのつながり

変数はデータをしまう箱、関数は処理のまとまり、 returnは結果を外に渡す役割を持っています。

これらが組み合わさることで、Excel操作が分かりやすく整理されます。 Office Scriptsが初心者にも優しい理由の一つです。


function main(workbook: ExcelScript.Workbook) {
  const message = "基本構文の理解";
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("C1").setValue(message);
}

7. なぜ基本構文が大切なのか

7. なぜ基本構文が大切なのか
7. なぜ基本構文が大切なのか

いきなり複雑なExcel自動化をしようとすると、 どこで何をしているのか分からなくなります。

ですが、変数・関数・returnという基本構文を理解していれば、 コードを読んだときに流れが自然と見えてきます。 これは、Office Scriptsを長く安全に使うための土台になります。

8. プログラミング未経験でも安心な理由

8. プログラミング未経験でも安心な理由
8. プログラミング未経験でも安心な理由

Office Scriptsで使うTypeScriptは、 書いている途中で間違いを教えてくれる仕組みがあります。

基本構文を押さえておけば、 「どこで何を間違えたか」が分かりやすく表示されます。 これは、初めてコードを書く人にとって大きな安心材料です。

カテゴリの一覧へ
新着記事
New1
Office Scripts
Office Scriptsの基本!企業環境で安全にExcel自動化を使うための利用制限と管理者設定
New2
Office Scripts
Office Scriptsの基本!TypeScriptの型注釈を理解してExcel自動化を安全に書く方法
New3
Office Scripts
Office Scriptsの基本!Excel自動化で使うgetValues・setValues完全ガイド【初心者向け】
New4
Office Scripts
Office Scriptsの基本!エラー表示とログ確認でExcel自動化を安全に進める方法
人気記事
No.1
Java&Spring記事人気No1
Excel VBA
Excel VBAモジュール共有術!複数のブックでマクロを使い回す最適構成
No.2
Java&Spring記事人気No2
Excel VBA
個人用マクロブック(PERSONAL.XLSB)で作る最強の共通ライブラリ化ガイド
No.3
Java&Spring記事人気No3
Excel VBA
Excel VBAのプロジェクト構成とモジュール管理!標準・シート・ThisWorkbookの違い
No.4
Java&Spring記事人気No4
Excel VBA
VBAモジュールを安全にエクスポート・インポートする方法と注意点
No.5
Java&Spring記事人気No5
Excel VBA
ThisWorkbookに書くべき処理とは?VBAプロジェクトの正しい構成方法
No.6
Java&Spring記事人気No6
Excel VBA
Excel VBAのループ処理を徹底解説!For文とDo Loopで繰り返しを自動化
No.7
Java&Spring記事人気No7
Excel VBA
Excel VBAのブレークポイント設定と使い方!初心者でも理解できるデバッグの基本
No.8
Java&Spring記事人気No8
Office Scripts
Office Scriptsの基本!関数分割で読みやすいExcel自動化コードを設計する方法