跳轉到

程式資訊

  • 程式 IDQRY_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_CSTKQRY_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_CSTKQRY_PA_CSTK
實作狀態 未實作(無 XAML / ViewModel / BLL / Source;ProgramClass 無此項;無 SP;無 VFP 類別)
已實作的標準版 採購查詢(PURCHQUERY),由 PurchQueryViewModel 實作
最接近的舊版來源 VFP pur_qry1(scx_qry.vcx,採購單查詢)

與標準版採購查詢的關係

新版已實作的標準採購查詢(PURCHQUERY)是 VFP pur_qry1(採購單查詢)的移植版:以廠商代號、品號、採購日期、預訂交期四組起訖區間查 vw_purchmvw_purch,列出採購單號、序號、採購日期、廠商、品號品名、數量、單位、已交數量、單價、匯率、幣別、預訂交期、備註、請購單號等欄位。QRY_PUR_CSTK 規劃為其客製衍生;實際差異(多/少哪些欄位、彙總到哪個層級、條件面板長相)在程式完成前都未確定,恕不臆測。

前置需求(規劃)

  • 權限:G.採購管理 → G-050 採購資料查詢 的瀏覽權限(待功能上線後於權限設定維護)。
  • 前置資料:本查詢屬事後檢視,需先有採購單資料才查得到內容——
資料 影響什麼
已開立之採購單(PURCH) 查詢結果的資料來源;沒有採購單就查無資料
廠商主檔 查詢條件的廠商起訖、結果的廠商簡稱
物料/品號主檔 品號的品名、單位等顯示欄位

上表為規劃對照

上述前置資料是依採購查詢流程推斷列出,待實際程式完成後會以真正讀取的主檔/View/SP 修正。

後續實作時將補上的內容

QRY_PUR_CSTK 在新版實作後,本頁會比照生產計劃查詢等查詢報表頁,補齊下列章節(目前因無程式可讀,暫缺,不臆測):

  1. 操作步驟——條件面板各欄位(廠商/品號/採購日期等起訖)的輸入與查詢流程。
  2. 欄位說明——條件欄位的預設值、結果格線的每個欄位。
  3. 欄位連動與附加功能——輸入某條件後系統的帶值/檢核、彙總算法、列印與匯出 Excel 等行為(須以實際 ViewModel/BLL 程式碼為準)。
  4. 常見問題——針對查無資料、欄位空白、單價/金額為 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/):

  1. qry_pur_cstk-step1.png — 條件面板(廠商/品號/採購日期等起訖查詢條件)。
  2. qry_pur_cstk-step2.png — 查詢結果格線(採購單明細彙整)。