此生成器的用途
此生成器會建立 KOKOCAL QUiCK PANEL 的用戶端轉接程式。
生成檔案同時包含函式庫專案用檔案,以及各目標 Google 檔案中使用的小型用戶端轉接檔案。
它也是今後 KOKOCAL SCRIPT 自架函式庫使用版生成器的第一個標準模式。
函式庫與側邊欄動作的固定設定
選單顯示語言
Google 應用程式選單與對話框或面板中顯示的語言。
用戶端轉接程式與 dispatch 設計
函式庫 Identifier
新增 KOKOCAL Apps Script 函式庫時,固定 Identifier 使用 KOKOCAL_QUICK_PANEL_LIB。
生成器輸入
生成器頁面只需要選擇選單語言。輸入模式、快取與列數上限皆為固定值。
預設動作
輸入會寫入游標或目前儲存格,支援時會取代選取文字。資料庫讀取快取 5 分鐘,每個分頁最多讀取 1,000 列。
輕量轉接程式
生成檔案會在目標 Google 檔案中提供選單、診斷與 KOKOCAL_QuickPanel_dispatch。
跨應用輸入
函式庫會依目前使用的應用程式與選取狀態,處理試算表、簡報與文件中的輸入。
導入步驟
從 Google Drive 建立函式庫 Apps Script
在任意 Google Drive 資料夾建立新的 Apps Script 檔案,並作為 QUiCK PANEL 函式庫專案保存。
貼上函式庫檔案
建立 KOKOCAL_QuickPanel_Library.gs 與 KOKOCAL_QuickPanel_Sidebar.html,並貼上生成的函式庫內容。需要時將 appsscript-library.json 反映到 appsscript.json。
建立函式庫版本並複製 Script ID
保存函式庫專案後建立版本,並複製專案 Script ID。各目標檔案會用此 ID 新增函式庫。
從目標檔案開啟 Apps Script
開啟要使用 QUiCK PANEL 的 Google 試算表、簡報或文件,從擴充功能開啟 Apps Script。
新增自架函式庫
以複製的 Script ID 新增函式庫。Identifier 請設定為 KOKOCAL_QUICK_PANEL_LIB,並選擇剛建立的版本。
建立 KOKOCAL_Menu.gs 與 KOKOCAL_QuickPanel_Client.gs
建立相同名稱的 Apps Script 檔案並貼上個別檔案用內容。需要時將 appsscript-client.json 反映到 appsscript.json。
手動執行 KOKOCAL_QuickPanel_setup
在函數下拉選單選擇 KOKOCAL_QuickPanel_setup 並執行,完成授權與函式庫診斷。請勿手動執行 onOpen。
重新載入並開啟 QUiCK PANEL
重新載入 Google 檔案後,從 KOKOCAL 選單開啟 QUiCK PANEL。
儲存導入指南
生成腳本後,可從生成結果欄右上方的「下載導入指南」儲存導入所需資訊。離開頁面後生成結果會消失,因此建議在導入前先儲存。
導入後確認事項
函式庫診斷
從 KOKOCAL 選單開啟診斷,確認 Identifier、連線狀態與版本資訊。
資料庫登錄
登錄含有標籤、屬性與值欄位的試算表資料庫,並在側邊欄切換資料庫與工作表分頁。
搜尋與複製
依標籤、屬性或值搜尋,並確認可複製選取值。
跨應用輸入
確認可輸入到試算表目前儲存格、簡報文字範圍,以及文件游標或選取範圍。
注意事項
需要設定自架函式庫
生成檔案分為函式庫用檔案與用戶端轉接檔案。請先在使用者自己的 Google Drive 中建立函式庫專案。
試算表資料庫權限
沒有已登錄試算表資料庫讀取權限的使用者,無法在側邊欄顯示資料。
QUiCK PANEL 固定設定
生成器頁面只需要選擇選單語言。函式庫 Identifier 為 KOKOCAL_QUICK_PANEL_LIB,輸入模式會寫入游標或取代選取文字,資料庫讀取快取 5 分鐘,每個分頁最多讀取 1,000 列。
輸入位置取決於選取狀態
在簡報與文件中,部分游標位置、選取範圍或選取物件無法插入文字。請保留複製功能作為替代方式。
資料庫登錄資訊會依使用者保存
目前實作會使用 PropertiesService.getUserProperties() 保存資料庫清單。這已取代舊版 DocumentProperties 的檔案內共用設計。
準備好後前往生成器
在自己的 Google Drive 建立自架 Apps Script 函式庫,並用它為 Google 試算表、簡報與文件加入共通定型輸入側邊欄。