操作指南:修改報表規則與排錯
本頁適合導入顧問、系統管理員或維護報表範本的人員。以下是規則編寫與排錯;日常查閱請看報表查閱。
這頁適合已完成第一份報表,需要調整規則時查閱。修改前先把目前 DSL 複製到自己的備份文件;每次只改一個部分,預覽並核對後再保存。
加入科目清單或範圍
Section titled “加入科目清單或範圍”先在「科目」確認代號,再選一種方式:
| 要選的科目 | 寫法 | 核對重點 |
|---|---|---|
| 單一代號 | 現金: {1110} |
確認它是要用的明細科目 |
| 指定幾個代號 | 現金與銀行: {1110,1111} |
用半形逗號分開 |
| 連續編號 | 現金與銀行範圍: {1110..1111} |
起訖都包括;中間編號也會選入 |
| 同一編號開頭的科目 | 流動項目: {11} |
會選實際編號以 11 開頭的下層科目;先核對整份科目表 |
連續範圍用兩個半形句點 ..,不是省略號;清單內也能放範圍,例如 {1110..1111,1511}。範圍起訖各不得超過 64 位,且同一份報表在去重前最多展開 10,000 個科目編號;超過時請縮小範圍或改用已確認的科目代號。
同一次科目選取中的重複編號只會計入一次;不過,不同報表列若再次引用同一科目仍會各自計算,因此合計公式應避免將範圍重疊的列直接相加。
代號若有更長的同前綴科目,系統會取那些下層科目,省略該代號本身。這個行為依編號前綴判斷,不是看名稱,也不是把群組列的金額再加一次。詳細例子見科目群組如何選取。
以既有列加總或計算
Section titled “以既有列加總或計算”把被引用的列放前面,計算列放後面。以下範例可整段預覽:
現金與銀行 現金: {1110} 銀行存款: {1111} _可用資金合計: $現金 + $銀行存款 =扣除保留額: $可用資金合計 - 10000本例合計 94,000 元,扣除保留額後為 84,000 元。10000 是算式中的固定數字,不會建立保留款交易。_ 是單底線,= 放在列名稱最前面是雙底線,兩者都只是顯示標記。
公式可用 +、-、*、/ 和括號。先乘除後加減,想先加總就寫 ($現金 + $銀行存款) / 2。金額常數填整數元,不填千分位逗號;例如 10000 代表 10,000 元。
列名稱建議保持簡短,不含空格或運算符號。引用時用 $ 加上相同列名稱,不加底線標記;同一份 DSL 的所有列名稱都要不同,包括分組標題。
填固定數字、分組和註解
Section titled “填固定數字、分組和註解”資金檢查 # 這是自己閱讀的提醒,不會印在報表 現金: {1110} 銀行存款: {1111} # 一月核對銀行 保留額 = 10000 _可用資金: $現金 + $銀行存款 - $保留額保留額 = 10000 使用等號設定固定數字,每個期間都使用相同數字。它與 _可用資金: 這種冒號公式不同,也與列名最前面的 = 雙底線不同。
沒有算式的「資金檢查」是標題,其數字格空白;縮排只表示層級,不會自動把下層加總。# 之後是註解,不出現在報表。要顯示說明標題,直接另寫一行文字,不必填文字常數。
假設銀行為 94,000 元、總資金也是 94,000 元,可以使用:
資金比例 現金: {1110} 銀行存款: {1111} 資金總額: $現金 + $銀行存款 銀行占比(百分比): ($銀行存款 / $資金總額)%最後的 % 把計算值乘以 100,本例結果為 100,代表 100%。畫面不會自動加上百分比符號,所以列名稱要說明單位,不能當作 100 元。
這個寫法也代表 10% 會得到 1000,不是一般書寫的十分之一。要計算十分之一,寫 10 / 100。比例可以產生小數,核對時應按比率解讀。
分母為零會讓此次報表計算失敗。如果某比較期間沒有資金,先移除該期間或暫時移除比例列,核對資料後再決定適當的報表呈現方式。
比較兩個月份
Section titled “比較兩個月份”- 保留同一份 DSL,按「修改報表區間」(新增/編輯頁為「設定報表區間」)。
- 第一欄設定 2026 年 1 月,新增比較欄設定 2026 年 2 月。
- 確認每欄名稱及起訖日期,再套用;在編輯頁重新按「預覽 DSL」。
- 逐列比較數字。每個月只計算自身日期內的已同意傳票,不會自動把上個月餘額帶入。
不要把日期寫成 20260101..20260131 放在 DSL,也不要加入 @COLUMN;本系統不支援這些寫法。科目代號不支援 *、? 等萬用字元,例如 {11*}。請使用已確認的科目代號、清單或數字範圍。
| 症狀 | 先檢查 | 怎麼處理 |
|---|---|---|
| 縮排錯誤,找不到上層 | 第一個有內容的項目是否已縮排 | 最外層標題從行首開始,下層統一使用四個空格 |
| 「發現重複的 ID」 | 同名列,包括底線標記移除後的名稱 | 給每列不同名稱,同時更新所有 $列名稱 |
| 找不到引用列 | 拼字、列順序、是否只有標題沒有值 | 把有數值的來源列放前面,名稱逐字一致 |
| 公式無法解析 | 全形符號、漏大括號或括號、貼入日期 | 使用範例的半形符號;日期改到報表區間設定 |
| 除數不能為零 | 每個比較期間的分母 | 先核對該列,移除無法計算的期間或比例列 |
| 科目顯示零 | 科目編號、日期、已同意狀態 | 選錯或不存在的編號也可能顯示零,回科目表與傳票確認 |
| 金額差異或正負號不同 | 借方減貸方、抵銷設定、其他交易 | 依計算說明比對,不直接改傳票補數字 |
| 標題空白數字格 | 該列沒有公式 | 這是正常標題;若要合計,明確寫加總公式 |
排錯時先預覽,不急著保存。修正後重新預覽目前文字,再按「儲存報表範本」,重新開啟確認。報表範本操作另有按鈕與權限說明。