Office Scriptsの基本！Excel自動化で使う関数とコードの書き方
生徒
「Office Scriptsでスクリプトを作ってみたんですが、名前の付け方がよく分からなくて困っています。」
先生
「スクリプトの命名はとても大切ですよ。名前を見ただけで、何をする自動化なのか分かるようにするのがポイントです。」
生徒
「適当に名前を付けると、あとで困るんですか？」
先生
「はい。Excel自動化のスクリプトが増えるほど、命名規則と管理方法が重要になります。順番に見ていきましょう。」
1. スクリプトファイルの命名規則とは
Office Scriptsにおけるスクリプトファイルの命名規則とは、「スクリプトにどのような名前を付けるか」というルールのことです。 Office Scriptsでは、Excel Online上でスクリプトを保存すると、その名前が一覧に表示されます。 この名前が分かりにくいと、どのスクリプトがどのExcel自動化を行うのか分からなくなってしまいます。
命名規則と聞くと難しそうですが、実際は「自分や他の人が見てすぐ分かる名前を付ける」というだけです。 これは、学校のノートに教科名を書くのと同じ感覚です。
2. スクリプト名は処理内容が分かる日本語や英単語にする
Office Scriptsのスクリプト名は、処理内容が一目で分かる名前にすることが基本です。 たとえば「Script1」「test」などの名前では、何をするExcel自動化なのか分かりません。 「売上表作成」「初期データ入力」など、内容をそのまま表す名前にすると管理が楽になります。
英語が苦手な場合は、日本語のスクリプト名でも問題ありません。 Office Scriptsでは、日本語のスクリプト名もそのまま使えます。 大切なのは、検索したときに見つけやすい名前にすることです。
3. 動詞＋目的語で考える命名のコツ
スクリプトファイルの命名規則としておすすめなのが、「動詞＋目的語」で考える方法です。 たとえば、「作成_売上シート」「入力_初期データ」のように、 何をするスクリプトなのかを言葉の順番で表します。
これは、家の中の収納にラベルを貼るイメージです。 「書類」「文房具」と書いてあれば、中身がすぐ分かります。 スクリプト名も同じで、見た瞬間に役割が分かることが重要です。
4. スクリプト内のコードも名前で整理する
スクリプトファイルの管理は、名前だけでなくコードの書き方も関係します。 Office Scriptsでは、変数に分かりやすい名前を付けることで、コード全体が読みやすくなります。 これもコード管理の一部です。
function main(workbook: ExcelScript.Workbook) {
const sheet = workbook.getActiveWorksheet();
const headerCell = sheet.getRange("A1");
headerCell.setValue("売上一覧");
}
この例では、「headerCell」という名前を付けることで、 そのセルが見出し用であることが分かります。 このような工夫が、スクリプト管理を楽にします。
5. 似たスクリプトは名前でグループ化する
Office ScriptsでExcel自動化を続けていくと、スクリプトの数が増えていきます。 そのときに役立つのが、名前によるグループ化です。 たとえば、「売上_作成」「売上_更新」「売上_削除」のように、 共通の言葉を先頭に付けることで、一覧表示したときに並びます。
これは、ファイルを五十音順に並べるのと同じ考え方です。 Office Scriptsのコード管理では、名前の付け方が整理整頓の代わりになります。
6. シンプルな処理でもスクリプト名は具体的にする
簡単なExcel操作だからといって、スクリプト名を適当に付けるのはおすすめできません。 たとえA1セルに文字を書く程度の処理でも、あとから見返すと内容を忘れてしまいます。
function main(workbook: ExcelScript.Workbook) {
const sheet = workbook.getActiveWorksheet();
sheet.getRange("A1").setValue("完了");
}
このスクリプトなら、「A1セルに完了と表示」などの名前にしておくと、 何をするOffice Scriptsなのかすぐに分かります。
7. スクリプト管理は「増える前」に意識する
Office Scriptsのスクリプト管理で大切なのは、「最初から完璧にしよう」と思わないことです。 まずは、分かりやすい命名を意識するだけで十分です。 スクリプトが増えてきた段階で、名前を見直すこともできます。
Excel自動化を続けていく中で、スクリプトファイルの命名規則と管理方法を意識することで、 作業効率が大きく変わります。 初心者の方ほど、この基本を大切にしてください。
