程式資訊

程式 ID：TRWKMA
所屬子系統：H.庫存管理
狀態：stable

加工單交易查詢¶

功能簡介¶

「加工單交易查詢」是一個唯讀查詢畫面，用來把某段期間、某些品號、某些廠商的加工單（委外加工）交易資料一次撈出來檢視。它的資料來源是加工單交易檢視（Twork_stk_vw_trwkma），透過 SP DARB_BD_TRWAMA 查詢。

實務上它不是獨立的主選單功能，而是以「加工資料」頁籤的形式內嵌在廠商資料（SPDATA）維護畫面中：當你在廠商資料逐筆切換廠商時，本頁會自動以該廠商為條件帶出對應的加工交易，方便採購／生管人員一邊看廠商主檔、一邊對照這家廠商歷來的委外加工進出明細。

本頁是查詢而非建檔

這支頁籤只有查詢，沒有新增／修改／刪除／列印。實際產生加工單交易資料的建檔作業在加工單（TRWKMA）建檔程式；其中的耗料（領料）明細另由生產模組的生產日報表（WKDAY）處理，請見 F.Production。本頁看到的每一筆都是那邊存檔後的結果。

前置需求¶

權限：H-030 加工單（TRWKMA）的瀏覽權限（可否瀏覽）。沒有瀏覽權限時，本頁籤在廠商資料畫面中不會出現。
可否看單價權限：另由 可否看單價（AllowViewPrice）控制。沒有此權限時，查詢結果中的金額／稅額等價格欄位會被系統歸零顯示（見欄位連動與附加功能）。
基礎資料：查詢結果的完整度取決於下列資料——

資料	影響的結果
加工單交易（`TRWKMA` 建檔，耗料另由 `WKDAY` 處理）	查得到的交易明細本身；沒有建檔就查不到任何資料
廠商主檔	起始廠商／截止廠商搜尋帶值、結果中的客廠部簡稱／名稱
品號主檔	起始品號／截止品號搜尋帶值
SP `DARB_BD_TRWAMA` 已部署且 `proc_param` 已登錄	整支查詢能否回傳資料；未部署會查不到

操作步驟¶

本頁通常從廠商資料（SPDATA）畫面進入：

開啟 廠商資料 維護畫面，切換到 加工資料 頁籤（需有本程式瀏覽權限才看得到）。
確認上方查詢方式為 預設（另有 自定義，見欄位連動與附加功能）。
設定查詢條件（條件面板由三組起訖欄位組成）：
1. 起始日期／截止日期：比對交易的交易日期。預設帶「三個月前～9998/01/01」。
2. 起始品號／截止品號：以品號區間篩選，預設 空白～系統最大品號（由廠商資料開啟時自動帶入，等同不限）。
3. 起始廠商／截止廠商：以交易部門（廠商）區間篩選。
按 查詢 鈕（條件面板右側）。結果顯示在下方表格：
- 上方為明細表格，逐筆列出加工交易。
- 若 SP 回傳第二組結果集，下方會出現統計表格。
小技巧

從廠商資料逐筆換廠商時，系統會自動把起始廠商／截止廠商設成目前這家廠商並重查，不必每次手動輸入。
需要進一步彙總時，使用畫面右下角的樞紐分析選擇器，把查詢結果轉成樞紐（Pivot）檢視。

查詢條件改了要重按查詢

修改任何起訖條件後，要再按一次 查詢 結果才會更新；條件本身不會即時觸發查詢。

欄位說明¶

查詢條件¶

欄位	必填	說明／格式／預設
查詢方式	—	`預設`（用下列起訖條件）或 `自定義`（自行輸入 SQL 條件字串）。預設為 `預設`
起始日期	—	比對交易日期下界。預設＝今天往前 3 個月（`AddMonths(-3)`）
截止日期	—	比對交易日期上界。預設 `9998/01/01`（等同不設上限）
起始品號	—	品號區間下界。預設 `空白`
截止品號	—	品號區間上界。條件元件原始預設 `zzzzz`，但從廠商資料開啟時會被改帶系統最大品號（`GetMaxInvent`），效果同樣是不限上界
起始廠商	—	以交易部門（廠商代號）篩選的下界。預設 `空白`；從廠商資料進入時自動帶該廠商
截止廠商	—	交易部門上界。預設 `空白`；從廠商資料進入時自動帶該廠商
自定義條件	—	僅 `查詢方式＝自定義` 時顯示；直接輸入 SQL WHERE 條件字串取代上列起訖（進階用法）

查詢結果（明細表格主要欄位）¶

結果欄位取自加工單交易檢視（Twork_stk_vw_trwkma），常見欄位如下：

欄位	說明
倉單號	本頁的導覽鍵欄位（NavigateKeyField），可由此回查單據
單號／單據別／關聯單號	交易單號與其單據別、所關聯的來源單號
耗料單號	對應的耗料（領料）單號
交易日期	該筆加工交易發生日期（查詢即比對此欄）
生產部門／交易部門	生產部門與交易部門（交易部門即廠商，作為廠商條件比對欄）
品號相關	透過檢視 JOIN 出的品號資訊（搭配起訖品號條件）
幣別／匯率／稅別／稅額	幣別與換算資訊；稅額屬價格欄位，受看單價權限控管
發票號碼／發票日期／發票金額	對應發票資訊；發票金額為價格欄位
分攤工時	該筆分攤的工時
客戶代號／廠商代號	關聯的客戶／廠商
客廠部簡稱／名稱	由檢視 JOIN 帶出的廠商（部門）簡稱與名稱
已審核／審核日期／審核人員	審核狀態與軌跡
傳票號碼	若已轉立傳票，顯示對應傳票號碼
交易備註／轉入備註／轉出備註／其他摘要	各式備註與摘要

欄位以資料庫檢視為準

實際顯示的欄位由 SP DARB_BD_TRWAMA 回傳的結果集與該程式的版型設定決定，並非每個欄位都一定顯示。以上列出的是檢視（Twork_stk_vw_trwkmaSource）中定義的完整欄位集合。

欄位連動與附加功能¶

這一節整理「輸入某欄位／按某按鈕後，系統會做什麼」，全部來自實際程式碼。

查詢方式（預設／自定義）¶

當你選 預設：系統用條件面板的六個起訖欄位組出查詢條件—— 交易日期 >= 起始日期 AND 交易日期 <= 截止日期 AND 品號 >= 起始品號 AND 品號 <= 截止品號 AND 交易部門 >= 起始廠商 AND 交易部門 <= 截止廠商。
當你選 自定義：畫面右側會出現一個多行文字框，你輸入的字串會直接取代上述條件丟給查詢（進階／除錯用）。每次在廠商資料換筆時，系統會重置查詢狀態（ResetQueryState）——查詢方式回到 預設、自定義字串清空。

按「查詢」鈕¶

當你按 查詢，系統會：

先檢查本頁是否啟用（同時要有瀏覽權限、且所在的廠商資料畫面處於可查詢狀態）；不符就直接略過、不查詢。
呼叫 SP DARB_BD_TRWAMA，帶入上面組出的條件，取得結果集。
把第一組結果集綁到上方明細表格；若 SP 回傳超過一組結果集，會顯示下方統計表格並綁第二組。
接著做單價控管（見下）。

看單價權限連動（金額／稅額歸零）¶

查詢完成後，若你沒有看單價權限（可否看單價 為否），系統會呼叫 PriceHelper.UpdateAmountToZero，把結果中的金額類欄位（如稅額、發票金額）歸零後才顯示。
也就是說：金額顯示 0 不一定是沒資料，可能是權限被擋。要看到真實金額需開啟看單價權限。

從「廠商資料」畫面進入時的自動連動¶

本頁以「加工資料」頁籤掛在廠商資料（SPDATA）畫面內，連動行為如下：

切換廠商（換筆）：系統自動把起始廠商＝截止廠商＝目前這家廠商代號，並重置查詢狀態；切到本頁籤時自動執行一次查詢，帶出該廠商的加工交易。
進入新增／編輯狀態：廠商主檔在新增或編輯時，本頁籤會被停用（避免在主檔未存檔時查詢）；存檔回到正常狀態後才重新可用。
初始品號上界：開啟廠商資料時，系統會把本頁的截止品號預設成系統內最大品號（GetMaxInvent），確保品號區間預設涵蓋全部。

統計表格¶

只有當 SP DARB_BD_TRWAMA 回傳第二組結果集時才會出現。它用來顯示查詢結果的彙總（例如數量、工時、金額小計），內容由 SP 決定。

樞紐分析（Pivot）¶

畫面右下角的樞紐選擇器（PivotSelector1）可把目前查詢結果轉成樞紐表檢視，讓你自由拖拉維度做交叉彙總。它在程式啟動時依本程式的查詢 SP 預設好可用欄位。

沒有新增／修改／刪除／列印／轉傳票

本頁是純查詢，工具列不提供建檔、列印或轉傳票等動作。畫面中看到的「傳票號碼」「已審核」等欄位只是顯示來源交易的既有狀態，並非在本頁執行；要立傳票或審核請回到加工單（TRWKMA）建檔程式。

常見問題¶

在廠商資料裡找不到「加工資料」頁籤？

該頁籤受 TRWKMA（本程式）瀏覽權限控制。沒有瀏覽權限時，廠商資料畫面不會掛出這個頁籤。請洽系統管理員於 A.System 開通 H-030 加工單 的瀏覽權限。

按了查詢卻沒有任何資料？

依序確認： 1. 日期區間是否涵蓋交易日期——預設只往前抓 3 個月，較早的交易要把起始日期往前調。 2. 廠商區間是否正確——從廠商資料進入時會鎖定目前廠商；若要查全部，把起始／截止廠商清空再查。 3. 該期間是否真的有 TRWKMA（加工單）建立的加工交易。 4. SP DARB_BD_TRWAMA 是否已部署、proc_param 是否已登錄（未部署會靜默查不到）。

結果裡的金額／稅額都是 0？

多半是看單價權限被擋。沒有 可否看單價 權限時，系統會主動把金額類欄位歸零後才顯示——這不是資料錯誤。開通看單價權限後重查即可看到真實金額。詳見欄位連動與附加功能。

我可以在這頁直接改交易、刪除或列印嗎？

不行。本頁是唯讀查詢，沒有新增／修改／刪除／列印功能。要異動加工單交易，請到加工單（TRWKMA）建檔程式；耗料明細則於生產日報表（WKDAY，見 F.Production）處理。

查詢方式的「自定義」要怎麼用？

自定義 是進階用法：選了之後右側會出現多行文字框，你在裡面輸入的字串會整段取代預設的起訖條件。一般使用者用 預設 的六個起訖欄位即可，不需要動到自定義。