KOKOCAL SCRIPT

Guide

試算表基準差異報告指南

以基準工作表為正本,比較另一個工作表並透過 Google Apps Script 建立摘要、完整比較報告與僅差異報告的指南。

公開日: 2026年8月7日更新日: 2026年8月7日
以基準為主

盡量保留基準工作表的版面,並以顏色、註解與管理欄顯示差異。

完整與差異視圖

建立包含所有基準列的比較報告,以及只包含變更、追加、刪除或鍵值問題列的差異報告。

不破壞原資料

讀取基準工作表與比較工作表,但不改寫其值或格式。

此生成器適合的用途

此生成器會建立 Apps Script,使用照合鍵欄比較兩個 Google 試算表工作表。

比較報告會盡量維持基準工作表版面,追加比較端才有的列,並標示變更儲存格。

差異報告採用相近的基準版面,但只列出需要確認的記錄。

表單輸入項目

基準試算表 URL 或 ID

指定包含基準資料的 Google 試算表。報告工作表會建立在此檔案中。

基準工作表名稱

作為正本基準的工作表。其值與格式不會被變更。

比較試算表 URL 或 ID

指定要與基準比較的 Google 試算表。可以是同一檔案或其他檔案。

比較工作表名稱

要報告與基準差異的工作表。其值與格式也不會被變更。

標題列數

來源工作表上方的標題列數。通常為 1。

照合鍵欄

用於對應基準工作表與比較工作表中同一筆記錄的欄位。

比較對象欄

用於差異判定的欄位。留空時會比較兩個工作表中標題名稱相同的欄位。

區分大小寫

通常不區分。只有在大小寫需視為不同值時啟用。

空白鍵的處理

選擇是否將鍵欄空白的列納入重複判定。

最大同步筆數(0 為無限制)

初次同步時處理的最大列數。0 表示不設上限。

摘要工作表名稱

輸出比較筆數、變更列數、追加件數與刪除件數等摘要的工作表名稱。

比較報告工作表名稱

輸出完整基準版面報告的工作表名稱,包含所有基準列與比較端新增列。

差異報告工作表名稱

只輸出有變更、追加、刪除或鍵值問題之列的工作表名稱。

導入步驟

1

開啟 Apps Script

從目標試算表開啟 Apps Script。

2

貼上腳本

貼上生成的 Code.gs。若已有既有程式碼,請先備份再替換。

3

執行初期設定

從函數下拉選單執行 setup 函數,建立確認用工作表與選單。

4

重新載入試算表

初期設定完成後,重新載入試算表,使 KOKOCAL 選單顯示。

5

從選單執行

從選單執行生成工具,並確認輸出到確認用工作表的內容。

儲存導入指南

生成後,可從生成結果欄右上方的「下載導入指南」保存導入所需資訊。離開頁面後生成結果會消失,因此建議在導入前先保存。

導入指南包含的內容

導入方法、導入後確認事項、生成腳本、設定 JSON 與設定雜湊會彙整在同一份文件中。導入方法開頭會說明生成腳本記載於下方。

保存格式

可選擇 Markdown(.md)、Word(.docx)或 PDF 儲存畫面。

導入後確認事項

1

候選輸出

確認預期的候選結果輸出到確認用工作表。

2

來源資料不變更

確認來源工作表的值、列數、欄數沒有被變更。

3

需要確認

確認不確定的值不會被強制轉換,而是標記為需要手動確認。

注意事項

使用前確認

正式使用生成腳本前,請確認此項目。

重要注意事項

正式使用生成腳本前,請確認此項目。

重要注意事項

正式使用生成腳本前,請確認此項目。

使用前確認

正式使用生成腳本前,請確認此項目。

準備好後前往生成器

以基準工作表為正本,比較另一個工作表並建立摘要、完整比較報告與僅差異報告,盡量維持基準版面。

開啟生成器