程式資訊
- 程式 ID:
QRY_PUR_CSTK - 所屬子系統:G.採購付款
- 狀態:stable
採購資料查詢(客製版)¶
本功能尚在規劃中(未提供)
QRY_PUR_CSTK 採購資料查詢(G-050) 目前只登錄在系統程式總表,尚未在新版 TsERP 實作。整個 repo 的程式碼中找不到對應的 XAML、ViewModel、BLL、Source(Model),連 ProgramClass 列舉裡都沒有 QRY_PUR_CSTK 這個項目(同家族只有 CUQT_CSTK 已定義)。也就是說,這支查詢還沒有可操作的畫面。
本頁僅就「程式名稱與所屬流程」描述其規劃用途,方便日後實作時對照。下方刻意不提供完整操作步驟與欄位連動,因為實際行為要等程式完成後、以真實程式碼為準才會確定。請勿把本頁描述當作現行可用功能。現階段請改用已實作的採購查詢(PURCHQUERY)。
功能簡介¶
依系統程式總表(docs/programmap.txt 第 132 列)登錄,QRY_PUR_CSTK 的中文名稱為採購資料查詢,代號 G-050,歸屬 G 採購管理模組,屬查詢報表類。
從命名推斷,它規劃為一支採購單(採購主檔/明細)的查詢報表:依條件(廠商、品號、採購日期、交期等)把已開立的採購單彙整成可回查的清單,供採購、生管或主管在單據登錄之後檢視。程式 ID 結尾的 _cstk 是本系統用來標示特定客戶客製版本的命名慣例(如 CUQT_CSTK、QRY_PA_CSTK 等同屬此家族),意味著 QRY_PUR_CSTK 規劃為標準採購查詢(PURCHQUERY)的客製衍生,欄位或彙總邏輯可能依特定客戶需求調整。
在流程中的位置,它落在採購單登錄之後的查詢分析端,與採購查詢(PURCHQUERY)、採購單列印(PURCHPRINT)同屬「採購資料的事後檢視」一環,三者面對同一批採購資料、只是檢視角度(彙總查詢/客製查詢/列印)不同。
用途為推斷,非程式確認
上述用途是依程式名稱、_cstk 客製命名慣例與同模組已實作功能推斷而來,並非從 QRY_PUR_CSTK 自己的程式碼讀出(因為它根本還沒有程式碼)。本專案中查無 QRY_PUR_CSTK 的任何實作檔(XAML / ViewModel / BLL / Source),也沒有對應的 SP/Procedure 或 VFP 類別,唯一出現位置是程式總表 programmap.txt。等本功能實作後,本頁會改以真實的條件面板、結果欄位與欄位連動改寫,並把 status 升為 beta。
規劃定位¶
| 項目 | 內容 |
|---|---|
| 程式代號 | QRY_PUR_CSTK |
| 中文名稱 | 採購資料查詢(客製版) |
| 選單代號 | G-050 |
| 所屬模組 | G 採購管理(Purchasing) |
| 類型 | 查詢報表 |
| 命名家族 | _cstk(特定客戶客製版本,例:CUQT_CSTK、QRY_PA_CSTK) |
| 實作狀態 | 未實作(無 XAML / ViewModel / BLL / Source;ProgramClass 無此項;無 SP;無 VFP 類別) |
| 已實作的標準版 | 採購查詢(PURCHQUERY),由 PurchQueryViewModel 實作 |
| 最接近的舊版來源 | VFP pur_qry1(scx_qry.vcx,採購單查詢) |
與標準版採購查詢的關係
新版已實作的標準採購查詢(PURCHQUERY)是 VFP pur_qry1(採購單查詢)的移植版:以廠商代號、品號、採購日期、預訂交期四組起訖區間查 vw_purchm/vw_purch,列出採購單號、序號、採購日期、廠商、品號品名、數量、單位、已交數量、單價、匯率、幣別、預訂交期、備註、請購單號等欄位。QRY_PUR_CSTK 規劃為其客製衍生;實際差異(多/少哪些欄位、彙總到哪個層級、條件面板長相)在程式完成前都未確定,恕不臆測。
前置需求(規劃)¶
- 權限:G.採購管理 →
G-050 採購資料查詢的瀏覽權限(待功能上線後於權限設定維護)。 - 前置資料:本查詢屬事後檢視,需先有採購單資料才查得到內容——
| 資料 | 影響什麼 |
|---|---|
| 已開立之採購單(PURCH) | 查詢結果的資料來源;沒有採購單就查無資料 |
| 廠商主檔 | 查詢條件的廠商起訖、結果的廠商簡稱 |
| 物料/品號主檔 | 品號的品名、單位等顯示欄位 |
上表為規劃對照
上述前置資料是依採購查詢流程推斷列出,待實際程式完成後會以真正讀取的主檔/View/SP 修正。
後續實作時將補上的內容¶
待 QRY_PUR_CSTK 在新版實作後,本頁會比照生產計劃查詢等查詢報表頁,補齊下列章節(目前因無程式可讀,暫缺,不臆測):
- 操作步驟——條件面板各欄位(廠商/品號/採購日期等起訖)的輸入與查詢流程。
- 欄位說明——條件欄位的預設值、結果格線的每個欄位。
- 欄位連動與附加功能——輸入某條件後系統的帶值/檢核、彙總算法、列印與匯出 Excel 等行為(須以實際 ViewModel/BLL 程式碼為準)。
- 常見問題——針對查無資料、欄位空白、單價/金額為 0 等實際會卡住的點。
常見問題¶
在主選單找得到「採購資料查詢」嗎?
QRY_PUR_CSTK 目前找不到可操作的畫面。它僅登錄在系統程式總表(G-050),尚未在新版 TsERP 實作。若主選單有此項但點開無反應或報錯,屬尚未開發完成,非設定問題。要查採購單請改用已實作的採購查詢(PURCHQUERY)。
我想查已經開立的採購單,現在可以用哪一支?
請用採購查詢(PURCHQUERY):輸入廠商、品號、採購日期、交期等起訖區間即可列出採購單明細;列印需求走採購單列印(PURCHPRINT)。QRY_PUR_CSTK 是該功能的客製版,在它上線前所有採購單回查都走標準版。
這頁為什麼沒有操作步驟和欄位表?
因為本專案程式碼中沒有 QRY_PUR_CSTK 的 XAML、ViewModel、BLL 或 Source,連 ProgramClass 與 SP 都查無此項、也沒有對應的 VFP 類別,無從讀出真實行為。為避免杜撰,本頁只描述規劃用途;等程式完成後才會補上以實際程式碼為準的操作與欄位說明。
QRY_PUR_CSTK 和標準的「採購查詢」差在哪?
依命名推斷:_cstk 是特定客戶客製版本的標記。標準採購查詢(PURCHQUERY)是給所有客戶用的通用版(已實作);QRY_PUR_CSTK 規劃為某客戶的客製衍生,欄位或彙總可能略有不同。實際差異仍以本功能完成後的程式碼為準。
相關功能¶
需補截圖清單
本功能尚未實作,目前無畫面可截圖。待 QRY_PUR_CSTK 在新版上線後,再補拍下列圖(放 docs/G-Purchasing/images/):
qry_pur_cstk-step1.png— 條件面板(廠商/品號/採購日期等起訖查詢條件)。qry_pur_cstk-step2.png— 查詢結果格線(採購單明細彙整)。