跳到內容
開始使用

操作指南:修改報表規則與排錯

本頁適合導入顧問、系統管理員或維護報表範本的人員。以下是規則編寫與排錯;日常查閱請看報表查閱。

這頁適合已完成第一份報表,需要調整規則時查閱。修改前先把目前 DSL 複製到自己的備份文件;每次只改一個部分,預覽並核對後再保存。

先在「科目」確認代號,再選一種方式:

要選的科目 寫法 核對重點
單一代號 現金: {1110} 確認它是要用的明細科目
指定幾個代號 現金與銀行: {1110,1111} 用半形逗號分開
連續編號 現金與銀行範圍: {1110..1111} 起訖都包括;中間編號也會選入
同一編號開頭的科目 流動項目: {11} 會選實際編號以 11 開頭的下層科目;先核對整份科目表

連續範圍用兩個半形句點 ..,不是省略號;清單內也能放範圍,例如 {1110..1111,1511}。範圍起訖各不得超過 64 位,且同一份報表在去重前最多展開 10,000 個科目編號;超過時請縮小範圍或改用已確認的科目代號。

同一次科目選取中的重複編號只會計入一次;不過,不同報表列若再次引用同一科目仍會各自計算,因此合計公式應避免將範圍重疊的列直接相加。

代號若有更長的同前綴科目,系統會取那些下層科目,省略該代號本身。這個行為依編號前綴判斷,不是看名稱,也不是把群組列的金額再加一次。詳細例子見科目群組如何選取。

把被引用的列放前面,計算列放後面。以下範例可整段預覽:

現金與銀行
現金: {1110}
銀行存款: {1111}
_可用資金合計: $現金 + $銀行存款
=扣除保留額: $可用資金合計 - 10000

本例合計 94,000 元,扣除保留額後為 84,000 元。10000 是算式中的固定數字,不會建立保留款交易。_ 是單底線,= 放在列名稱最前面是雙底線,兩者都只是顯示標記。

公式可用 +、-、*、/ 和括號。先乘除後加減,想先加總就寫 ($現金 + $銀行存款) / 2。金額常數填整數元,不填千分位逗號;例如 10000 代表 10,000 元。

列名稱建議保持簡短,不含空格或運算符號。引用時用 $ 加上相同列名稱,不加底線標記;同一份 DSL 的所有列名稱都要不同,包括分組標題。

資金檢查
# 這是自己閱讀的提醒,不會印在報表
現金: {1110}
銀行存款: {1111} # 一月核對銀行
保留額 = 10000
_可用資金: $現金 + $銀行存款 - $保留額

保留額 = 10000 使用等號設定固定數字,每個期間都使用相同數字。它與 _可用資金: 這種冒號公式不同,也與列名最前面的 = 雙底線不同。

沒有算式的「資金檢查」是標題,其數字格空白;縮排只表示層級,不會自動把下層加總。# 之後是註解,不出現在報表。要顯示說明標題,直接另寫一行文字,不必填文字常數。

假設銀行為 94,000 元、總資金也是 94,000 元,可以使用:

資金比例
現金: {1110}
銀行存款: {1111}
資金總額: $現金 + $銀行存款
銀行占比(百分比): ($銀行存款 / $資金總額)%

最後的 % 把計算值乘以 100,本例結果為 100,代表 100%。畫面不會自動加上百分比符號,所以列名稱要說明單位,不能當作 100 元。

這個寫法也代表 10% 會得到 1000,不是一般書寫的十分之一。要計算十分之一,寫 10 / 100。比例可以產生小數,核對時應按比率解讀。

分母為零會讓此次報表計算失敗。如果某比較期間沒有資金,先移除該期間或暫時移除比例列,核對資料後再決定適當的報表呈現方式。

  1. 保留同一份 DSL,按「修改報表區間」(新增/編輯頁為「設定報表區間」)。
  2. 第一欄設定 2026 年 1 月,新增比較欄設定 2026 年 2 月。
  3. 確認每欄名稱及起訖日期,再套用;在編輯頁重新按「預覽 DSL」。
  4. 逐列比較數字。每個月只計算自身日期內的已同意傳票,不會自動把上個月餘額帶入。

不要把日期寫成 20260101..20260131 放在 DSL,也不要加入 @COLUMN;本系統不支援這些寫法。科目代號不支援 *、? 等萬用字元,例如 {11*}。請使用已確認的科目代號、清單或數字範圍。

症狀 先檢查 怎麼處理
縮排錯誤,找不到上層 第一個有內容的項目是否已縮排 最外層標題從行首開始,下層統一使用四個空格
「發現重複的 ID」 同名列,包括底線標記移除後的名稱 給每列不同名稱,同時更新所有 $列名稱
找不到引用列 拼字、列順序、是否只有標題沒有值 把有數值的來源列放前面,名稱逐字一致
公式無法解析 全形符號、漏大括號或括號、貼入日期 使用範例的半形符號;日期改到報表區間設定
除數不能為零 每個比較期間的分母 先核對該列,移除無法計算的期間或比例列
科目顯示零 科目編號、日期、已同意狀態 選錯或不存在的編號也可能顯示零,回科目表與傳票確認
金額差異或正負號不同 借方減貸方、抵銷設定、其他交易 依計算說明比對,不直接改傳票補數字
標題空白數字格 該列沒有公式 這是正常標題;若要合計,明確寫加總公式

排錯時先預覽,不急著保存。修正後重新預覽目前文字,再按「儲存報表範本」,重新開啟確認。報表範本操作另有按鈕與權限說明。