2026-09-14 庫存單據版面微調、庫存查詢條件、例外出入庫查詢改版

單據畫面

• 加工單：「對帳期間」標籤改為「帳款期別」。

• 損耗單：「倉單號」標籤改為「耗料單號」。

• 出入庫單：交易部門下方新增幣別／匯率；快遞號碼上方新增稅別（含稅別名稱）、發票日期／發票號碼、發票金額／稅額、CINO／報單號碼，版面同加工單。上下一筆時稅別名稱自動帶出。

庫存查詢條件

• 期初期末查詢（INVBK1）：「倉庫」改「起訖倉庫」；起始值／截止值改為「起 始 值」「截 止 值」；抬頭列改與標籤同色；品號範圍／群組範圍移到起訖倉庫下方；「集團代號」改「群組代號」且不再被截斷。

• 庫存查詢（INVSTK）：

- 條件列改為只顯示目前查詢別對應的那一列。

- 「出貨通知」查詢別恢復可用，改以出通單號查詢；未填單號會提示。

- 「倉庫」改「隸屬倉庫」；單一倉庫欄移除，固定查全部倉庫（原預設 PR）。

- 「依批號分組」改「依批號彙總」；「不含直接進口訂單」勾選移除（仍維持排除）。

- 「銷售訂單號」改「訂單編號」。

例外出入庫查詢

• 倉庫勾選表自查詢條件搬到主畫面，與結果表左右並排，中間分隔條可拖曳；頁籤移除。

• ALL 列預設勾選。勾選決定查詢範圍；查詢後點選左表某一倉庫，右表只顯示該倉庫，不必重查（可用「依選取倉庫篩選顯示」關閉）。

• 勾選框改為檢視模式直接點選，不再出現編輯框造成外觀跑掉。

• 條件面板只留單據別、起訖日期、成本匯率表（高度隨筆數自動延伸）與兩行說明。

2026-09-14 庫存管理手冊全面更新，並修掉拍圖時撞到的三個問題

使用者看得到的變化

1. 庫存管理手冊 17 頁重寫並接上實機截圖。

原本手冊多數頁面是照舊程式寫的，欄位名還是英文（Prefix、SKU、Quantity Query…），

加工單那一頁寫的甚至是另一支程式；出入庫查詢被標成「尚未實作」但其實早就能用。

這次以現行畫面為準全部修訂，並在示範帳套拍了 38 張截圖接進去。

還有 4 張因程式或資料因素暫時拍不到，頁面上保留「需補截圖」標示。

2. 盤點單「產生盤點卡」的條件視窗改成中文。

以前按盤點單主檔旁的 新增 開出的條件視窗整窗都是英文（DocumentDate／Warehouse／Filter…，

還有拼錯的字），現在全部是中文，日期欄位叫製單日期，與主檔一致。

3. 不良處理單「真因分析」下拉有選項了。

以前這個下拉永遠是空的，按 產生 只會提示「請先選擇真因分析」，等於功能不能用。

原因是摘要檔裡「真因分析」這個類別（C274）從來沒有登錄選項。

這次補了三個示範選項（尺寸不良／材質不良／組裝不良，各附檢測項目範本），

客戶可以到「摘要檔維護」自行增修。朝陽帳套連對應的檢視與登錄都一併補上。

另外修正 產生 帶入明細時只比對摘要文字、沒限定類別的問題，避免別的類別有同名摘要時抓錯。

4. 倉庫表「批次關帳」按查詢不再跳系統錯誤框。

以前開「倉庫結帳」視窗按 查詢 會跳「程式：STKBAS_1 / Cannot find table 0.」。

原因是結帳前的成本稽核用到的檢視、15 支稽核程序與派發登錄在客戶帳套裡都不存在，

程式又沒有防呆。這次補上物件與登錄，並在程式端加防呆：查不到資料時回空清單，不再炸。

稽核程序本身原本引用舊版英文欄位結構，在中文帳套一定跑不動；同日已全部改寫成使用

帳套的中文檢視與資料表（sql/h-stkbas-audit-procs-zh-20260914.sql），

16 項稽核在三個開發帳套都能執行。其中「費用是否計入成本」（K-020-007）因中文帳套沒有對應欄位，

目前一律視為通過，待確認對應方式後再補。

部署注意

• 兩支新的 SQL 要跑在各帳套：sql/h-c274-真因分析-20260914.sql（每個帳套）、

sql/h-stkbas-audit-objects-20260914b.sql（每個帳套，先建表／檢視／種子）→ sql/h-stkbas-audit-procs-zh-20260914.sql（每個帳套，中文版稽核程序）＋sql/h-stkbas-procparam-20260914.sql（各 log 庫）。

• 跑完真因分析種子後，使用者要重新登入才會看到下拉選項。

2026-09-14 清單瀏覽的「預設條件」全面修好，並補給原本沒有的程式

使用者看得到的變化

1. 預設條件下拉不再是空的。

以前開清單瀏覽／明細瀏覽時，「預設條件」下拉有時只有一個 Not Set，條件列也空白，

按「查詢」等於整張表撈出來——資料量大的單據（出貨單、出入庫單）會轉很久甚至逾時。

現在系統會替每一支「可以瀏覽」的程式準備一組預設條件，開窗就帶好。

2. 預設的期間是「當月 1 號 ～ 今天」。

有交易日期／單據日期的單據，預設條件是該日期欄「介於 當月 1 號 到 今天」。

要看更早的資料，把日期改掉再按查詢即可，跟以前一樣。

沒有日期欄的主檔類程式（客戶資料表、庫存主檔、會計科目表…），預設條件維持「全部」的語意，

只是改成走得動索引的寫法。

3. 朝陽帳套的預設條件從此會出現。

朝陽的自訂條件資料在前一次系統改版時沒有完整轉過來，導致每一支程式的預設條件都找不到，

而且條件的運算子（等於／介於／包含…）對應到了錯的意思。這次一併修好：

以前存在系統裡的那些自訂查詢條件（例如「訂單明細－未出貨查詢」「進貨暫收單－待驗查詢」）

會重新出現在下拉裡，語意也對回來了。

4. 原本「有條件、但等於沒篩」的預設條件，也補上當月期間。

有些程式的預設條件內容是「單號 不包含 QWERT」「交易部門 開始於 空白」這類寫法——

看起來有條件，實際上等於整張表撈出來，按查詢一樣會轉很久

（實機遇到的：進貨單「全部資料查詢」、出入庫單「交易部門」、應收票據的「收票庫存 CE／託收 CB 查詢」）。

這次替整組都沒有日期條件的預設條件各加一列該單據的日期欄「介於 當月 1 號 到 今天」，

原本的條件一列都不動，只是多一列期間。

已經有日期條件的（包含那些寫死成 2020/01/01～9999/12/20 的）一律不動。

條件列已經滿 5 列的組沒辦法再加（面板只有 5 列），會列在部署腳本的驗證清單裡。

注意事項

• 這批要先更新程式再更新資料。 預設的期間用了一個新的關鍵字 #ThisMonth，

舊版程式看不懂，會把它當成一般文字去查而查不到資料。

部署順序：先發版、各站台更新完程式，才跑補預設條件的資料腳本。

• 自訂條件是登入時才載入的。 資料更新後，使用者要重新登入才會看到新的預設條件。

• 原本建好的預設條件一列都不會被改掉或刪掉；只有「完全沒有預設條件」會整組新建，

「整組都沒有日期條件」會多加一列期間。

• 查詢／統計／分析／儀表板類的程式（例如帳齡表、票齡分析、各式儀表板）不在這次範圍，

它們用的是自己的查詢條件面板，沒有清單瀏覽的預設條件。

相關

• 運算子代碼對照：ADR-0001

• 部署腳本（依序）：sql/zcond-sync-fix-20260914.sql（第一段，可先跑）、

sql/zcond-defaults-20260914.sql（第二段，要等程式更新完才跑）、

sql/zcond-defaults-date-line-20260914.sql（第三段，同樣要等程式更新完才跑）

2026-09-13 倉同儲=N 的虛擬儲位參數改中文 key，空白不再擋存檔

變動

• 倉庫表（SPLACE／GSPLACE）在「倉同儲＝N」時自動補的入庫／出貨虛擬儲位，前綴改讀系統參數「入庫虛擬儲位」「出貨虛擬儲位」（原本讀數字參數 3023／3026；3023 已被「出入庫查詢-鋼瓶進出預設查詢品號」使用，3026 從未登錄）。

• 進貨單／總務進貨單存檔時「不可手動輸入虛擬儲位」的檢查、採購進貨轉入、揀貨轉出貨、訂單轉出貨，一律改讀同兩個參數。出入庫單維持 VFP 的 7017。

• 參數空白時不擋存檔（維持舊行為：不補虛擬儲位列、不做關鍵字檢查）；參數有值但「值-隸屬倉庫」超過 10 字才擋，並提示到系統參數維護修改。

部署

• 各帳套跑 sql/prgpar-virtual-bin-chinese-keys-20260913.sql（補登兩列、值留空），再到「系統參數維護」填值；填完重新登入生效。

2026-09-13 庫存單據：朝陽帳套隱藏該帳套沒有的欄位

朝陽帳套（朝陽電裝）的資料庫沒有下列欄位，但畫面是兩家共用的，所以這些欄位在朝陽端一直是空白、

填了也存不進去，而且每次開窗都會跳出一個「檢查結果」提示視窗。本次改為在朝陽帳套下直接不顯示這些欄位。

程式	朝陽端不再顯示的欄位

進貨單	交易條件、報單日期、起運點、信用狀號碼、進項發票；明細表的「不良原因碼」欄；費用表的「已轉帳款」欄

加工單	發票金額

出入庫單	快遞號碼；明細表的「內容」欄

出貨單	集團公司、CINO；明細表的「單重」欄

耗料單	其他摘要、發票金額

• 禾久帳套（禾久貿易）畫面與行為完全不變，上述欄位照常顯示與存檔。

• 朝陽端開窗時不再跳出「檢查結果：XAML綁定有、SQL欄位沒有」的提示視窗。

• 隱藏是程式端處理，朝陽的資料庫沒有任何變動；既有資料不受影響。

• 明細表欄位若之前有存過「記憶格式」，朝陽端該欄會自動略過，其餘欄寬與排序照舊。

2026-09-12 進貨單主檔彙總欄修正

• 進貨單載入或切換單據時，原幣應收付、總本幣未稅、本幣應收付重新由明細算出（VFP 同公式：原幣應收付＝進貨明細原幣未稅合計依稅率含稅；總本幣未稅＝依匯率換算；本幣應收付＝總本幣未稅＋稅額）。

• 產值百分比隨之恢復顯示（分母總本幣未稅先前永遠為 0）。

• 改匯率、稅別、稅額或明細原幣未稅時即時重算。

• 關稅欄仍為明細關稅分攤合計；舊單據若當年關稅稅率為 0，該欄本來就是 0，不屬此次修正。

• 進貨單：右側加總金額改成「金額彙總」區塊（含費用合計），欄名改為原幣未稅合計／原幣含稅合計／本幣未稅合計／本幣含稅合計／關稅分攤合計／其他分攤合計／費用合計／進貨成本／費用率；新增未稅合計兩欄。

• 出貨單：同進貨單做法——右側改成「金額彙總」區塊（原幣未稅合計／原幣含稅合計／本幣未稅合計／本幣含稅合計／費用合計），並補上載入與明細變動時的重算（先前四個合計永遠 0）。

2026-09-12 不良品單（TRLOST）／出入庫單（TRLIMA）／生產日報（WKDAY）異常原因／處理方式／不良類別／不良原因欄改為「說明顯示、下拉選代碼」

使用者可見變動

• 不良品單、出入庫單明細原本的「異常原因碼＋異常原因」「重工代號＋重工」「不良類別碼＋不良類別」「不良原因碼＋不良原因」四組各兩欄，合併成四欄：異常原因、處理方式、不良類別、不良原因。

• 格子平時只顯示說明文字；點進去編輯時下拉列出「代碼:說明」，選了以後格子回到只顯示說明。

• 「重工代號／重工」欄改名為「處理方式」（與資料欄位「處理方式碼」一致）。

• 生產日報明細的「不良類別碼＋不良類別」「不良原因碼＋不良原因」「重工代號＋重工」三組同樣合併成三欄：不良類別、不良原因、處理方式。

• 出入庫單四欄維持「特殊修改」鎖定時唯讀。

• 修正：不良品單、出入庫單原本的說明欄（異常原因／重工／不良類別／不良原因）開單載入時是空白、要重新選過才會出現；現在載入即依代碼帶出說明。

• 交易別碼欄的下拉同日一併修正：原本編輯時下拉也只顯示說明，現在列「代碼:說明」。

• 修正：交易別碼欄格子空白（禾久耗料單 MP 單回報）。明細的代碼（UM／PD／IN）不在該單別目前的下拉選項（PA…SS）裡，原本靠下拉清單查說明就查不到。現在格子改查全量交易別表，全量也沒有就顯示原代碼，不再留白；下拉仍只列該單別允許的選項。

技術備註

• 新增共用欄 TsGridViewCodeDescriptionColumn（TsControl）：格子顯示說明、下拉顯示代碼:說明，清單來源走 TableAlias（CMB_ 對照表）或 ItemsSourceBinding；綁定欄是數值型時自動掛 NumericCodeToStringConverter，因為表格元件的 lookup 要求兩邊型別一致，否則格子永遠空白。

• TsGridViewTransactionCodeColumn 改為繼承上述共用欄，只保留「沒給清單時用本機 tritem1 全量對照」的預設。

• 翻譯檔 Trlost.json／Trlima.json／Wkday.json：新增「處理方式」，移除不再使用的舊表頭鍵。

• 出入庫單的不良原因對照表沿用原本的 C246（不良品單／生產日報是 C219）。

• 生產日報 VM 原本在換筆後回填 XxxItem 給說明欄用的段落已移除（改由欄自行 lookup）。

• runtime 未驗（只過建置＋smoke）。

2026-09-12 狀態列訊息恢復顯示、數處按下就出錯的功能修好

• 畫面下方狀態列的進度訊息恢復顯示。先前這些訊息被寫到一個沒有接上畫面的地方，等於寫了也看不到；

現在一律寫進真正的狀態列。受影響的功能：成本計算與總帳成本計算（各階段進度「1.清除成本資料」～

「7.計算品號轉撥」）、庫存帳齡查詢、材料分析查詢、訂單與生產分析查詢、總務成本轉入、總務進貨（重新

計算數量）、廠商／委外達成率、進貨地點維護、品號輸入檢核的錯誤提示。

• 下列操作先前按下去會直接跳出系統錯誤，現已修正：

- 庫存管理－進貨單維護「重新計算數量」。

- 代號欄旁的「搜尋」放大鏡按鈕（共用控件，全系統各畫面皆適用）。

- 客戶／廠商／部門代號查詢視窗。

- 系統管理者專用的欄位順序（TabIndex）檢視工具、開發用測試面板。

• 部分彈窗改用自己設定的視窗大小：共 21 支彈窗（進貨轉出貨、提單匯入、揀貨報表、成本計算、

分割採購單、EDI 匯出、批次輸入、傳票控制…）。原本程式裡「把彈窗放大成主畫面大小」的那段設定

從來沒有生效過，因此實際看到的大小與先前相同，不是行為變更。

• 彈窗改由目前主視窗當父視窗，關閉主畫面時不會再留下孤立的彈窗。

以上皆為既有缺陷修正，沒有任何資料或設定需要調整。

2026-09-13 追加：庫存／總務單據的關帳日期檢查恢復生效

庫存單據（進貨、出貨、借出、加工、耗料、盤點等）與總務庫存單據存檔、修改時的「已關帳不得修改或刪除」用戶端檢查，因為呼叫的預存程序 TWORK_CLOSEDATE 從來不存在，一直沒有生效。現已在帳套建立這支預存程序（內容同原本的 DARB_CLOSEDATE_KC）並登錄到 log 庫。

> 需要各帳套跑 sql/twork-closedate-20260913.sql（csa 庫建 SP、log 庫登錄）。生效後，交易日期落在已關帳期間的單據會被擋下，這是原本設計的行為。

2026-09-13 追加：例外出入庫查詢的成本匯率開窗自動帶入

條件面板的「成本匯率」表原本全是 0，不先手填按查詢就被「請輸入正確之匯率」擋下。現在開窗時自動帶入當日的賣出匯率（與生產計劃單、營運預測相同），仍可逐格修改。

2026-09-13 追加：下拉選單的空白項不再顯示成「0:」

出貨單、出入庫單的「運送方式」，進貨單的「交易條件」等下拉，第一項（代號 0、說明沒填的那筆）原本顯示成孤零零的 0:。現在這種項目一律整項顯示空白，等同「不選」，選它存進去的值仍是 0。

規則為全系統通用：說明空白，且代號空白或全部是 0 → 整項顯示空白；代號有值但說明沒填（例如 RC）仍照常顯示代號。

2026-09-13 追加：出貨單瀏覽預設條件、瀏覽查詢失敗訊息、出入庫申請儲位欄、朝陽工作流程註記

• 出貨單明細瀏覽的預設條件「出貨日期查詢」改成最近三個月（原本沒有日期界限，資料量大時查詢逾時）。需各禾久帳套跑 sql/zcond-trsama-browse-default-3months-20260913.sql，重新登入生效。

• 瀏覽查詢失敗時主畫面狀態列只顯示簡短訊息，不再把整段程式錯誤內容印在畫面上。

• 出入庫申請的明細表格補上「倉儲代號」欄（倉庫的倉同儲設為 N 時必填，原本畫面上無處可填）。

• 朝陽帳套補上工作流程註記用的預存程序與檢視（sql/cy-twork-wkflow-getnotes-20260913.sql），工作流程頁籤不再回錯。

2026-09-12 倉庫表（SPLACE）欄位名稱調整、是否可用／倉庫類型改下拉

使用者可見變動

• 標籤「倉庫」改為「隸屬倉庫」、「說明」改為「倉庫說明」，與資料欄位名一致。

• 「是否可用」由輸入 0／1 的數字框改為下拉「是／否」。

• 「倉庫類型」由輸入數字的框改為下拉，選項列「代碼:說明」：1 真實倉庫、2 現場倉、3 外包倉（0 不列；既有值 0 的倉庫下拉顯示空白）。

• 新增時預設：是否可用＝是、倉庫類型＝1 真實倉庫（既有值 0 的倉庫下拉仍顯示空白）。

• 「檢查負數」與「倉庫類型」位置對調：第 1 列為 隸屬倉庫／是否可用／倉庫類型／單一儲位／成本計算順序／開立日期，第 2 列為 倉庫說明／檢查負數／顯示順序／結帳日期。Tab 鍵順序改為依列由左到右，唯讀的開立日期／結帳日期不進 Tab。

技術備註

• 新增 Common/TsEnum/WarehouseTypeEnum.cs（WarehouseTypeEnumSet）集中定義三個選項；翻譯檔 Common/Lang/Xaml/WarehouseTypeEnum.json。

• 使用者實機看過後裁決 0 不列（2026-09-12）。1 的文字是推斷值：Invrec3y 把 0/1 歸為「倉庫」、2 為現場倉、3 為外包倉；禾久 SP DARB_LOG_WKPAPERA_TO_PD 以 倉庫分類碼=1 判定生產部門的「真實倉庫」。要改文字只改該檔。

• 是否可用走 YesNoComboBox＋ByteYesNoConverter（同總務倉庫表 Gsplace）。禾久有一筆倉庫「8.禾久」的可用值是 2，下拉會顯示「是」，再存檔會寫回 1。

• 倉庫類型 SelectedValue 綁 byte 欄位，經 NumericCodeToStringConverter 對上字串 Code。

• 翻譯檔 Splace.json：加「倉庫說明」，刪「倉庫」「說明」；「隸屬倉庫」走 Shared 共用鍵。

• 總務倉庫表（Gsplace）的倉庫分類碼仍是數字框，未動。

• 倉庫類型下拉已由使用者實機確認顯示；其餘欄位未逐一確認。

2026-09-12 單據主檔區綁定寫法統一

• 31 支單據畫面的主檔區改用與範本一致的 MasterData.GridView.CurrentItem 綁定（原本用 MasterItem）。使用者操作行為不變。

• 未動：12 支沒有掛在任何畫面樣板上的舊檔（Trsama_old、Trrama_zd 等）與兩支自有主檔屬性的畫面（工作流程、紀錄）。

2026-09-12 表格欄寬全面補齊

• 全系統 352 支畫面、約 8,700 個表格欄位統一給定固定寬度：原本「依表頭自動」或未設定的欄改為依表頭字數計算，中文四個字以上的欄至少 100。

• 名稱／說明類欄至少 150，單號／代號類至少 120，數值類至少 90，日期類 90。

• 既有已手動設定寬度的欄只在低於表頭需要時拉高，其餘不動。

• 13 支畫面因當時另有進行中的修改先跳過（帳款票據查詢、收付款查詢、客戶分頁、生產計劃單等），之後再補。

• 使用者曾用「記憶格式」存過版型的表格，仍以存下來的寬度為準。

進貨單／出貨單分析報表改到明細瀏覽的列印面板

摘要

進貨單（TRRAMA）與出貨單（TRSAMA）的 14 張分析報表，從原本的「分析報表」彈窗搬到明細瀏覽頁的列印面板，印的是您在瀏覽頁查出來的那份結果。

原本的做法要在彈窗裡重新輸入一次交易日期與廠商／客戶區間，印出來的資料與您剛剛在瀏覽畫面上篩選的結果無關；對照舊系統後確認那組功能本來就是掛在明細瀏覽面板上的。詳見 ADR-0157。

變更

• 進貨單（TRRAMA）、出貨單（TRSAMA） 主檔畫面單號旁的「分析報表」按鈕移除，原本的分析報表彈窗一併移除。

• 改到明細瀏覽 → 列印面板：查詢完直接在列印清單挑報表預覽／列印。

- 進貨 6 張：進貨明細表（廠商別／產品別／日期別），各有「含金額」版本。

- 出貨 8 張：出退貨明細表（客戶別／產品別／日期別／單號別），各有「含金額」版本。

• 報表沿用您在瀏覽頁下的查詢條件，不必再輸入一次；報表頁首會印出該組條件。

• 報表種類決定排序（廠商＋品號＋日期／品號＋廠商＋日期／日期＋廠商＋單號／單號＋序號），與舊系統一致。

使用時的注意事項

• 列印前要先在明細瀏覽頁按過查詢；報表印的就是那次查詢的範圍。

• 分析報表的資料來源與瀏覽畫面的欄位不完全相同。若您用了報表資料來源沒有的欄位當查詢條件，該條件會被略過（其餘條件照常套用），並在報表頁首的條件文字尾端標示「（略過：欄位名）」。

不受影響

• 進貨單／出貨單本身的列印頁（進貨單、出貨單等單據報表）完全不變。

• 明細瀏覽的查詢、欄位與匯出 Excel 不變。

• 其他程式的瀏覽頁列印行為不變。

2026-09-11 耗料單／加工單主檔欄位調整

耗料單（TRLOST）

• 標籤「倉庫」改為「隸屬倉庫」、「前綴」改為「單別」、「注意事項」改為「其他摘要」。

• 隸屬倉庫、單別、交易部門三個輸入框寬度統一為 90。

• 幣別／匯率下方新增發票日期、發票號碼、發票金額、稅額四個欄位（對應 trwkma 既有欄位）。

• 相關單號移到主檔區最右欄。

加工單（TRWKMA）

• 稅額同列補上原本缺少的「發票金額」欄位。

多語言

• Common/Lang/Xaml/Trlost.json、Trwkma.json 補齊上述新 key 的四語翻譯。

第二批（同日追加）

• 耗料單：單別下拉框加寬到 160（原 90 會把「MP:生產…」裁掉）。

• 耗料單、加工單：中欄改成四欄格線，發票號碼／稅額／匯率的標籤與輸入框上下對齊。

• 加工單：標籤「倉庫選擇」改「隸屬倉庫」、「執行表單」改「單別」；隸屬倉庫輸入框寬 90。

• 進貨單、出貨單、出入庫單：隸屬倉庫輸入框寬 90；標籤「序號前置碼」／「前綴」改「單別」；出貨單「倉庫」改「隸屬倉庫」。

• 對應翻譯檔（Trrama／Trsama／Trinout／Trwkma）同步改 key。

• 耗料單：盤點單號（含盤點退料、PB→PA 鈕）自備註區搬到右欄相關單號下方。

• 耗料單：倉單號／幣別／匯率／稅額標籤改成與加工單相同的等寬排版（「倉 單 號」「幣 別」「匯 率」「稅 額」），翻譯 key 同步。

• 耗料單、加工單：明細「交易別碼」格子點下去炸「RadComboBoxItem 樣式套到 ComboBoxItem」——編輯模板由原生 ComboBox 改為 TsComboBox。

• 耗料單：交易備註搬到中欄發票金額下方；新增轉入備註、轉出備註（唯讀，轉單寫入，照進貨單）；備註區只留其他摘要。

• 耗料單：其他摘要搬到交易部門下方，兩行高（50）、寬 302（＝倉單號 150＋單號 120＋各自邊距），右緣對齊單號框；原備註區整段移除。

• 耗料單明細：「交易說明」欄併入「交易別碼」欄——格子顯示說明（交易事項），進編輯下拉列出「代碼 說明」；換選後說明同步更新。

• 出入庫單：「倉庫」改「隸屬倉庫」、「前綴」改「單別」（單別標籤邊距改 1）；拿掉公司代碼欄位（新增時系統固定給 1）。

• 進貨單：「倉單號」改「進貨單號」；單別標籤邊距改 1。

• 出入庫單、出貨單：「暫收備註」改「交易備註」；出入庫單「追蹤號碼」改「快遞號碼」。

• 進貨單：兩個明細表格之間加可拖曳分隔線；中欄重排為第一列稅別、第二列發票日期／發票號碼、第三列發票金額／稅額。

• 出入庫單：倉儲調撥、物料調撥、撿貨調整三顆鈕先隱藏；其餘功能鈕群靠主檔區最右；快遞號碼移到交易備註上方，轉入備註、轉出備註移到交易備註下方。

• 出入庫單：借出查詢、Excel 匯入明細移到功能鈕群最下面。

• 出入庫單明細：補回交易別碼、派工單PKID、訂單PKID、其他資料1、其他資料2、單位成本、成本、轉入單PKID、轉入單號、沖回數量十欄；「例外代號」改「例外出入」並改成格子顯示說明、下拉列代碼＋說明，原獨立的「例外」說明欄併入。

• 出貨單：先拿掉「單據類別」下拉；中欄重排為第一列稅別、第二列發票日期／發票號碼、第三列發票金額／稅額（同進貨單）。

• 出貨單：「業務員代號」標籤改「業務員」。

出入庫單：補回「取批號」、虛擬儲位調撥、送樣轉 EO、出通轉調撥，以及朝陽的「不良轉入」

日期：2026-09-11

影響程式：出入庫單（TRLIMA，H 庫存管理）

接續同日第一批（2026-09-11-trlima-buttons-a），這次把舊版（VFP）出入庫單剩下的四顆

「開視窗挑資料」的鈕，以及朝陽帳套的【不良轉入】補齊。

> 這七個功能只在禾久帳套顯示（【Excel匯入明細】【帶入申請單】【出通反調撥】

> 【虛擬儲位調撥】【送樣轉EO】【出通轉調撥】與明細列的【取批號】）。

> 它們在舊版也只存在於禾久版，而且用到的資料表在朝陽帳套本來就沒有（製通單沒有批號欄、

> 沒有送樣單、料件沒有成箱領料量），所以在朝陽帳套整組隱藏不顯示。

> 反過來，下面第 3 點的【不良轉入】只在朝陽帳套出現。

使用者看得到的變化

1. 明細每一列多了【取批號】按鈕

新增／修改／複製新增狀態下，明細表格的「批號別」欄前面多一欄【取批號】，每列一顆鈕

（瀏覽狀態與「特殊修改」狀態下這顆鈕不能按）。

按下去會開「品名調撥單勾選視窗」：

• 上方輸入製通單號（或批號）後按查詢；輸入純數字時當成製通單的內部編號查，

否則同時比對製通單號與批號。

• 表格列出該製通單的各個途程：製通單號／批號／途程序號／工程代號／工程簡稱／現有數量／

品號／品名／批號別／單位／製通單pkid。每個途程會出現兩列——一列是正常工程代號、

一列是工程代號 XXX 的「不良品」；最後再加一列不帶數量的「不良品」彙總列。

• 勾一列（勾選是單選，勾新的會自動取消舊的）後按【確定】，會把那列的

批號別／批號／工程代號／途程序號／品號／單位填回剛才那一列明細，

數量填成負數（和舊版一樣，這張單是把料從製令批號調出來）。

2. 新增出入庫單時多了三顆帶料的鈕

在【申請單號】那一區下面，新增狀態下可用：

【虛擬儲位調撥】

查「入庫虛擬儲位」（系統參數 7017）上還有數量的所有品項，開勾選視窗（預設全部勾選，

可用【勾選全部】／【全部不選】），按【確定】後：

• 單別切成 SS（調撥）、倉庫與主檔交易部門切成該儲位的隸屬倉庫、申請日期帶今天。

• 明細逐列帶入品號／單位／數量（＝現有數量）／轉出倉儲＝虛擬儲位，

轉入倉儲留白由使用者自己填。

• 虛擬儲位上沒有任何數量時，只會提示「入庫虛擬儲位無資料」，不開視窗。

【送樣轉EO】

查所有已審核、未結案、而且還沒交清的送樣單明細，開勾選視窗，按【確定】後：

• 單別切成 EO（例外出庫）、倉庫切成備料倉庫（參數 8003）、主檔交易部門帶業務部門（參數 5005）、

申請日期帶今天。

• 明細逐列帶入品號／單位／數量＝送樣數量−已交數量，並記住來源送樣單明細，

存檔後才算得回送樣單的已交數量。

【出通轉調撥】

開視窗後在視窗裡輸入出通單號再按查詢（和前兩顆不同，來源資料是在視窗裡查的）：

• 上表列出該出通單裡還沒調撥完、還沒出貨完、未結案的明細；備註自動組成「客戶簡稱---單號」。

已經有製通單號的列數量會帶 0（等於不轉，按確定時會被濾掉）。

• 下表列出 MRP 倉庫（參數 7009）底下、這些品號還有庫存的儲位，含原有庫存量／ABC 分類／

儲位／包裝量／成箱領料量／安全庫存。下表只顯示上表目前選取那一列的品號（和舊版一樣，

點上表換一列，下表就跟著換）。在上表點一列、再按下表那一列的【選用】鈕，

就會把該儲位填進上表的「轉出倉儲」（舊版是雙擊，新版改成明確的按鈕）。

• 還沒輸入出通單號就按查詢，會提示「請輸入出通單號」。

• 按【確定】後：單別切成 SS、倉庫切成備料倉庫、主檔交易部門帶調入倉庫（參數 3021）、

申請日期帶今天、暫收備註帶出通單號；明細逐列帶入品號／單位／數量／

轉入倉儲＝調入儲位（參數 3022）／轉出倉儲（上表指定的）／備註，並記住來源出通單明細。

• 零數處理：轉出儲位在倉儲設定的備註裡標了「成箱」的，會依該品號的「成箱領料量」

算出湊整所需的差額；差額大於 0 且有設定零數儲位（參數 3019）時，會自動多一列——

同品號、數量＝零數、轉入倉儲＝零數儲位。這一列刻意不記來源出通單，所以不會回扣出通單的調撥數量

（和舊版一樣）。

> 三顆鈕都只有在「新增」狀態才能用；在瀏覽或修改狀態下按，會提示

> 「只有在新增狀態才能使用這個功能」。

>

> 另外，這幾顆鈕（含第一批的【帶入申請單】【出通反調撥】）都會把單別換成 SS 或 EO。

> 若該帳套的交易事項表沒有登錄這個單別，現在會直接提示

> 「交易事項表沒有登錄 XX 單別，無法帶入」並停住，不會像以前那樣帶完資料、存檔時才配不到單號。

3. 朝陽帳套的【不良轉入】可以用了

「其他功能」裡的【不良轉入】原本按下去沒反應（第一批的說明裡列為另案處理），這次補上。

按下去會開「不良轉待核報倉及報廢倉視窗」：

• 上方條件：來源交易日期起訖（預設當月 1 日到今天）；以及要寫進新單的交易日期、

報廢單交易部門（必填）、交易備註。

• 按查詢後，「資料」分頁列出報廢倉裡待轉出倉還是空白的不良品——包含報廢倉的 SS 調撥單

與報廢倉的 NA 不良退庫單兩種來源（「來源別」欄可以看出是哪一種）；

「無法轉單」分頁列出同條件下正被別人修改中的資料與修改人員。

• 勾選要轉的列（有【全部選擇】／【全部不選】）後按儲存，會依不良原因碼一次產生兩張入庫單：

- 不良原因碼 1、8、9 → 一張 SS 調撥單，交易部門「待核報」，轉出倉儲「報廢倉」、轉入倉儲「待核報」。

- 其餘不良原因碼 → 一張 NB 報廢單，交易部門＝你輸入的報廢單交易部門，

轉出倉儲「報廢倉」、轉入倉儲留白。

- 兩邊都沒有資料的那一張就不會產生。

• 轉出來的單據，明細序號會在新單裡重新編號（001 起）；要追來源請看該列記住的來源單據關聯，

不要用序號對照（勾選的列可能來自多張來源單，照抄來源序號會重複）。

• 存檔後畫面會自動跳到轉出來的單據。

• 存檔前的檢查：交易日期不可空白、不可小於等於關帳日期、報廢單交易部門不可空白、至少要勾一列。

> 這個功能只有朝陽帳套的權限設定裡有「不良轉入」標籤，其他帳套不會出現。

給系統管理者的備註

新出現的系統參數依賴（都在「程式參數」裡設定）：

參數	用途

7017	入庫虛擬儲位（虛擬儲位調撥的轉出儲位；第一批的出通反調撥也用它）

8003	備料倉庫（送樣轉 EO、出通轉調撥的隸屬倉庫）

5005	業務部門（送樣轉 EO 的交易部門）

3021	調入倉庫（出通轉調撥的交易部門）

3022	調入儲位（出通轉調撥的轉入倉儲）

3019	零數儲位（沒設定就不做零數拆列）

7009	MRP 倉庫（出通轉調撥下方庫存表只列這個倉庫底下的儲位）

沒設定的參數會讓對應欄位留白或該段功能不動作，不會報錯。

• 不良轉入（朝陽）：轉單前會先確認交易事項表有登錄 SS（待核報）與 NB（報廢）單別，沒有就提示不轉，避免配不到單號。

出入庫單：補回「特殊修改」、Excel 匯入明細、帶入申請單、出通反調撥四個功能

日期：2026-09-11

影響程式：出入庫單（TRLIMA，H 庫存管理）

舊版（VFP）出入庫單上有一批鈕在改版時沒有跟著移植過來，這次先補第一批。

使用者看得到的變化

1. 「特殊修改」按了會有反應了

畫面下方「其他功能」裡的【特殊修改】原本按下去完全沒動作。現在按了會進入特殊修改狀態：

• 這個狀態是給「已經存檔、但一般修改會被擋住」的單據用的——例如由盤點單或調撥申請單轉來的

出入庫單，平常按修改會跳「本單據由…轉來，不得修改」，走特殊修改就可以進去。

• 進去之後明細只有「備註」可以改，其他欄位（品號、數量、倉儲、各種代號…）全部鎖住；

主檔欄位預設也全部鎖住，只有權限設定裡「特修改欄位」有列出來的欄位才打得開。

• 要用這個功能，使用者的權限設定必須有「特殊修改」這個其他功能標籤（禾久帳套本來就有）。

2. 新增出入庫單時多了【Excel匯入明細】

在【借出查詢】旁邊。按下去會跳出選檔視窗（預設開在 C:\轉EDI資料、預設檔名 TRLI.XLS，

可以自己挑別的檔，.xls／.xlsx 都讀得到），選好之後照固定欄位順序把整份明細一次帶進來：

Excel 欄	帶到明細的欄位

第 2 欄	品號（會自動帶出品名）

第 4 欄	批號別

第 5 欄	批號

第 7 欄	途程序號

第 8 欄	工程代號

第 10 欄	數量

第 11 欄	交易別碼

第 12 欄	轉入倉儲

第 13 欄	轉出倉儲

第 14 欄	備註

第 1 列當標題列不讀，從第 2 列開始；讀到品號空白的那一列就停。第 1、3、6、9 欄

（倉儲代號／品名／批號C／工程簡稱）不讀，跟舊版一樣。匯入的資料會先填進明細裡品號空白的列，

不夠才新增列。

3. 新增出入庫單時可以直接打申請單號帶資料

新增狀態下，畫面右側多了「申請單號」欄和【帶入申請單】鈕。打上調撥申請單號後按鈕：

• 查這張申請單裡還沒結案、而且申請量大於核發量的明細；查不到會提示「無此申請單號 或均已核發」。

• 查到就把單別切成 SS（調撥）、倉庫切成申請單的隸屬倉庫，主檔的交易部門帶申請部門、

申請日期帶申請單日期、暫收備註填成「申請單號○○○:申請原因」。

• 明細逐列帶入品號、單位、數量＝申請量−核發量、轉入／轉出倉儲、交易別碼，

並記住來源申請單的明細（之後核發量才算得回去）。

• 帶完申請單號欄會自動清空。

4. 新增出入庫單時可以做「出通反調撥」（回沖）

同一區多了「回沖單號」欄和【出通反調撥】鈕。打上先前那張出通轉調撥的單號後按鈕：

• 查該單裡還沒沖回完的出通調撥明細；查不到會提示「無資料」。

• 查到就把單別切成 SS、倉庫切成來源單的交易部門，主檔交易部門帶來源單的隸屬倉庫、

申請日期帶今天、暫收備註填成「回沖:單號,倉單號」。

• 明細逐列反向帶入：數量＝原數量−已沖回數量，轉出倉儲＝原本的轉入倉儲，

轉入倉儲＝系統參數設定的入庫虛擬儲位（參數 7017），並標記成回沖列，

存檔後會回沖原本那張單的數量。

• 帶完回沖單號欄會自動清空。

> 【Excel匯入明細】【帶入申請單】【出通反調撥】三個功能都只有在「新增」狀態才能用

> （和舊版一樣）；在瀏覽或修改狀態下按，會提示「只有在新增狀態才能使用這個功能」。

其他

• 清掉兩個從來沒接到畫面上的無效指令（拆列出貨、倉儲調撥轉窗），對使用者沒有影響。

• 朝陽帳套的【不良轉入】仍然沒有作用：它要開的是舊版的「不良轉入」挑單視窗，該視窗還沒移植，

另案處理。

2026-09-11 交易別碼欄全系統統一顯示

• 所有表格的「交易別碼」欄（32 欄，涵蓋庫存、總務、帳款、EIS 查詢、銀行對帳）統一改為：格子顯示交易說明文字；可編輯的欄進編輯時下拉列出「代碼 說明」；唯讀與查詢型表格只顯示說明。

• 原本另外一欄的「交易說明／交易事項」（耗料單、加工單、耗料查詢、銀行對帳查詢）併入交易別碼欄，不再重複顯示。

• 查詢型表格的說明由本機交易別對照表反查，不必改查詢程序。

• 例外：庫存簿（Invbk2）的交易別碼字串本來就含說明，維持原樣。

• 欄寬統一 120。

2026-09-11 審核／流程鈕接回舊權限表的「快速審核／工作流程」

使用者可見變動

• 審核鈕、流程鈕出現了：以前在舊系統其他功能鈕有「快速審核」「工作流程」權限的人，新系統右側面板現在直接看到整合的「審核」「流程」鈕；原本那兩顆多出來的「快速審核」「工作流程」其他功能鈕不再顯示。

• 權限以其他功能勾選為準：程式在權限表有登「快速審核」或「工作流程」的，就看該格「可否其他N」；權限表的「可否審核」「可否流程」對這些程式暫時不生效（並行期結束後搬遷資料再恢復）。

• 查詢視窗的流程鈕開始看權限：以前只要有簽核樣板就能按，現在還要有流程權限（口徑同主畫面）。朝陽有 1114 列使用者×程式會因此收掉流程鈕（舊系統本來就沒給）。

• CI（出貨通知）其他功能鈕改照名稱對應：「拆單」開訂單轉出貨通知；「報關單」「調撥指示」新版尚未提供，鈕顯示為停用（「報關單」以前按下去其實是開「併入既有出貨通知」，屬接錯線）。

相關

• ADR 0156

• 程式：LogicBll/銜接/LegacyOtherButtonBridge.cs、ViewModel/Ade/AdePermissionViewModel.cs、ViewModel/Control/PageParts/ActionPanelViewModel.cs、ViewModel/E.Order/CiViewModel.cs、ViewModel/Control/QueryPanelViewModel.cs

• 測試：LogicBllTests/銜接/LegacyOtherButtonBridgeTests.cs

2026-09-10 修改清單：報表分客戶顯示、請購轉採購／訂單轉出貨接回、PAYPDT 卡頓、廠商資料版面等

日期：2026-09-11

影響程式：列印頁（全系）、廠商資料表（SPDATA）、採購單→請購轉採購（PPTOPU）、出貨單→訂單轉出貨（ODTOSA）、採購資料查詢（PURCHQUERY）、進貨轉應付（PAYPDT）／出貨轉應收（RECEPDT）、沖帳（RPFZERO）、費用科目表（GRPMACCL）、其他應收付（OTHERRP）、客戶資料表（CUDATA）、供應商協同回覆審閱（POCOLLABRPY）、所有單據的操作按鈕列、15 支轉單視窗

> 本批全部 尚未實機驗證（建置＋smoke 測試通過）。

使用者看得到的變化

1. 列印頁的報表清單：禾久版與朝陽版分開排

同一支程式若同時有禾久版與朝陽版報表，現在會把「本帳套的版本＋通用報表」排前面，另一家的排後面並加註

【朝陽版】或【禾久版】，序號重編；預設選中的第一張一定是本帳套的版本。判定靠報表檔命名（_cy／Cy／Nogi）。

另外，程式端已登錄的報表不再與資料庫 _rptdat 同編號的列重複顯示（朝陽應付列印清單原本會多出 6 筆重複、其中一筆點了「檔案不存在」）。

2. 應付列印：預覽視窗標題與匯出檔名不再一律「ApPrint_cy」

原幣／本幣等六張報表的檔案內部名稱都寫成 ApPrint_cy，預覽標題與 PDF／Excel 檔名因此看起來像選錯報表。已改成各自的報表名。

3. 廠商資料表（基本資料1 分頁）

「會計與採購條件」區塊併入「基本資料」區塊：收付款廠商緊接在廠商名稱下一列，其後依序是供應項目、科目代號、稅別／帳款起始日／收付條件號、等級／交易條件／付款方式碼、關係人／付款日遇假日提前。

帳款起始日（廠商、客戶、其他應收付三處）個位數時右側不再多一格空白。

4. 採購單「請購轉採購」與出貨單「訂單轉出貨」

按下去不再出現「沒有 TWORK_TUR_PPTOPU／TWORK_TUR_ODTOSA」。這兩支預存程序從來不存在，現改接資料庫實際有的版本。

> 需要在各帳套的 log 庫跑 sql/proc-param-tur-pptopu1-odtosa-20260911.sql，否則轉單查詢會靜默沒資料。

> 訂單轉出貨的畫面與資料欄位仍是舊英文版，接回後仍可能空白，待另案整支中文化。

5. 轉單視窗大小

15 支原本固定 1200×560（或 800×560）的轉單視窗改為跟著主視窗大小（主視窗減 100）。

6. 採購資料查詢

採購單號變成可點的連結，點下開採購單並定位到該張單。

7. 進貨轉應付（PAYPDT）／出貨轉應收（RECEPDT）

• 視窗標題改中文：「進貨轉應付帳款」「出貨轉應收帳款」。

• 儲存成功訊息改中文，「開始單號：」「截止單號：」等長對齊。

• 主檔的「選擇」按鈕按下後，下方明細會跟著切到那一筆。

• 明細多的單據切換／勾選明顯卡頓已改善（合併模式下原本每一筆明細各重算一次整張帳款）。

• 疊在同一位置的兩顆「全選」鈕只留一顆。

8. 沖帳（RPFZERO）

灰色底色拿掉；列選取後淡綠底不再配白字（字回黑色）。同一問題的共用樣式一併修，其他用綠底標示選取列的畫面也受惠。

9. 操作按鈕列的「審核」「流程」鈕

改成依程式決定顯示：有審核權限且主檔有「已審核」欄才顯示審核鈕；有流程權限且該單據別有簽核樣板才顯示流程鈕（客戶變體程式查不到樣板時退回查基底單據別）。

新增／修改狀態下這兩顆鈕一律收起，儲存／取消不會被它們蓋住；存檔完成後它們才出現，配合既有的 400 毫秒防連點守門，儲存連按兩下不再直接送審。

10. 費用科目表

借貸別改成一般下拉（借方／貸方），不再是代號＋說明的組合框。

11. 供應商協同回覆審閱

選單改掛「Y.新功能測試」Y-07。

> 需要各帳套跑 sql/pocollabrpy-menu-seed-y07-20260911.sql（朝陽庫缺登錄工具會被擋下）。

部署提醒

• sql/opendbf-sk-spdata-cudata-data-y-20260911.sql：SK_SPDATA／SK_CUDATA 改為整包下載（含資料=Y），使用者重新登入後生效。

• FastReport 六張 Apprint frx 已同步到報表資料夾。

12. 庫存單據搜尋區多了「倉庫」「單別」（同日追加）

借出、進貨、出貨、工單、耗用、異常領料六支單據的搜尋區改用庫存版：倉庫、單別、倉單號排在同一列；開窗時單別預設第一個（依交易事項表的排列順序排）、倉庫預設該單別在交易事項表設定的預設倉庫；上下一筆／搜尋只在該倉庫與單別內；把欄位清空＝不過濾。倉庫與單別都有選時，搜尋只打流水號會自動補上前面的倉庫＋單別。新增時會把選的倉庫與單別帶進新單（異常領料除外，維持原本的帶法）。

14. 下拉選單的空白項不再顯示「:」（同日追加）

共用的下拉項目樣板改成代號空白時不畫冒號，各程式下拉的空白預設項不再出現孤零零的「:」。

13. 出貨單「訂單轉出貨」整支中文化（同日追加）

畫面全部改中文，資料欄位對上實際的預存程序，原本查得到卻一片空白的問題解掉；並補回前一版遷移時漏掉的「庫存彙總」「庫存明細」「採購未入／訂單未交」三張表與「挑選」鈕（倉同儲＝N 的倉庫要靠它填轉出倉儲才存得了檔）。

第二輪再對照 VFP 表單原碼逐項對齊：抬頭用詞全照原版、補回超交檢查、倉庫與儲位檢查、倉同儲的倉庫取法、客戶帶幣別與出貨倉庫、換幣別重算匯率、十一個原本沒寫進出貨單的欄位（聯絡人、交易備註、其他摘要、付款方式碼、預訂交期、備註、客戶訂單號、客訂單序號、單重、客廠品號等）。「交期不同」欄原版因判斷順序寫錯永遠是否，本次改成有效判斷並照原版紅底標示。

另依裁決：轉單存檔成功後會問「是否列印出貨單」，選是直接進出貨單列印頁；畫面上沒作用的「單據分類」下拉拿掉；含稅單價沿用訂單上的值；倉同儲為 Y 時轉出倉儲欄唯讀；出貨數量大於零的列以淡綠底標示，改數量會即時更新。

2026-09-11 操作列審核／流程鈕顯示規則簡化

• 審核鈕與流程鈕的顯示／隱藏只看編輯態：按新增／修改進入編輯時收起（讓位給儲存／取消），離開編輯即顯示。

• 沒有審核權限或流程權限時，按鈕改為顯示但停用（灰掉），不再整顆消失。

• 拿掉「主檔沒有已審核欄就藏審核鈕」與「單據別沒有流程樣板就藏流程鈕」兩條判斷，各程式的操作列版位固定一致。

生產計劃單：可以新增了，查詢／客戶設定鈕改成圖示鈕，審核欄位顯示調整

日期：2026-09-09

影響程式：生產計劃單（PRODPLANM，子系統 Y「新功能測試」Y-06）

使用者看得到的變化

1. 「新增」可以按了

原本按新增會被擋（或整顆鈕是灰的）。原因是這支程式登錄時，權限是從唯讀的「生產計劃查詢」

整列複製過來的，新增／修改／刪除三個權限旗標都是關的。已補上，現在可以正常新增、修改、刪除。

因為【客戶設定】【查詢】兩顆重算鈕本來就只在「新增」狀態才開放，這個問題連帶讓那兩顆鈕

永遠是灰的——權限補好之後，按新增就會亮起來。

> 需要跑 sql/prodplanm-permission-fix-20260909.sql（每個帳套各跑一次）。

2. 【客戶設定】【查詢】改成圖示鈕

兩顆鈕原本只有文字、又小又不顯眼，容易被當成沒有這個功能。現在改成和系統其他操作鈕一樣的

「圖示＋文字」樣式（查詢是放大鏡、客戶設定是齒輪），並加上滑鼠提示：滑過灰掉的鈕會顯示

「重算只在新增狀態可用」，說明為什麼不能按。

3. 成本匯率表會自動撐滿左側剩下的高度

原本固定最高 220 像素，畫面再大也不會變高，幣別多的時候要捲動才看得完。

現在會自動展開到左欄剩下的空間。

4. 審核欄位顯示調整

• 主檔上的「審核人員」「審核日期」原本只有兩個沒有標題的框，分不出哪個是哪個；

現在各自補上欄位名稱，審核日期也改成日期欄位格式顯示。

• 畫面右上角原本還會再重複顯示一次「已審核」和一顆展開審核資料的圓鈕，本程式已隱藏，

審核狀態一律看主檔上那一組。（其他程式不受影響。）

技術備註

• 右上角審核區塊的隱藏是「程式自己選擇加入」：ViewModel 實作

ViewModel.Control.PageParts.IExtensionPanelApprovalHidden 才會隱藏，預設仍然顯示。

---

同日第二批

5. 存檔後明細（客戶設定／訂單預示預估／生產計畫／使用量）會不見 —— 已修

存檔會成功、也真的寫進資料庫，但四張明細的「歸屬單號」欄（linkid）停在 0，變成沒有主人的孤兒列；

而畫面載入明細是「找 linkid 等於這張單」的資料，所以下次開這張單四個分頁全空。

原因：這四張明細不是用表格手動一列一列新增的（那條路框架會自動接歸屬），而是【客戶設定】【查詢】

兩顆鈕算出來整批塞進去的，歸屬欄沒人接。現已在存檔前統一接上。

> 已經存壞的單（明細在資料庫裡但 linkid=0）救不回原本的歸屬，建議重存一張新的；

> 舊的孤兒列可另行清理（見技術備註）。

6. pkid 搬到主檔

單號、單據日期同一列後面加上 pkid（唯讀）。畫面右上角原本顯示 pkid 與已審核的小面板，本程式整組隱藏。

7. 成本匯率表左右也會撐滿

原本固定 240 寬，比上面的欄位區窄一截；現在跟著左欄寬度伸縮，「成本匯率」欄吃剩下的寬度。

技術備註（第二批）

• ProdplanmSave.HandleDataBeforeEndEdit 統一接 d1~d4 的 linkid（照 PerdataSave.cs:70 模式）；

新增時主檔 pkid＝-1 哨兵值，子列一起帶 -1，上傳鏈 remap 才會命中。

這是 2026-07-16 zcond 事故的同一顆雷（memory zcond-linkid-orphan-incident）。

• 右上角面板隱藏改用 ViewModel.Control.PageParts.IExtensionPanelHidden（宣告式、預設仍顯示，其他程式不受影響）。

• 孤兒列清理（未執行，需確認）：

DELETE FROM twork_eis_productiond1 WHERE linkid = 0;（d2/d3/d4 同）—— dev 庫目前 648／32972／32798／72842 列。

---

同日第三批

8. 樞紐分析（比照「生產計劃查詢」）

生產計劃單也有樞紐分析了：明細分頁上方多一列「樞紐下拉＋樞紐分析表鈕」，

按下去會用和查詢那支同一份 Excel 範本（生產計劃查詢樞紐分析表.xlsx）開出樞紐，

表一＝生產計畫、表二＝使用量，彙總口徑與查詢那支完全一致。

• 沒有生產計畫資料時按樞紐鈕會提示「無資料」。

• 需要跑 sql/prodplanm-pivot-register-20260909.sql（每個帳套各跑一次），跑完要重新登入才看得到。

9. 孤兒明細已清理（開發資料庫）

第 5 點造成的無主明細列已備份後刪除（*_bak_20260909）：648／32972／32798／72842 列。

2026-09-02 那張舊單的明細未受影響。存壞的那張空殼單（PP20260909001）建議直接刪掉重存。

技術備註（第三批）

• 兩張樞紐資料表的組裝抽成共用的

LogicBll/M.EIS/ProductionPlan/ProductionPlanPivotBuilder.cs，

「生產計劃查詢」與「生產計劃單」共用一份 —— 欄名與欄序是 Excel 範本的 ODBC 契約，

兩支各留一份會默默走鐘。

• 單據型版面（ErpProgramLayout）沒有框架提供的樞紐選擇器（那是查詢型版面才建的），

改由 ProdplanmViewModel 自建 PivotSelector1ViewModel 掛在頁面上，不動框架版面。

• 表名沿用 TWORK_QRY_PRODUCTIONPLAN（＋_USAGE00）：Excel 範本的連線照表名綁死，換名會失敗。

---

修正：左欄把明細擠掉（第三批的後遺症）

成本匯率表改成「左右撐滿」之後，左欄變成會無限往右長、把右邊的明細表格擠掉。

已修正：左欄現在最寬 620，超過就不再長，明細維持原本的空間。

---

同日第四批：條件改存 JSON、成本條件加類別

10. 「刪除數量為 0」改成勾選框

原本是「是／否」下拉，現在是一個勾選框，勾了就代表要刪掉數量為零的資料。

11. 查詢條件改用 JSON 儲存

單據上的整組查詢條件（資料別、起訖日期、截止報價日期、刪除數量為零、預估百分比、成本條件表）

現在整包存成一欄 JSON。好處是以後要加新的查詢條件，不必再改資料表結構、也不必每個帳套各跑一次腳本。

> 起訖日期、截止報價日期、刪除數量為零 這幾欄仍會同步寫回原本的欄位，清單瀏覽與「載入歷史單」的清單靠它們顯示。

12. 「成本匯率」改名「成本條件」，多一個「類別」欄

• 類別可選「匯率」或「原物料」。

• 匯率列的行為和原本的成本匯率完全一樣（計算會用）。

• 原物料列這一版只做輸入與保存，不參與計算。

• 新增單據時可以自己加列；瀏覽既有單時不開放加列。

13. 舊單據的匯率不再保留

2026-09-09 之前存的生產計劃單，成本匯率是存在舊格式欄位裡的，該欄位已隨這次改版移除。

開啟舊單時條件仍看得到（日期那幾欄還在），但成本條件表會改帶當日匯率。這是刻意的取捨。

技術備註（第四批）

• 新增 Common/Model/M.EIS/生產計劃單條件.cs（生產計劃單條件 ＋ 生產計劃成本條件 ＋ 成本條件類別）。

• 主檔 匯率資料（VFPData XML）→ 條件資料（JSON，Newtonsoft）；

Twork_eis_vw_productionmSource 新增 To條件JSON() / From條件JSON() / Get匯率列()。

• Get匯率列() 只放行類別＝匯率的列：ProductionPlanBll 會 ToDictionary(幣別)，

原物料列混進去同幣別會撞 key 直接炸。

• 「生產計劃查詢」的 ProductionPlanDocumentBll 一併改寫 JSON，兩支程式格式一致。

• DB：sql/prodplanm-conditions-json-20260909.sql（加 條件資料、DROP 匯率資料、

sp_refreshview 兩個 view）。必須配合發版，否則舊程式找不到欄位會存檔失敗。

---

修正：下拉選單空白項顯示成一個孤零零的「:」

代號與說明都空白的下拉項（例如「不指定」那一列），會顯示成一個冒號。

2026-09-06 已針對共用基底修過一次，但四個衍生的下拉型別自己覆寫了顯示方式、沒帶到那次的修正：

客戶／廠商別、借貸別、科目類別、待辦工作別。這次一併改走同一個共用寫法，空白項就是空白。

禾久：其他入庫單／借入單改用專屬套印格式（2026-09-09）

使用者看得到的變動

適用對象：禾久帳套。（其他客戶的入庫單列印完全不受影響。）

入出庫作業（TRLIMA）的列印頁，第一個選項「入庫單」以前不論哪一種單別都印同一張 A4 版面。

現在改成依單號前置碼自動挑對應的格式，與舊系統一致：

單別前置碼	印出來的表單	紙張

調撥出倉單（SS）	調撥出倉單	中一刀

借出還入單（LI）	借入單（新）	中一刀

其他（例外入庫單、盤點調整單、報廢單、模具出入庫單、借出單…共 14 種）	其他入庫單（新）	中一刀

兩張新表單都是印在預先印好格線的表單紙上（中一刀點陣紙，9.5 吋 × 5.5 吋），

每頁固定 10 筆明細、右上角印「頁次／總頁次」，最後一頁才印交易備註。

新表單會多印的內容

以前的版面沒有、新表單會印出來的欄位：統一編號、送貨地點、聯絡人。

其中「送貨地點」的組法與舊系統相同——客戶有填送貨地點就印送貨地點，沒有就印公司地址；廠商一律印公司地址。

電話／傳真的來源調整

入庫單上的電話／傳真以前分別取自不同的地方（電話取客戶／廠商共用檔、傳真只取客戶主檔），

造成廠商的單子會印出空白或不正確的傳真。現在統一改成：客戶取客戶主檔、廠商取廠商主檔，與舊系統一致。

> ⚠️ 這會讓部分單據上的電話／傳真與改版前不同（以廠商為交易對象的單據影響最大）。

照舊系統維持空白的兩處

• 「其他備註」欄：舊系統的資料表就沒有這個欄位，一直是空白，本次照舊不填。

• 借入單的「例外出入原因」欄：舊系統自 2018/07/23 起就不印這一欄（原本印的是來源借出單號），本次照舊留白。

要恢復印來源單號需要另外評估（資料表目前也沒有存這個欄位）。

需要注意

• 第一次列印請先對位：兩張表單的紙張尺寸是依版面推算的，實際上機列印時請先用一張紙試印、確認格線對得上，

必要時再微調印表機的起始位置。

• 電話／傳真來源的調整需要一併更新資料庫（隨本次版本部署）。

禾久：出貨單改用專屬套印格式（四種版本）（2026-09-09）

使用者看得到的變動

適用對象：禾久帳套。（其他客戶的出貨單列印完全不受影響。）

出貨作業（TRSAMA）的列印頁，以前只有一個「出貨單」選項、印一張 A4 版面。

現在改成四個選項，與舊系統一致：

列印頁上的選項	金額欄位	出貨數量

出貨單(整數)	印	整數

出貨單(3位小數)	印	小數三位

出貨單(不含金額/整數)	不印（單價、金額、貨款小計、稅額、合計金額都不出現）	整數

出貨單(不含金額/3位小數)	不印	小數三位

四張都是印在預先印好格線的表單紙上（中一刀點陣紙，9.5 吋 × 5.5 吋）。

「不含金額」那兩張是給不希望對方看到單價的場合（例如送貨簽收聯）用的。

版面行為（與舊系統相同）

• 每頁固定 10 筆明細，右上角印「頁次／總頁次」；不足 10 筆的部分留白。

• 出貨單／出貨退回單：同一張表單依單據性質自動切換標題，不必分開選。

• 出貨退回單的數量與金額印負數；但「今日歸還」的鋼瓶借出列照樣印正數。

• 貨款小計、稅額、合計金額、發票號碼、交易備註只印在最後一頁。

• 箱數：品號有設外箱包裝量時印 ( 箱數 )，沒設就留白。

• 項次是整張單跨頁連號；序號為 A00 的列不印項次、其他 A 開頭的列印序號原值（借出未還）。

• 借出提醒：該單只要有一筆借出明細，交易備註最後會自動加上

「(借出之鋼瓶及其他物品須歸還，若遺失需照價賠償 !)」。

• 運送方式有填時，會加印在交易備註的第一行。

• 倉單號含「禾久科技倉」時縮寫成「禾久科」（原字串太長印不下）。

照舊系統維持空白的一處

• 「規格」欄：舊系統在列印程序裡就把這十個欄位固定清成空白（原始碼註解寫「禾久不要規格」），

本次照舊不填。要改成印規格只需調整程式一行，但屬於行為變更，需要另外確認。

需要注意

• 第一次列印請先對位：紙張尺寸（241 × 140 mm）是依版面推算的，實際上機列印時請先試印一張、

確認格線對得上，必要時再微調印表機的起始位置。

• 列印不會再自動遞增「理貨人員」：舊系統每列印一次會把理貨人員改寫成「使用者--次數」並累加，

新版不做這個寫回動作（列印是唯讀動作）。需要記錄列印次數請另外提出。

• 本次不需要調整資料庫（現有的出貨單查詢程序已涵蓋全部欄位）。

2026-09-09 表格「從 Excel 匯入」會檢查代號、並自動帶出名稱

變動內容

明細表格右鍵的「從 Excel 匯入」，過去只檢查欄位型別（例如日期欄填了文字）。這次補上兩件事：

1. 代號不存在會擋下來

Excel 裡填的客戶代號、廠商代號、品號、員工編號、部門代號等需要查主檔的欄位，匯入前會先確認代號真的存在。只要有一筆查不到，整批就不匯入，並列出問題所在：

匯入已中止，下列資料無法填入（請修正 Excel 後重新匯入）：





Excel 第 5 列「品號」：資料不存在（值：A0012X）


Excel 第 9 列「部門代號」：資料不存在（值：ZZ）

行為與手動在格子裡打錯代號被擋下來一致，也維持原本「全部成功才匯入、不會匯入一半」的規則。

空白、MISC 以及系統佔位符（如 #I#）不做檢查，與手動輸入相同。

2. 名稱、簡稱會自動帶出來

以往匯入後，品名、廠商簡稱、部門名稱這類「跟著代號帶出來」的欄位是空白的，得再逐列點一次才會出現。現在匯入完成時就會一併帶出，與手動輸入代號後離開格子的結果相同。

代號存在但主檔沒有對應名稱時，該欄留白，不會因此中止匯入。

3. 匯入的資料接在既有明細後面

以往匯入會從表格第一列開始覆寫，既有的明細列會被匯入的資料蓋掉。現在匯入的資料一律接在既有明細之後，原本的列不受影響。

影響範圍

• 一般明細表格的右鍵「從 Excel 匯入」。

• 總帳傳票（SLIY）等自備匯入功能的畫面不受影響，規則與原本完全相同。

• 少數會依單據交易別動態切換查詢對象的欄位，維持原本行為（不做代號檢查），名稱一樣會帶出。

使用者需要做什麼

不需要調整既有的 Excel 檔。若匯入時出現「資料不存在」，請依訊息指出的列號與欄位修正代號後重新匯入。

朝陽出貨通知單移除「其他金額」欄

日期：2026-09-08

影響對象：朝陽（SALEMA_CY，出貨通知單）

變更內容

出貨通知單（朝陽版）明細表格移除「其他金額」欄。

原因

朝陽帳套的出貨通知單明細（salede / vw_salede）本來就沒有「其他金額」這個欄位，

朝陽版舊系統的畫面也沒有這一欄——它是禾久版才有的欄位。

2026-08-04 建立朝陽變體畫面時採「原樣複製禾久畫面」，這一欄跟著被複製過來，

結果是欄位在畫面上永遠空白，使用者填了也存不進去（上傳時會依實際資料表結構丟棄）。

使用者可見的差異

• 出貨通知單明細表格少一欄「其他金額」（原本永遠空白）。

• 金額計算不變：金額＝數量 × 單價（原本朝陽的「其他金額」恆為 0，本來就沒有參與計算）。

• 禾久版出貨通知單完全不受影響，「其他金額」欄照舊。

備註

若使用者曾對這張表格按過右鍵「記憶格式」，第一次開啟時仍會套用舊版型；

版型內找不到的欄位會被略過，不影響其他欄位。

2026-09-08 新增「生產計劃單」程式（新功能測試 Y-06），生產計劃可以修改了

使用者看得到的變動

新程式：生產計劃單（主選單 →「新功能測試」→ Y-06）

生產計劃查詢存下來的計劃單，過去只能查閱、載入、整張刪除，數字動不了。現在多一支「生產計劃單」程式，用一般單據的方式維護它：

• 新增：輸入查詢條件 → 按 客戶設定 帶出客戶清單 → 按 查詢 算出訂單預示預估／生產計畫／使用量三張明細 → 微調數字 → 存檔（系統配 PP 開頭的單號）。

• 修改：翻到任一張舊單，改上面的數值後存檔。

• 刪除：整張單連同四張明細一併刪除。

• 支援上一筆／下一筆、清單瀏覽、審核欄位。

可以改的欄位：客戶設定的預估起訖與百分比、訂單預示預估的訂單數量／預訂交期／單價、生產計畫的數量／日期／內外單位工時／備註。使用量(機種別) 整張唯讀（它是生產計畫 × BOM 展開的結果，一張單動輒數萬列）；四張明細都不能手動增列或刪列。

修改狀態下 客戶設定／查詢 兩顆鈕會變灰——重算等於整批換掉明細，要換一批資料請開一張新單。

生產計劃查詢（M-20）維持原樣

即時查詢、金流預測分頁、存成生產計劃單、歷史單分頁全部照舊，兩支程式共用同一批資料與同一組 PP 單號。金流預測只在查詢那支，因為它是用「當下」的票據與帳款算的，不屬於某一張單的內容。

收付條件號／預收日（預付日）開始存進資料庫

這幾欄 2026-09-04 起就顯示在畫面上，但先前只是算給畫面看、沒有存檔，載入舊單時一片空白。現在會隨單存下來。

• 影響分頁：訂單預示及預估（收付條件號、預收日）、生產計畫（同）、使用量(機種別)（收付條件號、預付日）。

• 2026-09-08 之前存的舊單這幾欄仍是空白，屬正常；重新產生一張新單即可。

• 修改預訂交期／日期時，預收日不會自動重算，維持存檔當下的值。

需要做的事

• 資料庫要跑 sql/prodplanm-deploy-20260908.sql（加欄位＋登錄新程式＋補權限）再跑 sql/prodplanm-move-to-subsystem-y-20260908.sql（掛到新功能測試 Y-06）。禾久庫已完成。

• 跑完要重新登入 ERP，選單是登入當下取得的。

• 權限沿用「生產計劃查詢」：原本看得到查詢的使用者，自動拿到生產計劃單的權限。

• 這是新功能，依慣例先放「新功能測試」子系統，穩定後再搬到 M.主管資訊。

已知限制

• 資料別（訂單／製通單）與預估百分比是產生資料時的條件，不隨單儲存，載入舊單時回到預設值。

• 朝陽帳套目前選單裡沒有生產計劃查詢，因此也還沒登錄生產計劃單。

2026-09-08 報表「無資料可列印」之後不再跳 SQL 錯誤訊息

症狀

在有列印頁的程式按 預覽／列印／Excel 時，如果該報表在目前條件下查無資料，畫面會連續跳兩個訊息框：

1. 無資料可列印！（正常，這是應該出現的提示）

2. Error Report Handle: SQL logic error no such table: <報表資料表名>（不該出現，使用者會以為系統壞掉）

實測環境：銷項發票 → 列印 → 選「三聯式發票、電子計算機發票」→ 預覽，該期別沒有 31 類發票時必現。

原因

列印流程在資料匯出這一步，插件回報「沒有資料」時只顯示提示訊息，卻沒有中止流程，後面照樣去載入報表範本；但報表要讀的暫存資料表根本沒有建立，於是又跳出一個資料庫層的錯誤訊息。

修正

沒有資料時直接中止列印流程，只保留「無資料可列印！」一個提示。此問題影響所有走列印頁的報表（不限發票模組），修正後一併解除。

影響範圍

• 使用者可見行為：查無資料時少跳一個錯誤訊息框，其餘不變。

• 有資料時的列印／預覽／匯出行為完全不變。

2026-09-08 發票轉檔沒資料時不再跳系統錯誤；統一發票／折讓單報表改以資料表判定

一、轉檔沒資料時跳「系統錯誤 Cannot find table 0.」

症狀：在進項發票按 轉入（進貨單轉進項發票）、或在銷項退回按 轉入（應收帳款轉銷貨退回及折讓），若該期別沒有可轉的資料，按 儲存 會跳出紅色的

> 系統錯誤　程式：TKTURNR　Cannot find table 0.

原因：查不到資料時程式沒有先擋下來，直接去取查詢結果的第一張資料表。

修正：改成正常提示「無資料!!!」。銷項發票的轉入（應收帳款轉統一發票）原本就是對的，不受影響。

二、統一發票與電子發票折讓單的報表清單以「帳套有沒有這些資料」判定

症狀：統一發票列印與電子發票折讓單列印兩頁，在某些環境下報表清單是空的，連 預覽／列印 按鈕都不出現。

原因：原本以公司簡稱字串判斷要不要登錄這幾張報表。只要公司簡稱與寫死的值不一致（例如更名、或另開一個同樣有發票資料的帳套），整組報表就會無聲消失。

修正：改成判斷該帳套是否建有存證發票／折讓單的資料表。沒有這些資料表的帳套（例如未使用存證發票功能者）行為不變，仍然看不到這幾張報表。

三、401 申報書／媒體申報檔存錯位置

症狀：401 申報書按 轉申報檔、媒體申報按 轉檔／零稅率轉檔 時，訊息顯示的路徑是 C:\Temps401_12345678.tet——檔案被寫到 C 磁碟根目錄、而不是暫存資料夾裡面，檔名還黏著資料夾名稱。

原因：組路徑時把資料夾與檔名直接相接，中間少了分隔符號。

修正：三處改用標準的路徑組法，現在一律寫進系統暫存目錄（預設 C:\Temps）下，訊息顯示的也是正確的完整路徑。原本誤存在 C 磁碟根目錄的舊檔案可自行刪除。

影響範圍

• 一、二為錯誤處理與判定條件的修正，正常有資料的流程完全不變。

• 三只改檔案存放位置，申報檔的內容格式完全不變；已在報稅前取過檔的使用者，請改到 C:\Temps 底下取新檔。

朝陽：操作引導欄名中文化並開通

日期：2026-09-08

影響對象：朝陽（USERGUIDE 操作引導）

變更內容

1. 朝陽的操作引導兩張資料表欄位名稱由英文改為中文（與禾久一致），共 30 個欄位。

2. 朝陽補上「操作引導」的單據登錄，這個功能原本在朝陽沒有登錄過。

原因

操作引導在朝陽是舊版英文欄位名稱，而程式讀的是中文欄位名稱，等於這個功能在朝陽從來讀不到任何資料；

單據登錄也一直缺一筆，功能等於沒開。禾久側早已是中文欄位、也有登錄，本次是把朝陽補齊到同一狀態。

使用者可見的差異

• 朝陽可以開始使用「操作引導」：在支援面板為各程式建立說明文件與附件。

• 原有的 1 筆舊資料保留，不受影響。

• 禾久不受任何影響。

部署

sql/cy-userguide-chinese-rename-20260908.sql（可重複執行）。

本機朝陽模擬庫已執行並驗證通過；朝陽正式機尚未執行。

專案資料：欄位名稱統一

日期：2026-09-08

影響對象：全部客戶（專案資料 APROJ）

變更內容

專案資料的兩個欄位改名，兩邊客戶統一成同一組名稱：

原本（禾久等）	改為

地點	專案地點

保留款比率	保留款比例

朝陽本來就是新名稱，不受影響。

原因

同一個欄位在不同客戶的資料庫裡叫不同名字，程式只認得其中一種，導致另一邊的畫面欄位讀不到值。

本次統一採用「專案地點／保留款比例」這組較清楚的名稱。

使用者可見的差異

• 專案資料畫面上的「地點」標籤改為「專案地點」。

• 兩張表原本都沒有資料，改名不影響任何既有資料。

部署

sql/aproj-rename-to-cy-naming-20260908.sql（每個帳套各跑一次，可重複執行）。

資料庫與程式必須同時上線，只更新其中一邊會讓該欄位空白。

本機 7 個帳套庫已執行並驗證通過；正式機尚未執行。

2026-09-07 拜訪行程規劃：實機驗證與截圖、兩處畫面修正

使用者可見變動

• 行程規劃在 lab 示範環境實機走完整流程（定位、無法定位手動點選、上移、AI 建議與採納、回填、拜訪單回看），手冊與案例書補上 11 張實機截圖，案例書 PDF 重出。

• 修正：按「上移」「下移」時序號欄沒有跟著列移動（列換了、數字還是舊的）。

• 修正：AI 建議區塊的理由文字不換行、要左右捲動；改為自動換行並加高到 260px。

2026-09-07 導覽（第一筆／最後一筆／上下一筆）表頭與明細對不上：TWORK_MOVEREC 修正

適用：所有帳套共用同一支導覽 SP。使用者 09-07 裁決禾久、朝陽正式機一起部署。

症狀

• TAG進貨單按「第一筆」，表頭是進貨單 RC2600001，明細卻是出入庫單 GD2600001 的（使用者 09-07 回報）。

• 同一根因在 TAG出入庫單按「最後一筆」也中；按「下一筆」跨過最後一筆時會出現「沒有表頭卻有別張單的明細」。

• 進貨單／出入庫單／出貨單三支程式共用同一張主表，其他帳套只是單號前置碼剛好排得開才沒被看到。

根因與修法

• 表頭從程式的主表 view（有單據別條件）取第一筆，但明細用來對應的主鍵是從共用主表（沒有單據別條件）另外取的，兩邊排序取到不同張單。

• 修正後明細主鍵一律從與表頭相同的來源取，PKID／定位（SEEK）分支也同源化，行為不變。

部署

• TAG 帳套：sql/sh03a/sh03a-twork-moverec-viewkey-fix-20260907.sql（可重跑）。dev TAG 庫已跑，七種導覽情境比對表頭 pkid＝明細 linkid 全部通過。

• 禾久／朝陽：sql/twork-moverec-viewkey-fix-20260907.sql（通用版，SQL 2008 相容，每個 csa 帳套庫各跑一次，已修過會自動跳過）。dev 兩庫各跑兩次（第二次跳過）驗過，進貨單／出入庫單／出貨單 第一筆／最後一筆 表頭與明細相符。正式機由使用者執行。

2026-09-07 SH03A TAG：業主儀表板「TAG追蹤儀表板」放進公司儀表板

適用：SH03A TAG 專案帳套。其他帳套沒有這些卡片與儀表板，不受影響。

使用者可見變動

• TAG業主 子系統多一支「公司儀表板」（排最後）。開啟後選「C0001 TAG追蹤儀表板」，兩頁：

- 總覽：本期進貨標籤數、本期領用標籤數、在廠標籤庫存、工班在手標籤四顆數字；各倉標籤庫存、各水泥廠進貨數、各工班領用數、施工地址 Top10 四張圖。

- 趨勢與明細：每月進貨數、每月領用數折線；最近領用紀錄（日期、單號、工班、TAG ID、施工地址、掃描時間、GPS）與最近進貨標籤明細兩張表。

• 上方「期間」條件套用到進貨／領用類磚；庫存三張看的是現況不受期間影響。

• 每張圖點下去跳到 TAG進貨單／TAG出入庫單 的清單瀏覽帶條件。

• 資料照登入身分過濾：水泥廠主管若開同一張板，只看得到自己廠與底下工班。

• 挑卡視窗多「TAG追蹤」分類 12 張卡，可自組個人版。

資料庫

• sql/sh03a/sh03a-tag-owner-dashboard-20260907.sql（由 gen-tag-dashboard-sql.py 從 tag-dashboard-cards.json 產生）：查詢程序 TWORK_QRY_TAGSTOCK（各倉標籤庫存＋單位類型）與 log 庫登錄、12 張卡片、儀表板 C0001、選單搬移與業主權限。dev 已跑，驗收 8/8。

• sh03a-tag-menu-roles-20260906.sql／sh03a-tag-menu-order-20260907.sql 同步納入公司儀表板（T-10）。

順帶修正

• TAG進貨單「清單瀏覽」原本任何條件都會報「無法繫結多重部分識別碼」：08-30 新寫的進貨清單查詢程序把查詢包成子查詢，吃不下條件欄位自帶的表別名。已改成自動去掉別名，並補上 TAG ID／手持機兩欄（sql/twork-bd-wrapped-prefix-fix-20260907.sql，同批修到出貨／採購／廠商報價三支）。禾久、朝陽正式機同樣有此問題，待裁決是否部署。

09-07 續：施工位置地圖

• 新磚型「地圖」（見 2026-09-07-dashboard-map-tile.md）；總覽頁改放「施工位置地圖」，各廠進貨／各工班領用移到第二頁。

2026-09-07 帳款／票據第二輪實測修正＋發票管理靜態稽核修正

帳款／票據（I／O 模組）

• 費用申請（PAYAPPLY）加明細列後存檔失敗（訊息「An error occurred while saving the entity changes」）：新增時程式把明細 pkid 顯式重編 1..20，與明細表格右鍵「新增數筆」交給資料庫產生的序號撞鍵。移除該段重編；明細 pkid 一律由系統產生。

• 預估資金表（BANKFCST）單號被覆寫：存檔時程式把單號改成「日期＋帳戶代號」，新增時伺服器會蓋回流水號所以看不出來，但修改後假單號（例：2026/12/31#01）直接落地，之後同日期再新增會撞唯一索引「資料重複」。移除覆寫；單號一律為系統依預估日期派的流水號（yyyyMMdd 加三碼序號）。既有資料庫中單號含「/」的舊資料屬歷史污染，需另行清理。

• 手冊 O-Check/bankfcst.md 原寫「單號＝日期＋帳戶代號、同日同帳戶會覆寫同一張」與實際不符，已更正。

發票管理（P 模組）

• 401申報書（TICK401）從選單消失：程式鍵未登錄於程式鍵清單，選單啟動時被「隱藏未實作程式」過濾器移除。補上程式鍵；同時把 401申報書 原本誤用的「申報資料轉檔（TUTAX）」程式鍵改回自己的鍵，兩支程式的權限、翻譯與表格版型記憶不再互相覆蓋。

• 存證折讓發票（TICKA_DISC）：明細「品號」欄綁到不存在的屬性導致永遠空白且品名不自動帶出，改綁正確屬性；「全選」「取消全選」兩顆鈕命令名不一致成死鈕，已對齊。

• 進項發票／銷項發票／銷項退回／存證發票／存證折讓發票 五張明細表格補掛標準表格樣式，待刪列會顯示紅字提示（與其他模組一致）。

發票管理（實機資料輸入抓到的）

• 進項發票／銷項退回的新增彈窗下拉全空（公司代碼、憑證類別、類別、課稅別，新增筆數也不顯示）：彈窗畫面改成 TsView 後仍用舊的 ElementName=Window 綁定，綁不到任何元素。改綁 View。

• 銷項發票／進項發票／銷項退回／存證折讓發票存檔即「The given key … was not present in the dictionary」：存檔類向框架索取明細集合時用了基底型別，程式登錄的是衍生型別，字典查不到。四支改用登錄的型別，存檔恢復正常。

• 彈窗式新增（進項／銷退／存證發票）關閉彈窗後多彈一個「系統錯誤」：主畫面的新增回呼以「失敗＋空訊息」表示「不進新增模式」，框架卻把空訊息補成假的系統錯誤。框架改成有訊息才顯示；資料早已寫入，只是訊息誤導。

• 銷項退回彈窗「客戶」欄輸入客戶代號彈「資料不存在」：欄位掛的是廠商查詢樣式，後端本來就查客廠合一的檢視表，改成客廠查詢樣式。

• 存證折讓發票：明細驗證與折讓金額加總的條件寫反（只處理被標刪的空列，真資料列從不驗、金額恆 0），已對齊 VFP 的 ELSE 分支；明細「品號」欄改走 品號Binding（原本覆寫 mapped 屬性並在 setter 取 Context，資料物化時 Context 尚未注入，存檔與取消都會 NullReference）；課稅別為空的列不再在算稅時炸掉。

• 同一期別／憑證類別的第二張進項或銷退發票存不進去（唯一索引重複）、401申報書與存證折讓查不到公司資料、客廠資料查詢恆空：程式向資料庫查詢時用的是程式端類別名稱（Twork_inv_vw_*、Twork_sys_vw_codata、Twork_sys_vw_cusp），資料庫沒有這些物件（朝陽雖有前兩者但是英文欄名舊檢視表），派發器靜默回空，程式便把既有期別當成新單。改查實際資料表（tickr_m／tickr_d／ticks_d／ticksr_m／ticksr_d／codata）與 vwseek_cusp。

框架（所有主檔程式）

• 存檔撞唯一索引時的訊息：原本原樣顯示派發器回傳的「NG ,2441 ,無法以唯一索引 'IX_bank_1' 在物件 'dbo.bank' 中插入重複的索引鍵資料列…」。現改為「資料重複，無法存檔：1103（追蹤號 2441）」，括號內是重複的鍵值，追蹤號可回查記錄庫。其他錯誤訊息維持原樣。

發票管理新增／補齊功能

• 存證作廢發票（TICKA_VOID，禾久）：原本只有資料表與選單、程式未實作而被選單隱藏，現補齊主檔畫面（買方代號查詢自動帶統編／名稱／地址，賣方資料由公司主檔帶入，作廢日期預設現在時間，發票作業別 CAN，含核准文號），新增／修改／刪除全循環實機驗過。

• 零稅率主檔「轉入」、存證發票「轉應收」「轉出貨」「批量匯出」四個視窗：原為舊式獨立視窗，按下即「Exception has been thrown by the target of an invocation」；改為內嵌式視窗，四支都能正常開啟與離開。

發票管理報表（第一批 5 張）

• 零稅率主檔「營業人申報適用零稅率銷售額清單」（Tick3a）、進項發票「進項稅額憑證」「進項退貨憑證」（Tickra／Tickrb，列印條件新增 8 種憑證類別選項）、銷項退回「銷項退回憑證」（Ticksr，新增列印條件頁）、留抵稅額「留抵稅額表」（Tickmin，瀏覽列印）。原本這些程式的列印鈕會亮但沒有任何報表可選；零稅率主檔與進項發票的舊列印頁原為無法運作的殘留頁，已改造成可用。

• 第二批：銷項發票「三聯式統一發票明細表」「二聯式統一發票明細表」「三聯式收銀機統一發票明細表」「發票明細表」（Tick1a／Tick2a／Tick1b／Ticksdtl，新增列印條件頁：期別＋4 種報表選擇；前三張為稅局固定格位套印，每 50 張一頁）。

• 第三批：申報書備註「申報書備註表」（Tother，瀏覽列印）、401申報書「營業人銷售額與稅額申報書(401)」（Tick401a，查詢後可直接列印整頁式申報書，只做 A4）。

• 第四批（禾久）：銷貨發票（存證發票）新增列印條件頁，五張報表「統一發票」（套印，明細超過 10 筆自動併成合併品名一列）、「銷項發票明細表」（依客戶＋日期區間）、「銷項發票品項明細表」（超過 10 筆的發票）、「電子發票證明聯」及「續頁」。統一發票的紙張尺寸為推算值（210×121 mm 零邊界），實機第一次列印請先對位。

• 第五批（禾久）：存證折讓發票新增列印條件頁（起迄折讓單號），報表「營業人銷貨退回、進貨退出或折讓證明單」（Ticka_disc，A5 橫，每張一頁、5 格位）。至此發票管理 VFP 現行 17 張報表全部移植完成。

2026-09-07 自訂儀表板新增「地圖」磚型（GPS 落點）

適用：所有帳套的自訂儀表板／儀表板設計；SH03A TAG 的「TAG追蹤儀表板」總覽頁已放一張「施工位置地圖」。

使用者可見變動

• 儀表板設計的磚型別多一種「地圖」：指定資料集裡的緯度欄、經度欄，選擇性指定標籤欄（標記標題）與顯示欄位（點標記的氣泡內容）。每一列資料一個標記，沒有座標（空白、0,0、超出範圍）的列不畫，磚上會註明略過幾列。

• 地圖底圖與拜訪行程規劃相同（免金鑰的開放圖磚，可用帳套參數 GEO_TILE_STYLE 換樣式），會自動縮放到涵蓋所有標記；點標記看氣泡，氣泡裡「看明細」跳該程式的清單瀏覽帶標籤值當條件。

• 需要連網才有底圖；離線或列印（PDF）時該磚改顯示標記清單（標籤＋座標）。匯出 Excel／PPT 時地圖磚匯出成一點一列的表格。

• TAG追蹤儀表板：總覽頁下半改為「施工位置地圖」（左）＋「施工地址 Top10」（右）；各廠進貨、各工班領用兩張柱狀移到第二頁與趨勢圖同列。

程式

• LogicBll/M.EIS/Dashboard/：DashboardDefinition（型別 地圖、磚定義 緯度欄／經度欄／標籤欄）、DashboardRenderModel（MapData／MapPoint）、DashboardAggregator.Map、DashboardQueryEngine（地圖分支、圖磚樣式讀 GeoSettingsLoader）、DashboardHtmlWriter（地圖內容、MapLibre 資源）、DashboardHtmlCss、DashboardHtmlScript.MapInit。

• ViewModel/A.SystemData/DashboardcfgItems.cs／DashboardcfgViewModel.cs（驗證）、TsERP/A.SystemData/儀表板設計.xaml（第 9 列三個欄位）、Common/Lang/Xaml/Dashboardcfg.json。

• 測試：LogicBllTests/Dashboard/DashboardMapTileTests.cs。

• TAG 卡片 GTRLIMA_TAG_施工位置地圖（sql/sh03a/tag-dashboard-cards.json）與 sh03a-tag-owner-dashboard-20260907.sql 重產。

同日：儀表板換螢幕不再重排（使用者「儀表板照 1920 設計」）

• 原本畫面列數依視窗高度算，跟設計列數不同就把整張板重新流排（2560 螢幕上四顆 KPI 會疊成一直排、磚亂跑）。

• 改為：列數只會比設計多、不會少，磚永遠停在設計器／存檔的位置；大螢幕多出來的列留空，小螢幕列數不夠就在格區內上下捲。

• 拖曳改成「放哪裡就是哪裡」（使用者同日裁決）：列數固定的板拖完、改大小後不再自動左吸／上吸壓實，磚停在放下的格子；壓到同尺寸的一顆就兩顆互換，壓到不同尺寸就把對方往右推；拖曳途中經過的磚不會被順手推走（每一步從拖曳前的狀態算）。存檔端同步不再壓實。列數 0 的舊版儀表板維持原本「往下推＋上吸」。

同日：鑽取回來全部「載入中」修正

• 從任何磚鑽取到清單瀏覽再回到儀表板，離開超過幾秒時所有磚都顯示「載入中」。原因是逐步顯示模式下畫面骨架與磚內容分開送，回來時只重灌了骨架。現在回到頁面會自動把版面與全部磚補回，不重新查詢。

2026-09-06 拜訪行程規劃：定位服務標示

• 行程規劃視窗的地圖下方新增「定位服務：內政部全國門牌地址定位服務（TGOS）」連結，點擊以系統瀏覽器開啟 https://www.tgos.tw。地圖右下角的版權列同步加上 TGOS 連結。

• 這是介接內政部定位服務的使用規定要求（互惠條款），不論目前設定的定位供應商為何都會顯示。

2026-09-06 拜訪行程規劃：地址定位補強、上移下移即時、狀態列顯示進度

使用者可見變動

• 地址定位查得到了：客戶主檔地址前面帶郵遞區號（「231新北市…」）或含「巷／弄」時，以前會顯示「查不到這個地址」。現在自動去掉郵遞區號與括號備註，查不到時逐階退到「巷」「路／段」層級再查。免費定位服務只有路名精度，門牌精度要等內政部 TGOS 服務接上。

• 上移／下移立刻反應：按下去列馬上交換、序號重編、選取跟著走；各段里程與過路費在狀態列顯示「順序已變更，重新計算中…」後幾秒內更新。連按多次只重算一次。

• 狀態列顯示進度：第一次開窗要逐站定位（外部服務限每秒一次），狀態列會顯示「定位中 3/7：客戶名」「計算路線中（7 站）…」，不再只有「計算中…」。

• 拜訪日期、業務員、總里程、總車程、總國道里程、過路費估算改為唯讀輸入框樣式（可選取複製）。

• 「重新計算」「上移」「下移」三顆按鈕拿掉圖示，只留文字。

2026-09-06 拜訪行程規劃：每站預計到達／離開時程

使用者可見變動

• 行程表新增「預計到達」「預計離開」兩欄；視窗上方新增「出發時間」欄（預設 08:30，可改後按重新計算）。

• 時程由程式推算，不是 AI 給的：到達＝上一站離開＋該段車程；離開＝到達與該站起始時間取較晚者再加停留；停留＝拜訪單有填截止時間就停到截止時間，沒填用預設 60 分鐘。終點只有到達。

• 採納 AI 建議順序時，AI 的「建議出發時間」自動帶入出發時間欄，時程隨重算更新。

• 新增系統參數（_prgpar，都可不設）：GEO_DEPART_TIME 預設出發時間（HH:mm，預設 08:30）、GEO_STAY_MINUTES 預設停留分鐘（預設 60）。

• 時程超過 24:00 會直接顯示 25:10 這類數字，不繞回隔天，讓人看得出當天排不完。

2026-09-06 拜訪查詢視窗調整

• 拜訪查詢視窗尺寸：從固定 1200×560 改為跟著主視窗（長寬各減 100），四個分頁的表格不再擠在小視窗裡。

• 查詢鈕文字：共用查詢鈕在查不到翻譯時原本顯示英文「Query」，改為顯示「查詢」（全系統共用控件，各查詢畫面一併受益）。

• 表格右鍵「全部勾選／取消勾選」：以前只在單據新增／修改狀態才能按，查詢類視窗（如拜訪查詢的「選取」欄）永遠灰掉；現在只要該格的勾選框本身可以點，右鍵全勾／全取消就可以用。

• 共用按鈕英文殘留一併清掉：離開鈕、儲存／確認／取消樣式、底部操作列的儲存／取消／離開／列印，翻譯查不到時原本顯示 Exit／Save／Confirm／Cancel／Print，全部改為中文；確認鈕的翻譯鍵也由英文 Confirm 改為「確認」。

• 下拉空白項顯示成「:」：代號與說明都空白的下拉項目（預設空白選項）原本會顯示一個冒號，現在顯示空白；語言、分錄範本等自組顯示文字的下拉一併修正。

2026-09-06 SH03A TAG：G倉庫表新增「TAG明細」子查詢

適用：SH03A TAG 專案帳套（_prgpar 參數 MENU_STYLE＝TAG）。其他帳套看不到這顆按鈕、雙擊也沒有動作，行為不變。

使用者可見變動

• G倉庫表主檔區「數量查詢」右邊多一顆 TAG明細。按下開彈窗，列出這座倉庫（工班）進出過的每一支 TAG：交易日期、單據（進貨／出入庫）、單號、交易事項、方向（轉入／轉出）、轉入／轉出倉儲、品號、批號、數量、TAG ID、手持機、掃描時間、GPS 緯度／經度、施工地址、交易部門與部門名稱。

• 先按「數量查詢」再在右側數量表格點選一列（或直接雙擊該列），TAG明細會帶入那一列的倉儲與品號，只看那個品號的 TAG。

• 彈窗上方可改 品號、填 TAG ID（包含）、施工地址（包含）再按查詢縮小範圍；右側顯示筆數。

• 資料照登入身分過濾：工班只看得到自己的列，水泥廠看得到自己與底下工班，業主看全部（與 RLS 規則相同）。

程式

• LogicBll/C.GeneralAffair/Gsplace/GsplaceBll.cs：GetTagDetail／BuildTagDetailCondition；TagStockDetailPoco.cs。

• ViewModel/C.GeneralAffair/TagStockDetailViewModel.cs（彈窗）、GsplaceViewModel.cs（IsTagSite／SelectedQuantity／TagDetailCommand／OpenTagDetail）。

• TsERP/C.GeneralAffair/TagStockDetail.xaml、Gsplace.xaml（按鈕、數量表格 SelectedItem＋雙擊）、App.xaml DataTemplate。

• Common/Lang/Xaml/Gsplace.json（TAG明細／TAG ID／施工地址／查詢／返回／筆數）、Gsplace_tag.json（彈窗表格欄名）。

資料庫

• sql/sh03a/sh03a-tag-stock-detail-qry-20260906.sql：TAG 庫 TWORK_QRY_TAGSTK(@倉儲代號, @查詢條件)＋log 庫 proc_param。dev 已跑，驗收 4/4。

2026-09-06 帳款管理／銀行票據全測修正

Hyper-V lab 對 I.帳款管理、O.銀行票據 兩模組做「全按鈕掃描」與「資料輸入」實機測試後修正的四件事。

使用者可見的變動

1. 瀏覽列印頁沒查詢就按 Excel 不再跳「系統錯誤」（銀行帳戶／應收票據／應付票據／預估資金表／廠商帳戶表等主檔程式）。原本會出現 NullReference 的系統錯誤視窗，現在與「預覽」一致，顯示「沒資料」。

2. 廠商帳戶表按「新增」不再立刻彈「資料不存在」。主鍵欄（廠商代號）掛了廠商查詢樣式，新增列的預設值 +++ 會被拿去做存在檢查；現在 +++ 視為佔位值不檢查。應收票據等程式「複製」時的同一類提示也一併消失。

3. 財務單明細「交易別」下拉可以編輯了。原本一進儲存格編輯就跳「無法將 ComboBoxItem 樣式套用到 RadComboBoxItem」的系統錯誤，連帶品號、品名等欄位彈「Textbox沒有設定」。

4. 客戶應收查詢／廠商應付查詢的「年度統計表」月份表頭恢復顯示月份（08月、09月……），不再停在 C01～C12。

6. 應付帳款／應收帳款／費用申請／收款單／付款單／費用科目表的明細表格補上 DataManager 綁定（10 張表格），右鍵「新增列」與「從 Excel 匯入」走框架正規路徑，與財務傳票單一致。

5. 付款單／收款單「轉傳票」在合併轉參數（2035）未設為 Y 的帳套不再跳「找不到預存程序」。付款單一律走合併轉程序（與舊版一致）；收款單只有參數明確為 N 時才走分開轉程序，參數未設視同合併轉。朝陽模擬帳套實測抓到。

改動檔案

• ViewModel/Browse/ErpBrowseBaseViewModel.cs：GenerateExcel 對未查詢（DataView 為 null）與 0 筆的情況顯示「沒資料」。

• TsControl/ControlValidation/TsSearchRule.cs：IsPlaceholder 把新增哨兵 +++ 視為佔位值。

• TsERP/O.CAandCL/Ftrlima.xaml：交易別下拉欄拿掉不相容的 ItemContainerStyle。

• TsControl/Localization/HeaderLocalization.cs：表頭有 binding 的欄跳過翻譯，保留程式自己給的動態表頭。

• TsERP/I.ARAP/Paymnt.xaml、Receive.xaml、Payapply.xaml、Rsheet.xaml（3 張）、Psheet.xaml（3 張）、Grpmaccl.xaml：明細 TsRadGridView 補 DataManager="{Binding DetailData / Detail1Data / Detail2Data}"。

• LogicBll/I.ARAP/RpshtToSliyBll.cs、TsErp.Common.Core/DataBaseObjectEnum/Procedure.cs：轉傳票程序選擇對齊舊版（付款單一律合併轉；收款單 2035=N 才走分開轉，並改用實際存在的程序名）。

測試

• 禾久 29 支、朝陽 26 支全按鈕掃描（導覽／瀏覽／查詢／歷程／工作流程／列印預覽與 Excel／複製／修改／新增／其他功能鈕／說明）零崩潰。

• 16 支主檔程式新增→存檔→修改→第二筆→刪除，測試資料留在模擬庫（單號日期 20260906）。

• 修正後在 lab VM 重驗：Excel 改顯示沒資料、廠商帳戶表新增無提示、財務單交易別可選、月份表頭正常。

2026-09-05／06 SH03A TAG：主選單新增三個角色子系統 TAG業主／TAG水泥廠／TAG工班

適用：SH03A TAG 專案帳套。其他帳套主選單會多一顆「TAG追蹤」按鈕，沒有對應程式列，點了顯示既有的「無權限」訊息，行為同「新功能測試」按鈕。

使用者可見變動（TAG 帳套）

• 主選單子系統區第三列多三顆按鈕：TAG業主、TAG水泥廠、TAG工班（09-05 先做成一顆「TAG追蹤」，09-06 依使用者裁決拆成三顆）。

• 內容：業主＝密碼權限表、部門表、關係表、G庫存主檔，再加上水泥廠與工班的全部程式（09-06 晚裁決「業主的程式要把全部都加進去」，業主一顆按鈕做完所有事）；水泥廠＝TAG進貨單、廠商資料表、G庫存帳冊；工班＝TAG出入庫單、G倉庫表。這九支程式在 TAG 帳套的原子系統（A／B／C／G）不再出現。

• 測試帳號登入只看到自己角色的按鈕：業主三顆、水泥廠主管兩顆（水泥廠＋工班，辦公室要代工班匯入領用單）、工班一顆。管理員帳號不受影響。

業主子系統掛了全部程式後，水泥廠／工班的權限表也會因共用程式出現「TAG業主」列；TAG 專屬主選單的業主鈕改為「有業主專屬程式（不掛在水泥廠／工班的程式）權限才顯示」，所以水泥廠／工班仍看不到業主鈕。

• TAG 專屬主選單（帳套參數 MENU_STYLE＝TAG）：登入後主選單只有三顆角色按鈕（依權限顯示）與「回到登入視窗」，管理員多一顆「完整選單」可切回標準版面。其他帳套沒有這個參數，主選單維持原樣，且不會出現任何 TAG 按鈕。

• 新增「隱藏無權限子系統按鈕」功能：帳套 _prgpar 參數 HIDE_NOPERMIT_MENU＝Y 才啟用，沒設定行為同以往。TAG 帳套目前未啟用（先寫好不藏）。

• 09-07：三個角色子系統內的程式順序改照作業流程排：TAG進貨單 → TAG出入庫單 → G倉庫表 → G庫存帳冊 → G庫存主檔 → 廠商資料表 → 部門表 → 關係表 → 密碼權限表（水泥廠／工班各取自己的子集合、順序相同）。原本帳號維護類排最前面。

• 09-07：TAG 專屬主選單面板改靠上排（原本垂直置中），標題 30pt 粗體、三顆角色鈕放大成 260×80、字 24pt（使用者「往上面排，清楚顯示就好」）。

程式

• TsERP/Lang/SystemMap.json：T.TagOwner／U.TagPlant／V.TagCrew ↔ T.TAG業主／U.TAG水泥廠／V.TAG工班。

• TsERP/MenuView.xaml：BtnTagOwner／BtnTagPlant／BtnTagCrew（Grid.Row 3／Column 2～4）。

• ViewModel/DisplayMeta/MenuDisplayMetaViewModel.cs：T／U／V 屬性；Common/Lang/Xaml/Shared.json Menu 區 T／U／V。

• ViewModel/Setting/SubsystemPoco.cs：三個子系統。

• ViewModel/MenuViewModel.cs：ShowTagOwner 改走 HasExclusiveProgramIn("T.TagOwner", "U.TagPlant", "V.TagCrew")。

資料庫

• sql/sh03a/sh03a-tag-menu-roles-20260906.sql（_menud 三組＋TAGU_* 的 prgsct1.可否瀏覽 依角色收窄；還原用 -unregister-）。09-05 的 sh03a-tag-menu-register 已被取代。

2026-09-05 SH03A TAG：資料列權限（RLS）掛上單據表；登入身分帶進資料庫連線

適用：SH03A TAG 專案。其他客戶帳套只有連線字串多了 Application Name（顯示在資料庫連線監看中），行為不變。

使用者可見變動（TAG 專案）

• 看得到的單據依身分過濾：業主看全部；水泥廠看自己倉的所有進貨與領用單、以及底下工班的庫存；工班只看交易部門是自己的領用單與自己倉的庫存。TAG進貨單、TAG出入庫單、G倉庫表數量查詢、清單瀏覽全部套用。

• 跨部門寫入被擋：直接對資料庫寫別人部門的單會被拒絕；程式內存檔照常（工班存自己的領用單、批號回查與庫存扣轉都正常）。

• 2026-09-05 之前的舊版程式連 TAG 庫會看不到任何單據（沒帶身分），要更新到含本次改動的版本。

程式

• 連線字串附 Application Name=TsERP|<登入代號>（DataBaseParameter.SessionUser，登入成功時由 UserBll 設定）。決策見 ADR 0149。

資料庫

• sql/sh03a/sh03a-tag-rls-docs-20260905.sql：述詞函數 4 支、原則掛 trgama／trgade／ginvstk、STATE=ON；log 庫 DARB_LOG 包 TAG_RLS_BYPASS。冪等。

驗證

• 資料庫端 11 種身分矩陣、lab VM 工班帳號登入 ERP 端到端（詳見 sql/sh03a/README.md RLS 節與 ADR 0149）。

2026-09-05 TAG 進貨單／出入庫單：GPS、施工地址、掃描時間各自落欄；SH03A 組織種子

適用：SH03A TAG 專案（darbtagcsa1）。其他客戶帳套畫面與資料庫零變動。

使用者可見變動

• TAG進貨單（C-071）／TAG出入庫單（C-081）明細：手持機 LOG 匯入後，原本擠在「備註」裡的「掃描時間 GPS 地址」拆成四個獨立欄位：掃描時間、GPS緯度、GPS經度、施工地址，排在「手持機」之後。備註只剩解析不出來的原始字串（例如手持機沒定位到的 GPS 文字），正常情況為空。

• 備註欄寬由 420 收到 200。

• 瀏覽清單（清單瀏覽）同步看得到四欄；09-06 起查詢條件也能選掃描時間、GPS、施工地址（TAG ID 原本就可選）。

資料庫

• sql/sh03a/sh03a-tag-patch-trgade-gps-20260905.sql：trgade 加 GPS緯度 DECIMAL(9,6)、GPS經度 DECIMAL(9,6)、施工地址 NVARCHAR(200)、掃描時間 DATETIME（皆可空）；vw_gtrrade、DARB_BD_GTRLIST、TWORK_BD_GTRRADE 補回四欄。冪等；跑完 gen-schema-sync 追 nogi 之後要再跑一次。

• sql/sh03a/sh03a-tag-org-seed-20260905.sql：業主 1＋水泥廠 5（A1～A5）＋每廠 3 工班（2 自有＋1 外包，dept.製程別='外包'），每單位一個倉庫／儲位與測試帳號（密碼同 CMSA）。

程式

• 共用 Twork_gen_vw_gtrsadeModel／Twork_gen_vw_gtrsadeSource 多四個可空屬性（ADR-0050 union Source 做法，同「時間／時間單位」CY 專屬欄先例）。其他帳套載入留空、上傳時被取交集丟棄；本機快取把 NULL 補成 0／1900-01-01 的哨兵值在 Source getter 還原成 null，不會被寫回。

• TagLogParser 新增 ParseGps（拆緯經度，0,0 與超出範圍視為無效）與 ParseScannedAt。單元測試 LogicBllTests/C.GeneralAffair/TagLogParserTests.cs。

未驗

• runtime 未開窗驗（lab VM 的 tag-e2e.ps1 S／T／L 段待跑）。

2026-09-05 定位搜尋欄自動轉大寫改由系統參數 22 控制

• 行為：定位搜尋欄（上一筆／下一筆旁的代號定位欄）輸入英文原本寫死一律轉大寫；現改成與主鍵欄一致，依系統程式參數 22（代號是否區分大小寫）決定——設 Y 不轉換、其餘一律轉大寫。既有帳套參數 22 多為未設定或非 Y，行為不變。

• 手冊：基本畫面介紹「其他小規則」補參數說明；系統程式參數頁的「被全系統取用」表補 22 一列；共用控制項首頁欄位標籤節補主鍵欄轉大寫規則。

2026-09-05 中央授權檢查（登入／排程／自動化）

摘要

TsERP 登入成功後會向中央伺服器確認該公司的授權狀態與到期日；排程服務與自動化任務執行前也會確認。授權逾期超過寬限期、被暫停，或本機尚未設定授權金鑰時，無法登入。

變更

• 登入後多一次授權查詢（逾時 10 秒），連不上中央時改用本機上一次的授權紀錄，因此正常客戶離線也不受影響。

• 到期前 30 天起，登入後提示剩餘天數；逾期後 60 天寬限期內仍可使用並提示；超過寬限期擋登入。

• 授權預設為滾動模式：客戶端每次連上中央，到期日自動延到 90 天後；只有被中央改為暫停時才會擋。按年授權的客戶可改為固定到期日模式。

• 排程服務的 --update 子命令不受授權限制，其餘子命令與每輪排程受限制。

Breaking Changes

• 每台客戶端必須讀得到 API 金鑰，否則更新後無法登入。金鑰二擇一設定，發版前逐家確認：

- 該機的 %ProgramData%\TsERP\appsettings.local.json 的 ExternalDataApi:ApiKey（單機測試／臨時覆寫用，優先採用）；

- 或該帳套 _prgpar 的 LICENSE_APIKEY（項目 90101）——一個帳套設一次，全公司的客戶端都讀得到，幾百台不必逐台改檔。

Migration Notes

1. 中央庫跑 sql/license-central-schema-20260905.sql（建表、SP、授權給 YYAPI、種子既有客戶一年）。

2. Function App YYAPI 新增設定 LICENSE_SIGNING_KEY，並 push TSAPI master 部署新端點。

3. 逐家設定金鑰，再發 ERP 版：在客戶的每個帳套庫（darb<客戶>csa1、csa2…）跑 sql/prgpar-license-apikey-20260905.sql（腳本最上方先填入該客戶的金鑰；朝陽的 _prgpar.參數 只有 30 字，腳本會自動加寬到 200）。少數需要用別把金鑰的機器，另外在該機的 appsettings.local.json 填 ExternalDataApi:ApiKey（本機優先）。

4. 停用某客戶：改 extdata.api_client_license 的 狀態 為 suspended；恢復改回 active（滾動模式下下次心跳自動展期）。按年授權改 模式='fixed' 並填 到期日。範例語句在腳本第 6 節。

2026-09-05 工程資料明細表格「新增列」修復＋測試面板日期欄修正

使用者可見變動

• 工程代號表／BOM表／模具資料表（含朝陽 BOM 變體）的明細表格：右鍵「新增列」原本沒有反應（框架在表格未綁資料管理器時無聲跳過），現已補綁，可正常新增明細列。

• 測試控制面板（管理員功能）：日期欄改依控件身分產生測試日期，不再對字串型日期欄填入文字造成「請輸入正確的日期格式」。

影響檔案

• TsERP/D.Bom/Procnos.xaml、Bom.xaml、Mold.xaml、Bom_cy.xaml：明細 TsRadGridView 補 DataManager="{Binding DetailData…}"（8 張）。

• TsERP/TestAutomation/TestControlPanelWindow.xaml.cs：GenerateValue 加 forceDate（主檔 TsDateTextBoxV2／grid 日期欄）。

驗證

• 禾久 lab VM 測試面板實跑：工程代號表 2 張、BOM 表 2 張、模具 2 張明細 grid 皆「新增列 20→40」並填值成功；庫存主檔／模具資料表日期欄由假失敗轉為成功。

• 朝陽變體 Bom_cy 只驗建置（朝陽 lab 的測試選單需 ADMIN 帳號，待處理）。

2026-09-05 手冊：資料表格與欄位標籤的顏色說明

• 資料表格頁新增「顏色代表什麼」一節：欄位標題灰色＝不可編輯；資料列左側紅色指示條＝待刪除、深灰＝不可編輯；整列淡綠底＝選取中、整列紅底＝檢核未通過。

• 共用控制項首頁新增「欄位標籤的顏色」一節：紅＝必填、藍＝主鍵、灰＝系統產生、深綠＝唯讀、黑＝一般，附「你該怎麼做」欄。

• 兩頁互相連結；補拍截圖三張登記在各頁「需補截圖清單」。

2026-09-05 案例書：每篇加「章-序」編號，新案例接在章末

• 24 篇案例全部加上「章-序」編號（例：2-5 誰看得到誰的資料，用一張關係表講清楚），同時出現在左側導覽、各篇標題、首頁卡片與 PDF 目錄／內頁，四處一致。

• 編號規則：新案例一律接在該章最後、拿下一個序號，既有編號不重排——序號越大越新，看編號就分得出哪些是後來加的。

• 依此規則把〈自動化與流程〉章內兩篇後加的案例移到章末：2-5 誰看得到誰的資料（08-14 加）、2-6 主管派拜訪任務（09-03 加）。

• 修正〈誰看得到誰的資料〉一篇原本漏掛在導覽（左側看不到、PDF 也沒收進去）。

• 首頁卡片編號改由各卡片明寫（原為 CSS 自動計數），與導覽順序不會再各走各的。

• PDF 重新產出（tools/case-book-pdf/build.py 改為章-序編號）。

2026-09-04 測試控制面板：明細表格自動新增列填值；零號資料庫閘門改回只有零號庫能清資料

零號資料庫：只有零號庫可以清掉 SQL 資料（使用者裁決）

• 8 月 26 日為了讓 darbnogicsa1（禾久開發庫）也能跑三方對照，把它加進了 TestAutomation:ZeroDatabases，等於同時開放「全部執行」對它清表／匯入。今天改回：設定檔只留 darbnogicsa5、darbdemocsa1 兩個零號庫。

• 閘門多一道硬性規則：SourceDatabase（1 號庫、匯入樣本的來源）就算被列進零號庫清單也一律不通過，理由寫成「是 1 號庫（樣本來源），不得當零號庫清資料」。以後手改設定檔也開不回去。

• 不受影響的功能：「掃描欄位」「建立對照」「前置作業報告」「模擬輸入」「完整循環」都不走這道閘門，在任何帳套庫照常可用；只有「全部執行」（含步驟 1 清表、步驟 9 匯入）被擋。

• 同日追加（使用者裁決「一定要避免 darbnogicsa1～5 被 TRUNCATE 這種危險指令」）：零號庫改成命名鐵律——只有庫名以 csa0 結尾（darb<客戶>csa0）的庫才算零號庫。darbnogicsa1～csa5、csa_zt、加日期的備份庫、darbdemocsa1 不論設定檔怎麼寫都一律禁止清表／匯入；設定檔 ZeroDatabases 只能在 csa0 之內再縮小，現在只列 darbnogicsa0。

• 兩層都擋：閘門判定（「全部執行」按鈕）擋一次；真正送 SQL 的清表／匯入方法自己再查一次庫名，不合規直接丟例外、連線都不開。

• 目前伺服器上還沒有 darbnogicsa0，所以「全部執行」在任何環境都會被擋，直到建好零號庫（從 csa1 還原一份、加對應的 log 庫與登入環境）。

明細表格（RadGridView）要能自動新增值

• 以前掃描只認主檔區的輸入控件，單據下方的明細表格完全不在欄位清單裡，模擬輸入與完整循環從來不會碰明細。

• 現在掃描會把每張明細表格的可編輯欄逐欄列進欄位清單：欄位名稱顯示為「表格名稱.欄位」（表格沒有 x:Name 時用來源類別名），控件型別顯示 TsRadGridView欄，DB 欄與長度看該欄綁的來源屬性（品號Binding 這類前端包裝屬性會對到真欄位）；長度以零號庫的子表結構為準（多張子表都有同名欄時不猜）。

• 模擬輸入時，同一輪第一次碰到某張表格就自動新增一列（走的是表格自己「新增列」按鈕那條路，一次加一批列、測試值填第一列），之後該表格的各欄都寫進那一列；每輪重跑會再新增新的一列。

• 填值後回讀來源屬性比對，型別轉不過、setter 拒收、來源值沒變都如實記失敗；非增刪修模式下明細欄預設「略過」，表格關閉新增（CanAddNewRecords／CanUserInsertRows 關閉、非一般型、沒綁 DataManager）會在清單標「不可新增列」並在 log 說明。

• 完整循環：新增階段會連明細一起填；「修改」階段仍只改主檔的 3 個字串欄（明細不再加列）。規格自動測試步驟 4(5) 的結果多一段「子表 xxx=N 筆」佐證明細真的存進去。

• 已知限制：明細填值不經表格的儲存格編輯器，欄位的離開儲存格連動（帶品名、算金額）不會觸發，交給存檔驗證；主檔逐欄核對仍只對主表。

• 實機驗證（2026-09-04，Hyper-V lab VM LAB-NOGI-01、禾久庫、G 進貨單）：掃描列出 detailDataGrid 22 欄＋detail1DataGrid 10 欄；新增後模擬輸入 log「新增列：detailDataGrid 明細 20→40 列」「新增列：detail1DataGrid 明細 0→20 列」，明細 32 欄全部填值成功、0 失敗（主檔＋明細共 47 欄）；畫面上明細第 0021 列與費用表第一列看得到填入的值；按取消可正常離開編輯。觀察到費用表的幣別／匯率被程式自己的連動改回 TWD／1.0000，這是程式行為不是治具問題。

---

title: TAG出入庫單（工班領用）與總務進貨／出入庫單畫面調整

date: 2026-09-04

---

2026-09-04 TAG出入庫單（工班領用）與總務進貨／出入庫單畫面調整

新功能

• TAG出入庫單（C-081，GTRLIMA_TAG）：SH03A 水泥廠 TAG 專案的工班領用作業。變體自 C-08 G出入庫單，走 GD 總務調撥單：每個工班在 G倉庫表建成一個倉庫／儲位，匯入手持機 LOG 後每支 TAG 一列（品號 TAG01、數量 1、轉出倉儲＝單頭倉庫、轉入倉儲＝工班），單頭交易部門＝工班；一張單只對一個工班。存檔時批號依 TAG ID 對回進貨批，倉庫該批減、工班倉同批加。只在 TAG 庫登錄（sql/sh03a/sh03a-gtrlima-tag-register-20260904.sql＋觸發器補丁 sh03a-tag-patch-trgade-outbound-lot-20260904.sql）。

使用者可見變動（全帳套）

• 總務單據統一：G進貨單／TAG進貨單／G出入庫單／TAG出入庫單／G出貨單 倉單號欄 150、單號欄 120、倉庫欄 90、「前綴」／「前置碼」標籤改「單別」且下拉加寬（146）；G申請單「序號前置碼」標籤同改「單別」；G出入庫單／TAG出入庫單／G出貨單／G暫收單／G需求單 畫面拿掉「公司代碼」欄（值仍由新增預設 1 寫入，資料不變）。

• G出入庫單 新增預設單別 GD 總務調撥單、G進貨單／TAG進貨單 新增預設單別 RC 總務進貨單——只在該帳套交易事項表真的有該碼時才預設，沒有就維持空白讓使用者自選。

• G倉庫表（C-11）／倉庫表（H）：「數量查詢」按鈕改靠左。

• G出入庫單／TAG出入庫單 明細「交易別碼」改成下拉選單（還原 VFP grid 的 sqlcombo）：清單依單頭單別在交易事項表的「交易別選項」決定（例：GD 總務調撥單→SS；M1 車輛保養→M1～M5），單別改變時清單跟著換；選項空白時退預設交易別，都空白才列全部。舊單若有不在選項內的交易別碼仍會顯示。

• G出入庫單／TAG出入庫單 倉單號欄寬改成與 TAG進貨單相同（150）。

修正

• G出入庫單／TAG出入庫單 新增存檔後找不到自己（上下一筆顯示沒有資料）：新增時漏設單據別，存成空白被檢視表濾掉，已補預設「2」。

• 進出庫單「新增」後下方面板變空白：程式切到「動態查詢」頁籤，但各帳套沒設定 MoverecProcedure 導致該頁籤隱藏。現在依原設計接通：上下一筆時一併回傳本單品號的各倉儲／批號現有數量，「庫存查詢」頁籤顯示（依明細選到的品號過濾，新增時改品號會即時查），並提供「挑選」把倉儲與批號帶回明細。適用 G出入庫單／TAG出入庫單／G出貨單／G進貨單／TAG進貨單，以及庫存模組的領退料、生產入庫、進貨、出貨、委外五支。需部署 sql/stock-query-moverec-20260904.sql（兩支新 SP、_sheetno 設定、TWORK_MOVEREC 移除多餘的查庫存尾段、log 庫登錄）。

• 代號欄的搜尋視窗（例：轉入倉儲查倉儲）文字發糊：另開的彈窗沒有套主視窗的文字渲染設定，改在彈窗基底統一設定，所有搜尋／選取類彈窗一起變清晰。

• TAG進貨單／TAG出入庫單 匯入超過 20 支時，追加列的序號位數與框架預生列不一致（6 位 vs 4 位）導致排序錯亂，改為沿用程式的序號位數。

備註

• TAG 庫倉庫的「批號管制」不可設「是」：批號由存檔觸發器回填，設「是」會在存檔前被擋。

2026-09-04 生產計劃查詢：明細列加「收付條件號」與「預收日／預付日」

使用者可見變動

• 訂單、預示及預估 分頁加兩欄：收付條件號、預收日（放在「單價」之前）。

- 收付條件號：訂單與預估列取訂單單頭的收付條件（單頭沒設才退回客戶主檔）；預示列取客戶主檔。

- 預收日：依收付條件＋帳款起始日＋預訂交期推算出的到期日。

• 生產計畫 分頁加兩欄：收付條件號（客戶主檔）、預收日（基準日＝該列日期）。

• 使用量(機種別) 分頁加兩欄：收付條件號（廠商主檔）、預付日（基準日＝該列日期）。

• 條件查不到、算不出日期或該列沒有基準日時，欄位留白。

• 金流預測分頁的「計劃預測」層改為沿用明細列上的預收日／預付日（同一個到期日口徑，數字不變；差別在於現在畫面上追得到來源）。列上留白的才照舊退回以預訂交期／需求日期當現金日，並在備註標「(無條件設定)」。

• 載入歷史單時，這三欄會用當下的收付條件重新算一次填回畫面（不隨單存檔）。金流預測分頁維持原規則：載入歷史單不重算、清空並顯示提示。

部署

• 禾久：sql/prodplan-payterm-20260904-nogi.sql

• 朝陽：sql/prodplan-payterm-20260904-cy.sql

- ⚠️ 朝陽正式機若已有自訂版本的 TWORK_QRY_PRODUCTIONPLAN，先比對 OBJECT_DEFINITION 再補欄，不要直接覆蓋（本機開發庫 darbcycsa1 從來沒有這支 SP，該檔本體是照禾久版寫的）。

• 兩檔都是 ALTER（不存在時自動先建空殼），參數個數不變，proc_param 不用動。

• 跑法：sqlcmd -S <伺服器> -d <帳套庫> -E -f 65001 -i <檔案>；跑完實查 OBJECT_DEFINITION 含「收付條件號」。

不動

• 三張明細的實體表（twork_eis_productiond2/d3/d4）沒有加欄位，存生產計劃單時不寫這三欄。

• 金流預測分頁的欄位與圖表口徑不變（票據／帳款／在途採購三層完全沒動）。

• 獨立的「金流預測」程式（FLOWCAST）與「營運預測模擬」不受影響。

2026-09-04 BOM 查詢「Excel取品號」新增「取得範本」按鈕

摘要

用途表（BOM_PURP）、最低階用料（BOM_BOTM）、階層式製程表（BOM_HIER）與成本表（BOM_COST）的 Excel 品號清單查詢，原本只有「匯入」沒有「範本」，使用者要自己猜欄位順序（A=序號、B=客戶代號、C=客戶簡稱、D=客戶品號、E=品號、F=查詢數量）。本次在匯入鈕旁加一顆 取得範本，一鍵產出空白範本。

變更

• 四支條件面板新增 取得範本 按鈕：開存檔視窗（預設 C:\TEMPS\泛用取品號.xlsx，也可存 .xls），產出「標題列＋一筆示範資料」的空白範本，存完詢問是否立即開啟。示範列品號為 SAMPLE-001，填資料時覆蓋或刪除即可；沒改就直接匯入，示範列會被略過並提示「Excel 內無品號資料」。

• 範本欄序與匯入讀取邏輯共用同一份定義（SkuListExcel.TemplateHeaders），產出的檔案可直接由 Excel取品號 讀回（單元測試 SkuListExcelTemplateTests 往返驗證 .xlsx／.xls）。

• 多語言：Bom_purp / Bom_botm / Bom_hier / Bom_cost 四個翻譯檔補 取得範本 key；前三支同時補上 09-01 改版後漏補的 Excel取品號、取得的條件 兩個 key。

• Excel取品號 選檔視窗預設改 .xlsx（C:\TEMPS\泛用取品號.xlsx），.xls 仍可從篩選切換；取消選檔＝不匯入、不提示、條件不變（使用者裁決）。

• 自訂條件沒設定就不查（BOM_PURP／BOM_BOTM／BOM_HIER）：自訂條件模式下條件列全空就按查詢，原本會因條件空白退回「''～'zzz'」整個 BOM 全展開（朝陽跑 5 分鐘逾時）；現在改為以訊息框提示「尚未設定自訂條件」並不執行查詢；Excel 模式沒匯入就查同樣改成訊息框提示（不再走例外路徑）。

• 自訂條件改走標準瀏覽流程、先以該單據別取得預設條件：欄位清單與「預設條件」下拉改由本程式的單據別（如 BOM_PURP）＋瀏覽辨識碼 D 讀取自訂條件設定（twork_sys_zcond_field / zcond_category / zcond_define），有登錄就用登錄的欄位並在開窗時載入第一組預設條件；沒登錄（目前三支皆未登錄）則退回品號主檔 invent 欄位（排除與 bom_m 同名的稽核欄，避免 BOM_BOTM 的 SP JOIN 時欄名模稜兩可）、下拉顯示「Not Set」、條件列空白。要讓某支有預設條件，到自訂條件維護程式以該單據別登錄 invent 的欄位即可。提示不查時會清掉上一次的查詢結果。

Breaking Changes

• 無。

Migration Notes

• 無 DB 變更。

---

title: 帳戶存提查詢起始日期預設最近三個月的 1 號

date: 2026-09-04

---

2026-09-04 帳戶存提查詢起始日期預設最近三個月的 1 號

使用者可見變動

• 帳戶存提查詢（O 模組）：開啟時「立帳日期」起始日不再是空白（等於查全部歷史），改預設為今天往前推三個月那個月的 1 日（例：9 月 4 日開啟預設 6 月 1 日）；截止日維持本月底。要看更早的資料自行改起始日即可。與票據查詢類「最近三個月」的預設原則一致。

2026-09-03 總帳選單程式名稱對齊會計使用手冊

使用者可見變動

• 選單 N-11 SORT1：分類索引1 → 分類索引

• 選單 N-14 SLIYYEAR：傳票年度表 → 年度傳票

• 手冊 N 總帳：ABOOK2 頁名 分類索引帳 → 索引分類帳、ACC_SELFRPT 相關頁名 自訂財報 → 自定財報（與選單用詞一致）；功能清單「財務報表」改為損益表在前、資產負債表在後。

部署

• sql/n-menu-rename-20260903.sql（改 _menum/_menud 兩表，冪等；@庫清單 換成該機帳套庫名）。

• 改完要重新登入 ERP 才看得到新選單名稱。

不動

• 報表抬頭仍為「傳票年度表」（N140-1）與「分類索引帳」（N100-4），為報表名稱非程式名稱。

2026-09-03 使用手冊網站移除第三方元件品牌名

使用者可見變動

• 手冊 22 頁的「Telerik 內建匯出」「Telerik 資料表格」「RadGridView／RadDiagram／RadCartesianChart／RadWindow」等字樣，一律改為「資料表格」「流程圖」「折線圖」「視窗」等中性用語；產品簡介的技術棧改寫為「.NET 8 + WPF」「WPF + Material Design」。

• docs/decisions/（ADR）與 docs/changelog/ 改以 mkdocs.yml 的 exclude_docs 排除，不再建進手冊網站，站內搜尋也搜不到。檔案仍保留在 repo 供開發者閱讀。

• 手冊頁面原本連到 ADR／changelog 的 21 個連結（10 頁）改為純文字「ADR 00NN」，不再是超連結。

驗證

• mkdocs build --strict 通過；輸出目錄無 decisions／changelog；全站 grep「telerik」0 檔。

2026-09-03 帳款／票據報表第三輪逐張實機與三處修正

使用者可見變動

• 瀏覽列印自動全選：主檔型程式（銀行帳戶、應收票據、應付票據、廠商帳戶表、預估資金表等）按列印進到瀏覽頁、按查詢載入後，會自動勾選全部資料再列印。先前只有在資料庫報表登錄表有列時才會自動勾選，新版報表登錄改寫在程式裡後這條永遠不成立，使用者按預覽一律得到「沒資料」。

• 客戶應收查詢／廠商應付查詢：查詢還沒跑完（或還沒查）就按報表預覽，改顯示標準「沒資料」，不再跳「Error Report Handle: Object reference not set」。

• 費用申請（朝陽等客戶庫）：選單「費用申請」可以正常開啟。客戶庫選單登的是舊鍵 PAYAPPLY，程式鍵維持 PAYAPPLY_KC，登入時自動改寫，不必改客戶資料庫。

資料庫（朝陽）

• sql/cy-rec-qry0-sync-20260903.sql：朝陽的 DARB_QRY_REC_QRY0 同步成禾久版（三個結果集）。朝陽舊版只回兩個結果集，客戶應收查詢查不出資料、年度應收統計表印不出。dev 模擬庫已套，正式機待部署批。

2026-09-03 帳款／票據報表小裁決落地

• CHKRECQRY 應收票據查詢：排序預設由「收付款日期」改為「到期日」，對齊 VFP chkrecqry 開窗預設（報表種類=3）。CHKPAYQRY 應付票據查詢維持「收付款日期」。

• BANKFXR 銀行往來：O140-2「銀行餘額表」（Bankfxr1）改為朝陽專屬——禾久版 SP 不回傳銀行名稱／本幣小計，在禾久會印成銀行名稱空白、％全 0 的半殘表，故不列入禾久報表清單。

• PAYMNTPQ 應付列印：舊 7 張（Apprint1／1local／2／2local／3／3_cy／4）由標楷體改細明體 house style（標題 14pt 粗體、內文 9pt），列印資訊統一為右上「列印日期／列印人員／第 x 頁 / 共 y 頁」（FastReport repo）。

• 裁決「維持現狀」：Arsummarycy 上期結欠／Ardetailtick 上期未收印 0、Checkrecqry3 未兌現填實值——口徑不再更動。

2026-09-03 客戶端安裝腳本：安裝檔改本機執行＋一併安裝 ASP.NET Core Runtime

適用：deploy/install-customer.ps1（GPO／手動佈署 TsERP 到客戶機器）。

變更

1. 安裝檔一律先複製到本機再執行（%TEMP%\TsERP-install\）。之前直接從網路分享（尤其 \\<IP>\deploy）啟動 .NET Runtime、SQLite ODBC、TsERP Setup 時，Windows 會跳出看不見的「開啟檔案 - 安全性警告」，整個安裝流程停住不動。

2. -InstallDotnetRuntime 現在同時安裝 .NET Desktop Runtime 與 ASP.NET Core Runtime。佈署包（-Source）要放兩支同版安裝檔：windowsdesktop-runtime-8.0.x-win-x64.exe 與 aspnetcore-runtime-8.0.x-win-x64.exe。只放 Desktop 時 Setup 會自己上網抓「最新」的 ASP.NET Core，版本一不同步程式就開不起來（訊息「必須安裝或更新 .NET」），安裝也會多等 30 秒才結束。

對使用者的影響

• 全新機器從零安裝：Config 階段約 10 秒、Install 階段約 10 秒，裝完直接可開。

• 已裝好的機器不受影響；重跑腳本會偵測到 runtime 已存在而跳過。

驗證

Hyper-V 全新 Windows 11 25H2（繁中）虛擬機從零跑完整鏈：設定→runtime→靜默安裝→開程式→登入→開五支程式，全部通過。

2026-09-03 帳款單據（rp_m／rp_d／rpsht_m）兩庫聯集——朝陽載入炸債結案

背景：朝陽（CY）帳套的 rp_m 多了進口採購／報關 8 欄，程式端 Source 沒有 → 應付／應收帳款、對帳單導覽到真資料即 SQL logic error: table … has no column named …（memory i-module-cy-load-crash-20260810）。依 ADR-0050 兩庫聯集模式補齊（skill dual-db-union-sync）。

• Twork_arp_vw_rp_m：Model＋Source 補 invoice_no／inv_date／due_date／inv_amount／報單號碼／快遞號碼／報單日期／報關金額（base table 欄，走上傳）；Source 另補 view-only 收付款日期（TsSkipCheck，不上傳）。

• Twork_arp_vw_rp_d：補 原單價。

• Twork_arp_vw_rpsht_m：補 view-only 廠付款條件。

• 朝陽 view 落後 4 欄：新增部署腳本 sql/cy-rpsht-view-backfill-20260903.sql（vw_rpsht_m.建檔日期、vw_rpsht_d.分類索引4／單別3／單號3）；dev darbcycsa1 已跑並實查 4/4，正式機併入部署批。

• 裁決不動：禾久 view 多出的 18 欄（部門名稱／客戶簡稱 等）在朝陽接受空白；客付款條件 兩庫語意不同（禾久＝付款條件代號、朝陽＝條件說明）維持各自原樣。

• 使用者可見變化：朝陽帳套 PAYMNT／RECEIVE／RSHEET／PSHEET 導覽真資料不再彈 SQL logic error；禾久無變化。

同日 runtime 走訪連帶修正（朝陽 dev 逐張預覽 PAYMNT 5/5、RECEIVE 3/3、PSHEET 3/3、RSHEET 5/5）

• 應付帳款單 Paymnt1／Paymnt5（朝陽）「Error Report Handle: String cannot be converted to Int16」：朝陽 rp_d.單價別 是 nvarchar(30)、禾久是 tinyint，報表 POCO Rpt_I010_ApReportPoco.單價別 宣告 short，DataTableToList 直接 SetValue 不轉型即炸。改 string（frx 未印此欄；Paymnt1-4.frx 的 Column DataType 同步改 String）。

• 收款單 Rsheet1 頁首「收款日期」恆空白、「匯率」恆 0.00（兩帳套都中、自移植以來）：插件 Rsheet1.cs 組明細列時從沒回填主檔的 收付款日期／匯率，補上。同張明細列 DataBand 加 CanGrow，長科目名稱折行不再被裁半截。

• 銷貨退回暨折讓單 Receive2／電子發票折讓單 Paymnt4 發票日期空白時整張印不出：ToInt32(Substring(發票日期,0,4))-1911 改 C# 三元守空值（report-layout 必死清單 #20 模式）。

• 治具：c-print-e2e.ps1 加 -PrintQuery（RSHEET／PSHEET 型列印頁要先按「查詢」勾主檔才有資料；之前跑出的「沒資料」×5 是治具沒按查詢，非缺陷）。

2026-09-03 案例書新增〈主管派拜訪任務，業務在拜訪單一鍵回報〉

案例書「自動化與流程」章節新增第 24 篇，把 2026-08-28 上線的拜訪任務回報（排程事件派工 → 行事曆 → 拜訪單相關任務分頁回報 → 主管待辦）寫成行銷案例。

使用者可見變動

• 新頁 docs/case-studies/visit-task-report.md：場景（口頭交代與 Excel 追蹤表兩邊對不上）、現況（任務排進行事曆、從拜訪單按回報）、實際跑一遍（課長派工 5 步＋業務回報 5 步）、四則提示（待辦內容即拜訪單／負責人填下屬／每月預設展開五年／行事曆 新增事件）、效益表。重要度 ★★★★☆、更新日期 2026-08。

• 首頁卡片、資料夾導覽（.nav.yml）與整本 PDF 目錄（tools/docs-pdf/manifests/case-studies.json）同步加入，排在〈單據線上送簽〉之後。

• 三張圖皆為實機截圖（Hyper-V lab VM LAB-DEMO-01 連 DEMO 展示庫，UIA 腳本走完整條流程後截取）：images/visit-task-assign.png（新增事件視窗）、images/visit-task-report.png（拜訪單相關任務分頁＋事件進度回報視窗＋右側行事曆）、images/visit-task-reported.png（回報後的已回報列）。去識別化：DEMO 庫登入者姓名改「王志明」、業務員姓名與角落公司簡稱以影像後製改為「林佳蓉」／「岩月」。

• 整本案例書 PDF（assets/Darbware-ERP-case-book.pdf）重出。

不寫進案例的內容（刻意）

• 行事曆事件卡 開單（從事件直接開拜訪單）與 Line 通知：尚未提供。

• 拜訪行程規劃（地圖／路線／過路費）：程式已入庫但 runtime 未驗，暫不入案例。

2026-09-01 測試控制面板認得代號查詢控件；總務單據標籤去冒號、日期欄寬度回歸樣式

測試控制面板：廠商代號／收付條件／稅別這類欄位掃得到了

• 廠商代號、收付條件、稅別、客戶代號、部門、科目、群組、專案、業務員、銀行帳號等「代號查詢」控件（VendorSearch／PaymentTermSearch／TaxTypeSearch／CustomerSearch／DeptSearch／GLAccountSearch／GroupSearch／ProjectSearch／SalesRepSearch／BankAccountSearch）以前掃描時只抓到控件內層的文字框，來源被解成控件自己的 Code，欄位清單看不到正確欄名，三方對照也把這些 DB 欄誤報成「無UI」（總務進貨單 GTRRAMA 實測）。

• 現在掃描直接認得整個控件：欄位清單顯示綁定的來源屬性（如 廠商代號Binding／收付條件號／稅別）、控件種類顯示 VendorSearch 等；三方對照能對到 DB 欄。

• 模擬輸入／完整循環對這類欄位的填值直接寫進控件的代號值（不經內層文字框，避免查無代號時彈出訊息框卡住整輪），所以「帶簡稱」不會觸發、代號是否存在交給存檔驗證。自產值仍是「欄名.長度」格式，欄位清單備註會提醒「存檔前請改填存在的代號」（既有限制不變）。

• 綁 XXXBinding 前端包裝屬性的欄位（如 廠商代號Binding），欄位清單的「DB欄」與零號庫逐欄核對現在會對到真欄位 廠商代號，不再固定回「資料表無此欄」。

• 「前綴」等下拉型代號控件（TsDocumentPrefix／TsFinanceType／TsCobLanguage）同樣改在外層辨識：欄位清單顯示綁定的來源屬性（如 序號前置碼）與控件種類，測試值取下拉清單第一個選項（清單為空時標「無可選項，不支援設值」），填值只挑清單內存在的值。

• 填值後多一道「回讀比對」：把來源屬性的值讀回來與測試值比（字串不分大小寫、日期比到日、數字比數值），不符就記「來源值未更新」而不是成功——避免 binding 沒開 ValidatesOnExceptions 時存檔驗證擋下卻記成填值成功。

• 實機驗證（2026-09-01，GTRRAMA 三方對照報告修前→修後）：廠商代號／收付條件號／稅別／序號前置碼 由「無UI」→「三方齊」；整張表 三方齊 64→68、無UI 28→24、UI無來源 9→1、問題 42→38。

• 畫面上直接放的代號查詢文字框（TsSearchTextBox）在模擬輸入填值當下暫時不做「資料不存在」檢查（填完即還原），不會再因自產代號查無而跳出訊息框卡住整輪。

全系統欄位標籤去掉冒號（含總務四支）

• 使用者裁決：標籤一律不帶冒號（半形「:」與全形「：」都算）。本次機械式清掉 45 支 XAML、465 個 DisplayMeta[…:] 標籤鍵（含 FallbackValue 的冒號），涵蓋總務（GTRRAMA／GPURCH／GTRLIMA／GPPURCH）、發票 P 模組全系（Tick401／Ticka／Ticks／Tickr…）、帳款（Arclaim／Rfe／Rpdef）、生產（Wkday／Pdtinf／Wkpaper）、品管（Purama／Twrama／Wkrama）等。

• 多語言翻譯檔 Common/Lang/Xaml/*.json 同步改鍵：52 檔、485 個鍵去冒號改名、34 個已有無冒號版的重複鍵刪除，各語言譯文尾端冒號一併拿掉；改前有翻譯的鍵改後全部仍查得到（0 流失），切換語言不受影響。

• 只動 DisplayMeta[…] 標籤鍵；表格欄位標題（grid Header）不在範圍內。

• 寫死字串的標籤（Content="xxx:"／Text="xxx:"）另掃 405 處：192 處在 XML 註解內不動、7 處純符號分隔（時間 : 等）保留、其餘 206 處／14 支去掉冒號——這 14 支全是無畫面引用的舊檔（Invent_zd、Payapply_zd、Trrama_zd…）、TsControl 內容控件與測試面板本身，沒有可到達畫面需要再包多語言。

總務報價單（GSPPDT）：活動起始日／活動截止日寬度回歸控件預設

• 這兩個日期欄原本寫死 Width=120，蓋掉了日期控件依格式自動給寬的機制；已移除，寬度與其他日期欄一致（短日期 90）。

2026-09-01 TAG 專屬進貨單（TAG進貨單／GTRRAMA_TAG）：匯入TAG 按鈕移到畫面上

新程式：TAG進貨單（C.總務管理 → C-071）

• SH03A 水泥廠 TAG 標籤追蹤系統新增一支專屬的總務進貨單 TAG進貨單（程式鍵 GTRRAMA_TAG），畫面與存檔規則沿用 G進貨單（GTRRAMA），差異只有兩處：

1. 主檔區右上角多一顆「匯入TAG」按鈕——手持機 LOG（CSV）匯入 TAG 明細，一列一支 TAG，一張進貨單＝一個批次。按鈕只在按下「新增」後可按（使用者裁決：一張新進貨單＝一個 TAG 批次；修改既有單據不開放匯入）。

2. 明細表格把 TAG ID（原「其他資料1」）、手持機（原「其他資料2」）、批號別、批號 四欄移到「品名」後面，TAG 唯一碼一開單就看得到（原本排在第 25 欄之後）。

• 原本掛在 G進貨單「其他功能 → 匯入TAG」的擴充鈕已拿掉（TAG 庫的權限表本來就沒設這顆，從未出現過）；G進貨單本身行為不變。

• 登錄方式：直接登進 TAG 庫的 _menum／_menud／_sheetno／prgsct1／瀏覽條件設定（複製 GTRRAMA 的列改鍵），不走登入時的程式分流；部署腳本 sql/sh03a/sh03a-gtrrama-tag-register-20260901.sql（含還原腳本），只有 TAG 庫需要。

• TAG 版的擴充鈕（採購轉單／送修轉入／工作流程／快速審核）一律不開放。

順帶修掉的母版問題（L4 實測抓到）

• 前綴（序號前置碼）下拉一直是空的：總務進貨單／出入庫單／出貨單與庫存的進貨／領料／生產／出貨／委外單，新增時前綴下拉都沒有選項，新單被「請輸入[序號前置碼]」擋住存不了。根因是程式拿程式鍵去比對交易事項表的「單據別」，但該欄存的是「1.總務進貨」「A.進貨」這種群組名（VFP 的 d_單據別）。現在改成程式鍵→群組對照（總務三支對 1/2/3，庫存五支照 VFP 原始碼對 A~E），前綴與交易別下拉都會正確列出。已直接登程式鍵的資料庫不受影響（等值比對優先）。

• 匯入 TAG 的明細序號從 000001 起：新增時框架會先預生 20 列空白列，匯入改成先填這些空白列、填完才追加，不再從 000021 起跳。

• G進貨單新增時漏設「單據別＝1」：存出的單在進貨單 view（只看單據別 1）裡找不到自己，存檔後單頭停在「+++」、要重開才看得到；已在新增預設值補上（出貨單本來就有設 3）。

• TAG 庫的配批號程序原本拿「轉入單pkid」當批號（那是採購轉單來源，匯入 TAG 的列恆為 0，永遠配不到）；改為單頭 pkid（sql/sh03a/sh03a-tag-patch-trgade-lot-20260901.sql，只有 TAG 庫）。

• 前綴／公司代碼／語言版本三種下拉（2026-09-02 使用者裁決）改成與傳票「傳票種類」下拉同款：單一下拉直接顯示「代號:名稱」、寬度隨內容，拿掉舊的自訂項目樣式與旁邊的說明文字框。舊樣式有兩個毛病：選定後收合框顯示「…」；且樣式宣告的控件型別不對，清單一有項目、一展開就跳「系統錯誤」視窗（語言版本／公司代碼下拉是潛雷，前綴修好後才引爆）。

• 匯入列的 linkid 在存檔前由存檔邏輯統一接到主檔（自製產生列不走 grid 標準新增，原本存進資料庫變孤兒、重載後消失、也配不到批號）。

驗證

• 建置 0 error；HarnessSmokeTests＋ProgramClassRouterTests 62/62 通過；部署腳本在 darbtagcsa1 冪等與從零單趟皆 7/7 OK。

• L4 runtime（三輪 UIA 實測，.claude/tmp/gtrrama-tag-l4-report.md）：開窗、新增後才可按、前綴 RC/RD/MG、匯入 5 支（重複略過 1）、序號 0001–0005、存檔回填倉單號、DB 明細 linkid／批號別 TG／批號＝單頭 pkid／單據別 1、重開載回 5 列、母版 G進貨單無回歸——全部通過。未驗：庫存按批次累進（測試庫 ginvstk 無資料）。

2026-09-01 總務查價（廠商比價表）補回：新建 SP `TWORK_BIZ_GSPPDT`

• 總務請購單（GREQMA／GPPURCH）、總務採購單（GPURCH）、廠商報價（GSPPDT）的「查價／廠商比價表」原本在任何帳套都是整排空白、沒有錯誤：程式端派發的 SP TWORK_BIZ_GSPPDT 從來只存在於英文 schema 帳套，中文帳套（禾久／朝陽）沒有這支 SP、派發器也沒登錄，查詢被靜默略過。

• 現在新建中文版 TWORK_BIZ_GSPPDT（sql/twork-biz-gsppdt-20260901-ssms.sql，執行器 -run.ps1）：形狀照採購模組同功能 DARB_BIZ_SPPDT，回兩個結果集——採購單歷史（gpurchm/gpurch）與廠商報價（gsppdma/gsppdt，只取已審核）。查詢別 1＝各廠商最新一筆（報價另依活動起迄日包含查詢日者優先）；查詢別 2＝同一廠商各取最新 20 筆。

• 比價表欄位對齊採購模組：報價類型／廠商代號／廠商簡稱／廠商品號／品號／單號（新增）／報價日期／幣別／單價／傳回／單位／數量（新增）／最低採購量／備註；原「生效日期」欄拿掉（中文帳套報價明細沒有此欄）。來源類別文字由 1.Purchasing／2.Quotation 改為 1.採購／2.報價（系統參數 6006 依前綴挑價來源的行為不變）。

• 部署：每個帳套跑 sql/twork-biz-gsppdt-20260901-run.ps1 -Csa <csa庫> -Log <log庫>（csa 建 SP＋log 登錄 proc_param param_qty=4）；未跑前比價表維持空白（不炸）。dev 禾久／朝陽與正式機皆已部署（2026-09-01）。

同日：比價表「單號」可點（總務＋採購兩張）

• 總務（GREQMA／GPPURCH／GPURCH／GSPPDT）與採購（PPURCH／PURCH／SPPDT）的比價表，「單號」欄變成藍字底線超連結，單擊依該列「報價類型」分流：1.採購 開對應採購單（總務→G採購單、採購→採購單）、2.報價 開對應廠商報價（總務→G廠商報價、採購→廠商報價）。右側「歷史單價」頁與下方比價表都有。

• 跳轉後按左下「返回」回到原來那張單（例：G廠商報價 SG2600002 → 點 PN2600004 開 G採購單 → 返回回到 SG2600002）。⚠️ 已知限制：來源與目標是同一支程式時（在 G採購單裡點另一張採購單號），「返回」回不到原單——這是框架同程式切頁不推歷史的既有行為，非本次新增。

• 沒權限開目標程式時點下去會出訊息；解不出目標的列維持一般文字（不會出現點不動的藍字）。

• 品號欄同樣是超連結：總務比價表開 G庫存主檔、採購比價表開庫存主檔，返回回原單。品號／單號欄加寬（140／120），不再截字。

2026-08-31 測試控制面板：前置作業報告與三方對照合併成一份

• 規格自動測試的「① 前置作業報告」與三方對照的「匯出 HTML」原本各出一個檔（<程式>-前置作業-<時戳>.html、<程式>-trisource.html），現在合併成一份 C:\temps\TestAutomation\<程式>-前置作業.html（一支程式一份、只留最新，列印日期在報告內）。

• 報告段落：一、主資料表及相關聯之資料表 → 二、資料結構及索引 → 三、三方對照（SQL 欄位／本地類別／畫面 UI） → 四、VFP 專案程式內容。三方對照的「VFP 驗證」欄直接跳到同一份報告第四段的程式碼錨點，不再跨檔連結。

• 三處入口都出同一種檔：規格分頁「① 前置作業報告」（會先建立對照再出檔）、「▶ 全部執行」的步驟 0、三方對照分頁的「匯出報告（併入前置作業報告）」。

• 尚未建立對照時報告照出，第三段只寫一句提示；前置作業步驟結果有問題筆數時記「人工」（同步驟 0 的口徑）。

同日：自動測試值改成「欄名＋點＋長度」

• 掃描欄位時字串欄的自動測試值不再是「測試HHmmss」，改為欄位名稱＋「.」補滿＋欄位長度，剛好填滿欄位：備註 nvarchar(5) → 備註..5、客戶名稱 nvarchar(10) → 客戶名稱....10；Memo 欄用「Memo字數」設定；長度未知時只填欄名。

• 規格自動測試的「輸滿欄位長度」與修改階段同一格式（修改值＝改備註.5，仍維持長度）。

• 重掃只帶回使用者親手改過的值，沒改過的自動值會依零號庫實際欄長重算。

2026-08-30 G庫存主檔分頁改版＋瀏覽表格版型存檔修復

G庫存主檔（GINVENT）分頁改成與庫存主檔（INVENT）相同的動態分頁

• 「基本」分頁抽成獨立畫面 GinventTab1，右側「自定義」分類改成與 INVENT 相同的群組框版面（上緣對齊主檔欄位、「分類內容」改為下拉欄可直接選群組定義的內容）。

• 「統計」分頁改共用 INVENT 的統計畫面：按鈕由「顯示」改為「檢視」、數值加千分位。

- ⚠️ 目前 twork_sys_statistics_definition 只有 CUSTOMER／INVENT_BS／SPDATA 三種分類的定義，沒有 GINVENT，所以 G庫存主檔 的統計分頁目前是空清單（改版前也是空的）。要不要補 GINVENT 的統計定義待裁決。

• 切分頁時不再在除錯輸出洗版 System.Windows.Data Error: 23/7（原因：VM 的 TabSelectedItem 型別與畫面的靜態分頁不合，切分頁也一直觸發不了查詢分頁的自動查詢）。

• 編輯狀態下統計／出貨／廠商報價／採購／進貨分頁會一併停用並跳回「基本」，行為與 INVENT 一致。

瀏覽表格（查詢畫面的資料表格）版型從來存不起來——已修

• 症狀：查詢類畫面（如 G庫存主檔 的廠商報價分頁、各瀏覽視窗）的表格欄寬／欄序／隱藏，切畫面後不保留；右鍵「記憶格式」也存不成功（DebugLog：SaveSessionFormat failed for GSPPDTbrow: Type: TsControl.QueryTemplate.InventQuery is not included in the AllowedTypes collection）。

• 根因：Telerik 版型序列化的自訂屬性提供者只登錄在基底表格型別，瀏覽用的衍生表格型別解析不到，退回預設序列化 200 多條屬性而中斷。

• 修法：表格建構時以實際型別自我登錄；已加 smoke test 守門。

G庫存主檔 統計分頁補上 GINVENT 定義（同日第二批）

• 新增子程序 TWORK_STATISTIC_GINVENT 與 8 列定義（sql/ginvent-statistics-definition-20260830.sql，可重跑、SQL 2008 可跑）：

最新報價單價／最新未結案採購單／最新進貨單號／最新進貨單價／本月・本年・去年進貨額／最新出貨單號。

資料來源是 G 系列表（gsppdma/gsppdt、gpurchm/gpurch、trgama/trgade）。

• 與 INVENT 的差異：G 版「最新報價單價」不限已審核（禾久 gsppdma 67 筆只有 2 筆已審核）。

• 同時修好 G庫存主檔 三個查詢分頁「按查詢永遠空白、沒有任何錯誤訊息」的一串既有缺口（每一條都實測過）：

1. 出貨／進貨分頁指向不存在的 DARB_BD_TRGAMA → 改 DARB_BD_GTRSADE／DARB_BD_GTRRADE，並登錄到 twork_sys_viewlist（dispatcher 沒登錄就回空）。

2. 出貨／進貨分頁的程式類別 TRGAMA 不是真程式（權限表零使用者）→ 沒瀏覽權限、查詢一開頭就跳出；改 GTRSAMA／GTRRAMA。

3. 交易別碼清單為空（禾久 tritem1 沒有 RA-/SA- 分類）時字串切割丟例外 → 補製造版本來就有的 if (tri.Any()) 守衛。

4. G 的瀏覽 proc 是 inline join，條件欄位 品號／廠商代號／客戶代號 與 pkid_m 不加別名會「模稜兩可」／「無效欄名」→ GA 條件全部加別名；統計「檢視」條件改 a.pkid／A.pkid。

5. 廠商報價分頁原本查的是製造版 sppdt → 改走 DARB_BD_GSPPDT（gsppdma/gsppdt）。

• 分頁順序改為 基本／統計／廠商報價／採購／進貨／出貨；右上 pkid／已審核 面板改走框架擴充面板（統計等分頁會收合，與 INVENT 一致）。

• 已部署：開發機 darbnogicsa1、darbcycsa1（朝陽模擬庫另補跑 08-12 的父程序腳本才有 NavigatePkid 欄）。正式機待跑。

統計分頁「內容」欄的數值列看起來空白——已修（INVENT／G庫存主檔 共用畫面）

• 症狀：統計分頁的單價／金額列看似沒有值，單號列正常。

• 根因：InventStatistics.xaml 左側面板最寬 300px，「內容」欄自動撐到 238px 後，靠右對齊的數字全排到可視區外（要拉水平捲軸才看得到）；靠左的單號從欄首開始所以看得到。不是權限問題（實查 CMSA 對 G 程式的可否看單價本來就是 1）。

• 修法：面板放寬到 480px、「內容」欄上限 240px。

G庫存主檔 查詢分頁／統計「檢視」改走新的 TWORK_BD_G* 瀏覽程序（全部用 pkid_m）

• 新增 TWORK_BD_GSPPDT／TWORK_BD_GPURCH／TWORK_BD_GTRRADE／TWORK_BD_GTRSADE（sql/ginvent-query-procs-twork-20260830.sql）：內容包成子查詢再接條件，

pkid_m／pkid 與不加別名的欄位都能用；進貨那支直接用基礎表（朝陽沒有 vwbd_gtrrade 也能跑）。原 DARB_BD_G* 不動。

• 登錄：twork_sys_viewlist（查詢分頁 dispatcher）與 _sheetno.QueryProcedure（GSPPDT／GPURCH 由 DARB_BD_G* 改指新程序，GTRRAMA／GTRSAMA 原本空白）。

• 統計「檢視」條件統一 pkid_m=…（與 INVENT 一致）；程式端 GA 條件的別名全部拿掉。

• 執行順序：先 ginvent-statistics-definition-20260830.sql，再本檔（本檔會重寫 TWORK_STATISTIC_GINVENT）。正式機待跑。

2026-08-28 拜訪任務回報（第一批）：排程事件派任務、拜訪單回報

主管在「排程事件（專案）」派「客戶拜訪」任務給下屬，下屬拜訪完在「拜訪單」回寫進度並通知主管，主管點待辦直接開啟該張拜訪單。

!!! note "最終樣貌以本頁最後一節為準"

當天依使用者回饋改版四次。回報入口最後定案在拜訪單下方面板「相關任務」分頁的 回報 鈕（不是工具列按鈕），詳見文末下午第三補與下午第四補。以下先記錄當初的第一批內容；文中的「來源任務」分頁與 已關聯 狀態均為當時名稱，現已改為 相關任務 與 已回報。

使用者可見變動

排程事件（專案）EVENTPROJECT

• 新增事件範本視窗（批次新增 用，右側行事曆的 新增事件 也是同一個視窗）的「明細」群組最下方多兩個欄位：

- 任務類型：下拉，選項來自新設定表 twork_sys_tasktype（禾久種子一筆「客戶拜訪」）。選定後自動把 單據別 填成對應程式（客戶拜訪 → VISIT），並把 對象 欄切換成該類型的查詢窗（客戶拜訪 → 客戶主檔）。

- 對象：代號查詢欄（可打 [ ] ? 開窗），右側唯讀顯示「代號 名稱」；離開欄位後把代號換成內部識別存進事件的 對象id。

• 任務類型與「自動化參數」的執行項目互斥：選任務類型會清掉執行項目與自動執行；選執行項目會清掉任務類型與對象。

• 明細資料表格多兩欄：任務類型、對象（顯示反查後的名稱）。

拜訪單 VISIT

• 下方面板新增 來源任務 分頁：列出這張拜訪單已關聯的排程事件（狀態 已關聯），以及登入者名下尚未回報、單據別為 VISIT 的任務（對象與本單受訪客戶相同者標 同客戶）。欄位：導航（跳到該事件所屬專案）／狀態／預定時間／說明／任務類型／對象／進度／已完成／專案。換筆自動重撈。

• 其他功能新增 回報任務（在既有的 查詢 旁，權限的其他2）。只能在瀏覽狀態、已存檔的拜訪單上使用，編輯中或新單會提示。

• 回報拜訪任務視窗：上半為候選任務清單，依「已關聯 → 同客戶 → 預定時間離拜訪日期最近」排序，第一筆為系統建議且預設已選；下半為 進度（預設 100）、標記完成（預設勾）、通知人員（預設帶專案負責人，有 負責人 鈕可重帶）、通知方式（預設待辦事項）、內容（預設「(今天) 已完成拜訪 客戶代號 客戶簡稱，詳見拜訪單 單號。」，可改）。

• 按 回報 依序執行：寫進度／通知人員到事件（進度 ≥ 100 會標完成）→ 勾了標記完成則標完成（完成時間由系統寫）→ 有通知人員就開一筆待辦，待辦掛在這張拜訪單上，主管點待辦直接開拜訪單 → 拜訪單記住來源事件。

修正

• 行事曆事件卡 報告 按鈕的進度與通知人員先前從未寫進資料庫，已修正。

• 下方面板「其他查詢」分頁現在會顯示各自真正的名稱。

資料表變更

物件	變更

twork_sys_tasktype	新增設定表：任務類型清單（禾久種子一筆「客戶拜訪」）

排程事件明細	新增 任務類型、對象id 欄位

拜訪單	新增 來源事件id 欄位（使用者看不到，供「來源任務」分頁判斷已關聯）

部署

腳本	對象

sql/visit-task-report-nogi-20260828.sql	禾久各帳套（事件端 + 拜訪單端）

sql/visit-task-report-cy-eventpart-20260828.sql	朝陽只跑事件端（朝陽沒有拜訪單）

• 權限：腳本已把 VISIT 的其他1說明＝查詢、其他2說明＝回報任務、可否其他2＝1 設好，不需手動調整。

Breaking Changes

無。既有事件與拜訪單不受影響：沒有任務類型的事件行為完全不變，回報任務 是新增的功能鈕。

尚未提供（第二批）

• ~~拜訪單的工作流程送簽。~~ → 同日的工作流程視窗改版已讓沒有樣板的單據（含拜訪單）用 自訂流程 送簽。

• 行事曆事件卡的 開單（從事件直接開拜訪單）。

相關文件

• 排程事件（專案）→ 操作範例：派拜訪任務給下屬

• 拜訪單 → 回報拜訪任務

• 右側行事曆面板 → 用 報告 回報進度

2026-08-28 下午補記（UIA 實機驗證後）

• 整條流程已在禾久模擬環境以 UIA 腳本實機走完（派工→事件 grid→拜訪單→回報→待辦→來源任務分頁顯示「已關聯」）。

• 拜訪單資料表另加五個工作流程欄（聯絡單id／工作流程／審核人員／審核日期／已審核）：任何被待辦指到的單據，系統都會回寫這五欄（非簽核流程「已審核」寫空白，不會鎖單），缺欄會讓「回報任務」開不了待辦。vw_visit 同步帶出這些欄位（ALTER VIEW，原有授權保留）。

• 順帶修正：行事曆事件卡「報告」按鈕以前連待辦都開不出來（程式錯誤），已修。

下午第二補（使用者實機回饋）

• 回報視窗：「內容」改成真正的多行框（原本是一條浮在中間的單行框）；「標記完成」移到最前面，勾了進度自動 100、進度改到 100 以下自動取消勾選；「負責人」鈕加寬不再截字。

• 右側行事曆事件卡：四顆鈕改為「導航／報告」上列、「附件／執行」下列（執行與報告換位）。

下午第三補（依使用者回饋改版）

本次把回報入口從工具列移進分頁，並讓拜訪單與行事曆共用同一個回報視窗：

1. 拜訪單工具列不再有 回報任務 延伸功能鈕（其他功能2 已移除），VISIT 權限的可否其他2不必再開啟。

2. 回報改在「來源任務」分頁裡按 回報：分頁第一欄由原本的 導航 改名為 回報，每一列一顆鈕；按下開啟的是與行事曆事件卡 報告 同一個視窗——標題「事件進度回報」，欄位為項目進度／通知人員／通知方式／通知帳號／內容，下方 通知 送出、離開 關閉。原本的「回報拜訪任務」專用視窗（含候選任務清單、標記完成勾選框）已取消。

3. 從拜訪單開窗會預填：項目進度＝100、內容＝「已完成拜訪 客戶代號 客戶簡稱，詳見拜訪單 單號」、通知人員＝該事件所屬專案的負責人。按 通知 後：事件進度回寫並標記完成 → 開一筆待辦給通知人員（待辦掛在這張拜訪單上，點開就是拜訪單）→ 拜訪單記住來源事件，分頁狀態變 已關聯。

4. 回報條件不變：只能在瀏覽狀態、已存檔的拜訪單上回報，編輯中或未存檔會提示。「來源任務」分頁仍列出已關聯的事件與登入者名下未完成的客戶拜訪任務（狀態欄：已關聯／同客戶／空白）。

5. 分頁裡不再有 導航：要打開事件本身，請從行事曆事件卡按 導航（或直接開排程事件（專案））。

6. 行事曆事件卡：四顆鈕為「導航／報告」上列、「附件／執行」下列；報告 開啟的視窗標題改為 事件進度回報，關閉鈕文字為 離開。

7. 新增事件視窗：標題改為 新增事件；版面改成左欄「明細」、右欄上「通知」下「自動化參數」，中間分隔線可拖曳；說明移到 對象 下面；選定對象後系統自動把「代號 名稱」帶到說明最前面（改選對象只替換開頭那段，使用者自己打的字不動）。

下午第四補（依使用者裁決再調整）

1. 分頁改名：拜訪單下方面板的 來源任務 分頁改名為 相關任務（功能不變）。

2. 狀態值改名：該分頁的狀態欄 已關聯 改為 已回報（意思不變＝這張拜訪單回報過的那筆事件）。另外兩種值 同客戶 與空白不變。

3. 回報視窗多一顆 完成 鈕：位於項目進度輸入框左邊，按下把進度一鍵設為 100，不必手打（多數回報都是「做完了」）。行事曆事件卡按 報告 開的是同一個視窗，同樣有這顆鈕。

4. 通知方式下拉整理：待辦事項 在第一個、滑鼠停在下拉上的提示清單照代碼排；待辦事項 + Line 因 Line 通道尚未提供先隱藏（代碼 1 保留，舊資料照常顯示）。選項內容、代碼與既有資料不變，新增事件的預設值仍是 待辦事項。選 待辦事項 + Email 時，通知帳號會自動帶入通知人員的 email（先填人員再改方式也會補帶）；只走 待辦事項 時通知帳號用不到，留空是正常的。

5. 待辦點開看得到拜訪單內容：回報開出的待辦，收件人點開後「內容」區會顯示這張拜訪單的欄位（拜訪單號、拜訪日期、拜訪主旨、受訪代號、客戶簡稱、業務員、部門、起訖時間、受訪人員、拜訪內容、附件及備註、里程數、過路費）。這靠部署腳本新建的 vwcommpr_visit 檢視與 _sheetno.聯絡單view 登錄；沒跑到那段的環境，待辦點開只有主旨、內容一片空白（回報與跳轉功能本身不受影響）。

| 物件 | 變更 |

|---|---|

| vwcommpr_visit | 新增檢視：待辦「內容」區要顯示的拜訪單欄位（單一主表、無明細） |

| _sheetno（單據別設定） | VISIT 的 聯絡單view 登錄為 vwcommpr_visit |

部署腳本同 sql/visit-task-report-nogi-20260828.sql（已含這段；朝陽沒有拜訪單，不適用）。

工作流程視窗改版（同日）

單據工具列 工作流程（送簽）視窗依使用者裁決改版，影響所有會送簽的單據，不只拜訪單。完整操作見工作流程派送。

1. 不再跳「沒有發行者」：關卡裡沒有發行列時，系統自動補一列 發行（處理人＝登入者、狀態已完成），面板照常開啟、照常送簽。原本的「沒有發行者，請檢查工作流程表是否有設定錯誤」提示不會再出現。

2. 流程樣板下拉最後永遠多一項 自訂流程（樣板號顯示 CUSTOM）。選它時清單只有一列發行，其餘關卡由使用者在關卡資料表格按右鍵 新增數筆 自己加：處理事項可選（通知／確認／承認／初審／複審／核定）、處理人用放大鏡挑、審核順序照加入順序。單據別沒有任何流程樣板時（例如拜訪單），下拉就只有 自訂流程 且預設選中，可以直接送簽。

3. 選一般樣板時：樣板帶出來的關卡仍不能改；但可以按右鍵 新增數筆 補通知人員——新增列的處理事項固定 通知、排在流程最後，只要選處理人。

4. 儲存（送簽）前檢查：除發行以外的每一關都要有處理人，否則提示「關卡 00X 尚未指定處理人」並擋下存檔。

5. 下方面板「工作流程」分頁（流程圖）：只畫真正送簽的流程。被回報／行事曆 報告 通知過的單，那些通知待辦改列在流程圖下方的 通知紀錄（N） 清單（日期、主旨、通知給誰、狀態），不再一條條畫成「發行→通知」；還沒送簽時顯示 尚未送簽。分頁標題的筆數：有流程算關卡數，只有通知算張數。

6. 被通知過的單現在可以正常送簽（改版前會被當成已送簽而整個面板唯讀）。此項靠部署腳本 sql/wkflow-getnotes-skip-notify-20260828.sql；沒跑到的環境仍會唯讀。

腳本	對象

sql/wkflow-getnotes-skip-notify-20260828.sql	各帳套（讓通知類聯絡單不被當成已送簽）

2026-08-27 定位搜尋欄加提示、手冊 PDF 加頁次、常見問題問句改紅字

使用者可見的變動

1. 定位搜尋欄（導覽列中間的輸入欄）永遠有提示

改前：TsSeekTextBox 的 ToolTip 直接綁 TsSeekTextBoxViewModel.ToolTip，而該值是從 DB 撈該程式的

查詢清單說明——沒有設定查詢清單的程式就是空字串，整個欄位完全沒有任何提示，

使用者不會知道這欄還能打 ;、[、]、?。

改後：滑鼠停在欄位上一定看得到輸入規則：

• 輸入代號後按 Enter 定位到該筆

• 代號後面加分號(;) 再按 Enter，定位到符合的最後一筆

• 輸入 [ 、 ] 或 ? 可開啟查詢視窗挑選 ← 只有該程式有設定查詢清單時才列出（沒設定時打這些符號本來就沒反應，列出來會誤導）

• 輸入的英文字母會自動轉成大寫

該程式有設定查詢清單時，原本的清單說明接在提示後面（空一行隔開），資訊不會少。

實作：ViewModel/Control/TsSeekTextBoxViewModel.cs 新增 SeekToolTip（原 ToolTip 不動，

因為 HaveSQLSeekData 是靠它是否為空來判斷有無查詢清單，動了會讓 [／? 誤以為有窗可開）；

TsControl/Themes/TsTextBoxGeneric.xaml 的 TsSeekTextBox 樣式改綁 SeekToolTip。

提示文字走 DisplayMeta[中文]，未翻譯時顯示中文原文。

已知限制：提示文字在 VM 建構時決定，切換語言後要重開該程式才會換語言。

2. 手冊匯出的 PDF 每頁加頁次

頁尾中央顯示「第 N 頁 / 共 M 頁」，封面不加，頁碼＝PDF 實體頁次（與檢視器頁碼一致，方便對照）。

Chrome 的 --print-to-pdf 只能全有全無地開預設頁首頁尾（會夾帶 file:/// 路徑），

CSS 的 @page margin box（@bottom-center）Chrome 也不支援 → 改在產出後用 PyMuPDF 蓋上去

（tools/docs-pdf/export-pdf.py 的 stamp_page_numbers）。字型用微軟正黑體並做子集化——

MuPDF 內建的 china-t 會把數字排成全形、字距很醜，而不子集化會讓 PDF 暴增 13MB。

manifest 可用 "page_number_footer": false 關掉。

3. 常見問題的每一題問句改紅字

??? question 的問句在網頁與 PDF 都改用紅色（#b42318；深色主題用 #f08a7a），

章節標題「常見問題」維持原色。全手冊 391 個檔、2172 題一次套用（純 CSS，不動 md 內容）。

• 網頁：docs/stylesheets/extra.css 新增 --ts-question 色票與規則。

• PDF：tools/docs-pdf/export-pdf.py 的列印 CSS 加 .admonition.question 標題色（左側線也一併改紅）。

相關說明調整

docs/getting-started/index.md「查詢視窗不是每支程式都有」那段原本寫「有設定的程式，把滑鼠停在輸入欄上

會顯示提示文字」，配合第 1 項改成「一定會顯示輸入規則，有設定查詢清單時再附上符號與查詢內容」。

2026-08-27 手冊用語統一：格線 → 資料表格；標準功能視窗分區圖第 4 項框線對齊

使用者可見的變動

1. 手冊用語統一

終端使用者手冊（docs/）中原本用來指稱畫面上多筆資料表格（TsRadGridView）的「格線」，

一律改為「資料表格」，共 209 個檔案、984 處。

• 連帶調整的標題與錨點：基本畫面介紹 的 ## 格線（表格）通用操作 → ## 資料表格通用操作，

內文連結 #格線表格通用操作 → #資料表格通用操作（同步改，連結未失效）。

• 原本重複語意的「表格（格線）」一律收斂成「資料表格」。

• 未改動：docs/changelog/、docs/decisions/（歷史紀錄，保留當時用語）。

docs/_guide/writing-guide.md 已加入用語規定，新頁面不得再寫「格線」。

共用控制項頁面的標題也一併對齊：表格（TsRadGridView）→ 資料表格（TsRadGridView）

（頁面標題、H1、controls/.nav.yml 導覽名稱與 8 處連結文字，共 11 處）。

2. 標準功能視窗分區圖修正

docs/getting-started/images/standard-form-layout.png：

• 第 4 項（資料導覽列）的橘色框線原本沒有對齊——框線畫在導覽列下緣的狀態列上，

上緣橫線還橫切過「傳票號碼」欄、「歷程」選項與換頁按鈕。現已重畫成貼齊導覽列本身的

上下分隔線（y=1308／y=1347），涵蓋定位搜尋欄到 說明 鈕，編號圓標同步移到框的左側中央。

• 被舊框線蓋掉的畫面像素，改由同一次截圖的未標註版本 images/main-window.png 還原

（兩張圖除標註外逐像素相同，只差最上方 22 列）。

• 圖內圖例第 3 項文字同步改為「明細（單身）資料表格」。

3. 清掉已補齊的截圖提示

手冊頁尾的截圖提示區塊，凡是「截圖已經補齊」的一律移除，只留下真正還沒拍的：

• 移除整個區塊 20 支：4 支只寫「本頁截圖已補齊」的 截圖說明

（getting-started/ 的 index／browse／list-browse／print），

以及 16 支所列截圖全部已存在且已嵌進頁面的 需補截圖清單

（_infodb、datatpl、language-switch、zcond、bom_botm、bom_chk1、culbl、

otherrp、prepaid、commpr、nouse、px_qry、bank、bankday、bankfcst、checkqry）。

• 只刪已補齊的那幾條、清單保留並重新編號 25 支：共 29 條（含 pur_qry3 那條）。

• 判定條件：該 .png 檔實際存在於該頁的 images/ 且頁面內真的有引用；

只有檔案、頁面沒引用的不算補齊，提示保留。

• 刻意保留：M-EIS/customdash.md 的 customdash-export-html-select.png

（提示本身註明「需重拍」，仍是待辦）；以及 尚無截圖／無需補截圖／截圖來源

這幾種非待辦性質的說明區塊。

2026-08-27 外部資料改存資料庫：EXTDATA 加車輛公會統計、月報改讀 DB

程式：外部資料擷取（L.聯絡傳訊 › L-090）、業務儀表板／業務課報告表（E.營業收款 › SALESDASH）、排程任務 ExternalDataFetch。設計取捨見 ADR 0145。

車輛公會（TTVMA）統計與金屬行情原本只落地成檔案，這次改成同時寫進資料庫（集中自動化庫的 twork_auto_ttvma／twork_auto_metalprice 兩張表）。原始檔照舊落地保留，可以繼續拿來跟公會網站對帳。

外部資料擷取（EXTDATA）

• 查詢條件新增 車輛別：全部／汽車／機車，決定下面「車輛公會統計」要看哪一種。

• 查詢結果新增 「車輛公會統計」 表格（資料月份／車輛別／銷售別／期別／規格／廠牌／數量），一列一個數字，可直接排序、複製、匯出。

• 金屬行情改讀資料庫（以前是讀當期落地的 JSON 檔）：換一台電腦、換一個人查，看到的都是同一份資料；查得到的期間也不再受「這台機器有沒有抓過那個月」限制。

• 本期還沒有公會資料時，自動改顯示表內最新的月份，並在底部訊息列註明「顯示 2026-07（本期尚無資料）」，不會給一張空白表讓人以為壞了。

• 勾「順便取得最新資料」查詢時，抓完會一併寫進資料庫，訊息列附上入庫筆數（例如「TTVMA_QTA1 入庫 234 筆（新增 234／更新 0）」）。本期已有而被跳過的來源也會補入庫——檔在本機不代表已經進表。

• 若資料庫端還沒部署好，訊息列會明說 「查詢派發失敗（proc 未部署或跨庫權限鏈未開，不是查無資料）」 並標紅，不會被誤讀成查無資料。

業務儀表板（SALESDASH）

• 按 立即擷取 後，狀態文字會附上入庫筆數（不只是「抓到檔案了」）。

• KPI 卡與趨勢圖的內部命名由「訂單」改為「銷售」（各月銷售趨勢、本月銷售金額）。銷售數字自 2026-08-06 起本來就取自出貨單，這次把畫面上殘留的「訂單」字樣一併改掉，避免誤會。

業務課報告表（月報）

• TTVMA 資料改讀資料庫，不再於產生報告表時另外連一次公會網站下載、另外解析一次。少一次下載，產生速度變快，也不會再出現「儀表板抓到了、月報卻說沒有」的落差。

• 檢核模式的 「汽車TTVMA原始」／「機車TTVMA原始」兩個分頁改由資料庫重建公會版面：版面（標題、直排標籤、廠牌兩列表頭、合計欄、％欄、% 列、備註）與原本貼上去的公會表格一致，數字經真檔逐格比對完全相同。

- 百分比一律重新計算並顯示兩位小數；數量欄顯示千分位。

- 已知差異（刻意）：直排標籤的字數與位置略有不同（原檔「去年同期銷售」6 字、重建為「去年同期」置中）；公會逐月手打的臨時附註不保留（例如「\*三陽工業產銷統計資料彙整中」），要看原文請開落地的原始 xls；原檔自己算錯的格（#DIV/0!）在重建版會變成 0。

• 範本模式的表頭標題由「(預訂交期)」改為「(交易日期)」——口徑本來就是出貨單的交易日期，標題跟上。

排程

• 排程任務 ExternalDataFetch（單據別 SALESDASH）新增參數 FullHistory，預設 false：

- false（平時）：只解析並更新最近的月份（表內最大月份的前一個月起）——公會會在月中回頭修正上個月數字，所以固定多重抓一個月。

- true：TTVMA 全歷史重載（現有落地檔含 2002-08 起共 288 個月，汽車約 6.7 萬列／機車約 21.8 萬列）。首次啟用時跑一次即可，之後改回 false。

• 其餘參數（Sources／RootDir／Period／Force）與行為不變；任一來源入庫失敗會讓該次排程記為失敗（F），其他來源照做。

!!! warning "全歷史首載會很重"

全歷史一次寫入約 44 MB 的派發稽核紀錄（log_sys_skd），請安排在離峰時段跑，且只跑一次。

部署

• 集中自動化庫（darb<客戶>auto1）：跑 sql/extdata-table-deploy-20260827.sql — 建 2 張表與 5 支 proc（TWORK_SKD_EXTDATA_TTVMA_UPS／_METAL_UPS／_TTVMA_QRY／_METAL_QRY／_TTVMA_MON），冪等可重跑。

• 各 log 庫（log1～log5）：跑 sql/extdata-procparam-log-20260827.sql 登錄 proc_param。沒跑的話畫面會顯示「查詢派發失敗」。

• 兩支腳本用 sqlcmd 執行都要加 -f 65001（含中文、UTF-8 無 BOM），跑完看腳本最後的驗證結果。

• 正式機部署前先實查該機 auto1 的相容等級：腳本用到 OPENJSON，需 ≥ 130（SQL Server 2016 以上）；不足時腳本會直接中止，不會建到一半。

• 朝陽（CY）本次不部署：其正式機為 SQL 2008，沒有 OPENJSON。

• 需要新版程式（TsERP.exe／AutoPilot.dll）。

狀態

建置 0 error；單元測試通過（含 288 張真實工作表全數解析成功、版面重建真檔逐格比對數值格 0 筆不一致）。runtime 未驗——實際打到集中自動化庫的端到端（proc_param 登錄、跨庫權限鏈、大量 JSON 吞吐、EXTDATA 新表格開窗）尚未執行。

---

title: 傳票報表跨頁每頁重印傳票號碼與欄位標題

date: 2026-08-26

---

傳票報表跨頁每頁重印傳票號碼與欄位標題

使用者可見變動

• 傳票列印（Sliy／A5 版 Sliy_a5／英文版 Sliy_e／簽核版 SliyApprove）一張傳票明細超過一頁時，第二頁起也會印出傳票號碼、傳票日期與欄位標題列（科目代號／科目名稱／摘要／部門別／借方金額／貸方金額）。過去只有第一頁有，續頁直接從明細列開始。

• 做法：四支 .frx 的傳票 GroupHeaderBand 加 RepeatOnEveryPage="true"；每張傳票另起新頁（StartNewPage）的行為不變。

驗證

離線渲染治具（.claude/skills/vfp-report-to-fastreport/references/frxrender/）以 45 行假傳票渲染四支報表，第 2 頁皆有傳票號碼／日期／欄位標題；REPORTSROOT\Reports 部署副本已同步。ERP 內實印未驗。

同日另一筆：BOM 流程圖「材料流向圖」右欄（製程／半成品／成品）改左緣對齊，垂直主幹改用固定 X 的自訂接點維持直線；按「左右相反」時改右緣對齊。

---

title: 密碼權限表「其他功能」勾選改了存不進去

date: 2026-08-26

---

密碼權限表「其他功能」勾選改了存不進去

使用者可見變動

• 密碼權限表（SECRET）右側「其他功能」表格勾選／取消「是否允許」後按儲存，現在會真的寫進 prgsct1 的 可否其他N（說明文字 其他N說明 同修）。過去畫面看起來改了，存檔後重開又變回原值。

• 根因：存檔前的寫回（Twork_sys_vw_prgsct1Source.SetOtherFunctionPermission）用舊英文屬性名 AllowExtendedFunction{N}／DescriptionOfExtendedFunction{N} 反射找欄位，屬性早已中文化成 可否其他{N}／其他{N}說明，反射查無屬性就靜默跳過，勾選從來沒進 Model。改為中文名後與讀取端（ActionPanelViewModel）一致。

驗證

LogicBllTests/A.SystemData/SecretOtherFunctionTests.cs 三支迴歸測試（勾選寫回／說明寫回／取消勾選寫回）＋ HarnessSmokeTests 8 支全過；Model 用 dotnet build、測試專案用 MSBuild 建置皆 0 錯誤。ERP 內開窗實存未驗。

---

title: 朝陽 PACKING LIST「修增」「標籤新增」轉單視窗（PK_M）

date: 2026-08-26

---

朝陽 PACKING LIST「修增」「標籤新增」轉單視窗（PK_M）

使用者可見變動（朝陽）

• 其他功能新增「修增」（對已選裝箱單追加明細）與「標籤新增」（新建裝箱單），共用 VFP 子表單 PK_M 的「PACKING新增視窗」：輸入 CI No./出通單號（SL 開頭查出通單、否則查 CI，並擋已有裝箱單的單號）＋起始／截止箱號＋前置文字＋箱子品號＋箱重／單箱毛重；查詢帶出明細（含出通單數量／已包數量／待包數量，靠 pkde.交易單pkid 控管重複裝箱）；逐列按「增加」累加包數／尾數（尾數改為剩餘量，VFP 算成超出量是 bug）；超量列變綠；儲存自己完成交易（標籤新增連 pkma 一起建），存檔後自動預覽側嘜貼紙再問「新增記錄已儲存,是否繼續新增 ?」，關窗後主畫面跳到新單（pkid 回 0 時改 SEEK cino）。

• 其他裁決落地：修增反查客戶 salema 查無改查 ci_m；查詢鈕以程式碼為準；CI 路徑放行碼表照抄 salema；grid2「無法轉單」拿掉三個恆 0 欄；包裝量_包=0 時「增加」只累加包數（照 VFP）。

• 依賴：darbcylog1.proc_param 補 DARB_TUR_PK_M_CI（sql/proc-param-pk-m-ci-cy.sql，dev 已套、正式機待跑，未跑 CI 路徑靜默回空）。

• 已知限制：側嘜自動預覽的取數條件（報表端 CyOrderReportCondition.CiNoRange）只吃 cino 起訖、不吃前置文字／箱號區間 ⇒ 印整張 CI 的側嘜而非本次區間（D3 半套，報表端另案）。

驗證

單元測試 30（增加公式含 D2 反例／小計／超量／序號／五條存檔驗證）＋smoke；MSBuild 0 error；VFP 133 元素差集 0。朝陽 dev UIA：修增開窗自動查詢（cino/箱號/前置文字/客戶帶入）、增加累加包數、取消釋放放行碼後離開；標籤新增端到端：SL202600442→查詢 2 列→增加→儲存（毛重必填擋下→補後成功）→pkma 新增、pkde 1 列且 交易單pkid 有值、序號 00101＝VFP 公式→側嘜預覽 Pkmark1 開啟→「是否繼續新增」否→主畫面跳到新單→放行碼釋放（測試單已清）。審查修正（08-26）：修增存檔後不再誤用 SaveMessage 的 pkid（會導到不存在的單、繼續新增會掛錯單）→ 只有標籤新增取新 pkid、修增沿用既有；manager 註冊改快取；視窗 X 關閉也釋放放行碼（IDisposable）；查詢鈕版面獨立一欄。複驗：修增追加端到端（SE-202600034 7→8 列、新列 linkid 掛原單、交易單pkid 有值、不多生 pkma、主畫面停在原單、側嘜預覽＋繼續新增）；X 關窗→放行碼 0→可立即重開。未驗：包裝量_包>0 的拆列、CI 路徑實資料、正式機。

---

title: 朝陽 PACKING LIST「合併」視窗（PK_E3）——先開放查詢顯示，合併存檔延後

date: 2026-08-26

---

朝陽 PACKING LIST「合併」視窗（PK_E3）——查詢顯示（6A）

使用者可見變動（朝陽）

• 其他功能新增「合併」：「PACKING合併視窗」依客戶代號＋製表起訖日（預設帶目前單的客戶與製表日期）查多張裝箱單明細，可勾選列（全部選擇／全部不選），被其他人鎖住的列列在「無法轉單」；查詢會取放行碼鎖住相關單據，取消／離開／視窗 X 都會釋放。

• 合併存檔本輪不開放：儲存鈕停用並提示「合併存檔尚未開放（待裁決）」；AllowSave 也恆擋。原因：朝陽 VFP 現場的合併 allowsave 整段被註解、關窗不回單號，等於本來就不能用；要復活哪一版演算法（新開 SL 出通單／原單如何處理／分組鍵／箱號重排…）待使用者裁決後做 6B（使用者 2026-08-25 裁決）。

• 查詢條件擋門（VFP 沒有）：客戶代號必填、製表起訖日必填且起≤訖。

驗證

單元測試 16（條件驗證各分支／勾選統計）＋smoke 24/24；MSBuild 0 error；VFP 77 元素差集 0。朝陽 dev UIA：開窗預設值、查詢 2026 年 A07 得 33 列、放行碼 125 列鎖定、儲存鈕停用、X 關窗後放行碼歸零、主畫面不動。未驗：「無法轉單」grid 有資料的情境、全部選擇／不選、正式機。

---

title: 朝陽 PACKING LIST「設定棧板」視窗（PK_1）

date: 2026-08-26

---

朝陽 PACKING LIST「設定棧板」視窗（PK_1）

使用者可見變動（朝陽）

• 其他功能新增「設定棧板」（VFP 子表單 PK_1）：按下後主畫面進編輯態、開「設定棧板」視窗——上方輸入格逐列填 起始棧板號／起始箱號／截止箱號／棧板別（初值自現有明細帶入），中間彙總各棧板總箱數，下方明細列被棧板區間完整接手者整列綠底；「重新計算反綠」強制重算；儲存→依棧板設定重建整組明細（原列刪、新列序號 001 起重編，重用重排序號規則）→回主畫面存檔；離開→主畫面取消編輯。

• 裁決落地：棧板別寫獨立 棧板別 欄（pl_meas 尺寸字串不動）；棧板毛重＝毛重+10；淨重／毛重四捨五入 2 位；VFP 死碼 allowsave 不搬；存檔前若有明細列未被任何棧板區間接手，先跳 YesNo「有 N 列未指派棧板，將被刪除」（VFP 是靜默刪）。

• 注意：存檔會經主畫面 PkSave/Pk_cySave 的既有檢查——朝陽明細沒有單價欄，每次設定棧板存檔都會先問「明細有 N 列單價為 0，是否繼續存檔？」（08-25 匯入 CI 裁決的提示同一道），選否＝不存並自動取消編輯。若嫌吵可裁決只在匯入 CI 路徑提示。

驗證

單元測試 22（區間攤平／覆蓋／重疊／未接手清單／序號／棧板別欄／毛重+10／捨入）＋回歸 44/44；MSBuild 0 error。朝陽 dev UIA：閘門→進編輯態→開窗（初值自明細、全綠、彙總 1/12・2/12・3/15、總箱數 39）→重新計算→儲存進主畫面 Save→單價 0 提示選否→存檔取消→主畫面回瀏覽態、DB 明細 7 列不變。未驗：C5 未接手提示（UIA 改不到輸入格）、實際存檔重建寫入、200 列空白列效能。

---

title: 工程P管制圖 Excel 樣板「作成」欄改照現場公式

date: 2026-08-26

---

工程P管制圖 Excel 樣板「作成」欄改照現場公式

使用者可見變動（朝陽，主管資訊→不良期間統計→工程P管制圖→Excel）

• 產出的 P 管制圖工作表「作成」欄，改為依查詢的起始部門自動帶班別負責人＋當天日期（H1/H2→陳素枝、H3～H5→孔淑芳、H8→蔡佳珍、M1/M2→吳書萍、M3～M7→束燕霞、R1→徐秀珍），與現場 2025-09-09 的 P管制圖新版.xlsx 一致（使用者 2026-08-26 裁決）。原本 ERP 內嵌版帶的是登入者（輸入人員）。

• 其他欄位、圖表、每 30 筆一張圖的產生邏輯不變；不再需要桌面的 P管制圖.exe／CyP管制圖新.exe（ERP 端本來就已內建產圖）。

• 人名硬編在樣板公式裡（照現場做法）；換人要改 Common/Excel/ExcelTemplate/P管制圖新版.xlsx 的 sheet2!N2。

驗證

只改 sheet2!N2 公式（直接改 xlsx XML、圖表與其他部件逐項 hash 不變）；openpyxl 讀回公式正確、圖表 1 張仍在。runtime 未驗（需 Excel Interop 開圖，待實機按一次 Excel 鈕看作成欄）。備份：.claude/tmp/backup-20260826-pctl/。

2026-08-26 庫存管理模組體檢修正（出貨單費用分頁／耗料單⇄加工單導覽／盤點單導覽／進貨單死欄）

來源：H.庫存管理 16 支 UIA 實機體檢（禾久模擬庫），例外堆疊對回程式碼後逐項修正。

使用者可見變動

程式	修正前	修正後

出貨單 TRSAMA	導覽到末筆或切「費用」分頁跳「Cannot create a DbSet for Twork_stk_vw_trsafeeSource」	正常導覽；費用分頁可開

耗料單 TRLOST／加工單 TRWKMA	同一次登入先開耗料單再開加工單，按上一筆跳「UNIQUE constraint failed: Trwkma.pkid」	兩支各用自己的本機暫存表，互不干擾

盤點單 INVREC	導覽末筆跳「The input string '' was not in a correct format」	正常導覽；抽盤數／複盤數空白視為 0

進貨單 TRRAMA	主檔「分攤完成」欄永遠空白（綁到不存在的欄位）	移除該欄

出貨單 費用分頁	欄位屬性全英文（LineNo_／ImportCostCode／…）	屬性改中文（序號／費用代碼／費用說明／科目代號／客廠部代號／幣別／匯率／原幣未稅／本幣未稅／費用備註／出貨單序號／發票號碼／數量／單位／單價／轉帳款數量／轉出備註／客廠部簡稱／科目名稱），畫面文字不變

2026-08-27 追加：進程式的「檢查結果」（XAML 綁定有、SQL 欄位沒有）

程式	修正前清單	處理

全部 H 程式	Code	檢查器誤判：TsDocumentPrefix 沒進控件對照表，遞迴走進樣板把內部 {Binding Code} 當主檔欄位 → 對照表補上

進貨單／出入庫單／出貨單	SKU、AmountWithoutTax、Warehouse、Quantity、OtherAmount、ProjectCode	檢查器誤判：XxxBinding 剝掉字尾後找不到就報 → 改為退回原路徑找，NotMapped／TsSkipCheck 視為存在

進貨單	初品單號、初品變更（朝陽專有 view 欄）、是否為成本／進貨單序號／發票號碼／轉出備註…（費用分頁 7＋1 欄，7/23 裁決保留）	Source 標 [TsSkipCheck]（附註明）

出貨單	費用格 19 欄	檢查器改由 grid 的 DataManager<T> 綁定解析 T（原本拿明細 trsade 型別去找、永遠缺欄）；trsafee 全部標 [TsSkipCheck]（無 server 表）

出貨單	ProjectCode／ProjectName／ShipToAddress／TrlimaPkid／員工編號／EmployeeName	真死綁定：Source 與兩庫 vw_trsama/vw_trsade 皆無 → 移除主檔「專案代號」「送貨地址」「揀貨單ID」三組控件與明細「員工編號／員工姓名」兩欄

複驗：進貨單／耗料單／出貨單開窗不再出現「檢查結果」；HarnessSmokeTests 18/18。

2026-08-27 追加：英文 `*Binding` 屬性中文化＋「其他查詢」分頁英文表頭中文化

• H 模組六個 Source 的 16 個英文顯示／計算屬性改中文（WarehouseBinding→隸屬倉庫Binding、CurrencyBinding→幣別Binding、ForeignExchangeRateBinding→匯率Binding、SKUBinding→品號Binding、QuantityBinding→數量Binding、OtherAmountBinding→其他金額Binding、UnitPriceBinding→單價Binding、AmountWithoutTaxBinding→本幣未稅Binding、ImportCostCodeBinding→費用代碼Binding、TotalQuantity/TotalAmountBinding→總數量/總金額Binding），XAML／VM／Bll 引用連動；同名屬性在其他模組的 Source 不在本次範圍。

• 順帶修兩個既有死綁定：Ratosa.xaml 品號／單價欄（原綁 SKUBinding／UnitPriceBinding，Source 從無此名）、TrramaAllocation.xaml 數量欄（原綁 QuantityBinding）。

• ⚠️ 這些欄沒明寫 UniqueName，Telerik 以綁定路徑當鍵：曾按「記憶格式」存過版型的使用者，該欄會回到預設寬度／順序（不崩）。

• 「其他查詢」分頁（SpecialQuery）grid 表頭原為英文字面值（Transaction Code／SourceBin／Lot Num…），改為中文字面值並補 Common/Lang/Xaml/*.json 翻譯 key：TrsamaPickingSpecialQuery／TrramaAllocationSpecialQuery／TrramaAPSpecialQuery／StockQuery／Trapply_qSpecialQuery／TrlimaPickingControl／WktompPickingControl／PickingControl（C.總務的 G* 同款不在本次）。

• 「其他查詢」分頁 grid 的欄位綁定原本是英文屬性名而 Source／POCO 早已中文化 → 格子從來空白：89 個綁定接回中文屬性（TrsamaPicking 10／TrramaAllocation 5／TrramaAP 8／StockQuery 4／TrlimaPicking 9／WktompPicking 8／PickingControl 9；同款順修 GtrramaAllocation 5／GtrramaAP 8／SpdataContact 19／WarrantyContent 4），反射驗證 142/142；PickingControl.xaml 的 PickedQuanatity 拼錯一併修。對照表 .claude/tmp/specialquery-binding-fix-report.md。

• 表頭修兩個翻錯：TrramaAP「相關單號」→「參考單號」（綁 參考單號）、「原幣到期金額」→「原幣應收付」（綁 原幣應收付），Shared.json key 同步改名。

• 08-27 續：其餘「其他查詢」表頭 71 筆中文化（廠商聯絡／保固／總務 Gtrapply_q／GUnitPrice／GtrramaAP／GtrramaAllocation／PageHeader／CustomerQuery），Shared.json 補 25 key；Skype／Facebook／pkid 保留。TWORK_QRY_TRRAMAAPQUERY 改寫中文 schema 版並部署（sql/trramaap-query-deploy-20260827.sql，禾久／朝陽 dev 已跑＋proc_param 登錄；正式機已跑（2026-08-27））；TsControl/Layout/PickingControlDatagrid.xaml/.cs 死檔刪除。

• （上列缺口已於 08-27 處理：proc 部署、死檔刪除、兩支表頭中文化。）

2026-08-27 追加：H-15 出入庫查詢 INVBK2 整支移植

• 新程式 INVBK2（禾久選單 H-15 原指向未移植程式，點了跳「程式鍵無法解析」）：條件面板（年度月份／起迄倉庫＋所有倉庫／起迄品號／不分儲位／不分工程／不分批號／期末不為0）、分頁 1「出入庫查詢」（排序方式 5 選 1、報表選擇彙總／明細、只顯示入出庫數不符；彙總 25 欄＋明細 13 欄）、分頁 2「鋼瓶進出查詢」（起迄日期／查詢品號／起迄倉庫；7 欄＋17 欄），Excel 匯出；資料走 DARB_QRY_INVBK2（派發器 proc_param 已登錄），期初／入庫／出庫／期末／平均量／庫存月數等彙總在 Bll 以 LINQ 實作，逐段對 VFP。

• 新增 LogicBll/H.Inventory/Invbk2/（9 檔）、Invbk2ViewModel／Invbk2ConditionViewModel、Invbk2.xaml／Invbk2Condition.xaml、Common/Lang/Xaml/Invbk2.json；接點 ProgramClass.INVBK2、Procedure.DARB_QRY_INVBK2、App.xaml DataTemplate ×2、DIExtension。

• 驗證：對比表 .claude/tmp/invbk2-compare-20260827.md VFP 185 元素差集 0；單元測試 23/23、真資料對照 3/3（期末恆等式 851 列全過、明細合計與 SP 一致）；UIA 禾久開窗查詢：分頁 1 彙總 52 列＋明細連動正常，分頁 2 查詢正常。

• 裁決落地（2026-08-27）：D3 所有倉庫顯示；D4 入出庫不符＝群組 SUM(入庫)≠SUM(出庫)；D5 品別／群組代號／說明／單重補值、新增備註／現有數量／總重量移除；D6 新 SP TWORK_QRY_INVBK2（不動 DARB_QRY_INVBK2）回資料別 出貨／加工／其他，sql/twork-qry-invbk2-deploy-20260827.sql（含 proc_param 與 _prgpar 3023 預設鋼瓶品號）禾久 dev 已跑實查；D7 明細「單號／倉單號」超連結依序號前置碼（lcl_tritem，退路表 RA→進貨單…）跳對應單據並 Seek（GridViewHyperLink 新增 InventoryDocumentPrefix 模式，5,592 單號離線路由零錯）；D8 分頁 2 預設品號改讀 _prgpar 3023；D9 明細關聯鍵套用不分儲位／工程／批號替換。UIA 複驗：資料別顯示、超連結點擊跳出入庫單並載入該單。正式機（禾久）已跑（2026-08-27）；朝陽無 INVBK2 不裝。

技術

• Model/LocalDbContext.cs：補 DbSet<Twork_stk_vw_trsafeeSource> Trsafee；formStagingTypes 加 TrlostTrwkma／TrlostTrwkde。

• Model/Source/H.Inventory/TrlostFormStagingSources.cs（新）：TRLOST 主檔／明細 staging 薄殼，作法同 rp／zcond／trgama 系。TrlostViewModel、TrlostSave/Edit/Delete 改註冊衍生類；Trlost_sBll 自有 manager 續用 base。

• Twork_stk_vw_invrecdModel/Source：抽盤數／複盤數 改 string（DB 兩庫皆 nvarchar(24)），*Binding 仍為 decimal 供數值欄綁定與差異計算。

• Twork_stk_vw_trsafeeModel/Source：屬性中文化＋補無參建構子＋ImportCostCodeCobPoco／本幣未稅Binding 標 [NotMapped]；Trsama.xaml 費用 grid、TrsamaViewModel、TrsamaSave/Delete 連動。

• Trrama.xaml：移除「分攤完成」標籤與唯讀框（CompletedAllocation 無來源）。

• TsControl/CheckSqlField.cs：對照表補 TsDocumentPrefix；XxxBinding 剝字尾失敗退回原路徑；CheckField.SourceType 由 grid 的 DataManager 綁定解析，無結果集的 grid 也能依 TsSkipCheck／NotMapped 判定。

• LogicBllTests/Harness/HarnessSmokeTests.cs：LocalDbContextEntityTypes() 改為連 EF model（OnModelCreating 註冊的 staging 殼）一起讀；baseline 移除 14 筆殼類歷史欠帳。

資料表 ↔ 類別比對（H 模組，禾久＋朝陽聯集）

_menum(SCX_STK) → _sheetno 全部 18 個 view/table 逐一比對：DB 有、Source 無＝0；Source 多出的欄位皆為計算欄（trrade／trsade 代工單價系列、trrama／trsama 合計欄）或 2026-07-23 裁決保留的 trrafee 費用欄。報告：.claude/tmp/h-db-source-compare-20260826.txt。英文殘留：trrama.invoice、trsama/trlima.cino 是 DB 本身的英文欄名，保留；EDI/BOL 系 Source（Trsama_bol 等）屬 B2B 交換格式，未動。

未處理（待裁決）

• H-15 出入庫查詢 INVBK2：整支未移植，選單為死項；VFP 原碼 .claude/tmp/scx_stk/invbk2.prg，需另開移植案。

• H-CY1 廠商庫存表 INV_SP：朝陽專屬程式，禾久畫面出現是 dev-programs.json 開發注入，非客戶問題。

驗證

MSBuild TsERP 0 error；HarnessSmokeTests＋DerivedSourceDataManagerTests 18/18；UIA 實機：禾久 H 模組 16 支 sweep（導覽＋分頁）零錯誤彈窗、朝陽 11 支 sweep 零錯誤；針對性複驗（h-verify2.ps1）：出貨單四向導覽、盤點單四向導覽、耗料單→加工單→耗料單交叉導覽皆無例外，debuglog 無新增例外。

2026-08-26 明細表格鍵盤：Enter 往右跳格、下拉欄 Tab 可離開

適用範圍：所有使用 TsRadGridView 的明細表格（傳票輸入 SLIY 為回報來源，全系統生效）。

變更

1. Enter＝往右跳下一格（與 Tab 相同）。舊版 TsDataGrid 本就如此，遷移到 RadGridView 後變成 Telerik 預設的「提交＋跳下一列」，現已對齊回來。編輯中按 Enter 會先提交該格再往右；非編輯狀態按 Enter 也往右。

2. 幣別等下拉欄：

- Tab 不再在下拉選項之間循環，會收合下拉並跳到下一格（選好的值保留）。

- 上下鍵在下拉欄內直接切換選項（原本會被表格攔成換列）。

- 下拉開著時按 Enter＝提交反白項並收合；再按一次 Enter 才往右跳。

技術

• TsControl/TsTelerik/TsGridKeyboardCommandProvider.cs（新）：DefaultKeyboardCommandProvider 子類，Enter → CommitEdit＋MoveNext。

• TsRadGridView.cs：建構子掛上 provider；OnPreviewKeyDown 對 RadComboBox 編輯器放行上下鍵。

• TsGridViewComboBoxColumn.cs：編輯器 IsDropDownTabNavigationEnabled=false、CanKeyboardNavigationSelectItems=true。

驗證

MSBuild TsControl/TsERP 0 error；HarnessSmokeTests 8/8；UIA 實機（禾久模擬庫 SLIY 傳票 20260731078 編輯態）7 項鍵盤檢查全過（.claude/tmp/sliy-keynav-verify.ps1），截圖 .claude/tmp/shots/sliykey/。

---

title: 儀表板查詢進度條、取消與逐步顯示

date: 2026-08-26

---

儀表板查詢進度條、取消與逐步顯示

使用者可見變動

• 查詢自訂儀表板（含公司／部門／個人）時，畫面先出現版面骨架（每張磚位置、大小、標題都在，內容顯示「載入中…」），資料集每查完一個，依賴它的磚就一批亮起來，不再整頁等到最後。

• 條件面板與儀表板頁頂各有一條進度條＋文字：「查詢中 3/8：訂單管理 訂單日期 2025/01/01~2026/08/31（已 4.2 秒）」，步數＝實際要打的資料集數（同源合併後）＋彙總＋渲染。

• 頁頂進度條旁有「取消」：按下不再打後面的資料集，畫面保留上一次結果（條件面板在查詢中會被框架整片停用，所以鈕放在頁面上）。

• 查詢進行中暫不接受磚的鑽取／連動篩選（避免與背景查詢互搶），完成後恢復。

• 靜態匯出 HTML／PDF／排程寄送／設計器預覽維持原本一次渲染，不受影響。

驗證

LogicBll／ViewModel／TsERP 建置 0 error；新增 10 條測試（進度總數、取消後不再打 DB、串流分批、前期依賴、串流結果＝一次查詢結果、骨架不打 DB 且磚位一致）；全套 1993/1993。runtime 未驗（骨架→亮磚→取消的實際體感由使用者自測）。

---

title: 儀表板分公司／部門／個人＋卡片權限＋主選單「個人專區」

date: 2026-08-26

---

儀表板分公司／部門／個人＋卡片權限＋主選單「個人專區」

使用者可見變動

• 主選單多一個子系統「個人專區」（S）：放「個人儀表板」（S-01）與「排程事件」（S-02，自 L.聯絡傳訊移入）；權限與其他子系統相同（程式權限表）。「密碼及我的最愛設定」存檔不再洗掉我的最愛 8~10。

• 個人儀表板：第一次開啟自動建立一張空白的個人儀表板並跳出挑卡視窗，之後可隨時按條件面板的「挑選卡片」把卡片庫的卡加進來（進個人版面，可拖排、儲存版面）；挑卡視窗的「分類」篩選移到第二排。個人板不限列數：橫向放哪裡就是哪裡，縱向維持既有的上吸（上方沒磚會貼上去）。

• 新子系統「新功能測試」（Y）：測試中／新加的功能先集中在這裡——目前放 自訂儀表板（Y-01，原 M-D5）、儀表板設計（Y-02，原 A-155）、公司儀表板（Y-03）、部門儀表板（Y-04）；主選單子系統區第三列多一顆鈕。個人儀表板在 S 個人專區。三支儀表板畫面同「自訂儀表板」，下拉只列該類型；舊 M-D5 自訂儀表板改為三類總覽。既有 D0001~D0007 歸「公司」。

• 可見規則：公司板全公司可見（仍受各磚程式瀏覽權）；部門板本部門／子部門成員可見；個人板只有本人看得到（既有自建板若之前靠主管關係分享，部署後將縮成只本人；要分享請改成部門板）。

• 儀表板設計：新增「類型」欄（預設個人）；選「部門」時使用部門自動帶本人部門且唯讀；「公司」只有系統管理者（Admin）可新增／修改／刪除，非 Admin 看不到公司選項。

• 權限設定新分頁「儀表板卡片」：對選定使用者列出全部卡片，取消勾選＝該人看不到這張卡（該磚在儀表板隱藏並自動補位，狀態列提示「有 N 個磚因無卡片權限未顯示」；「新增卡片」也挑不到）；有全選／全不選／從其他使用者複製；本分頁自帶儲存鈕。預設全部可看。

• 依賴：sql/dashboard-3tier-20260826.sql＋sql/dashboard-s-subsystem-20260826.sql＋sql/subsystem-y-testing-20260826.sql（禾久五帳套）／各自 -cy.sql（朝陽，SQL2008 相容）——dev 已跑，正式機待跑；未跑則新選單與 S 子系統不存在。

驗證

TsERP MSBuild 0 error；LogicBllTests 331/331（smoke 含表名 20 字守門）；dev 三庫 SQL 冪等跑兩次、實查物件全在；L4 UIA 三輪（CMSA，dev darbnogicsa1）：個人專區 S 子系統清單、三入口類型篩選、公司板 Admin 閘與非 Admin 擋存、卡片黑名單（磚隱藏壓實＋提醒列、挑卡不列、全選／取消／複製、存 0 列）、首開空白個人板＋自動挑卡＋挑卡出資料存版面、同名去重、Row 4 版面，全過；修掉 Row4 擠版／複製撞唯一索引（取樣口徑）／全選鈕樣式共用 UIElement 空白／非 Admin 類型欄空白／清單重覆列／欄寬／空板列數 0 疊欄／首開查詢緒。第四輪：子系統下拉「S.個人專區」、鈕「個人專區」過。已知未修（待裁決）：空白個人板挑進的磚在畫面上疊在最左欄——既有版面 reflow（findSlotRight 填滿整欄才換欄）的行為，改動會影響所有儀表板各解析度重排。未驗：朝陽庫與正式機、headless 排程、多使用者跨帳號、挑卡視窗分類過濾。

2026-08-25 56 支畫面寫死文字改走翻譯檔

使用者可見變動

切換語言（英／日／越）時，下列畫面原本固定顯示中文（或英文）的標籤、按鈕、提示文字，現在會跟著語言切換：

• EIS／預測家族：金流預測（含條件）、營運預測模擬（含條件）、生產計劃查詢（含條件）、每日報表（Daily）、Itemship、庫存樞紐條件、自訂查詢面板（條件／匯出選擇／彙整列印選擇／匯出項目設置）、自訂儀表板條件

• 系統設定：儀表板設計、自訂面板配置、系統設定頁（SettingView）、登入頁的 Windows 驗證勾選

• 各模組零星標籤：Ormast_s、拜訪查詢、採購查詢條件、Ginvent／Ginvrecm／Gpurch／Gtrlima／Ginvbook 條件、BOM 流程圖、Ci_m1、廠商統計、Cupdma_cy、達交率列印、送貨地址、預示樞紐輸入、SPEVA 列印、庫齡（含條件）、ARAP 查詢（含條件）、移動成本、專案成本、信件搜尋（含條件）、Trlost／Trsama／Trlima／Bol／Inv_sp、Abook1 條件、Ticka_m、MRP 條件、Pdtinf、Invstk 條件、TableSchema／TableSetting 條件／Library 查詢條件

• 原本英文介面的畫面（Ormast_s、Daily、SettingView 的 Save/Exit）改為依語言顯示，中文語系下會看到中文。

• 標籤尾隨的冒號一律拿掉（與其他頁面一致）。

翻譯來源：Common/Lang/Xaml/*.json 新增 26 檔、追加 24 檔，共約 480 個 key；英／日／越譯文為機器初稿，發現不妥可直接改 JSON 不必動程式。

未變

• 系統外殼（ERPSystemContainerView 頁籤、主選單 MenuView）走另一套固定屬性翻譯，本次未動。

• 報表預覽視窗、Doc Explorer、關於我、測試面板等 Window 型視窗本次未動。

• 已無人引用的舊變體畫面（*_zd／*_US／*_old／日期戳版）未動。

2026-08-25 廠商資料表（SPDATA）新增「索引分類帳」分頁

使用者可見變動

• 廠商資料表多一個「索引分類帳」分頁，位置在「信件搜尋」之前。行為與客戶資料表的同名分頁一致：

- 只有具備 ABOOK2（索引分類帳）瀏覽權限的使用者看得到這個分頁。

- 切入分頁自動帶入條件：索引種類＝客戶或廠商代號、索引起迄＝目前廠商代號、期間預設當月；不自動查詢，按「查詢」才查。

- 廠商代號空白（新增中／沒有資料）按查詢會提示「廠商代號空白，無法查詢索引分類帳」並不查；索引被清空時自動補回目前廠商再查。

• 客戶資料表的索引分類帳分頁行為不變（實作改為兩邊共用同一套）。

技術備註

• 共用基底 ViewModel/N.GeneralLedger/Abook2HostViewModel；CudataAbook2HostViewModel／SpdataAbook2HostViewModel 只提供代號。

• App.xaml 版面抽成 Abook2HostTemplate 共用，兩個型別各掛一個 DataTemplate。

• Lang：Spdata.json／Cudata.json 補「索引分類帳」key。

---

title: PACKING LIST 兩家共用修正：單箱材積漏除 1000000、匯入鈕派發靜默失效

date: 2026-08-25

not_in_nav: true

---

PACKING LIST 兩家共用修正

適用：所有中文 schema 帳套（禾久、朝陽…）。

1. 單箱材積算成 100 萬倍（`Twork_ord_vw_pkdeSource.SetVolume()`）

• 問題：公版手改箱長/箱寬/箱高時的材積公式漏了 /1000000（公分→立方公尺），算出的立方呎是正確值的 10^6 倍並寫進 pkde.單箱材積。

• 證據：禾久與朝陽 VFP 原碼皆有 /1000000；朝陽 DB 實資料 5/5 筆吻合帶除法算式；同 repo 姊妹程式 RTAXMA（RtaxdeSource）同式本就帶除法。

• 修正：補 / 1000000m（一行）；測試對點 100×100×116→40.97、120×100×102→43.23、500×600×500→5297.21。

• 歷史資料：禾久 pkde 箱長>0 為 0 筆、朝陽資料為 VFP 寫入——dev 庫無需回補；正式機若有人用新版手改過尺寸，單箱材積 可能是錯值，需抽查。

2. 匯入鈕（出通單／CI）從未能用（`Twork_qry_pk`）

• 問題：派發 TWORK_QRY_PK（四庫皆無此 SP、proc_param 未登錄→派發器靜默不執行）；POCO 英文屬性對不上中文欄；型別錯配會丟例外；讀 Tables[1] 對朝陽 1 表形狀越界；查詢別寫死 11 而朝陽 SP 只有 1/2。兩家的 DARB_QRY_PK 是兩支不同 SP（禾久：查詢別 11 回 2 表；朝陽：1 出通單／2 CI 各回 1 表）。

• 修正：派發名改 DARB_QRY_PK；依回傳表數判形狀（0 表才 fallback 查詢別 2）；POCO 中文化＋型別對 SP；SetData 只覆寫 SP 有回的欄（不洗使用者已填值）；meas 取紙箱尺寸（朝陽）。測試 15 案。

• 使用者可見：禾久／朝陽的「匯入」開始有資料（原本恆空）。

• 未驗：runtime 兩家皆未開窗按匯入；正式機 SP 版本與 proc_param 需抽查（darbcmacsa1 只有查詢別 1、darbzdcsa1 無此 SP）。

3. 匯入的尾數箱毛重偏高（`Twork_qry_pk.GetPkde`）

• 問題：尾數箱（不足一整箱的最後一列）的單箱毛重用了整箱列的淨重＋箱重，而非尾數箱自己的淨重＋箱重（禾久 VFP :1956／朝陽 :2520 都是後者）。例：整箱淨重 7／毛重 7.8、尾數 500 件淨重 3.5 → 應為 4.3，修前算 7.8。

• 修正：一行改用尾數列淨重（GetPkde 依賴 Source 的 Context 反查，無法純單元測試；證據為兩家 VFP 原碼，runtime 未驗）。

4. 存檔時 CI單號 重複檢查（`PkSave.AllowSave`）

• 問題：VFP 兩家 cino 控件都有 is_noduplicate="pkma"，新版只有輸入側框架檢查（該欄被編輯過才觸發；複製新增沿用原 cino、匯入帶值都不經過），存檔側沒有背書。朝陽側 WP3 已先補在 Pk_cySave。

• 修正：上提到公版 PkSave.AllowSave，兩家同套；同 cino 且不同 pkid 存在時擋下「CI單號 資料重複」。

相關：changelog 2026-08-25-pk-cy-screen-fork.md、memory order-module-union-align。

---

title: 朝陽變體程式其他功能鈕消失修復＋裝箱單「查核」視窗

date: 2026-08-25

---

朝陽變體程式其他功能鈕消失修復＋裝箱單「查核」視窗

使用者可見變動

兩家共用（框架）

• 朝陽所有走變體鍵的程式（訂單管理／出貨通知單／客戶報價單／PACKING LIST／客戶資料表／BOM…）右側「其他功能」鈕整排消失 的問題修復：登入時權限列被改寫成變體鍵（PK→PK_CY）後，其他N說明字典用原鍵查不到 ⇒ 一顆鈕都不建。現在變體鍵查不到會退回母鍵（LogicBll/銜接/ExtendFunctionKeyResolver）。朝陽 dev 實測 PACKING LIST 重新出現 修增／查核／合併／標籤新增／設定棧板／其他報表／條碼 七顆（未實作的呈灰色停用）。順帶補上原本漏抄的「其他9說明」。

• 禾久不受影響（不走變體鍵）。

朝陽 PACKING LIST（Pk_cy）

• 新增其他功能「查核」（VFP 子表單 PK_E）：唯讀彈窗「出貨查核視窗」，依品號並排 PK 數量（單箱數量×箱數彙總）與出貨倉單數量，多加「差異」欄（非零紅字）。每次查詢先清空（修 VFP 連按累加）；一張 CI 對到多張倉單時全部合併；出貨倉單號／CI單號可手改。

• 已知限制：SE- 新制單號自動帶出貨倉單號在 dev 資料上幾乎全空（pkde.交易單pkid 多為 0），要在朝陽正式機再驗；目前多靠手 key 倉單號。

驗證

單元測試 23/23（含 ExtendFunctionKeyResolver 4、PkCyCheckRules 11、smoke 8）；MSBuild 0 error；朝陽 dev UIA：開窗→按查核→查詢→連按不累加→離開，全過（.claude/tmp/pk-e-verify-log.txt）；fresh-context 對抗審查 🔴1（BasedOn）🟡4 🟢4 已處理或記錄。

---

title: 朝陽 PACKING LIST（Pk_cy）畫面對齊朝陽 VFP：欄位／計算鈕／重排序號／cino 反查／匯入

date: 2026-08-25

not_in_nav: true

---

朝陽 PACKING LIST（Pk_cy）畫面對齊朝陽 VFP

適用：朝陽（CY）帳套 PK_CY。禾久與其他帳套畫面不受影響（共用 Pk.xaml／PkSave 未動；PkEdit 只抽 virtual 掛點）。ADR 0142 第二支。

使用者可見變動（朝陽）

畫面（原本是禾久版複本）

• 移除 15 項朝陽沒有的欄位/按鈕：主檔 ci日期、轉退稅註記（朝陽 DB 無欄）、幣別、總金額、後置文字、起始箱號、「依序號排箱號」鈕；明細 不足箱、後置文字、包裝量_箱（朝陽 DB 無欄）、數量、單價、毛重、淨重、材積、廠商代號、交易單pkid、庫存單箱數量。

• 補回明細 5 欄：棧板長／棧板寬／棧板高／棧板別／單板材積；明細 36 欄改照朝陽 VFP 欄序，固定欄寬。

• 明細新增兩顆計算鈕欄：「計算材積」（箱長×箱寬×箱高 → 單箱材積，立方呎）、「計算單板材積」（棧板尺寸 → 單板材積＋棧板尺寸字串）；只在新增/修改/複製模式可按。

• 截止棧板號輸入後自動算棧板數（截止−起始+1，照 VFP 不防呆）。

• 箱長／箱寬／箱高改為純輸入（照朝陽 VFP：只有按鈕才重算材積，不再每次改尺寸自動算）。

• 修改閘門：朝陽不檢查「轉退稅註記」（朝陽 VFP 無此檢查、DB 無此欄；原公版會靜默空轉）。

行為對齊（WP3／WP4）

• 重排序號鈕（依前置文字／起始棧板號／起始箱號／客戶訂單號）、cino 三段反查帶值（含 POLARIS→商品名稱、A07→前置文字 CY）、cino 重複檢查。

• 匯入鈕改成兩顆（照朝陽 VFP）：「匯入出通單」（以 CI單號 欄的值當出貨通知單號查 salema）與「匯入CI」（查 ci_m/ci_d，並帶入 ci_m 的頁首備註／頁尾備註／正嘜）；兩顆只在新增態且 CI單號 非空可按。

• 匯入明細照朝陽規則展開：單箱數量＝包裝量_箱（0 時改用 包裝量）、MEAS＝紙箱尺寸、合約號碼＝reqno（CI 為空）、尾數箱序號續編不加 'A'（訂單量不足一箱時整箱列仍佔一個序號，照 VFP 留空號）、商品名稱為 POLARIS 時箱號從同年度最大截止箱號續編、匯入後補 20 列空白列供手動輸入（存檔時空品號列自動略過）。

• 匯入後右側總箱數／總淨重／總毛重／總材積／總數量立即重算。

• 查無時提示「查無此出貨通知單號碼 !!!」／「查無此CI號碼 !!!」；派發失敗（SP 未部署等）改跳「匯入失敗：…」而非靜默無反應。

• 匯入 CI 帶不到單價（朝陽 SP 不回）：存檔時若有明細單價為 0，跳「明細有 N 列單價為 0（序號…），是否繼續存檔？」確認，選否則不存檔（畫面無單價欄，故為確認而非擋死）。

• 與 VFP 刻意不同（皆 VFP 殘值，禾久 VFP 與公版皆已改）：整箱列數量＝單箱數量×箱數（VFP 為總數量，與尾數列相加會超量）；尾數列淨重／毛重＝該列單箱值（VFP 沿用整箱列的值）；匯入後不清空畫面前置文字。

兩家共用修正（同日另列）

• 公版 SetVolume() 漏 /1000000（手改箱尺寸時單箱材積 100 萬倍）已修——見 2026-08-25-pk-public-fixes.md。

• PACKING LIST 匯入鈕 TWORK_QRY_PK 派發靜默失效已修——同上。

本輪不做（停放）

• 條碼檢查兩分頁（page4/page5）：朝陽 dev 庫缺 混板棧板號 欄，待正式機 DDL 確認。

• 五支子表單（修增／標籤新增／查核／合併／設定棧板／條碼）：VFP .scx 原始碼待匯出。

• 表頭字面（長/寬/高(箱;棧板)、備註(交貨地點)、合約號碼(BIT,REQNO)）暫維持新版，改 JSON 顯示值即可。

• 單價 0 確認選「否」後，改顯示「存檔已取消（明細單價為 0）」（原本會把提問原句再彈一次，08-25 朝陽 dev 實測抓到後修正）。

• 新增態右側五項合計（總箱數/總淨重/總毛重/總材積/總數量）改為歸零（原本停在上一張單的數字；公版 PkViewModel.AfterAddNew 補 Refresh()，禾久一併受惠，純顯示不進 DB）。

• 明細「品號」欄寬 125→150、「客戶品號」140→180（原寬度會把 36100-A5L-1002-A1 靜默截成 …-A；pkde 客戶品號 >16 字者 619/44882 筆）。

驗證狀態

建置 0 error；單元測試全綠（PkCy 六組＋PkQry＋smoke 87/87）；各工作包 fresh-context 綁定核對＋對抗審查。

2026-08-25 朝陽 dev（darbcycsa1）UIA runtime 驗訖兩輪（腳本 .claude/tmp/pk-cy-verify.ps1，log pk-cy-verify-log*.txt，截圖 shots/pkcy*）：開窗、既有單載入（A07 前置文字 CY、棧板欄、計算欄）、錯誤 cino 擋下、出通單／CI 反查帶客戶、匯入出通單（2 筆展開 3 列＋20 空白列，總箱數 17／總數量 6300）、匯入CI（ci_m 三備註帶入、2 列）、重排序號、重複 cino 存檔擋下、單價 0 YesNo 選否不存、取消復原；DB pkma 筆數前後不變。

第三輪（修正後）加驗：新增態合計歸零、客戶品號完整顯示、grid 內填箱長寬高按「計算材積」→單箱材積 2.12（總材積同步）、填棧板長寬高按「計算單板材積」→單板材積 34.96／棧板尺寸 110*100*90、匯入列右半欄（訂單編號 CO2026400178／預訂交期 2026/04/22）。fresh-context 審查報告 .claude/tmp/pk-cy-runtime-review-20260825.md（15 項通過、🟡3 已修/已補驗、🟢2 為共用控件既有行為另案）。

未驗：實際存檔寫入（兩道閘門皆擋下、刻意未寫庫）、POLARIS 續號（dev 無樣本）、棧板數（截止棧板號未填）、禾久側公版匯入（禾久 dev 無 ci_m 明細與 pkma 資料）、朝陽正式機（SP 欄位型別存證仍待做）。

---

title: 朝陽 PACKING LIST 條碼檢查視窗＋兩個條碼分頁（CyPdfCheck 內建化）

date: 2026-08-25

---

朝陽 PACKING LIST 條碼檢查視窗＋兩個條碼分頁

使用者可見變動（朝陽）

• 主畫面明細改成三個分頁：明細／條碼檢查／混板條碼檢查（後兩者為 pkbarcode1 唯讀呈現，對應 VFP page4/page5）。明細分頁內容與欄位設定完全不變。

• 其他功能新增「條碼」（VFP 子表單 PK_BARCODE）：檢查條碼視窗——公司選擇（YMMC／TYM／YJBM／YJBM更新側嘜／YMMC混板側嘜）、混板棧板號（預設帶明細的棧板號 CSV）、「手動掃描」產生預期 P/K/V/S/Q 五段條碼清單（已存過批次則載入既有批次）、掃描槍逐槍檢核（行位／內容錯誤訊息照 VFP 原句）、五段全對 檢查=OK、全選／取消全選、儲存（只存勾選列、整批同一唯一碼；trigger 自動汰換同 CI 舊批次）。

• 「選PDF」改為 ERP 內建：選標籤 PDF → 逐頁抽內嵌圖 → 解 CODE128（品號）／CODE39（P/K/V/S/Q）→ 直接餵進清單。不再需要 C:\TEMPS\CYPDFCHECK\Cypdfcheck.EXE 與 DBF。

• 混板路徑需 pkbarcode1.混板棧板號 nvarchar(100)（sql/pkbarcode1-add-mixed-pallet-cy.sql，dev 已套；正式機待跑）。

• 裁決：0 筆勾選存檔擋下「未勾選任何條碼列，無法存檔 !!!」（VFP 會清空舊批次）；公司選擇 4 箱號恆 0 照抄（程式註 TODO）；全選／取消全選在產生清單後可用。

驗證

單元測試 47/47（規則 R-1~R-4 逐條具名案例＋PDF 解碼分類）＋PkCy 回歸 92/92；MSBuild 0 error。朝陽 dev UIA：三分頁（SE-202600029 25 列 OK）、開窗、手動掃描載入 25 列、模擬五槍掃描、取消全選→儲存被擋零寫入、全選存檔整批汰換（trigger 生效、筆數不變、唯一碼更新）、離開。未驗：真實標籤 PDF 解碼、真掃描槍、混板（公司選擇 5）實資料、正式機。

• 修正：套 BtnSelectAll/BtnUnselectAll 樣式的鈕在本彈窗不可見（功能正常），改自組 Image＋文字；該樣式在其他頁面（Odtosl／Ci_m1／DeletePassNumber）是否同樣不可見待查。

• 對抗審查修正（08-26）：勾選欄可手動點（grid 整張 IsReadOnly 改逐欄）；五段碼生成前照 VFP cursor 欄寬截斷（P/K/Q 15、客訂單箱號 20、SRNO 21、品號 30，+8 測試；pk_p1 列印端是否同寬待確認）；裝箱明細補回 DARB_RPT_PK 的 cudata/invent/codata 過濾語意（EXISTS 版，dev 44,872 筆與 SP 一致）；產生清單後焦點回掃描框；新增態兩個條碼分頁清空；無單據（Empty）時按條碼／查核改跳「尚未選擇單號」訊息；單箱數量 numeric 改四捨五入。UIA 複驗：勾選單擊 On→Off、焦點在掃描框、新增態分頁 0 列、0 筆存檔擋下。

• 待裁決：VFP 第二段 SCAN 的 前置文字 memvar 殘留（整張單 S 段用最後一列的前置文字）新版改逐列用自己的；grid 表頭沿用 VFP 英文字面（P_CODE 等）。

2026-08-25 庫存主檔統計分頁文字補翻譯＋待辦清單「核准」欄改「審核」

使用者可見變動

• 庫存主檔（INVENT）→ 統計分頁：表格內「檢視」按鈕與「內容」欄超連結的提示文字「開啟對應程式並跳到這一筆」原本寫死中文，切換語言不會跟著變；現在改走翻譯檔（Shared.json _Common 新增「開啟對應程式並跳到這一筆」一組四語）。客戶資料表（CUDATA）統計分頁同一句提示文字一併改走翻譯。

• 待辦清單（TODOLIST）：五個分頁（本人／代理人／直接下屬／間接下屬／已審核查詢）表格的「核准」欄表頭一律改名「審核」，與旁邊的「快速審核」欄及審核視窗名稱一致。翻譯檔 TodoList.json 已有「審核」條目，各語言顯示不變。

範圍

• TsERP/D.Bom/InventStatistics.xaml、TsERP/E.Order/CudataStatistics.xaml、TsERP/Z.System/TodoList.xaml、Common/Lang/Xaml/Shared.json。

• 沒有動資料表、沒有動行為；純顯示文字。

2026-08-25 庫存主檔（INVENT）：工程圖檔搬到「工程」分頁、取消圖片預覽、開檔超連結加權限閘

使用者可見變動

• 「基本」分頁的「圖檔」群組：只剩「圖檔名稱」與產品圖預覽；原本並排的「工程圖檔」欄與工程圖預覽（圖片／PDF 檢視器）已移除。

• 「工程」分頁的「工程文件」群組：最下方新增「工程圖檔」欄（路徑選檔框，與原本同一個欄位、存檔行為不變：選本機檔會複製進數位圖庫 Drawing 資料夾、存相對路徑）。

• 「開啟圖檔」超連結：在工程圖檔欄右側，只有權限表（_menu 使用者權限列）「備註」欄含「工程圖檔」字樣的使用者才看得到；點了用系統預設程式開啟圖檔。沒有此備註的使用者仍看得到、改得了路徑欄，但沒有開檔連結、在唯讀狀態雙擊路徑欄也不會開檔（控件新增 AllowOpenFile 屬性；其他頁面預設不變）。

• 工程圖檔不再做圖片／PDF 內嵌預覽（使用者裁決）。

• 開檔方式改變（全系通用）：所有「開檔案」的超連結——雙擊路徑欄、「開啟圖檔」連結、BOM 流程圖卡片開圖／影片、數位圖書館檔案總管開檔、圖書館／聯絡單附件開啟、庫存主檔(E)附件、郵件範本附件、外部資料檔案——一律先把檔案整個讀進記憶體、寫到本機 C:\Temps\OpenFile\<檔名>_<雜湊>.<副檔名> 再開啟副本。原檔（網路圖庫）不會被外部程式鎖住，開啟後在程式裡改到的是副本；同一檔重開不重複落地；每次開檔前自動清掉該資料夾內前一天以前的副本（當天的保留）。

影響範圍

• 只影響公版 INVENT 畫面（InventTab1／InventTab2）；Invent_prime／Invent_zd／Invent_bs 變體本來就沒有工程圖檔欄，不受影響。

• 資料表、view、存檔邏輯（InventSave）皆未變。

設定方式

• 要讓某使用者看得到「開啟圖檔」連結：在該使用者 INVENT 的權限列「備註」欄加上 工程圖檔（與既有「真實成本」「單價」等備註開關同一機制，可並列）。

2026-08-25 表格自動產生欄：日期時間統一顯示 yyyy/MM/dd HH:mm:ss

使用者可見變動

• 所有自動產生欄位的表格（資料瀏覽器、清單瀏覽、查詢結果等 AutoGenerateColumns 的畫面），DateTime 型別欄一律顯示 yyyy/MM/dd HH:mm:ss、置中。原本沒有指定格式，交給系統文化預設，會出現「2026/8/25 下午 03:00:00」這類不齊的寫法。

• 各維護程式 XAML 明寫的日期欄（TsGridViewDataDateColumn，預設 yyyy/MM/dd）不變（使用者裁決：只調自動產生欄）。

技術備註

• TsControl/TsTelerik/TsRadGridHelper.ApplyColumnStyle 新增 DateTime／DateTime? 分支，格式常數 AutoDateTimeFormat。

• 欄寬仍由版型存檔／Auto 決定；帶秒後約需 150px，若某瀏覽窗已「記憶格式」存了舊欄寬，需重設一次。

2026-08-25 自訂儀表板：表格磚金額欄改依本國幣小數位顯示

使用者可見變動

• 自訂儀表板（DASHBOARD）表格磚的金額欄（單價／金額／本幣／未稅／含稅／成本／價／amount／price，或設計者在磚上指定的「金額欄」）改依本國幣的小數位顯示——台幣為 0 位。原本照資料庫欄位的小數位，numeric(18,4) 的金額會印出 4 位小數。

• 數量、重量等非金額欄不變，仍照資料庫小數位。

• 查不到本國幣小數位（幣別主檔沒該幣別）時維持原行為。

• KPI 卡與圖表磚不在此次範圍（KPI 沿用磚設定的小數位）。

技術備註

• DashboardAggregator.Table 新多載帶 isAmountColumn＋金額小數位；顯示字串 新多載帶 固定小數位。舊多載行為不變。

• DashboardQueryEngine：Lazy<int?> 一次查 OpenDbfTable.GetDecimalPlaces(Env.LocalCurrency)；測試建構子為 null。

• 金額欄判斷共用 DashboardPermissionGate.IsAmountColumn（與看單價遮蔽同一套）。

2026-08-25 儀表板卡片庫移除「部門受訂金額佔比」

使用者可見變動

• 自訂儀表板／儀表板設計的挑卡清單不再有訂單類卡片「部門受訂金額佔比」（ORMAST_部門受訂佔比）。卡片庫由 204 張變 203 張。

• 已放進個人版面的該卡（若有）會因卡片定義不存在而不再顯示；公版 D0001～D0007 本來就沒放這張卡。

原因

該卡是 vwbd_ormast.業務部門 欄的唯一用途；正式機部署時決定不修改共用檢視 vwbd_ormast，改為直接拿掉卡片。

範圍

• LogicBll/M.EIS/Dashboard/Cards/ORMAST.json（刪一張卡）、sql/dashboard-cards-deploy-20260820(-cy).sql（種子重產）。

• 新增 sql/ormast-dept-card-remove-20260825.sql：刪卡片列＋把曾加過 業務部門 欄的 vwbd_ormast 還原成原始定義（正式機不需要）。

• sql/ormast-view-add-dept-20260821(-cy).sql 作廢。

2026-08-25 自訂儀表板（DASHBOARD）：水平卷軸固定在視窗最下面

使用者可見變動

• 互動模式（ERP 內檢視／編輯）的磁貼格區改為自己捲動：欄數超過視窗寬時，水平卷軸永遠貼在視窗底部，不必先把頁面捲到最底才摸得到；頁首、工具列、分頁列固定不動。

• 舊版「不限列數」的儀表板改在格區內縱向捲動（原本整頁捲）。

• 列數自動推算時預留一條水平卷軸的高度，欄數超寬時不會多出一條小小的垂直卷軸。

• 匯出 HTML（靜態）、行動版與列印／PDF 版面不受影響。

技術備註

• DashboardHtmlWriter 在 <body> 加穩定的 data-shell 屬性（data-mode 會被 setMode 改成 view/edit，不能當 CSS 鉤子）。

• DashboardHtmlCss：body[data-shell="interactive"] → .wrap → .page-host → .page 撐滿 100vh 的 flex 鏈，.grid{flex:1;min-height:0;overflow:auto}；@media print 全數還原成 block／auto。

• DashboardHtmlScript.fitUnit：可用高度 - 18。

• 驗證：LogicBllTests Dashboard 全組＋smoke 284/284；Chrome 以模擬 900×520 視窗實看，水平卷軸貼底、頁首固定。

---

title: 客戶單價查詢（Twork_biz_cusp_price）派發修復：查詢價格／自動帶價不再靜默回空

date: 2026-08-25

not_in_nav: true

---

客戶單價查詢派發修復

適用：所有中文 schema 帳套（禾久、朝陽…）。受影響功能：客戶報價單「查詢價格」側邊面板（公版）、RATOSA／TRSAMA 自動帶價、預示表樞紐輸入／年度預估的品號帶價。

問題

Twork_biz_cusp_price 整支經派發器呼叫 TWORK_BIZ_CUST_UNITPRICE，但中文帳套的 SP 叫 DARB_BIZ_CUST_UNITPRICE（TWORK_ 版只存在振德的英文 schema 帳套）。派發器 DARB_LOG_SYS_EXEC 查 proc_param 查無登錄就靜默不執行，回空、不報錯；加上 POCO 屬性是英文名而 SP 回中文欄名，即使登錄了也整排空白。結果：上述功能在中文帳套從來沒有帶出過價格。

修正

• 派發名改 DARB_BIZ_CUST_UNITPRICE（兩客戶 log 庫已登錄，qty=4，參數序 @查詢別/@客戶代號/@品號/@日期）。

• 三個查詢別 POCO 屬性改中文＝SP 欄名（補 匯率單號／單重／最低訂單量），並以 [TsColumnName("英文欄名")] 備援英文 schema。

• 查詢別 4 依回傳表數判形狀：禾久 2 表（訂單最新＋報價全部）、朝陽 1 表（只含報價），不寫死帳套。

• 9 個呼叫端與 CupdmaSpecialQuery.xaml 15 欄同步改中文屬性名；行為不變。

• 測試 CuspPriceTests 14 案（假連線、走真實產品方法）。

使用者可見變動

禾久／朝陽帳套的「查詢價格」側邊面板與自動帶價功能開始有資料（原本恆空）。

停放（待裁決）

1. 禾久帳套 SP 無查詢別 5／6 分支：RATOSA／TRSAMA 走查詢別 5 的自動帶價在禾久仍回空（SP 層缺口，非程式）。要補分支屬業務裁決。

2. runtime：禾久 CUPDMA「查詢價格」側邊面板 2026-08-25 實機驗訖（QN20260040 → 訂單最新 1 筆＋報價 3 筆，修復前恆空）；RATOSA／TRSAMA 帶價尚未開窗驗。

3. 禾久 SP 查詢別 5／6 已照朝陽版補入（sql/darb-biz-cust-unitprice-add-qt56-20260825-nogi.sql，dev 實查訖；-nogi-prod.sql 正式機待跑）。注意 5／6 照朝陽帶 已審核='Y'，禾久未審核報價（dev 516 筆）不會被自動帶價——若要放寬需另開新檔。

（振德環保帳套為英文 schema，本系統派發器寫死 DARB_LOG_SYS_EXEC，振德在派發器層本就不可達且會明確報錯——本次改名與它無關，不列風險。）

相關：memory cusp-price-dispatch-silent-empty、dispatched-proc-param-qty-gotcha。

---

title: 朝陽客戶報價單（Cupdma_cy）畫面對齊朝陽 VFP：比價表／歷史報價／回傳／From Excel

date: 2026-08-25

not_in_nav: true

---

朝陽客戶報價單（Cupdma_cy）畫面對齊朝陽 VFP

適用：朝陽（CY）帳套的客戶報價單 CUPDMA_CY。禾久與其他帳套畫面不受影響（共用 Cupdma.xaml／CupdmaSave 未動；CupdmaViewModel 只加 virtual 掛點）。ADR 0142。

使用者可見變動

畫面（原本是禾久版複本）

• 移除 14 項朝陽沒有的欄位：主檔 業務員編號、製表人員、叫修單號、活動起始日、活動截止日、預計結案日、實際結案日（朝陽 DB 無欄）、報價別、報價備註；明細 中文描述、規格、客戶價（朝陽 DB 無欄）、金額。

• 報價人員還原為獨立欄（原被併成業務員查詢的附屬描述）；補回 聯絡單id（唯讀）。

• 明細 23 欄欄序改照朝陽 VFP（客戶品號移到第 2 欄…共 16 位變動，欄位集合不變）；全部欄位固定欄寬（依 DB 實測長度）。

• 新版側邊「取價」分頁移除，改為畫面內 客戶比價表 grid2（照 VFP 欄序，含「回傳」鈕欄）。

客戶比價表（grid2）

• 「查詢價格」列出其他客戶對同品號的已審核報價（本客戶排除），附 類別＝2.報價、本國報價（單價×匯率，本位幣小數位）。

• 「回傳」：品號與幣別都相符才把該列的客戶品號與單價填回明細列，不符提示「品號或幣別不合」。

歷史報價分頁

• 瀏覽單據時自動列出本客戶各品號的全部歷史報價（一次批查整單，同客戶連續換單不重查）；編輯時選品號／換列即同步顯示該品號歷史。

• 查到資料才展開分頁；新增單據時清空。

• 不會自動覆寫明細單價（VFP 該段 2016 年已註解）。

行為對齊（WP4）

• 客戶品號反查加生效/失效日期篩選與擋下（客戶代號空／查無）。

• 品號欄「待補」淺紫底。

• 「From Excel」匯入：檔案選擇對話框（預設 C:\轉EDI資料），17 欄對映、序號重編、空列優先覆寫、匯入後品號補值／失效清空；匯入期間不逐列彈窗。

• 編輯模式自動切到歷史報價分頁（VFP changeopmode）。

部署

無 SQL 部署（所用 SP 皆已登錄）。程式隨下次發版。

刻意偏離 VFP（請過目）

• 客戶品號對照全部失效時照 VFP GO BOTTOM 仍帶出最後一筆品號、不擋不提示不轉紫底（只有「查無」才擋）——是否改成「全失效視同查無」待裁決。

• From Excel 匯入前新增「客戶代號必填」擋下（VFP 無；無客戶代號無法反查）。

• 客戶品號反查失敗不扣住焦點（WPF 無等價機制），改以紫底提示；歷史報價分頁查到才展開；匯入數量四捨五入（VFP 語意）而非截斷。

已知未做／停放

• 聯絡單id 顯示口徑（07-22 曾裁決訂單「系統欄移除」，朝陽 VFP 報價單有此欄——暫照 VFP 顯示）。

• CY 正式機 DARB_BIZ_CUST_UNITPRICE 查詢別 4 版本需與 dev 同（dev 回單一 result set）。

• 集中式審核是否回寫 cupdma.已審核='Y'——否則比價表與歷史報價恆空（不報錯）。

• 另案線上缺陷：Twork_biz_cusp_price 走未登錄 proc → 禾久 RATOSA/TRSAMA 自動帶價、公版 CUPDMA 查詢價格靜默回空（memory cusp-price-dispatch-silent-empty）。

驗證狀態

建置 0 error；單元測試 100/100；四個工作包各經 fresh-context 綁定核對＋對抗審查並修正。

朝陽模擬實機（2026-08-25）驗訖：開窗、主檔（客戶名稱全名／報價人員／聯絡單id／殘留欄消失）、明細 23 欄 VFP 欄序、歷史報價分頁自動展開有資料、客戶比價表（排除本客戶）有資料。未驗：回傳鈕回填、編輯態流程、From Excel、客戶品號反查／紫底——清單見 .claude/tmp/cupdma-cy-fork-plan-20260825.md。

2026-08-25 客戶資料表（CUDATA）索引分類帳分頁：客戶代號空白不能查

使用者可見變動

• 客戶資料表「索引分類帳」分頁按「查詢」時，若目前客戶代號空白（例如新增中尚未輸入代號、或目前沒有任何客戶資料），會跳出「客戶代號空白，無法查詢索引分類帳」並不執行查詢。

• 若條件面板的索引起迄被清空，按查詢時會自動補回目前客戶代號再查，不會變成查全部客戶。

動機

索引範圍跟著客戶代號走；代號空白＝索引空白＝查全部客戶的分類帳，既慢又越權。

2026-08-24 生產計劃查詢：存成生產計劃單＋歷史單分頁

程式：生產計劃查詢（M.主管資訊 › PRODUCTIONPLAN）。設計取捨見 ADR 0140。

使用者可見變動

• 結果區頂端新增「備註」欄與「存成生產計劃單」鈕：按下後把這次查詢的條件、匯率表、客戶設定、訂單預示預估、生產計畫、使用量存成一張單據，單號格式 PP20260824001（PP＋日期＋3 碼流水），存好後彈出單號。查詢本身不會自動存，要留版本才按。

• 新增「歷史單」分頁：依單據日期起訖（預設近一年）列出已存的生產計劃單（單號、條件、備註、筆數、輸入人員），每列可「載入」或「刪除」。

• 載入歷史單後，畫面上方顯示「目前顯示：歷史單 PPxxxxxxxx」，條件與匯率表一併還原；金流預測分頁清空並提示「歷史單不重算」（它是當下帳款快照的計算，不屬於計畫）。重新按查詢即回到即時模式。

• 沒有查詢結果時按存檔會被擋下並提示先查詢。

部署

• 開發庫（nogi／cy 本機）已跑 sql/prodplan-save-deploy-20260824.sql（五張表＋view、_sheetno 修正、_tableseq、清單瀏覽三要件），可重跑。

• 正式機另出 sql/prodplan-save-deploy-20260824-cy-prod.sql（SQL 2008 相容），未執行。跑完要重新登入 ERP（_sheetno 登入時載入）。

• 表名維持 twork_eis_productionm/d1~d4（21／22 字）：這批表原本會被框架取號／配號鏈（DARB_LOG_BB_1_1 等）的 20 字表名參數截斷成 twork_eis_production、存檔報「無效的物件名稱」；08-24 曾暫時改名 t_eis_production* 迴避，08-25 二次裁決改回原名，改由框架 SP 本身把表名參數加寬到 60（tools/widen-tablename-params.ps1）解決截斷。部署前置條件：該庫須先跑過加寬腳本。五個 view 名 twork_eis_vw_production* 全程不變。

狀態

建置＋單元測試通過；2026-08-25 於 nogi 模擬庫開窗實測六項通過（存檔 PP20260825001／連存 002 遞增／載入還原／刪除連刪四張明細／空結果被擋／樞紐鈕正常）。已知：nogi 一次存 29,276 筆訂單＋29,102 筆計畫＋62,834 筆使用量約 22～24 秒，逼近 30 秒逾時線，朝陽資料量未測；來源缺交期的列（本次 d3 63 列／d4 36 列）會被框架存成存檔當天日期。

---

title: 朝陽訂單管理（Ormast_cy）畫面對齊朝陽 VFP＋預示比對整套上線

date: 2026-08-24

not_in_nav: true

---

朝陽訂單管理（Ormast_cy）畫面對齊朝陽 VFP＋預示比對整套上線

適用：朝陽（CY）帳套的訂單管理系統 ORMAST_CY。禾久與其他帳套畫面不受影響（共用 Ormast.xaml 未動）。

使用者可見變動

畫面（原本顯示的是禾久版畫面，現改為朝陽版）

• 移除 31 項朝陽 VFP 沒有的欄位/按鈕：主檔 訂單別、集團公司/代號/簡稱、報價單號、收付條件、稅別、交易條件、業務員編號、聯絡人、本幣未稅、「採購單收件匣」「匯入採購單」鈕；明細 顏色、折扣率、本幣未稅、客訂單序號、預計出貨日、廠商代號、建議採購量/交期/售價、請購數量、是否採購、是否核發、製程別、採購別、客戶交期、訂單分類、交期變更、營業確認、出貨別、分批交貨。

• 補回主檔欄：預示單號、流程樣板號、交易方式、數量總額（明細數量合計，即時更新）。

• 補回明細欄（共 38 欄，與 VFP 相同）：客戶訂單號、Request #、庫存管制、停用、停用日期、預訂完工日、最低訂單量、輸入日期、輸入人員、舊製造交期、製造交期（回覆日期，唯讀）、預示比對、預示資料、回覆、比對說明1、比對說明2、查聯絡單（按鈕欄）。

• 明細列樣式：單價 ≤ 0 淺綠底；預示比對含 NG 紅字粗體；有聯絡單的列序號紅字粗體；待刪列紅底（既有）。

• 新增「聯絡單」分頁（查到聯絡單才展開），列上聯絡單號可點選開啟聯絡單。

預示比對（朝陽核心功能，新版首次提供）

• 主檔「預示單號」輸入離焦即檢核：需先填客戶代號；單號不存在或客戶不符→提示並清空；為該客戶最新預示單號時僅提示、仍可存。

• 頁內「預示比對」鈕：任何模式可按（瀏覽模式當試算）。依預示單明細按品號計算「最後預示日＝最大預訂交期＋5 工作日」，逐列算扣抵前/後「交期(含)前／交期後至最後預示日」小計，寫入 預示比對（A/B→C/D，扣抵後交期前不足加註 NG）、比對說明1/2、預示資料（同品號共用）。

• 存檔時自動重算預示比對（預示單號空白則靜默略過）；存檔時明細交期 ≥ 客戶預示交期僅提示不擋。

• 瀏覽模式按預示比對後自動匯出 Excel「單一訂單預示比對」（17 欄固定序，含回覆欄）至 C:\Temps\TmpExcel\。

• 頁內「XLS 回覆」鈕（瀏覽模式）：讀回同名 Excel 的第 17 欄「回覆」，依明細 pkid 回填後自動存檔；檔案不屬於本張訂單、無可用回覆、pkid 對不到皆有提示。

其他行為對齊朝陽 VFP

• 客戶品號輸入離焦：檢核客戶代號/預訂交期必填，依客戶產品表帶出品號、包裝量，再帶客戶單價；已有製通單號且改值會提示。

• 「批次搜尋單價」鈕（編輯模式）：依客戶單價表回填全部明細單價。

• 「更新出貨」鈕（僅特殊修改）：依出貨資料重算已交數量。

• 「搜尋聯絡單」鈕（瀏覽模式）：列出本單相關聯絡單並標記明細列。

• 出通單數量、製通單號欄改為可點選超連結，直接開啟出貨通知單／製造通知單（全系統 2026-08-14 裁決：單擊超連結取代 VFP 雙擊）。

• 製通單號在「特殊修改」模式可編輯（其他模式唯讀）；新增明細列即帶入主檔客戶訂單號；「特殊修改」其他鈕改為就地特殊修改（原誤開信用審核視窗）。

部署

• CY 正式機 log 庫需跑 sql/ormast-cy-find-commpr-procparam-20260824.sql（登錄 DARB_QRY_FIND_COMMPR 到派發器參數表；冪等、含庫別守門；SQL 2008 相容）。未跑時「搜尋聯絡單／查聯絡單」靜默查無資料。

• 程式隨下次發版。

已知未做（停放，待裁決或待素材）

• 其他鈕「出貨」（朝陽版 ORMAST_S）、「改交期」（ORMAST_F）：VFP 原始碼未提供。

• 存檔自動產生聯絡單（VFP U_COMMREXTEND）：新版無對應機制。

• 庫存查詢「庫存量」口徑（VFP 只算 STOCKA/STOCKM 倉）。

• XLS 回覆鈕未接「可其他6」權限（ORMAST_CY 借用 ORMAST 權限列，槽位對不上）。

• 明細表頭字面「出貨日／金額」維持「預訂交期／原幣未稅」。

驗證狀態

建置 0 error；單元測試 64+ 案（比對引擎、Excel 讀寫、顯示欄規則、訂單工具）；四個工作包各經 fresh-context 綁定核對＋對抗審查並修正。runtime 未驗（開發機無朝陽資料）——實機驗證清單見 .claude/tmp/ormast-cy-fork-plan-20260824.md。

信件搜尋：查詢改走 LOG_SYS_SKD 派發（2026-08-24）

變動

「信件搜尋」（L-091）的讀取面全部改走派發器（使用者 2026-08-24 裁決「查詢也要走 log、不可直連」）：

搜尋信件、信箱帳號清單、重建歸戶的既有信件讀取，改經 Log_Sys_Skd_Exec →

集中自動化庫（darb*auto1）的 DARB_GETDATA4，與行事曆「查看執行結果」同一條路。

使用者可見的差異：

• 按「查詢」後 log_sys_skd 會留下派發紀錄（先前直連 SQL、無紀錄）。

• 全文檢索失敗的降級訊息改為「全文檢索查詢失敗（詳見 DebugLog），已降級為 LIKE 搜尋…」

——派發器吞例外，桌面拿不到原始錯誤碼，詳細原因要查 DebugLog。

• 桌面登入不再需要 auto1 庫的直連授權即可查詢（寫入面例外，見下）。

尚未改走派發（待裁決另案）

信箱帳號「啟用／停用／刪除」與「重建歸戶」的寫入仍是直連 auto1——派發是查詢 SP，

寫入要新建專用 SP 並逐客戶部署（auto1 SP＋log 庫 proc_param 登錄）。權限閘雙條件不變。

技術備註

• 零新 SQL 物件：DARB_GETDATA4（動態 SELECT 欄位 FROM 表 WHERE 條件）以

「TOP 放欄位串／ORDER BY 接條件尾／JOIN・OUTER APPLY 塞表名（實測 ≤250 字＜參數上限 500）」

表達原本的查詢形狀；條件走派發器 @param2 nvarchar(MAX)。

• 派發 SQL 無法參數化：關鍵字、使用者代號、日期一律經 字面()（單引號跳脫）／

跳脫Like()（萬用字元）併入字串；日期用 ISO 8601 字面值不受語系影響。

• 主要改動：ViewModel/L.Communication/MailSearchQuery.cs（建構子新增 IDatabaseConnection）。

• 三種查詢形狀（CONTAINS＋日期、客廠部過濾、LIKE＋排除詞）已在 darbcyauto1 以

GETDATA4 實跑驗證。

品號主檔加「工程圖檔」、工程代號表加「工程影片」

• 日期：2026-08-23

• 影響範圍：庫存主檔（D-01）、工程代號表（D-03）；CY 客戶需求

變動

• 庫存主檔：圖檔區塊新增「工程圖檔」欄位（路徑選擇框），對應 invent.工程圖檔 nvarchar(100)。

• 工程代號表：圖檔名稱旁新增「工程影片」欄位（路徑選擇框），對應 procno.工程影片 nvarchar(100)。

• 兩欄存檔行為與既有「圖檔名稱」相同：選本機檔案時自動複製進數位圖庫

（invent → Image 目錄、procno → Processing 目錄），DB 存相對路徑；

複製失敗（圖庫不可達）會擋存並顯示原因。

資料庫

• sql/invent-procno-media-cols-20260823-cy.sql（朝陽；正式機已部署）

• sql/invent-procno-media-cols-20260823.sql（darbnogi 測試庫；nogi1/nogi5 已跑）

• 兩支皆冪等、含驗證區；一併把 vw_invent／vw_brow_invent／vw_procno 補欄，

並修正 vw_procno 被 SSMS 檢視設計器展開造成的別名錯位風險（ALTER 回 procno.* 標準版）。

儀表板 SQL 型資料集停用

• 日期：2026-08-23

• 影響範圍：儀表板設計（A-155）、自訂儀表板（M-D5）

變動

• 儀表板資料集的「SQL」種類停用：設計器的種類下拉不再提供 SQL，SQL 陳述式欄位一併移除。

• 既有含 SQL 型資料集的儀表板定義仍可開啟，但查詢時該資料集回報

「SQL 型資料集已停用：請改用 SP 型（DARB_BD_* 預存程序）或清單瀏覽」；存檔前驗證會直接擋下。

原因

正式環境的資料庫連線帳號只進得了 log 庫，公司庫查詢一律經 dispatcher

（DARB_LOG_SYS_EXEC 提權路由）。自訂 SELECT 直連公司庫在此安全模型下

必然被拒（runtime 實測「無法存取資料庫」）；開提權派發 SP 讓任意 SELECT

通過的安全代價不划算，故裁決停用。需要自訂查詢的場景請改走：

1. SP 型：包成 DARB_BD_* 預存程序並登錄 proc_param（參數慣例 [編號, 查詢條件]）。

2. 清單瀏覽：掛 _sheetno.QueryProcedure。

3. 查詢程式型：寄生既有 M 模組查詢程式。

信件搜尋：新增「立即同步」按鈕（2026-08-21）

變動

「信件搜尋」（L-091）頂部按鈕列新增 立即同步（在「重建歸戶」左邊，每個使用者都能按）。

按下後系統把最近一筆已到期的信件同步（MailSync）排程事件重新排入執行佇列，

伺服器上的排程器約 5 分鐘內會抓一次新信；完成後重按「查詢」即可看到最新信件。

行為細節

• 同步不在使用者的電腦上執行——憑證金鑰只在排程主機，按鈕只是「送指令到伺服器」。

• 事件正在執行中（10 分鐘內開始）→ 提示「正在執行中」，不重複排入。

• 事件已在等待佇列 → 提示「已在等待執行」，不重複排入。

• 找不到已審核的 MailSync 排程事件、或預定時間都在未來 → 紅字提示原因

（需先在「排程事件（專案）」建立並審核事件）。

• 觸發成功的訊息會帶出上次完成時間。

技術備註

• 零新 SQL 物件：讀事件走 DARB_GETDATA4 派發查 twork_vw_calendarevent；

清狀態走既有 TWORK_SKD_UPDATE_EVENT_STATUS（清 已完成 時連 是否停用 一起清，

事件因此重新符合 TWORK_SKD_GET_PENDING_AUTOEXEC 的撿選條件）。

• 判定邏輯：LogicBll/MailSearch/MailSyncTrigger.cs（純函式，MailSyncTriggerTests 8 案）。

• 延遲上限＝排程器的工作排程間隔（建議 5 分鐘）。

2026-08-21 自訂儀表板：連動篩選可視化、版面不限高、查詢合併、匯出改進

連動篩選看得出誰有被篩

• 篩選作用中時，資料沒有同名欄（沒被篩到、仍顯示全量）的卡片會淡化並在標題列標「未套用篩選」；發起篩選的來源卡框線點亮。

• 能發起連動篩選的卡片（柱狀／折線／圓餅且有分組欄）標題列有漏斗小圖示。

• 修正：KPI 的前期比較值現在也套同一個連動篩選（原本主值被篩、比較值全量，增減％失真）。

版面

• 公版七張儀表板（D0001~D0007）列數改 0＝不限高，改為縱向捲動；「一頁填滿」改為在儀表板設計把列數設回正數即可。

• D0001 首頁移除「每日受訂金額」卡（月趨勢／每月柱狀已足），客戶Top10 補滿右半。卡片庫仍保留該卡，可自行加回。

• 佈署腳本不再清除個人版面與自建儀表板（2026-08-20 首發已清過，重佈署只 UPSERT 公版）。

查詢次數

• 引擎新增同源日期範圍合併：同一（單據別｜View）之下的多個純日期區間條件（本期／KPI 前期／當月／全年／同比疊線）合併成一次涵蓋全範圍的查詢，各卡在記憶體切自己的範圍。原本一個單據別家族開一次儀表板要打約 7 次查詢，現在 1~2 次。

• 條件不是純日期區間、或有卡用「統計」集的資料集不合併，照原路查，行為不變。

匯出

• 「匯出HTML」改輸出互動版：分頁 tab、版面與畫面一致（原本靜態版分頁會不見）；排程出圖仍走靜態版不受影響。

• 匯出完成後自動用預設瀏覽器開啟。

儀表板設計（第二輪，同日）

• 挑卡改勾選：「可用卡片」清單最前面新增「加入」勾選欄，單擊即勾——勾＝加進儀表板、取消勾＝移除（原「加入」按鈕移除）；勾完右側預覽自動更新。

• 選卡即看範例：在可用卡片清單點選任一張卡，右側立即渲染該卡的假資料範例（不動設計中的定義、不可拖排）。

• 預覽不再綁編輯模式：瀏覽狀態也能按「預覽」「檢查」（拖排仍限編輯狀態）。

• 分頁標題改為直接在版面分頁的清單格子內修改（原下方「分頁屬性」區移除）。

• 設計器內所有小按鈕移除圖示、只留文字。

• 「儀表板卡片」維護程式（A-156）移除（使用者裁決）：卡片庫改以版控 JSON＋種子 SQL 維護；選單與權限清除 SQL＝sql/dashboard-card-remove-program-20260821.sql（已跑 nogi1/5）。卡片資料表、_sheetno 登錄與挑卡彈窗都保留。

自訂查詢面板 × 儀表板整併（2026-08-22）

• 顯示項目可轉儀表板卡片：「匯出內容設置」每列新增「轉成卡片」鈕——選中的圖表/表格顯示項目一鍵轉成卡片（分類「自訂查詢」）寫進卡片庫，之後儀表板設計與檢視端「新增卡片」都挑得到。逐欄展開（寬轉長）模式不可轉，會提示原因。

• 磚新增「計算欄」：兩欄運算的衍生欄（差異/比率等，語意同自訂查詢），表格可入欄位清單、圖表可入序列、KPI 可當數值欄（前期比較同步套用）。

• 磚新增「多欄序列」：一欄一序列（柱/折），多個數值欄同圖對照，序列名可用欄位別名改。

• 表格磚新增「隱藏零值」：整列數值皆 0 不顯示、單一 0 顯示空白（語意同自訂查詢匯出）。

• 匯出HTML 可附帶儀表板：匯出選擇彈窗新增「附帶儀表板」勾選區——勾選的儀表板以「指標摘要一頁＋一磚一頁」接在查詢頁後面，同一份 HTML/PPT、同一組風格；期間跟著面板的目標月份。

2026-08-20 自訂儀表板改成「挑卡片」：卡片庫、設計器卡片分頁、檢視端新增卡片

使用者可見變動

儀表板設計（`A-155`）

• 新增 卡片 分頁，而且是打開就在的第一個分頁。左邊列可挑的卡片（分類／標題／單據別／型別／預設尺寸／說明，可用分類下拉篩選），按 加入 就多一塊磚；右邊列已加入的卡片，可 移除／上移／下移。

• 加入卡片時系統自動帶進它需要的資料來源，同一組條件的卡片自動共用一次查詢。

• 參數／資料集／磚 三個分頁改成進階設定，預設隱藏——左上角勾 進階設定 才會出現。版面 分頁維持顯示。

• 新增一張儀表板時預設：版面 14×5、一個「主頁」分頁、不顯示進階設定。

自訂儀表板（`M-D5`）

• 編輯版面模式的工具列多一顆 新增卡片：開挑卡視窗（可複選、可依分類篩選）→ 確定後畫面重查並停在編輯模式，新卡片就在版面上，拖到想要的位置後按 儲存版面 才會保留。

• 挑卡清單只列「你有瀏覽權限、該程式有掛清單瀏覽查詢、而且這張儀表板上還沒有」的卡片。

• 還原預設 會連同自己加的卡片一起收掉。

內建卡片（20 張）

單據別	張數	內容

ORMAST 訂單	9	本期受訂金額／受訂筆數／未交數量合計（KPI）、客戶 Top10（柱）、每日受訂・月受訂趨勢（折線）、業務佔比（餅）、未交明細・客戶統計（表格）

SLIY 總帳	6	本期借方・貸方總額（KPI）、科目 Top10（柱）、每日傳票金額（折線）、部門佔比（餅）、傳票明細（表格）

TRSAMA 出貨	5	本期出貨金額（KPI）、客戶・品號 Top10（柱）、每日出貨（折線）、出貨明細（表格）

> TRSAMA 目前不會出現在挑卡清單：_sheetno 尚未登錄 QueryProcedure（DARB_BD_TRSAMA 已存在），補登錄後即可挑選。

開發者

• 契約：DashboardCard（代號／單據別／標題／分類／說明／資料集／磚／預設尺寸／允許尺寸／參數）、DashboardTileDef.卡片代號、DashboardLayout.額外卡片。

• 卡片庫 LogicBll/M.EIS/Dashboard/Cards/DashboardCardLibrary.cs：

- 從內嵌資源 Cards/*.json 載入（csproj 萬用字元，新增卡片檔不必改 csproj），處理程序內只載一次；單一檔 JSON 壞掉只記 DebugLog 並跳過該檔。

- ForUser(IAppContext)：功能權限（走 DashboardPermissionGate，含 ProgramClassRouter.ApplyCompanyOverride 變體解析）＋ 清單瀏覽型必須有 _sheetno.QueryProcedure。

- Materialize(代號清單, def)：資料集依「單據別＋種類＋條件＋ViewNo／SP／SQL／分組＋前期」簽章去重（ds_<單據別>_<n>，既有同簽章直接沿用），磚 id＝卡片代號；已存在的 id 跳過。攤出去的是深複製，不會污染共用單例。

- Validate()：代號唯一、單據別／標題非空、磚型別合法、條件 token 只能用 DashboardTokenResolver.內建Token（鑽取額外允許 {分類}）。

• 引擎：DashboardQueryEngine.併入額外卡片(def, personalLayout)（public static）在權限閘之前把個人版面的 額外卡片 攤進 def 的副本；原 def 不動，攤出來的磚照樣過權限閘。

• 版面修正：DashboardLayout.Normalize 對「沒座標但有指定尺寸」的磚改成沿用該尺寸（原本無條件給「中」，卡片的預設尺寸會被默默吃掉）。

• 檢視端：DashboardViewModel 用 _待加卡片（尚未存檔）＋_額外卡片（本次生效）兩份狀態；儲存版面 時把 額外卡片 補回 Normalize 產出的新版面（Normalize 不帶這欄，漏了會存完就消失）。

• 新增卡片的做法：見 skill dashboard-card（含 references/card-template.json 逐欄說明）。

追加（同日）：卡片庫進資料庫，卡片有編號與單據別

使用者可見變動

• 卡片定義從「只在程式裡」改成存在資料庫 twork_sys_dashboardcard：每張卡有 卡片代號（編號） 與 單據別，另有標題／分類／說明與 停用 欄。

• 效果：卡片清單可以查、可以個別停用、可以由客戶端調整（不必改程式）；資料庫還沒有卡片資料時，系統自動使用程式內建的 20 張，不會出錯也不會空白。

• 部署或調整卡片後要重新登入 ERP 才會生效（卡片於登入後首次讀取時快取）。

開發者

• 表 dbo.twork_sys_dashboardcard（單據別路由鍵 DASHBOARDCARD）：卡片代號(UNIQUE, nvarchar40)／單據別／標題／分類／說明／卡片JSON(nvarchar max, 整份 DashboardCard)／停用＋標準共有欄位；pkid 非 IDENTITY。_sheetno（編碼欄位＝卡片代號）與 _tableseq（seqval 種子後校正為 MAX(pkid)）同檔登錄。

• 來源優先序：DB 是 runtime 權威（同 卡片代號 蓋掉內嵌、DB 獨有的直接多出來、停用='Y' 不列）；內嵌 Cards/*.json 是版控源頭與後備（表不存在／連線失敗／0 列 → 退內嵌，只記 DebugLog，不丟例外）。表上的 卡片代號/單據別/標題/分類/說明 覆蓋 卡片JSON 內同名欄。

• 讀取：DashboardCardLibrary.For(IAppContext) 走通用查詢 SP DARB_GETDATA4（不必新增 SP、不必登 proc_param），每個連線字串快取一份，ClearCache() 可清；Default 會優先給最近一次以 context 載入的合併結果。DashboardQueryEngine.Run 改用 For(_context)，headless 排程出圖同樣吃得到 DB 卡片。單列 JSON 壞掉只跳過該列。

• 種子工具 tools/gen-dashboard-card-seed.ps1：讀 Cards/*.json → 產 #dashcardseed 種子 SQL（-Apply 直接寫回部署檔的 GENERATED-SEED 標記區）。JSON 以括號配對掃描原文抽出（不重新序列化），輸出不含時間戳、重跑位元組相同。

• 部署 sql/dashboard-cards-deploy-20260820.sql（NOGI 五帳套）／-cy.sql（朝陽 darbcycsa1）：建表＋_sheetno／_tableseq＋20 張 UPSERT，整檔一次跑；重跑印「新增 0 張、更新 0 張」；不動既有列的 停用。

• Model/Source：Common/Model/M.EIS/DashboardCardModel.cs、Model/Source/M.EIS/DashboardCardSource.cs、LocalDbContext.Twork_sys_dashboardcard（供之後的卡片維護 UI 走標準上傳）。

追加的相關檔案

• 新增：sql/dashboard-cards-deploy-20260820.sql、sql/dashboard-cards-deploy-20260820-cy.sql、sql/_gen/dashboard-card-seed.sql、tools/gen-dashboard-card-seed.ps1、Common/Model/M.EIS/DashboardCardModel.cs、Model/Source/M.EIS/DashboardCardSource.cs

• 修改：LogicBll/M.EIS/Dashboard/Cards/DashboardCardLibrary.cs、LogicBll/M.EIS/Dashboard/DashboardQueryEngine.cs、Model/LocalDbContext.cs、LogicBllTests/Dashboard/DashboardCardLibraryTests.cs、.claude/skills/dashboard-card/SKILL.md、docs/M-EIS/dashboard.md

相關檔案

• 新增：LogicBll/M.EIS/Dashboard/Cards/（DashboardCardLibrary.cs、ORMAST.json、SLIY.json、TRSAMA.json）

• 新增：ViewModel/M.EIS/Dashboard/DashboardCardPickerViewModel.cs、TsERP/M.EIS/儀表板挑卡.xaml(.cs)

• 新增：LogicBllTests/Dashboard/DashboardCardLibraryTests.cs（21 項）、.claude/skills/dashboard-card/

• 修改：LogicBll.csproj（EmbeddedResource）、DashboardQueryEngine.cs、DashboardHtmlWriter.cs（工具列 addCard）、DashboardMessageRouter.cs（DashboardWebCommand.AddCard）、DashboardViewModel.cs、DashboardcfgViewModel.cs、DashboardcfgItems.cs、TsERP/A.SystemData/儀表板設計.xaml、TsERP/App.xaml、Common/ProgramClass.cs（DASHBOARDCARDPICK）、Common/Lang/Xaml/Dashboardcfg.json＋新增 Dashboardcardpick.json、LogicBll/M.EIS/Dashboard/DashboardDefinition.cs（Normalize 尺寸）

2026-08-19 共用 HTML 顯示控件 TsHtmlView；郵件內容預覽修復

使用者可見變動

• 寄送 Email 視窗的「檢視內容」（SendEmail → 內容預覽）以前開出來是空白（HTML→XAML 轉換器早已拆除），現在正常顯示郵件 HTML；預覽視窗加大為 900×700，標題「內容預覽」。

• 預覽內容不執行 JavaScript、頁內連結改用系統瀏覽器開啟（郵件屬不信任內容）。

• 沒裝 Microsoft Edge WebView2 Runtime 的電腦不會閃退：顯示提示文字＋純文字版內容。

開發者

新增 TsControl/Html/TsHtmlView.cs（xmlns:html="clr-namespace:TsControl.Html;assembly=TsControl"），之後要顯示 HTML 一律用它，不要再直接放 WebView2：

屬性／成員	用途

Html	HTML 字串（NavigateToString）

Source	網址瀏覽模式

IsScriptEnabled（預設 false）	要互動才開，只對自家產生的頁面開

OpenLinksExternally（預設 true）	Html 模式下 http/https/mailto 連結走系統瀏覽器

MessageCommand ／ WebMessageReceived	頁面 window.chrome.webview.postMessage(obj) → C#（JSON 字串）

ExecuteScriptAsync ／ PostMessage	C# → 頁面

TsHtmlView.IsRuntimeAvailable ／ UserDataFolder	Runtime 偵測；資料夾固定 %LocalAppData%\TsERP\WebView2（整個 app 共用一個 Environment）

內建：宿主視窗 Closed 立刻 Dispose、Unloaded 3 秒後仍離場才 Dispose（ContentWindow 內容暫離視覺樹不會誤殺）、Dispose 後再 Loaded 自動重建並重套 Html；alert/confirm、DevTools、瀏覽器快捷鍵、縮放關閉。

離線 WPF 探針驗過：渲染中文、頁面 postMessage 進 C#、C# ExecuteScript 取值、無 Runtime 時降級純文字（四項皆有截圖／log）。

相關檔案

• TsControl/Html/TsHtmlView.cs（新增）

• TsControl/Content/ViewHtml.xaml、ViewModel/Control/Content/ViewHtmlViewModel.cs（RichTextBox → TsHtmlView；RichText 改名 Html）

• 未遷移：TsERP/AIQuery/ChatAgentView.xaml 仍直接用 WebView2（可運作，之後要改再換）

2026-08-19 測試控制面板：三方對照（SQL 欄位／本地類別／畫面 UI）

• 測試控制面板新增「三方對照」分頁：對目前開啟的程式，分別抓 _sheetno 主表＋子表的 sys.columns、程式已註冊的 Source 類別屬性、畫面控件與明細表格欄的綁定，合成一張對照表。

• 狀態分類：三方齊／DB 有類別沒有／類別有沒畫面／畫面綁到不存在的屬性／類別有 DB 沒有／畫面綁非資料來源；框架共用欄（pkid、輸入人員、工作流程、審核…）不算缺漏。

• 「只看問題」篩選＋「匯出 HTML」（與前置作業報告同目錄，檔名 <程式>-trisource.html，只留最新）。

• 規格自動測試「全部執行」在閘門通過後自動先建對照，記為步驟 0；發現缺漏只記「人工」，不阻擋後續步驟。

2026-08-20 前置作業報告：VFP 原始碼結構化

• 前置作業報告第三段改成 VFP 大綱：業務屬性表（主子表別名、鍵欄、瀏覽型別…）、版面屬性收合、方法目錄依控件分組可點跳、每個方法可摺疊（allowsave／Init／Valid／LostFocus 等測試相關預設展開），行號為原檔行號。

• 找檔改為只用禾久版（排除 *_cy 資料夾），帶家族檔（_bd／_brow），整包 vcx（如 scx_acc 內 30 支程式）經 vfpcode/index.json 或自動掃 DEFINE CLASS 找到。

• 三方對照多「VFP 驗證」欄：欄位在 VFP 有 Valid／LostFocus 等事件就列出並超連結到前置報告的該段程式碼。

• 客戶端沒有 vfpcode 資料夾時改讀隨程式發佈的 TestAutomation/vfpcode.zip（建置時自動打包，約 1.6MB）。

2026-08-19 主選單背景：客戶所在地世界地圖

使用者可見變動

• 登入後的主選單背景仍是原本的點陣世界地圖，但現在會依客戶主檔（cudata）在各國亮點：點越大客戶越多（1～2／3～9／10～99／100 家以上四級），台灣用琥珀色、其他國家藏青色；滑鼠移到點上顯示「國家 · N 家」。

• （台灣放大子圖與說明文字已做但預設關閉，目前主選單只顯示世界圖亮點。）

• 「所在地」怎麼來：國家別 有填就照欄位（TW／JP／USA／中文國名都認得）；沒填就看 公司地點 的關鍵字（日本／Japan／USA／Hong Kong／Viet Nam…），中文地址且無海外關鍵字＝台灣。台灣縣市用 公司郵遞號 前 3 碼，沒填再看地址。

- 想讓圖更準：把客戶的 國家別 或 公司郵遞號 填起來即可，下次回主選單（快取 10 分鐘）就反映。

• 背景載入、不影響選單開啟速度；查詢失敗只會維持原底圖，不跳錯。

相關檔案

• TsERP/MenuView.xaml（CustomerGeoMap 覆蓋層）

• TsControl/PageControl/CustomerGeoMap.cs（繪圖＋tooltip＋台灣子圖；各國像素座標對底圖手工標定，換底圖要重標）

• LogicBll/E.Order/CustomerGeo/（CustomerGeoResolver 判國／縣市、CustomerGeoDistribution 彙總、CustomerGeoDistributionBll 查詢＋快取）

• ViewModel/MenuViewModel.cs（CustomerGeo 屬性背景載入）

• 決策：docs/decisions/0138-menu-customer-geo-map.md

2026-08-19 排程事件（專案）接工作權限 MY_SCOPE

使用者可見變動

• 排程事件（專案）EVENTPROJECT 開窗、上下一筆、放大鏡查詢、直接輸入項目編號，只列出負責人在你的工作權限範圍內的專案：

本人／代理／直接下屬／間接下屬／部門成員（與待辦事項同一組關係，ADR 0132 決策 4）。

• 負責人空白的專案視為公用，人人可見。

• 負責人 ADMIN／SYSTEM 的系統排程專案（FXRATE／MAILSYNC／PURCH／MOLD-CHK…）只有系統管理員（secret1.管制系統 含 admin，同程式內 IsAdmin()）看得到；系統管理員看得到全部專案。（同日修正：初版曾把非員工代號一律公開，使用者實測後收窄。）

• 之前：任何有 L-050 功能權限的人都看得到全公司所有專案（含別人的個人事件專案）。

部署（每個 csa 帳套庫各跑一次，先有 `TWORK_FN_MY_SCOPE`）

sqlcmd -S <server> -d <csa庫> -E -f 65001 -i sql/TWORK_FN_EVENT_SCOPE.sql

缺函式時桌面版一開 EVENTPROJECT 會跳 SQL 錯誤（找不到 dbo.TWORK_FN_EVENT_SCOPE），不是靜默空白。

相關檔案

• sql/TWORK_FN_EVENT_SCOPE.sql（新增 iTVF，SQL2008 相容、冪等）

• ViewModel/L.Communication/EventProjectViewModel.cs（FilterCondition）

• docs/L-Communication/eventproject.md（前置需求補工作權限說明）

2026-08-19 新增「自訂儀表板」與「儀表板設計」兩支程式（可自己定義內容的磁貼式儀表板）

使用者可見變動

兩支新程式

程式	位置	做什麼

自訂儀表板（M-D5）	M 主管資訊	選一張儀表板、填期間與部門，按 查詢 就把磚（KPI／柱狀／折線／圓餅／表格）畫成一頁

儀表板設計（A-155）	A 系統資料	定義儀表板內容：參數、資料集、磚、預設版面、匯出風格

• 磚的資料來源是各程式既有的「清單瀏覽」查詢：在設計時挑一個單據別，條件可用 {起日}／{迄日}／{年月}／{部門}／{使用者} 等 token，查詢時才代換成條件面板上填的值。另可用預存程序或自訂 SQL 當來源。

• KPI 磚可開前期比較（差額／百分比、可設定「增加為好」或「減少為好」）。

• 點磚可鑽取：帶著該磚的條件切到對應單據別的清單瀏覽，落地看明細。

磁貼版面與個人版面

• 版面是 12 欄磁貼格線，磚有 小／中／寬／大 四種尺寸。

• 按 編輯版面 進入編輯模式：拖曳磚調整位置，右鍵或磚上的 尺寸 鈕改大小、隱藏 鈕收起磚；鍵盤 Ctrl+方向鍵 移動一格、Ctrl+1~4 換小／中／寬／大、Esc 取消。

• 按 儲存版面 存成你自己的版面（不影響別人，也不動設計者的預設版面）；按 還原預設 刪掉個人版面回到設計者的排法。

• 設計者之後新增的磚會自動追加到個人版面尾端，不會因為你存過版面就看不到。

分頁與 Full HD 版面（2026-08-20 追加）

• 儀表板可分多個分頁（畫面上方 tab；設計器 版面 分頁維護標題、磚屬性指定所在頁；檢視端右鍵 移到分頁 ▸、Ctrl+PageUp/PageDown 切頁）。

• 每頁固定 欄數 × 列數（新儀表板預設 14×5＝Full HD 扣掉行事曆與下方面板剛好一頁不捲動；舊儀表板沿用 12 欄、自動套 5 列）；放不下的磚自動順延下一頁；匯出 PDF 一頁一張。

• 修正：圓餅只有單一分類時整塊空白；分類值空白時顯示「(空白)」。

匯出與外觀

• 匯出HTML：把目前這一頁存成一個自包含的網頁檔（無工具列、可離線開、可轉寄）。

• 匯出行動版：產生手機直立閱讀的單欄卡片流網頁檔（檔名尾 _mobile）。

• 匯出PDF：把同一份版面產生 A3 橫式 PDF（欄數 ≤8 時 A4 橫式；深色風格會先問是否改用列印友善）。需要本機已安裝 Microsoft Edge WebView2 Runtime。

• 排程自動寄送：行事曆事件 單據別 = DASHBOARD、執行方法 = DashboardDeck，headless 產出 HTML／行動版／Excel 後以附件寄出（排程端不支援 PDF）；字典登錄腳本 sql/dashboard-autopilotmethod-register.sql。

• 右上角風格下拉可即時換配色（典雅簡報（預設）／簡潔商務／列印友善／深色簡報／賽博龐克，與 匯出HTML 共用同一組風格）。

權限

• 儀表板的可見範圍與「自訂查詢面板」相同：本人、你代理的人、你的下屬、使用部門相符者建立的儀表板才會出現在下拉中；只有建立者本人能修改或刪除。

• 磚所屬單據別你沒有瀏覽權限時，該磚不顯示（版面會自動往上壓實，不留空洞）；沒有「看單價」權限時，金額類 KPI 磚不顯示、表格的金額欄顯示 —。

一般使用者不會遇到、但會影響上線的事

• 兩支程式需要系統管理者先在資料庫部署三支 SQL（依序 sql/dashboard-deploy.sql → sql/dashboard-sheetno-tableseq-register.sql → sql/dashboard-register-program.sql；朝陽環境用同名 -cy 版），跑完要重新登入 ERP 才會生效。未部署時程式開得起來，但儀表板下拉載入會提示 SP 未部署。

• 只有 _sheetno 掛了清單瀏覽查詢（QueryProcedure）的程式才會出現在設計器的單據別下拉。想用的程式沒出現時，要先替該程式掛上清單瀏覽查詢。

開發者

• 新增 LogicBll/M.EIS/Dashboard/：DashboardDefinition（定義 JSON POCO＋DashboardLayout.Normalize/Compact）、DashboardTokenResolver、DashboardSqlGuard、DashboardDataSetRunner、DashboardAggregator、DashboardPermissionGate、DashboardQueryEngine、DashboardRenderModel、DashboardHtmlWriter（互動／靜態／行動三模式）、DashboardConfigBll。

• 資料集走輕型 DataTable 路徑（SheetNoMethod.GetQueryProcedure → Log_Sys_Exec(TWORK_BD_VIEWLIST)），不寄生查詢 ViewModel、不寫 SQLite、無 STA 依賴；同源多磚共用一次查詢。

• HtmlDeckWriter.BuildRootCss 抽成共用 DeckThemeCss；DeckChartSvg 新增 ChartRenderOptions 多載、sparkline、<title> 與 data-cat/data-ser（舊呼叫端輸出逐位元不變，golden 測試已比對）。

• TsControl/Html/TsHtmlView.cs 新增能力：ContentLoaded 事件／IsContentLoaded、PostMessage 未載入時先排隊（首包不再靜默丟棄）、PrintToPdfAsync(path, landscape, paper)、AreDevToolsEnabled（預設 false）。

• 新表 twork_sys_dashboard（DASHBOARDCFG，編碼欄位 pkid）、twork_sys_dashboardlayout（DASHBOARD）；新 SP TWORK_DASHBOARD_QRY（TWORK_FN_MY_SCOPE 六種關係）、TWORK_DASHBOARD_LAYOUT_QRY；LocalDbContext 加 Twork_sys_dashboard／Twork_sys_dashboardlayout 兩個 DbSet。

• 登錄：Common/ProgramClass.cs 加 DASHBOARD／DASHBOARDCFG；App.xaml 三個 DataTemplate；DIExtension 加 AddScoped<DashboardConditionViewModel>()。

• 決策與取捨見 ADR 0139；操作說明見自訂儀表板手冊。

相關檔案

• 新增：LogicBll/M.EIS/Dashboard/*、ViewModel/M.EIS/Dashboard/*、ViewModel/A.SystemData/DashboardcfgViewModel.cs＋DashboardcfgItems.cs、TsERP/M.EIS/自訂儀表板.xaml＋自訂儀表板Condition.xaml、TsERP/A.SystemData/儀表板設計.xaml

• 修改：TsControl/Html/TsHtmlView.cs、LogicBll/CommonSystem/Reporting/DeckChartSvg.cs、HtmlDeckWriter.cs、Model/LocalDbContext.cs、Common/ProgramClass.cs、TsERP/App.xaml、TsERP/DIExtension.cs

• SQL：sql/dashboard-deploy.sql、sql/dashboard-sheetno-tableseq-register.sql、sql/dashboard-register-program.sql（各有 -cy 版）

2026-08-20 追加：唯一代號與螢幕版頁尾

• 儀表板代號（儀表板設計）與配置代號（自訂面板配置）：兩支設計程式的主檔各加一個全公司唯一的代號欄位。新增時系統自動給 D0001／C0001 起跳的流水，可自行改成好記的代號（最長 20 字，存檔時轉大寫）；代號重複會存不進去並提示改代號。

• 導覽／定位改用代號：上一筆下一筆的排序、查詢定位（_sheetno.編碼欄位）都從 pkid 換成代號，清單依代號排序。

• 選單下拉顯示「代號 名稱」：自訂儀表板與自訂查詢面板的條件面板下拉改為可輸入，直接打代號就能篩選。

• 排程可用代號指定儀表板：DashboardDeck 參數新增 儀表板代號，與 儀表板pkid 二擇一（兩個都填時 pkid 優先）。建議改用代號——pkid 是各資料庫各自配的流水號，換帳套就對不上。

• 螢幕檢視不再顯示頁尾：互動模式（畫面上看的那份）拿掉底部「公司名／資料時間／共 N 磚 N 頁」那一列，版面高度全留給磚；匯出的 HTML／PDF／行動版仍保留頁尾（列印與轉寄需要）。條件字條上的資料時間不受影響，照常顯示。

• 系統管理者：要跑兩支新 SQL —— sql/dashboard-add-code-20260820.sql、sql/customdash-add-code-20260820.sql（朝陽用同名 -cy 版）。既有資料會自動回填代號（D／C + pkid 補零四位），跑完要重新登入 ERP 才吃得到新的編碼欄位。

2026-08-19 右側行事曆新增「新增事件」按鈕

使用者可見變動

• 右側行事曆的「事件／佈局／新增事件」列移到「個人／部門／公司」篩選列上方，並多一顆 新增事件。

• 按下直接開「新增事件」視窗（不跳轉到排程事件程式），預設：預定時間＝行事曆目前選取日 09:00、只執行一次、擁有者＝個人（本人）、通知方式＝待辦事項。

• 按「返回」即背景存檔並刷新行事曆，事件立刻出現在當日清單：

- 個人事件統一掛在「項目編號＝使用者代號」的排程事件專案下：已存在 → 直接追加一筆事件明細（序號接續）；不存在 → 自動建立專案（項目編號／負責人＝使用者代號、項目名稱＝「姓名＋個人事件」、已審核＝Y）連同事件一起寫入。

- 之後可從事件的「導航」進排程事件程式檢視／修改該專案。

相關檔案

• ViewModel/MainWindowPage/CalendarPageViewModel.cs（AddEventCommand）

• LogicBll/Calendar/CalendarBll.cs（FindProjectPkidBy項目編號／SavePersonalEvent 背景存檔）

• TsControl/Calendar/RightSideCalendar.xaml、Common/Lang/Xaml/Eventproject.json

2026-08-19 BOM 表：明細之間加可拖曳分隔線

使用者可見變動

• BOM 表（Bom）：材料明細與製程明細之間多一條分隔線，滑鼠拖曳可調整上下兩張表格的高度比例（上表至少 80px、下表至少 60px）。

• BOM 表（朝陽版 Bom_cy）：材料／製程／產品治具表三張之間各一條分隔線，同樣可拖曳。

• 分隔線樣式沿用系統既有 GridSplitterHorizontalStyle（與信件搜尋、待辦清單相同）。

相關檔案

• TsERP/D.Bom/Bom.xaml、TsERP/D.Bom/Bom_cy.xaml

2026-08-19 回到選單：還原滑鼠游標、清空狀態列

使用者可見變動

• 左欄「回到選單」按下時，系統會一併：

- 把滑鼠游標還原（程式忙碌時設的沙漏若沒收尾，回選單後不再卡住）；

- 清空最下方狀態列的訊息文字，並收起進度條。

• 若目前程式還在新增／修改中，仍照舊先提示「程式編輯中」且不切換、不清狀態。

相關檔案

• ViewModel/PageControl/MainWindow/ERPSystemContainerViewModel.cs（SwitchToMenu → ResetUiStateForMenu）

2026-08-18 其他應收付（OTHERRP）新增列印：I100-1 其他應收付單

背景

2026-08-18 帳款報表盤點列出四支「手冊寫了列印、卻一張報表都沒有」的帳款程式，

OTHERRP 是第一支補上的。VFP 原版沒有專屬 frx（browsetype=I10B 走瀏覽型列印），所以這張是全新設計，

版面比照同為 rp_m 單據的暫付申請單（Temporary），欄位取自 Otherrp 表單畫面上的所有欄位。

使用者可見變動

• 其他應收付（I-100）工具列的 列印 現在會開出其他應收付單列印頁（財務單號起訖，預設帶目前單據），

報表清單有 I100-1 其他應收付單（A4 直式、一張單一頁，含核准／財務／部門主管／經辦簽核欄）。

• 修前：按列印只會退回瀏覽頁（VM 沒實作 IPrintViewModel）。

實作（零 DB 部署）

層	檔案	說明

Model	Model/Rpt/Rpt_I100_OtherrpReportPoco.cs	中文屬性名＝SQLite 欄名＝frx Column；GetDescription() 補付款方式／收付條件說明／使用部門簡稱／進銷分類名稱／未沖金額

Model	Model/ReportBll.GetOtherrpReport	走既有 SP DARB_RPT_PREPAID（SELECT a.* FROM vw_rp_m 依條件，rp_m 系共用），不新增 SP

Plugin	TworkReportPluginOfficial/I.ARAP/Otherrp.cs	類名＝報表名稱；條件＝財務單號 between 起訖 AND 程式類別='H'

ViewModel	ViewModel/I.ARAP/OtherrpPrintViewModel.cs、OtherrpViewModel 加 IPrintViewModel	IPrintSource.GetReports() 登錄 I100-1／Otherrp／rpt_i100_otherrp_report1，免 _rptdat

Common	ProgramClass.OTHERRPPRINT、Lang/Xaml/OtherrpPrintPage.json

TsERP	I.ARAP/OtherrpPrintPage.xaml(.cs)、App.xaml DataTemplate	版面同 TemporaryPrintPage

frx	C:\Users\momo1\source\repos\FastReport\Otherrp.frx（版控）＋ C:\dglibrary\REPORTSROOT\Reports\Otherrp.frx（部署）	手工版面（非 VFP 轉換器產物）；其他客戶要另外把 frx 放進他們的 REPORTSROOT

Test	LogicBllTests/I.ARAP/Otherrp_ReportTemplateTests.cs	frx 表名＝VM 登錄、frx Column ⊆ POCO 匯出欄、STA Prepare 有頁；設 OTHERRP_PREVIEW_DIR 可另存 PNG 人眼檢查

Docs	docs/I-ARAP/otherrpprintpage.md（新）、otherrp.md 列印節、index.md 列印頁表

驗證

• ✅ MSBuild TsERP.csproj／LogicBllTests.csproj 0 error。

• ✅ Otherrp_ReportTemplateTests、ReportRegistrationConsistencyTests（2）、HarnessSmokeTests（8）全過。

• ✅ 版面以樣本資料輸出 PNG 人眼檢查（C:\temps\otherrp-preview\Otherrp.png）：表頭／框線表格／簽核欄排版正常，數字靠右兩位小數。

• ✅ DB 端實跑 EXEC DARB_RPT_PREPAID 2, N'財務單號 between ''9B-20260706001'' and ''9B-20260714001'' AND 程式類別=''H'''

於 darbnogicsa1 撈到 3 筆 9B 單據，欄位齊全（說明 可為 NULL，dt.ToList 同 Temporary 路徑處理）。

• 🔴 未驗：app 內實際按列印→預覽（需 CMSA 密碼做 UIA 登入，本輪無法取得）。路徑與 Prepaid→Temporary 完全同構，

但上線前請人工點一次：其他應收付 → 任一筆 → 列印 → 預覽，確認 I100-1 出現且有資料。

剩餘三支（仍無報表，需規格）

ARCLAIM（應收索賠扣款單）、RFE（費用申請單）、COMMISSION（業務員佣金）——皆無 VFP 對版且無現成 SP，欄位取捨待業主確認。

同日追加：其他應收付表單版面重排＋暫付申請單防壓到右側面板

• TsERP/I.ARAP/Otherrp.xaml 從單一大 Grid 改為 GroupBox 分區（單據資訊／申請資訊／基本資料／金額／帳款與付款／備註），

版型比照暫付申請單 Temporary.xaml；所有 binding 與 x:Name 與舊版逐一比對相同（差集為零）。Common/Lang/Xaml/Otherrp.json

補區塊標題與 進銷分類／關係人／受款人／付款條件 key。

• 兩支表單（Otherrp／Temporary）根 StackPanel 右側留 230px：框架的 FinancialExtensionPanel（pkid／相關單號／傳票號碼／已審核／審核日期）

是疊在同一區塊的 overlay，滿版 GroupBox 會壓到它——使用者實機回報後修正。

• ✅ --screenshot 模式實拍兩支（CMSA 登入）：分區排版正常、右側面板不再被壓；截圖已更新到

docs/I-ARAP/images/otherrp-step1.png、prepaid-step1.png。

2026-08-18 手冊：基本畫面介紹的瀏覽／清單瀏覽／列印拆成三頁

• 拆頁：原 docs/getting-started/browse-print.md（瀏覽、清單瀏覽與列印畫面）拆為三個獨立頁面：

- browse.md 瀏覽畫面（畫面組成、條件區與按鈕列、操作步驟）

- list-browse.md 清單瀏覽畫面（與瀏覽的差別、統計格線／樞紐選欄、操作步驟）

- print.md 列印畫面與報表預覽（兩種進入路徑、列印控制列、新增操作步驟、報表預覽視窗）

• 條件區與按鈕列的完整說明只留在瀏覽頁，清單瀏覽與列印頁以連結指回；常見問題依主題分配到各頁，跨頁問題（瀏覽 vs 清單瀏覽、按列印跑到瀏覽畫面）兩邊都保留一份並互連。

• 同步更新：docs/getting-started/.nav.yml 導覽順序（瀏覽 → 清單瀏覽 → 列印 → 行事曆）、index.md 工具列按鈕表與相關功能連結、tools/docs-pdf/manifests/basic-only.json PDF 章節清單。

• 截圖檔名與內容不變，無需重拍。

同日補充：定位搜尋欄（導覽列中間輸入欄）功能說明

• docs/getting-started/index.md 原「代號搜尋欄」段落改寫為「定位搜尋欄（導覽列中間的輸入欄）」，依 TsSeekTextBox 與 TWORK_MOVEREC 實作補齊：代號＋Enter 定位開頭相符的第一筆、代號; 定位開頭相符的最後一筆、打字中輸入 [／]／? 開查詢視窗（僅限有設定查詢清單的程式，滑鼠停留有提示）、.PKID 依內部主鍵 PKID 定位；另補自動大寫、離開欄位即定位、PageUp／PageDown 與 Ctrl 組合快捷鍵、帳款類「財務類別」與庫存類「倉庫／單據類別」附加欄位。

---

title: 客戶資料表／廠商資料表新增「信件搜尋」分頁

date: 2026-08-18

---

客戶資料表、廠商資料表多一個「信件搜尋」分頁

使用者看得到的變化

位置	改版前	改版後

客戶資料表（CUDATA）分頁列	最後一頁是「索引分類帳」	後面多一頁「信件搜尋」

廠商資料表（SPDATA）分頁列	最後一頁是「加工資料」	後面多一頁「信件搜尋」

切入該分頁	—	自動把目前這筆客戶／廠商代號帶進條件面板的「客廠部代號」並立刻查詢，直接看到這家的往來信件（近 3 個月、上限 200 封，同信件搜尋主程式）

上下一筆換客戶／廠商	—	再切回分頁時重新帶入新代號並重查

條件面板	—	與信件搜尋主程式同一套（日期／客廠部代號／關鍵字／AI 用問的），可自行改條件後按旁邊「查詢」鈕重查

誰看得到

跟索引分類帳分頁一樣走權限閘：使用者要有「信件搜尋（MAILSEARCH）」的瀏覽權限，分頁才會出現；沒權限的人畫面完全不變。

做法（給維護者）

寄生整支 MAILSEARCH，完全比照 CUDATA 索引分類帳分頁寄生 ABOOK2 的做法（ADR 0115）：

• 新增 ViewModel/L.Communication/MailsearchHostViewModel.cs（ITabQuery adapter，CUDATA／SPDATA 共用，建構子收「取當前代號」委派）；lazy ProgramNavigator.CreateHostedQueryProgram("MAILSEARCH") 自己一個 DI scope。

• CudataViewModel／SpdataViewModel：權限閘掛分頁＋Dispose 釋放 scope；換筆時既有的 AfterMoverRecord → ResetQueryState() 機制照舊生效。

• TsERP/App.xaml：MailsearchHostViewModel 的 DataTemplate（條件在上＋查詢鈕、結果在下），條件與主畫面靠既有隱式 DataTemplate 渲染。

• 與索引分類帳的一處刻意差異：切入即自動查詢（信件查詢便宜、有筆數上限與權限閘；帶了代號不查等於白切分頁）。

• Lang：Common/Lang/Xaml/Cudata.json、Spdata.json 補「信件搜尋」四語 key。

驗證狀態

• 建置 TsERP.csproj 0 error；HarnessSmokeTests 8/8。

• runtime 未驗（需 CMSA 密碼做 UIA 登入；待實機切分頁看：分頁出現、代號自動帶入、結果格有信、換筆重查）。

2026-08-18 匯率排程：Cosmos 查詢暫時性失敗改原地重試

• 現象：worker 每輪第一個資料庫跑「每日匯率查詢」時，KeyVault／Auth 冷啟動的暫時性錯誤被 TsAPI.GetFXRateFromAzureCosmos 吞成「查詢失敗」佔位列，任務再把它當「工作日查無資料」記 F（失敗不重試），該日匯率就沒寫；後面的資料庫通道已暖全部成功（2026-08-17 實際發生於 pkid 1715）。

• 修法（AutoPilot/Bcurrenm_FxRate.cs）：偵測到「查詢失敗」佔位列即視為暫時性失敗，原地重試最多 3 次、間隔 30 秒；仍失敗才回 F，訊息改為「Cosmos 查詢失敗（API／金鑰暫時性錯誤，已重試 3 次仍失敗，詳見 DebugLog）」，與真正的「Cosmos 查無 {日期} 匯率資料」分開。

• 既有失敗事件重跑：F 不會自動重撿，需手動清狀態（實體表在 csa1 庫）：

UPDATE twork_skd_eventitem SET 已完成 = '', 執行開始時間 = NULL WHERE 說明 = N'每日匯率查詢' AND 已完成 = 'F';

worker 下一輪即重跑；同日已有匯率單會自動跳過，不會重複寫入。

• 需重新發版 SchedulerWorker（sched-prod 通道）才生效。

朝陽 E.訂單管理：全模組報表接入（69 張）

2026-08-17～18。把朝陽（CY）E.訂單管理整個模組的 VFP 報表移植到 FastReport 並接上列印管線。

此前這個模組一張報表都印不出來——連列印頁與 ProgramClass 都不存在。

使用者看得到的變化

10 支程式的列印按鈕現在會出現報表清單可選：

程式	報表數	內容

客戶資料表 CUDATA	2	客戶資料表、客戶要員資料表

客單品報價 CUQT	1	報價單

客戶產品表 CUINVE	1	客戶產品表

客戶報價單 CUPDMA	3	客戶報價單、明細表(客戶排序)、明細表(品號排序)

訂單管理 ORMAST	13	訂單、訂單(含金額)、兩張橫式、ARCTIC CAT/YMTT/JAM/SOJITZ 嘜頭、客供品表等

PACKING LIST PK	37	裝箱單、發票，及 WARN/POLARIS/AGCO/ANTUNG/HONDA/致勝/山葉興業/石川島 各家標籤

預示表 PREORD	3	明細表、彙總表、彙總表(原始數量及金額)

產銷表 PDTSAL	2	產銷計畫表、產銷計畫表(金額)

年度預估 ESTSAL	1	年度預估表

出貨通知單 SALEMA	3	正常報表、外銷報表、彙總報表

CI	2	CI、CI(無合約號碼)

條件面板一律改成 GroupBox「列印條件」＋一列一條件的排法（照 GSLIYPRINT）。

做法上的幾個決定

報表清單走內建 IPrintSource，不寫客戶庫的 _rptdat。

兩個客戶庫（darbcycsa1／darbnogicsa1）的 _rptdat 都沒有這些程式的登錄列，靠登錄資料就得每個客戶端各補一次；

而且 _rptdat 是用主程式 ProgramClass 名去查的，CY 變體（如 CUINVE_CY）本來就查不到。改走程式內建清單兩個問題一起解。

條碼改用 FastReport 的 BarcodeObject，不依賴條碼字型。

VFP 有兩種畫法：早期用 Code39 字型（TextObject + Font="3 of 9 Barcode"），2019/02 起部分改用 FoxBarcode 產圖（空 PictureObject）。

兩種都換成 BarcodeObject，字串格式沿用 VFP 的 *<前綴><值>*。列印主機不必再裝條碼字型。

列印後處理照搬 frxprint.prg。

先前以為 SP 回什麼報表就印什麼，實際上 VFP 取數後還會建 cursor 算小計、做樞紐、展開箱號。

這些邏輯在 C:\darb_fox\CY\APJX_BASIC\CY\PRGS\frxprint.prg，已移植進各 *ReportBuilder。

修掉的既有問題

標籤與正嘜的出貨城市、嘜頭、港口全是空的。 三個問題疊在一起：

① ShippingCity 參數存在，但沒有任何 PK 外掛把它轉給 builder，AGCO／HONDA／ARCTIC 標籤的出貨城市與 DEST 條碼永遠空白；

② 列印頁根本沒有可以填的欄位；

③ 嘜頭與港口在 VFP 是各報表寫死或由「山葉興業別／ANTUNG 別」optiongroup 決定（scx_ordp_cy.prg 3247／3723／5376 三段），新版完全沒實作。

已補：PkReportBuilder.CityOf/YamahaMark/AntungMark，八張標籤各自接上；新增 YamahaType／AntungType 兩個列印參數；PkPrint.xaml 加一個「標籤選項」區塊（出貨城市、出貨客戶、山葉興業別、ANTUNG 別，後兩者用下拉、選項文字照 VFP 的 Caption）。

山葉興業別	嘜頭／港口		ANTUNG 別	嘜頭／港口

1	YMES／BARCELONA		1	SAIMA ANTUNG／LA SPEZIA

2	YMME／ROTTERDAM		2	DMT ANTUNG／LAEMCHABANG

3	YMDB／SANTOS

4	YMMC／ATLANTA		PK_ADJ	AD／（無港口）

5	YMME／RTM		PK_ADVN	ADVN／HAIPHONG

6	YMRE／MILANO

7	TYM／BANGKOK

8	YJBM／ATLANTA

棧板標籤印不出棧板號。 ExpandPallets 要求 截止棧板號 >= 起始棧板號 才展開，但實測 pkde 有棧板號的 11,690 筆裡有 11,688 筆的截止棧板號是 0——實務上起始棧板號就是該列的棧板號，截止欄不填。等於對所有真實資料都不展開。已改成截止沒填時當單一棧板處理，並補上整板彙總的 棧板淨重／棧板內數量（SP 只回單箱值）。

客供品表拿錯結果集。 BuildCustomerSupplied 讀 Tables[2] 當組件展開表，但實測 DARB_RPT_ORMAST 的 T2 是「訂單聯絡單」，組件展開是 T3 而且只有查詢別 19 才回（Custom(2) 只回三個結果集）。原本這張報表在任何情況下都印不出東西。已補 GetOrmastReportDataSet(int queryType, ...) 多載並改讀 T3。

Cuqtlst 的客戶簡稱／備註（原列為做不了）。DARB_RPT_CUQT 只回 客戶代號，兩欄都來自 cudata；改成在外掛反查（CyOrderReportLookup.Customers），不動 SP。

Salema／Salema3 的配件（原列為做不了）。VFP salema_p 是逐一品號呼叫 DARB_BIZ_BOMBOTTOM 展 BOM、取 配件='Y' 的子件品號用換行串起來，只有第 1 張與第 4 張要印。已照樣移植；同品號＋同交易日期只展一次，展 BOM 失敗時該格留白、不讓整張單印不出來。POCO 另補了不印在版面上的 交易日期——那是展 BOM 的基準日參數。

ANTUNG 棧板標籤（Pk_Antung1）的混板樞紐（原列為未實作）。原本誤用通用的 PalletLabel 形狀（照棧板號展開），但版面要的是「一板一列＋板上客戶品號樞紐成 1~5 組」。新增 AntungPallet 形狀：先把明細照起訖箱號展成一箱一列，再依起始棧板號彙總，棧板淨重／棧板毛重 為該板所有箱子的單箱重量總和，品號依序填進五組欄位（超過五種照 VFP 一樣捨去，版面只有五組）。

驗證：反射呼叫出貨的 PkReportBuilder.BuildAntungPallets（不在治具重寫），28 個棧板的箱數、淨重、毛重、五組品號樞紐全部與獨立算出的答案相符。

棧板攤重 未移植 VFP 2020 年加的重分配那段——它參照一個名為 棧板重量 的 memvar，新版 SP 沒有對應欄位（該段迴圈在 VFP 裡其實也退化成「直接等於那個 memvar」）。

PK 家族 22 張一取真資料就炸（包裝量 型別）。 DARB_RPT_PK 的 包裝量 回 decimal，POCO 宣告成 int；DataTableToList 是直接 SetValue 不做轉換，於是整個 PACKING LIST 家族在真實資料下丟 Decimal cannot be converted to Int32。已改成跟 SP 一致的 decimal，七張範本的欄位型別一併對齊。（其他系列 SP 的同名欄回 int，型別不一致是來源就有的。）

20 處運算式沒有外框，會把程式碼原字印在紙上。 FastReport 只對整段包在 [ ] 內的 Text 求值；沒包外框時只代換裡面的 [表.欄]，其餘照原樣印出。實際印出來長這樣：

(string.IsNullOrEmpty() ? 242749 : )      ← 應該印 242749


('+幣別+')                                     ← 應該印 (TWD)

涉及 14 張（Ci、Ci_1、Pk2advn、Pkciadvn、Pkmark1、Pk_Advn、Pk_Agcoplt、Pk_Antung1、Pk_Hondaplt、Ymes、Ymes1、Ymes_Atlanta1、Ymes_Atlanta2ymmc、Ymes_Atlanta2ymmc_A4）。其中 Pk2advn／Pkciadvn 的 TEL/FAX 行還有引號沒跳脫，XML 屬性在 +"" 那裡就被截斷，後半段整個遺失。

轉檔器留下的死欄位宣告。 Ci／Ci_1 的 F／T／NOT（VFP 的 .F.／.T. 被當成欄名）、單價遮罩（VFP 表單變數），Pk2／Pk2pal 的 ' '（空白字面值）。留著不會壞，但會讓三方名單比對永遠有雜訊，已清掉。

PACKING LIST 的 MEAS 型別錯誤。 meas／pl_meas 是外箱與棧板的尺寸字串（例 91*66*37），

POCO 卻宣告成 decimal，一取數就 FormatException。已改成 string，Pk2／Pk2advn／Pk2pal／Pkplt

四張範本的欄位型別一併對齊。數值型的材積另有 SP 的 單箱材積／單板材積，目前沒有報表綁。

最後一批把 VFP 原始碼印在紙上的欄位。 11 處：星號截斷（外掛已在建資料時截好，改直接綁欄位）、

Ordwarn2 取客戶品號空白後 3 碼、致勝箱號／棧板號的 RIGHT(STR(1000+號,4),n)，以及下面兩個框架函式。

全庫掃描後 VFP 專有函式殘留為 0。

金額大寫（CI 的 金額描述）已補上。 原本列為做不了——後來在 CY 的 PRGS/util2010.prg 找到

U_VATOSTR／U_ONESTR／U_TWOSTR 的完整定義，已 1:1 移植成 CyOrderReportCondition.AmountInWords()

（含一億上限與「AND CENT ONE／AND CENTS xx」的角分寫法）；幣別英文名照 VFP 的 U_CURRNM 改讀 bcurren。

Pk2pal 的板箱數描述（TWO PALLETS THREE CARTONS ONLY.）同源，一併補上。

CI 單價的顯示格式。 VFP 是 U_ROUNDTrimEnd(m.單價遮罩, 單價, .F., .T.)，但 單價遮罩 是 VFP

表單變數、SP 不回——版面上是幽靈欄位。改成外掛算好的 單價顯示（去尾隨 0：0.5000 → 0.5）。

版面上殘留的 VFP 函式。 轉檔器把 VFP 的運算式原樣搬進 frx，ALLTRIM()／LEFT()／RIGHT()／SPACE()／

IIF()／CTOD()／U_MDY() 在 FastReport 都不存在，會印出字面字串或編譯失敗。已全部改寫成 C#：

取字串一律夾在 [0, 實際長度] 之間（VFP 越界回空字串，C# 會丟例外），英文日期（Aug. 20,2025／August 20,2025）

改由外掛的 CyOrderReportCondition.EnglishDate() 算好成欄位，不在版面上截字串。

運算式沒有外框會印出原文。 frx 的 Text 只有整段包在 [ ] 內才會求值，

[表.欄].ToUpper() 這種「欄位有框、方法呼叫在框外」的寫法會原字印出 .ToUpper()。

判準是括號配對而非長相：首個 [ 的配對 ] 落在字串結尾＝整段已是運算式（不可再包），

否則才需要補外框。混排型（[本幣][IIf(…)]※）與已完整型（[IIf(…)]）都不能包——

包了會讓外層當運算式、內層當字串，編譯直接掛掉。

報表 POCO 用英文屬性名會整片空白。 Rpt_E040_CuinveReportPoco 與 Rpt_E050_CupdmaReportPoco 原本是英文屬性名

（CustomerCode、SKU…），而報表 SP 回的是中文欄名；DataTableToList 只比對屬性名／[TsColumnName]，

一欄都對不上 → 印出「筆數正確但每格全空」的報表。CY 線已全面改中文屬性名。

frx 綁到不存在的欄位。 新寫的檢查器比對「frx 引用的欄位」vs「POCO 實際屬性」，發現先前每支報表幾乎都有懸空引用：

_pageno／_PAGETOTAL（VFP 頁碼變數，改綁 [Page#]／[TotalPages#]）、pub_公司名稱（改綁 [CompanyName]）、

是否SI（SP 欄名小寫，用 TsColumnName 對映）、以及各種需要外掛補算的欄位。現已全數對齊。

客戶產品表漏了品號區間。 VFP cuinve_p 的自訂條件是「客戶代號 BETWEEN … AND 品號 BETWEEN …」兩段，

新版只做了客戶代號那段，VM／plugin SQL／XAML 三處都補回。

客戶報價單的 HaveReportData() 擋掉明細表。 原本無條件要求「報價單號起訖都有值」，

選客戶條件時永遠印不出來；改成依條件別判斷。

金額大寫：修掉舊版的十萬位漏字

移植時逐位對照發現舊版 VFP 本身有 bug：它把金額切成「百萬(2位)／十萬(1位)／千(2位)／百(1位)／個位(2位)」，

THOUSAND 只掛在「千位那兩碼」上，所以十萬位有值、千位是 00 時整個字會消失。

影響 x00,000~x00,999 這段，而這是印在出口 CI／INVOICE 上的金額文字。

2026-08-18 裁決：改成正確英文（不沿用舊版行為）。改法是換成標準的三位一組，

順便把舊版遺留的連續空白與 ONLY. 前的多餘空白收乾淨。

金額	舊版 VFP	新版

100,000	ONE HUNDRED ONLY.	ONE HUNDRED THOUSAND ONLY.

200,000	TWO HUNDRED ONLY.	TWO HUNDRED THOUSAND ONLY.

900,500	NINE HUNDRED FIVE HUNDRED ONLY.	NINE HUNDRED THOUSAND FIVE HUNDRED ONLY.

20	TWENTY ONLY.（兩個空白）	TWENTY ONLY.

0	ONLY.	ZERO ONLY.

123,456	正確	不變

驗證：以反射直接呼叫已編譯的 AmountInWords()，19 組邊界值全數符合預期

（含百萬進位、角分的 AND CENT ONE / AND CENTS xx 兩種寫法）。

沿用舊版的部分：一億上限。金額超過 99,999,999.99 仍回舊版那句中文提示

「待轉換數字大於 1億,無法轉換成文字顯示」——這是舊版取位法留下的限制，本次未一併放寬。

覆蓋率：對照 VFP 原始碼盤過

把 vfpcode/scx_ordp_cy.prg 裡所有 L_FRXNAME=／L_報表名稱= 的值抽出來當母體，套上四個改名（PK_致勝1/2→Pk_Win1/2、ORMASTCY_客供品→Ormastcy_Csp、CUPDMA→Cupdma_cy）後比對：

	張數

VFP 訂單管理會印的報表	68

已移植	67

未移植	1（PI）

另外多做	2（YMES1／YMES3）

YMES1／YMES3 沒有出現在字面清單裡，是因為 VFP 用 L_FRXNAME=IIF(INLIST(山葉興業別,4,7,8),'YMES3','YMES1') 動態選的，兩支 frx 都實際存在於 C:\darb_fox\CY\REPORTS\，所以要做。

已知未完成

• PI：朝陽端沒有 PI.frx，也沒有 DARB_RPT_PI，做不了。

• 報表版面：轉檔器產出的是草稿，欄寬與對齊未經人眼校對。

驗證

• 範本健檢：69/69 通過（離線渲染治具，走完整 SP→POCO→SQLite→frx Prepare）。

• 真實資料對映檢查：69 張全部用真資料走一次 DataTableToList，66 張完全乾淨；剩下 3 張（Cudata 6 欄、Cudatadtl 2 欄、Ormast1 的 建議售價）已用 SQL 證實是來源資料本身全空（cudata 那 6 欄 102 筆全空、ordetl.建議售價 48 萬筆全為 0），不是程式問題。

• 逐欄核對（真實資料）5 張，四個 Builder 家族各有代表：

- ORMASTCY（訂單單據，OrmastReportBuilder）

- Ordcat2（ARCTIC CAT 條碼側嘜，OrdmarkReportBuilder）：通訊錄地址、5 組 Code39、MM-DD-YY 交期

- Pk2（PACKING LIST，PkReportBuilder）：8 張單的列數／數量／箱數／淨重／毛重與 SQL 逐張相符

- Preord2（樞紐，PreordReportBuilder）：分桶總計 0/50458/51229 與獨立 SQL 完全一致，114 組交叉比對全中

- Ci（商業發票）：1166 張全部的列數／數量／金額與 SQL 相符；金額大寫、幣別英文名、單價去尾零、英文日期都實際印在版面上驗過

• 金額大寫另以反射直接呼叫已編譯的 AmountInWords()，19 組邊界值全對。

• ANTUNG 棧板樞紐以反射呼叫出貨的 BuildAntungPallets，28 個棧板全數相符。

• 標籤／正嘜 43 張逐欄檢查：治具用 DispatchProxy 動態實作 IAppContext，直接呼叫每支外掛真正的 GetReportSource（不是複本），再逐一確認版面綁的欄位有值。

結果 28 張完全乾淨；其餘 15 張的空白欄位逐一追過來源，分別是來源資料稀疏（合約號碼 全庫 533/44882、REQNO 全庫 937/483821、出船日／到達日／前置文字）、版面刻意留白（POLARIS 地址的 LINE03/05/06），或該板品號種類不足五種（客戶品號4/5）。

仍未定案 2 處：Pkplt 的 箱號 與 Ymes3 的 箱號C——棧板標籤上要印哪一箱的箱號，VFP 的 cursor 同時帶了棧板號與箱號，但選哪一箱沒有明確規則，沒有猜。

• 既有報表回歸：非訂單模組的 247 張 frx 與版控 HEAD 逐張比對渲染結果，回歸 0 支。

仍未做

• 69 張都沒有從 TsERP 視窗實際列印過（全部走離線治具）。

• 版面美觀（欄寬、對齊）未經人眼校對。

相關檔案

• 報表範本：repos/FastReport/*.frx，部署副本 C:\dglibrary\REPORTSROOT\Reports\

• 報表 POCO：Model/Rpt/Rpt_E0*ReportPoco.cs（15 個）

• 匯出外掛：TworkReportPluginOfficial/（69 支 + 4 個共用 Builder）

• 取數：Model/ReportBll.cs、Model/ReportBll.CyOrder.cs

• 列印頁：ViewModel/E.Order/*PrintViewModel.cs、TsERP/E.Order/*Print.xaml

• VFP 來源：vfpcode/scx_ordp_cy.prg、C:\darb_fox\CY\APJX_BASIC\CY\PRGS\frxprint.prg、C:\darb_fox\CY\REPORTS\*.frx

2026-08-18 帳款管理報表：收款單列印頁修復＋直式報表指錯修正

背景

盤點「帳款管理（I）報表有沒有缺」時，先做了三份比對：

① 手冊 features 寫「列印」的程式 vs VM 實際的報表登錄；

② VFP 帳款列印庫 scx_arpp 用到的報表名（GRPMACCL／PAYAPPL1-2／PAYMNTA5／PREPAID／PSHEETD 系／

RPSHTD 系／RSHEET 系／PSHETM3 系／PAY4…）vs V2 已登錄；

③ C:\dglibrary\REPORTSROOT\Reports\*.frx vs V2 程式碼裡的 報表名稱。

結論：帳款模組沒有「該有卻整張不存在」的報表，但有兩個真缺陷（本次修）與四支沒有任何報表來源的程式（待裁決）。

使用者可見變動

1. 收款單列印頁（RSHEETPRINT）從「一開就跳系統錯誤」變成可用。

TsERP/I.ARAP/RsheetPrintPage.xaml 的「選擇」欄是 TsDataGrid 時代殘留的 WPF

DataGridTemplateColumn，卻放在 Telerik TsRadGridView.Columns 裡。build 全綠、XAML 也載得起來，

但模板實體化（ApplyTemplate → Measure）時丟

The value "System.Windows.Controls.DataGridTemplateColumn" is not of type "Telerik.Windows.Controls.GridViewColumn"，

整頁毀掉；而且每個 render pass 重丟一次，2026-08-18 當天的 debuglog 被灌到 62MB。

改用 tsRadGridViewColumn:TsGridViewCheckBoxColumn（同 A.SystemData/Secret.xaml 慣例）。

2. 「直式收款沖帳表」以前會印出橫式。

RsheetPrintViewModel.GetReports() 最後兩筆（直式收款沖帳表、直式收款沖帳表(含沖帳明細)）

的 報表名稱 被整段複製成 Rsheet2（橫式），報表編號 也都是 I050-2。

Rsheet4.frx／Rsheet5.frx（皆為直式，無 Landscape 屬性）與對應插件早就存在，只是沒人指到。

已改為 Rsheet4／Rsheet5、編號 I050-4／I050-5。

兩支新的守門測試

• LogicBllTests/Harness/HarnessSmokeTests.TsRadGridView內不得殘留WPF的DataGrid欄型別

—— 掃 XAML：檔案含 TsRadGridView 且有未註解的 <DataGrid*Column 就紅。第 1 條的那類崩窗以後 build 期就抓到。

• LogicBllTests/Reporting/ReportRegistrationConsistencyTests

- 每個登錄的報表名稱都要有對應的frx（列印時才跳「檔案不存在」的那類）

- 同一報表名稱不得登成不同抬頭（第 2 條那類複製貼上錯誤）

兩支都用 allowlist 明列既有債，只擋新增的違規。

順手盤到、本次未修的既有債（allowlist 內）

類型	項目	症狀

登錄了但沒有 frx	Pur_qry21~Pur_qry24（G.採購）、Qc_qry21／Qc_qry22（J.品管）	選這幾張列印會跳檔案不存在

同名不同抬頭	Trlimatl／Trradtl／Trradea／Trsadetl／Trwkmatl（H.庫存）、Sliy（N.總帳）	可能是同一張換排序（無害），也可能同第 2 條那樣指錯，需逐張確認

sqlite 表名與 frx 不符	Abook11~Abook17（登 rpt_n100_abook2_report1、frx 用 rpt_n080_abook1_report*）、Trial2	需確認是否印得出資料

仍然「沒有任何報表」的四支帳款程式（需要規格才能做）

OTHERRP（其他應收付）、ARCLAIM（應收索賠扣款單）、RFE（費用申請單）、COMMISSION（業務員佣金計算）

—— 手冊 features 都寫了「列印」，但：

• VFP 沒有對應報表：scx_arpp 的報表清單裡沒有它們；名字接近的 tother.frx 其實是營業稅申報書、

commpr.frx 是內部聯絡單，都不是這四支的。

• VFP 也沒有 OTHERRP／CLAIM 以外的原程式：scx_arp 有 OTHERRP（代收付主檔，browsetype=I10B＝走瀏覽型列印，

無專屬 frx）、scx_ord 有 CLAIM（索賠單主檔）；RFE（rfem/rfed）與 COMMISSION

（salescommission_history*）在 VFP 完全不存在，屬 V2 新設計。

• 報表 SP 部分現成：DARB_RPT_RP（rp_m，可供 OTHERRP）、DARB_RPT_PAYAPPLY、DARB_RPT_PREPAID

等已在庫；索賠／佣金 沒有對應 SP。

也就是這四張要做就是全新版面設計（欄位取捨需業主確認），不是移植，因此本次不動。

驗證

• ✅ MSBuild 0 error；HarnessSmokeTests 8 支（含新加那支）與 ReportRegistrationConsistencyTests 2 支全過。

• ✅ runtime 實測（CMSA 登入 localhost darbnogicsa1）：收款單 → 前往最後一筆 → 列印，

列印頁正常開啟（修前是系統錯誤），「選擇」欄渲染正常並帶入單號 R5-20180920001；

頁內查詢撈到該筆（483,000）並自動勾選；報表清單五張齊全，第 4、5 張標題為直式版；

按預覽成功產出「報表預覽 Rsheet1」真實資料報表（PDF 存 C:\temps\rsheet-preview\Rsheet1.pdf，

直式 210×297mm）。

• 🔴 未驗：Rsheet4／Rsheet5 的實際渲染。那兩張要靠列印頁的自訂清單選第 4／5 項才會產生所需的

4 組 SQLite 表，而該清單不是標準控件、UIA 點不到；離線渲染因缺 _1/_11/_111 表而失敗。

建議上線前人工點一次第 4 項預覽確認是直式（frx 本身無 Landscape 屬性，Rsheet2 有，故版面差異可確定）。

2026-08-18 手冊新增「應收帳款沖帳教材」情境頁

背景

舊系統（VFP）時代有一份《應收帳款沖帳說明.xlsx》教材：兩條主流程（收客戶票據／銀行電匯不知匯款客戶）＋ 11 個示例，

內容幾乎全是舊畫面截圖。使用者希望新系統手冊也有一份對應教材。新頁以新系統程式（Receive／Rsheet／RpfZero）

逐情境改寫，情境編號與舊版一致。

使用者可見變動

• 手冊 I 帳款管理 新增頁 應收帳款沖帳教材（docs/I-ARAP/ar-writeoff-tutorial.md），模組首頁多一個提示框指過去；

.nav.yml 由 gen-doc-nav.py 重新產生。

• 頁內含「與舊版的差異」對照表，明列新版沒有的東西（見下）。

改寫時查證到的新舊差異（供後續是否補功能參考）

舊版行為	新版現況	證據

收款單 工作流程 鈕通知出納／會計	收款單無此鈕；轉傳票參數字串 RsheetToSliy-NO-WKFLOW	ViewModel/I.ARAP/Rsheet/RsheetViewModel.cs:436、Rsheet.xaml 無 TsButton

沖帳視窗「超收貨款」幣別／金額欄	XAML 整段註解掉；Bll 仍有 OverCharge() 但無入口	TsERP/Other/RpfZero.xaml:992-997、StrikeEntryBll.cs:194-221

減項帳款列反綠	只以「加減別」+/- 表示；底色僅粉紅（有聯絡單）／紅（NoSliy）	RpfZero.xaml:250-287

暫收單 修改客戶 存檔後自動產生收款單並進沖帳	同日補齊：ReceiveViewModel.CreateTemporaryReceiptRsheetAndStrike 以 ItemsBindingManager 建收款單（收付款別 R、沖帳方式 3、無明細）→ HyperLinkWithPkid(RSHEET) → RsheetViewModel.ExtendedFunction1() 開沖帳；動手前先檢查 RSHEET 權限／收款單畫面不在編輯中／今天未被 2033 關帳（對齊 VFP 的前置擋門，避免留孤兒收款單）；VFP 原碼 vfpcode/scx_arp/receive_utf8.prg:3136-3178。runtime 未驗	ViewModel/I.ARAP/ReceiveViewModel.cs

沖帳視窗分錄格線「財務單ID」雙擊跳帳款	沖帳視窗無超連結；收款單畫面的傳票分錄格線有	Rsheet.xaml:630-638,706-713

已確認可行（DB 查證）：沖帳 SP DARB_TUR_RPFZERO 以收款單的客戶代號＋廠商代號（含廠商代號1/2）同時撈 rp_m → 應收應付互抵成立；

DARB_TGR_RPSHT_D 對 單別2 ∈ (71,24,25,29) AND 單號2='NEW' 的分錄自動 INSERT rp_m → 轉預收／暫收會自動立帳款單。

待辦

• 10 張截圖待以測試資料操作後補拍（頁尾「需補截圖清單」）。

• 「修改客戶→自動收款單→沖帳」新流程 runtime 未驗（本機庫無未沖暫收單），需走一次批次電匯→暫收→修改客戶端到端。

2026-08-18 應收沖帳實測：收款單「沖帳」開窗即崩等 19 處修復＋全系統其他功能鈕改照標籤

背景

為了驗證新寫的應收帳款沖帳教材，在模擬環境（darbnogicsa1）用 UIA 腳本實際走了

示例 1（本幣支票直接沖帳）與示例 8（批次電匯 → 暫收 → 修改客戶 → 自動建收款單開沖帳）。兩條流程一路踩到 8 個 bug，

其中兩個是 6 月重構留下、會讓收款單按「沖帳」必崩的 regression。全部修完後兩條流程端到端走通，截圖已進教材。

使用者可見變動（修前 → 修後）

#	畫面	修前	修後	根因與修法

1	收款單 › 沖帳	一按就跳「Exception has been thrown by the target of an invocation」	正常開沖帳視窗	Rp_mForRPFZero 建構式 6/4 改成 base() 後沒設 Context，單據分類 setter 用 Context.DisplayNameService → NRE。建構式補 SetContext(context)（LogicBll/Other/RpfZero/Rp_mForRPFZero.cs）

2	收款單 › 沖帳	過了 #1 後跳「StaticResourceExtension 行號 243」	正常	RpfZero.xaml 6/2 轉 RadGridView 時把 RowStyle="{StaticResource RpfZeroRow}" 寫在 attribute，但 RpfZeroRow 定義在同元素自己的 Resources 裡（forward reference）。改成 <TsRadGridView.RowStyle> property element 放在 Resources 之後

3	收款單右側六顆功能鈕	按「批次電匯」跑轉傳票、按「轉傳票」進特殊修改、「特殊修改」灰掉	各鈕做自己的事	鈕的標籤來自權限表 prgsct1.其他N說明（＝VFP CMDELSE1~7 順序：沖帳／取消沖帳／批次電匯／轉傳票／工作流程／特殊修改／轉票據），C# 卻把 3/4/5 寫成 轉傳票／特殊修改／批次電匯。RsheetViewModel 改成 IOther1,2,3,4,6：EF3 批次電匯、EF4 轉傳票、EF6 特殊修改；其他 5 工作流程與 7 轉票據不實作（鈕呈灰色）

4	應收帳款右側功能鈕	按「修改客戶」進特殊修改、按「批改客戶」才是修改客戶	「修改客戶」＝修改客戶	同上根因（權限表 4=修改客戶、5=批改客戶）。ReceiveViewModel 改成 IOther1,2,3,4,8：EF4 修改客戶、EF8 特殊修改（禾久權限表順序）。⚠️ 特殊修改在各客戶權限表位置不同（禾久 8、朝陽 6），朝陽待裁決

5	收款單 › 批次電匯	開窗只顯示 ViewModel.Other.Rsht_inputViewModel 文字，且格線沒有欄位	正常視窗（收款註記／迴轉分錄方式／收款日期／幣別／匯率／客戶／銀行帳號＋序號／摘要／金額格線）	Rsht_input.xaml 還是 TsWindow、VM 已改走 ContentWindow → 沒 DataTemplate；欄位在「刪真死綁定」時被砍光沒補中文欄。轉成 TsView＋App.xaml DataTemplate＋補 摘要／金額 欄；VM 補 Title

6	批次電匯 › 儲存	「系統錯誤 程式：RSHEET Object reference not set」	存檔成功、產生收款單並跳到該單	Rsht_inputBll.Save 走舊 AdeUploadBll.UpdateData(object[])，內部 xmlSource 從未建立 → Upload NRE。改走 ItemsBindingManager＋UploadToSql（adeupload-to-itembinding 模式，獨立 StagingScope）

7	應收帳款 › 修改客戶	「Constructor on type TsERP.Other.ChangeNo not found」；修掉後再跳「Value cannot be null (name)」；再修掉後靜默失敗	開「更改暫收客戶」視窗、存檔、自動建收款單並開沖帳	(a) 已廢棄的 WindowHelper.OpenWindow → 改 ContentWindowService.ShowContentWindow(new ChangeNoViewModel(…,2,this))；(b) ChangeNoViewModel 用 ProgramHelper.GetList 拿主檔，DataManager 系 VM 沒覆寫 GetBindingSourcesPropertyName → 補 GetMasterList() 先讀 MasterData.ObservableCollection；(c) ReceiveSave.AllowSave 對暫收單也要求交易日期（VFP 不檢查；trigger 建的暫收單交易日期空）→ 25 豁免；存檔失敗改成有訊息

8	沖帳視窗 › 自動沖帳	有負數列（暫收／折讓／退貨）時只把負數列沖掉，正數列一毛不分配	負數沖完後把差額由上而下分到正數列	(a) 沖負數後沒同步 VM 的 Difference（拿到舊值）；(b) 找「餘額剛好等於差額」那筆時沒排除負數列，剛沖掉的暫收列本身就命中、而 MasterApply 對負數列不動作。AutoStrikeRegionViewModel.AutoStrikeExecute 先 CalculateBalanceCurrencyAmount() 再只在 + 列找

9	收款單／批次電匯的「收款別／迴轉分錄方式」	顯示英文 Direct Balance／Make Temporary Receipts After Balance	直接沖帳／沖帳後做暫收／暫收沖帳／預收／其他	新增 Common/Lang/Xaml/RSheetReverseEntryMethodEnum.json

另外實測確認：參數 2042=Y 時沖帳存檔後出納傳票號／沖帳傳票號自動帶出（示例 1）；批次電匯存檔的沖帳分錄與 trigger 建立的暫收單（25-…）皆正確；修改客戶 存檔後自動建收款單（R3-…、收款別 3）→ 跳到收款單 → 開沖帳視窗，帳款格線含暫收（−）列。

第二輪（同日稍晚）：其他功能鈕改「照標籤」＋示例 2～B 全部實測

使用者裁決「都要實測，程式要統一」後把剩下的示例全走過（示例 2／3／4／5／6／7／9／A／B，各截一張進教材），再修：

#	畫面	修前 → 修後	修法

10	所有程式的右側其他功能鈕	照 IOther{N} 索引接動作，權限表順序各客戶不同就接錯 → 新增 IOtherByName（標籤→動作字典），ActionPanelViewModel 優先用它、找不到才退回索引；RsheetViewModel／ReceiveViewModel 改實作 IOtherByName，一份程式禾久／朝陽通用（朝陽「特殊修改」在其他 6 也對得到）	ViewModel/Interface/IOtherByName.cs、ActionPanelViewModel.CreateOtherButtonViewModels

11	應收帳款 › 新增	一律「資料重複」存不了：主鍵驗證拿佔位鍵 +++ 去查 DB，而 nogi rp_m 殘留一筆 2024 年鍵值真的是 +++ 的孤兒列	PrimaryKeyValidateViewModel.CheckPrimaryKey 對 +++ 直接放行

12	應收帳款 22 折讓	原幣應收付用「原幣稅額」算（300）、本幣用稅額（315）對不上	ReceiveSave：22 折讓原幣＝本幣＝發票金額＋稅額（同 VFP）

13	沖帳視窗表頭「沖帳匯率」	改了不會重算票據／電匯分錄列本幣、也不會帶到同幣別帳款列 → 外幣票據永遠差一截	RpfZeroViewModel.StrikeForeignExchangeRate setter：重算 UseStrikeForeignExchangeRate 的分錄列、把同幣別帳款列的沖帳匯率同步並重算匯兌損益

14	應收帳款 › 特殊修改	改「收款客戶」會連「出貨客戶」一起改（VFP 不會；轉傳票客戶就跑掉）	ReceiveEdit.AfterSpecialEdit 關 NeedUpdateCustVendCode（同 PaymntEdit）

15	應收帳款 › 修改客戶	存檔後畫面停在假編輯狀態（存取消亮、其他灰）	直接呼叫 Save()／Cancel() 後補 InEditingLayoutHandle()

實測確認可行：外幣票據沖同幣別帳款自動產生兌換收益列（示例 2）；跨幣別靠各帳款列自己的沖帳匯率（匯率表依收款日期）換算，表頭「差額」是原幣直接相減、跨幣別要看最下方本幣差額（示例 3／9）；退回／折讓／折扣三種減項 自動沖帳 一次吃掉（示例 4～6）；互抵（示例 7）；轉預收→自動建 24 預收單→再沖出貨（示例 A）；特殊修改改收款客戶後出現在另一客戶的沖帳格線（示例 B）。

第三輪：其餘四項全修＋全系統其他功能鈕批次改「照標籤」

#	範圍	修前 → 修後	修法

16	所有還走舊 AdeUploadBll.UpdateData(object[]) 的存檔（舊 TransferBll 41 支轉單、BatchAddBll 3 支、CommprNoteBll）	2 月起 Add／Edit 改用 xmlSource 後，這幾個反射入口沒把結果塞回 → 存檔 NRE	AdeUploadBll.UpdateData／UpdateDataWithModel 三個入口把 UseRefrectionToCreateUploadData 結果指給 xmlSource（一處修、全部恢復；runtime 未逐一驗）

17	沖帳視窗載入途中例外	DARB_TUR_RPFZERO 已寫的 zpermit 沒人清 → 之後每張都「均已鎖住」	RpfZeroTransfer.Transfer 對 TransferHandle 包 try/catch → RpfZeroBll.ReleasePassNumber() 再 rethrow

18	收款單／付款單票據與電匯列的幣別欄	選外幣匯率停在 1；就算抓到也是賣價	(a) Rsheet.xaml／Psheet.xaml 幣別欄加 ExchangeRateType="Accounting"（原預設關稅匯率表沒資料）；(b) RsheetViewModel 收款日期改變時把日期推到票據列（CollectionOrPaymentDate）；(c) Twork_BLRateBll／ModelHelper.GetAccountingFxRate 傳給 DARB_BLRATE 的 @買賣別 改成 N'買'／N'賣'（原本傳 enum 代碼 1／2，SP 永遠落到賣價——全系統幣別下拉帶出的匯率因此從賣價變成買價，是全域行為變更）

19	全系統其他功能鈕	57 支 VM 走 IOther{N} 索引	派 4 個 agent 三方對照（VFP CMDELSEn.Caption／兩家權限表標籤／C# 方法內容）：44 支改 IOtherByName，13 支跳過（兩家權限表都無標籤：AUDIT 以外的 FIELDCOMPARE／BCURRENM／RMA／COMMISSION／COMPLAIN／REPAIR／COST／ACCL／BANK／TRRAFEEPRIME／JOBCODE；CI／CUDATA 方法內容與標籤全對不上，不猜、維持原狀待裁決）。批次中發現原本就照索引接錯的：WKDAY、PPURCH、PURCH、TRLOST（5/6/7 整組旋轉）、GPURCH、GSPLACE、GTRRAMA、INVENT、SALEMA、TICKA、TICKSR、ACCEXP、ASSET、SLIY、PAYAPPLY_KC、TRRAMA——即客戶按某顆鈕實際跑的是別的動作

兩家標籤對照表存 .claude/tmp/other-button-labels-20260818.json（prgsct1 其他1～8，nogi／cy）。改「照標籤」後：字典沒放的標籤（C# 未實作）與客戶自行改字的標籤會呈灰／無動作，比接錯動作安全；TwramaViewModel／WkramaViewModel 的 ProgramClass 誤寫成 PURAMA（權限表 TWRAMA／WKRAMA 各自有「轉單」標籤），agent 兩個鍵都放了先不死鈕，ProgramClass 本身待另案修。

沒修（記下來）

• RpfZero 沖帳視窗關閉後主視窗標題殘留「收付款沖帳畫面」；沖帳視窗客戶簡稱欄空白（名稱反查空表通案）。

• 批次電匯轉暫收時，每張暫收單的備註都用最後一筆匯款摘要（RpfZeroTransfer 取 lastItem.票據備註）。

• 「工作流程」其他 5：VFP 建「收款單通知」聯絡單；新版走共用工作流程頁籤，未另做。

• 沖帳視窗表頭「差額」跨幣別時是原幣直接相減（看最下方本幣差額）。

• CI／CUDATA 的其他功能鈕方法內容與權限表標籤全對不上（疑複製貼上／美規功能），維持原索引，待裁決；TWRAMA／WKRAMA VM 的 ProgramClass 誤為 PURAMA 待修。

• 舊 AdeUploadBll.UpdateData(object[]) 路徑修復僅程式面，41 支舊轉單未逐一 runtime 驗。

驗證

• MSBuild ViewModel／LogicBll／LogicBllTests 0 error（TsERP.csproj 因另一 session 進行中的 TworkReportPluginOfficial 改動暫時建不過，以 ViewModel/LogicBll dll 覆蓋輸出目錄實測）；HarnessSmokeTests 8/8。

• runtime：示例 1～B 全部端到端走過（教材 16 張截圖 step1–16）。

• 測試單留在 darbnogicsa1（收款單 R1/R2/R3-2026081800x、R1-2026080300x；帳款 21/22/26-20260818001、19-2026080300x、24-…、25-…；12-20260715014 的收款客戶被改成 +5CA01）。

2026-08-17 銷售單價異動記錄（QRY_SALPX_CSTK）自 VFP 客製庫移植

背景

選單點「銷售單價異動記錄」（M-120）與「客戶代料查詢」（M-130）都彈「無法建立ViewModel」。

真因在 C:\temps\debuglog\<date>.txt：

[ResolveErpViewModelType] 解析不到：className=[Qry_salpx_cstkViewModel] PrgClassVCX=[SCX_DCST] ProgramClass=[QRY_SALPX_CSTK]


[ResolveErpViewModelType] 解析不到：className=[Qry_custkp_cstkViewModel] PrgClassVCX=[SCX_DCST] ProgramClass=[QRY_CUSTKP_CSTK]

不是 DI 漏註冊，是這兩支 V2 從未實作——Common/ProgramClass.cs 只登了空鍵（commit c7ea7525

「ProgramClass 查詢程式登錄」為程式對照表補的代號），沒有 VM／XAML／BLL。手冊兩頁都寫

status: planned。本次先移植 QRY_SALPX_CSTK（使用者裁決順序），QRY_CUSTKP_CSTK 仍待做。

舊碼不在 vfpcode/（那裡只有 .prg），而是客製類別庫 C:\DARB_FOX\ASMBLY\VCXS\scx_dcst.vcx

（同支也在 NOGIHISA\VCXS\）裡的表單類別 qry_salpx_cstk，繼承 sql_qrya；程式碼在同名 .vct

memo 檔（Big5）。

使用者可見變動

• 主管資訊 銷售單價異動記錄（M-120） 可以開了，條件只有品號起訖（截止預設 zzzz）。

• 畫面三塊、上下連動：品號清單 → 報價歷史（每張報價單一列、報價項目金額橫展 10 欄）→ 廠商代工報價。

• 報價歷史的項目 1~10 欄標題＝該品號實際的報價項目名稱，隨選取品號切換。

• 手冊頁 docs/M-EIS/qry_salpx_cstk.md 由「規劃中」改寫為實作版（status: beta），

M-EIS index 的 _CSTK 段落同步改。

與舊版的差異（刻意）

1. 沒有項目的欄位隱藏，不像舊版留一排空白表頭的空欄。

2. HEADER01~HEADER10 的覆寫錯位不照抄：舊碼 `REPLACE HEADER01 WITH M.HEADER01, HEADER02 WITH

M.HEADER02, HEADER01 WITH M.HEADER03, HEADER03 WITH M.HEADER01…` 把 HEADER01 寫三次、02/03 錯接，

是舊版既有缺陷（只影響舊版那張 FRX 報表，畫面表頭走 更換抬頭 方法不受影響）。新版按正確語意

逐欄對應。若使用者反映舊報表表頭本來就長那樣，再議。

3. 報表拆成兩張：舊版一張 FRX ORDQRY_CSTK 用 relation 把三個 grid 串在同一張卡上印；

新版拆成 M120-1 客戶產品銷售單價異動紀錄卡（品號群組＋報價歷史，項目名印在群組表頭當欄標題）

與 M120-2 客戶產品廠商代工報價表。Excel 匯出走既有匯出機制，未特別處理。

沿用舊版的行為（有意保留）

• 只撈 已審核='Y'，畫面不開放此開關。

• 品號清單同品號只留一列，取查詢結果的最後一筆。

• 報價項目超過 10 個時，第 11 個之後金額不併入任何欄、不進小計（舊註解：「超過就是異常」）。

• 機台噸數＝第一個加工項目（序號 001）名稱含「壓鑄」時，項目名去掉「壓鑄-」。

改動清單

檔案	內容

LogicBll/M.EIS/銷售單價異動記錄/	QueryParameters＋4 個 Source＋Bll（新增 6 檔）

Common/DataBaseObjectEnum/Procedure.cs	加 DARB_QRY_ORDQRY_CSTK、DARB_QRY_單品報價歷史

ViewModel/M.EIS/Qry_salpx_cstk{,Condition}ViewModel.cs	主 VM（選取連動＋項目表頭）與條件 VM

TsERP/M.EIS/銷售單價異動記錄{,Condition}.xaml(.cs)	三格線畫面與條件面板

TsERP/App.xaml	兩個 DataTemplate

TsERP/DIExtension.cs	AddScoped<Qry_salpx_cstkConditionViewModel>()（漏了即「無法建立ViewModel」）

Common/Lang/Xaml/Qry_salpx_cstk{,Condition}.json	表頭與標籤四語

LogicBllTests/M.EIS/銷售單價異動記錄Tests.cs	8 個純邏輯測試（樞紐／抬頭編號／噸數／10 欄上限／預設值）

LogicBllTests/M.EIS/Qry_salpx_cstk_DispatcherIntegrationTests.cs	4 個整合測試：兩支 SP 的 proc_param 登錄＋經 dispatcher 實跑的結果集數與欄位名（欄位一變就紅）

Model/Rpt/Rpt_M120_SalpxCstkReportPoco{1,2}.cs	兩張報表的 POCO（屬性名＝中文；SQLite 欄名直接等於屬性名，見 memory report-sqlite-no-translate-chinese-poco）

TworkReportPluginOfficial/Qry_salpx_cstk{1,2}.cs	兩支 IExportReportPlugin（類名＝報表名稱；插件名稱留空時以報表名稱解析）

ViewModel/M.EIS/Qry_salpx_cstkViewModel.cs	實作 IPrintSource.GetReports()＋GetReportParameters()＋HaveReportData()

Qry_salpx_cstk{1,2}.frx	報表範本：版控來源 C:\Users\momo1\source\repos\FastReport\，部署複本 C:\dglibrary\REPORTSROOT\Reports\

LogicBllTests/M.EIS/Qry_cstk_ReportTemplateTests.cs	四張報表共用的範本測試（frx 表名／欄位 vs POCO／能否 Prepare）

資料來源

兩支 SP 都已存在於 darbnogicsa1 與 darbasmblycsa1，並登錄在 darbnogilog1.proc_param

（databaseid=C、param_qty=2），本次不需要跑任何 SQL：

• DARB_QRY_ORDQRY_CSTK（@查詢別=1, @查詢條件）→ 3 個結果集：品號主表／廠商報價／品號製程（第 3 集舊版也沒用）。

⚠️ 這支的 OBJECT_DEFINITION 顯示的建立名稱是 DARB_QRY_CUQTQRY_CSTK（曾被 sp_rename 改名），別誤認找錯物件。

• DARB_QRY_單品報價歷史（@查詢別=1, @查詢條件）→ 1 個結果集（cuqtd1 原料 UNION ALL cuqtd2 加工）。

一個差點踩到的坑：`序號` 有尾隨空白

SP 對 cuqtd1 的列輸出字面值 '000'，對 cuqtd2 的列輸出 加工序號。實際資料（darbcycsa1，14198 筆）

的 加工序號／材料序號 是 char(6) 補空白（'001 '），VFP 的 序號='001' 在 SET EXACT OFF

下照樣命中；C# 端必須 Trim() 後比對，直接 == "001" 會全部落空、單重／材料單價／噸數永遠空白。

本版已 Trim。

⚠️ darbdemocsa1 的 5 筆是造出來的示範資料，序號長成 '000010'／'0000000010'，

不代表正式格式，別照它調程式。

驗證

• ✅ MSBuild：TsERP.csproj 全綠 0 error（含 XAML 編譯）。因使用者的 TsERP.exe 正在執行、bin 被鎖，

改用 -p:OutputPath=C:\temps\build-salpx\out\ 導向別處編譯。

• ✅ 新增 8 個單元測試＋4 個整合測試全過（整合測試證明 dispatcher 路徑通、@result=OK、

三個／一個結果集的欄位名與 Source 完全對齊）；HarnessSmokeTests 7 支全過；LogicBllTests 全套 1158 支僅 1 失敗，

是既有的 PocollabOverdueAlertTests.掃描並通知_依發送人分組寄信_fallback_抑制重跑不重複（綁 dev 資料，與本次無關）。

• 🔴 runtime 未驗：① TsERP.exe 執行中無法覆蓋 bin；② 本機 darbnogicsa1／darbasmblycsa1 的

cuqtm 都是 0 筆（只有 darbcycsa1 有 14215 筆，但朝陽庫沒有這兩支 SP），沒有可驗證輸出的資料。

上線前需在有報價資料的環境開窗實測：三塊格線內容、項目欄標題隨品號切換、噸數帶出。

2026-08-17 runtime 實測（CMSA 登入 localhost／darbnogicsa1「模擬環境」）

用 TsERP.exe --screenshot <清單> 批次模式導覽＋UIA 驅動，實機確認：

• ✅ 兩支都開得起來——登入時的選單掃描（debuglog [ResolveErpViewModelType] 解析不到 那批）

已不再出現 Qry_salpx_cstkViewModel／Qry_custkp_cstkViewModel（同日 16:19 還在），

「無法建立ViewModel」不再發生。

• ✅ 條件面板與預設值正確落地：SALPX＝品號 空白~zzzz；CUSTKP＝客戶／品號 空白~zzzzzz、

交易日期 2014/12/01~2026/08/17、依客戶區間篩選 已勾。

• ✅ 格線與欄標題正確（SALPX 三塊、CUSTKP 兩塊）；沒有項目的項目1~10 欄如預期隱藏。

• ✅ 兩支的列印面板都列出各自兩張報表（IPrintSource 登錄生效），附 預覽／列印／Excel。

• ✅ 實際按 查詢 走完整 dispatcher→SP 路徑，無任何錯誤框、debuglog 無例外堆疊；

結果 0 筆（該庫 cuqtm 0 筆、bom_d.備料倉庫 非客戶代號，屬預期）。

• ✅ 0 筆時按 預覽 → 乾淨的「沒資料」提示（HaveReportData 守門有效），不崩。

• 🔴 仍未驗：有資料時的數字與報表版面。本機所有可登入的庫都沒有這兩支的資料，

必須在「BOM 備料倉庫填客戶代號、有已審核客戶單品報價」的環境（亮群）對帳。

報表版面已另以合成資料 PDF 驗過（Qry_cstk_ReportTemplateTests ＋ 四張 PDF）。

順帶：同批次掃了 M＋I 兩子系統共 57 支（35 OK／22 FAIL＝CMSA 在此庫無權限或該 doc id 非真 ProgramClass），

無新的開窗即崩；截圖存 C:\temps\smoke-20260817\。