Office Scriptsの基本文法とAPI基礎!Excel自動化を始めるための書き方と基本構文をやさしく解説
生徒
「Excelを自動で動かせるって聞いたんですが、Office Scriptsってどうやって書き始めればいいんですか?」
先生
「Office Scriptsには決まった書き方があります。まずは基本の形を覚えることが大切です。」
生徒
「プログラミングは初めてなんですが、難しくないですか?」
先生
「Excelを操作する手順を文章で書くイメージなので、意外と分かりやすいですよ。」
生徒
「まず何から覚えればいいですか?」
先生
「Office Scriptsの基本構文から順番に見ていきましょう。」
1. Office Scriptsとは?
Office Scripts(オフィス スクリプト)は、Excel Onlineで使える自動化機能です。毎日同じセルに文字を入力したり、同じ作業を何度も繰り返したりする場合、その操作をコードとして保存できます。コードとは、パソコンに出す命令を文章のように書いたものです。Office Scriptsを使えば、クリックや手入力の代わりに、ボタン一つでExcel作業を実行できます。プログラミング未経験の人でも、Excel操作をそのまま文章に置き換える感覚で学べるのが特徴です。
2. Office Scriptsの基本的な書き方
Office Scriptsのコードは、必ず決まった形から始まります。これは「Excelを操作するための入口」のようなものです。料理で言えば、キッチンに入るドアのような存在です。この形を覚えるだけで、Office Scriptsの第一歩は完了です。
function main(workbook: ExcelScript.Workbook) {
const sheet = workbook.getActiveWorksheet();
}
functionは「これから処理を書きます」という合図です。mainはスクリプトの名前で、Office Scriptsでは必ず使われます。workbookはExcelファイル全体を表し、「今開いているExcel」を意味します。難しく考えず、「Excelそのもの」と覚えて大丈夫です。
3. セルに文字を書く基本コード
次は、Excelのセルに文字を書く一番シンプルな例です。これは、人がキーボードで文字を入力する作業を、コードで表現したものです。セル番地の「A1」は、Excelの左上のマスを指します。
function main(workbook: ExcelScript.Workbook) {
const sheet = workbook.getActiveWorksheet();
sheet.getRange("A1").setValue("はじめてのOffice Scripts");
}
getRangeは「このセルを使います」という指定です。setValueは「値を入れます」という意味です。つまりこのコードは、「A1のセルに文字を書いてください」とExcelにお願いしているだけです。
4. 複数のセルを操作する考え方
Office Scriptsでは、同じ考え方で別のセルも操作できます。セル番号を変えるだけで、違う場所に文字を書けます。これは、ノートの何ページ目に書くかを変えるような感覚です。
function main(workbook: ExcelScript.Workbook) {
const sheet = workbook.getActiveWorksheet();
sheet.getRange("A1").setValue("商品名");
sheet.getRange("B1").setValue("価格");
}
このように、同じ命令を並べるだけで、Excelの見出し行を自動で作れます。手で入力するより、ミスが減り、作業も速くなります。
5. コメントを書いてコードを読みやすくする
コードにはコメントを書けます。コメントは、パソコンには無視され、人が読むためのメモです。ノートに付せんを貼るような役割があります。後から見返したときにも内容が分かりやすくなります。
function main(workbook: ExcelScript.Workbook) {
// 今開いているシートを取得
const sheet = workbook.getActiveWorksheet();
// A1セルにタイトルを書く
sheet.getRange("A1").setValue("売上一覧");
}
//から始まる行はコメントです。初心者のうちは、何をしているコードなのか日本語で書いておくと、理解が深まります。
6. Office Scriptsでよく使う基本ルール
Office Scriptsを書くときには、いくつかの基本ルールがあります。アルファベットの大文字と小文字は区別されます。また、文の終わりにはセミコロンを付けます。これは、日本語の「。」のような役割です。最初は忘れても問題ありませんが、少しずつ慣れていきましょう。
また、コードは上から順番に実行されます。上に書いた命令から、Excelが一つずつ処理していくイメージです。流れを意識することで、Office Scriptsの動きが分かりやすくなります。
7. Office Scriptsは「Excel操作の文章化」
Office Scriptsの基本文法は、「Excelでやっている操作を、そのまま文章にする」考え方が大切です。セルをクリックする代わりにセル番号を書く。文字を入力する代わりにsetValueを書く。それだけで、Excel自動化が実現します。プログラミングが初めてでも、Excelを使った経験があれば理解しやすいのがOffice Scriptsの大きな魅力です。