複数のスクリプトを追加して使用する際のガイド

複数のKOKOCALスクリプトを同じApps Scriptプロジェクトで使うこと自体は可能です。現在のKOKOCAL SCRIPTでは、KOKOCAL_Menu.gsを共通入口にし、各機能をKOKOCAL_<機能名>.gsと専用HTMLファイルに分ける構成を標準にしています。

安全に使うためには、KOKOCAL_Menu.gsはプロジェクト内に1つだけ置き、各ジェネレーターで生成された機能別ファイルを追加します。1つ追加するたびに保存、承認、再読み込み、動作確認を行い、問題がないことを確認してから次のスクリプトを追加します。

function onOpen(e) {
  KOKOCAL_buildMenu(e);
}

function KOKOCAL_buildMenu(e) {
  const ui = SpreadsheetApp.getUi();
  const menu = ui.createMenu('KOKOCAL');

  if (typeof KOKOCAL_IncrementalSync_registerMenu === 'function') {
    KOKOCAL_IncrementalSync_registerMenu(menu);
  }

  if (typeof KOKOCAL_DuplicateFinder_registerMenu === 'function') {
    KOKOCAL_DuplicateFinder_registerMenu(menu);
  }

  menu.addToUi();
}

1. 1

   追加前に既存コードを退避する

   既存の.gsファイルやHTMLファイルをコピーし、元に戻せる状態を作ってから追加作業を始めます。業務ファイルでは、可能であればファイル自体のバックアップも作成してください。

2. 2

   プロジェクト名とファイル名を整理する

   複数のスクリプトを入れる場合は、Apps Scriptプロジェクト名、KOKOCAL_Menu.gs、KOKOCAL_<機能名>.gs、HTMLファイル名を分かる名前で管理します。

3. 3

   関数名の重複を確認する

   同じプロジェクト内に同名の関数があると、後から貼り付けた関数で上書きされたり、意図しない処理が実行されたりする可能性があります。

4. 4

   KOKOCAL_Menu.gsを1つだけ置く

   上部メニューを作る入口はKOKOCAL_Menu.gsに集約します。複数のKOKOCAL_Menu.gsを別内容で置かず、生成結果の最新版を1つだけ使います。

5. 5

   メニュー名とメニュー項目を確認する

   複数の機能は、上部メニューのKOKOCAL内に項目としてまとまります。各機能の項目が表示されるか確認します。

6. 6

   トリガーを重複登録しない

   初期設定関数を何度も実行すると、同じ時間主導型トリガーやインストール型トリガーが重複することがあります。トリガー一覧で不要なものがないか確認します。