程式資訊

程式 ID：Abook2Condition
所屬子系統：N.總帳管理
狀態：stable

索引分類帳查詢條件¶

功能簡介¶

本頁是索引分類帳（程式 ABOOK2）的查詢條件面板。索引分類帳會把總帳傳票明細依某一個「索引欄位」分群（例如依員工、部門、客戶/廠商、專案、項目，或四組自訂分類索引），列出各群在指定期間的期初餘額、借貸明細與期末餘額。本面板負責收集「期間、科目範圍、索引種類、索引範圍」四組條件，按母頁的 查詢 後送進後端 SP 取資料。

主要使用者為會計與稽核人員：當你想知道「某個員工 / 部門 / 客戶這段期間在某科目上發生了哪些帳」時，就用這張面板把分群維度（索引種類）切到對應的欄位再查。

這是條件面板，不是獨立程式

本頁與索引分類帳是同一支程式（共用 ABOOK2）。面板本身只設定條件，實際的 查詢、列印、結果格線與報表都在母頁；完整操作與報表說明請見索引分類帳。

前置需求¶

權限：N.總帳 → N-100 索引分類帳 的瀏覽／列印權限（與母頁共用）。
基礎資料：條件面板上「索引種類」可選的維度，各自對應一份主檔。選了某種索引後，下方「索引」起訖欄位會去對應的主檔做放大鏡查詢，因此這些主檔要先維護好：

索引種類	起訖索引查詢的來源主檔	沒維護會怎樣
分類索引 1～4	分類索引主檔（`Sort1`）	索引欄放大鏡查不到可選值
項目編號	會計項目主檔（`Accitem`）	項目放大鏡無資料
部門代號	部門主檔（`Dept`）	部門放大鏡無資料
客戶或廠商代號	客戶／廠商主檔（`Cusp`）	客戶/廠商放大鏡無資料
員工編號	員工主檔（`Perdata`）	員工放大鏡無資料
專案代號	專案主檔（`Aproj`）	專案放大鏡無資料
品號群組代號	品號群組主檔（`Grpm1`）	群組放大鏡無資料

傳票資料：查詢期間內的傳票需已輸入，分群明細才有資料可顯示。

操作步驟¶

開啟索引分類帳後，畫面左側即為本條件面板。
設定日期起訖（帳冊期間）。
視需要縮小 科目代號 起訖範圍。
在 索引種類 下拉選擇要分群的維度（預設為「員工編號」）。
設定索引起訖範圍——此處的放大鏡會依步驟 4 選的索引種類，連到對應主檔挑值（詳見欄位連動與附加功能）。
回母頁工具列按 查詢，結果會在母頁格線依索引分群顯示；點某群可在下方看到該群的傳票明細與逐筆累計餘額。

小技巧

只想看「某一個」員工／客戶的帳時，把索引起訖設成同一個代號即可。要看全部就維持預設（起＝空、訖＝zzzzz）。

欄位說明¶

欄位	必填	說明／格式／預設
日期（起）	✔	帳冊起始日。預設帶本月 1 日（由結束日換算當月第一天）。格式 `YYYY/MM/DD`。
日期（訖）	✔	帳冊結束日。預設帶今天。格式 `YYYY/MM/DD`。
科目代號（起）	—	科目範圍起點。預設空字串（不設下界）。可用放大鏡查科目。
科目代號（訖）	—	科目範圍終點。預設 `zzzzz`（不設上界、含到最大）。
索引種類	✔	分群維度下拉。預設員工編號。可選：分類索引 1～4、項目編號、部門代號、客戶或廠商代號、員工編號、專案代號、品號群組代號。
索引（起）	—	依索引種類的代號範圍起點。預設空字串。放大鏡來源隨索引種類切換。
索引（訖）	—	依索引種類的代號範圍終點。預設 `zzzzz`。

畫面上看不到的內部條件

程式內部還有「查詢方式（Between／Contain）」與「需要餘額（NeedBalance）」兩個參數，但在目前的條件面板 XAML 中已被註解隱藏，使用者不會看到。查詢方式固定走 Between（區間），後端對應 DARB_QRY_ABOOK2 程序。

欄位連動與附加功能¶

這一節說明「選了 / 輸入了某欄位後，系統會做什麼」，全部來自實際程式碼。

索引種類 → 切換「索引」放大鏡的查詢來源（核心連動）¶

當你變更 索引種類 下拉時，系統會立刻把下方「索引」起訖兩個放大鏡框重新指向對應的主檔與查詢程式（SetTxtViewModel）：

選 分類索引 1：放大鏡查分類索引主檔（Sk_sort1），查詢程式 Sort1_1。
選 分類索引 2 / 3 / 4：同樣查分類索引主檔（Sk_sort1），分別走 Sort1_2 / Sort1_3 / Sort1_4（注意「分類索引 4」內部代碼是 10，並非 4）。
選 項目編號：查會計項目主檔（Sk_accitem / Accitem）。
選 部門代號：查部門主檔（Dept）。
選 客戶或廠商代號：查客戶／廠商主檔（Sk_cusp / Cusp）。
選 員工編號（預設）：查員工主檔（Sk_perdata / Perdata）。
選 專案代號：查專案主檔（Sk_aproj / Aproj）。
選 品號群組代號：查品號群組主檔（Sk_grpm1）。

因此操作順序很重要：先選對索引種類，再開「索引」放大鏡挑值。先挑值再改種類，前一個種類挑的代號未必對得上新主檔。

注意

「索引」放大鏡的 CheckDataExist 設為關閉，代表面板不會在你離開欄位時即時擋掉「查無此代號」。打錯代號通常不會報錯，只是查詢結果該群沒有資料而已——查不到時請先回頭確認索引種類與代號是否相符。

日期預設值的帶入邏輯¶

開啟面板（ResetToDefault）時：先把 日期（訖） 設為今天，再以結束日換算出當月第一天填入 日期（起）。所以預設查詢區間是「本月 1 日～今天」。要查整年或跨月請自行調整起日。

科目／索引範圍的「全部」寫法¶

科目代號（訖） 與 索引（訖） 預設都是 zzzzz，這是「取到最大值、等於不設上界」的慣用寫法；對應的起欄預設留空＝不設下界。維持預設即代表「不限這個範圍、查全部」。

索引種類影響母頁的分群鍵長度¶

索引種類也會影響母頁分群時的索引鍵取法：當索引種類屬於分類索引 1～3（代碼 ≤ 3）時，用完整索引值分群；其餘種類（含分類索引 4、項目、部門、客戶/廠商、員工、專案、群組）會取索引前 10 碼當分群鍵。這是後端彙總明細時的行為，使用者通常不需介入，但能解釋「為何很長的索引代號是依前 10 碼歸群」。

查詢後在母頁的後續動作¶

條件設好、回母頁按 查詢 後，由母頁（ABOOK2）負責：依索引分群、計算各群期初／期末餘額與逐筆累計餘額、點群展開明細，並提供六種報表列印（彙總表、彙總表-含原幣、明細表、分類索引帳、應收帳款餘額明細表、應付帳款餘額明細表）。這些都在索引分類帳說明，本面板不重複提供。

常見問題¶

「索引」放大鏡查不到任何代號可選？

放大鏡的內容由 索引種類 決定。請先確認：(1) 已在下拉選對索引種類；(2) 該種類對應的主檔（員工→員工主檔、客戶/廠商→客戶廠商主檔…）已維護資料。對照前置需求的主檔表逐一檢查。

查詢結果某個員工／客戶完全沒有資料？

多半是索引代號與索引種類不相符，或該代號在查詢期間內沒有傳票。本面板的索引欄不做存在性即時檢核（CheckDataExist 關閉），打錯不會報錯只會查無資料。請回頭確認索引種類選對、代號正確，並確認期間內確有傳票。

為什麼預設只查到本月、查不到上個月的帳？

日期預設是「本月 1 日～今天」（開窗時自動帶入）。要查上月或整年，請手動把日期起訖改成你要的區間再查。

下拉裡看不到「查詢方式」或「需要餘額」選項？

這兩個參數目前在條件面板上刻意隱藏（XAML 已註解），查詢方式固定走區間（Between）。這是設計，不是缺漏。

改了條件按查詢卻沒反應／結果沒更新？

本面板只負責收集條件，實際取數要回母頁工具列按 查詢。每次改完條件都要再按一次 查詢 才會重新取數。