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

生徒

「Office Scriptsでスクリプトをいくつも作っていたら、どれが何の処理かわからなくなってしまいました…」

先生

「それはよくある悩みですね。実は、スクリプトの名前の付け方と管理方法がとても大切なんです。」

生徒

「名前ってそんなに重要なんですか？」

先生

「はい。きちんとした命名規則があると、自分も他の人も迷わず使えるようになりますよ。」

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自動化を続けていく中で、スクリプトファイルの命名規則と管理方法を意識することで、作業効率が大きく変わります。初心者の方ほど、この基本を大切にしてください。

Office Scriptsのプロジェクト構成入門！スクリプトファイルの命名規則と管理方法をやさしく解説