例外不良（生產不良品登錄）¶

此功能尚在規劃，新版尚未提供

「例外不良」（WKNG，選單代號 F-050）目前僅完成資料模型（Model/Source POCO）與程式代號註冊，新版 TsERP 尚未實作可操作的畫面（無 ViewModel、無 SaveBll/EditBll、無 XAML、無報表）。本頁依舊版 VFP 程式 wkng 的設計，說明此功能規劃中的用途與欄位，供導入評估參考；下列「操作步驟」描述的是規劃中的流程，目前在新版中無法執行。

功能簡介¶

「例外不良」用來登錄生產過程中發生的例外不良品：由哪個生產部門、在什麼不良日期、發生哪些品號的不良，並逐項記錄不良數量、不良原因、不良類別、處理方式、責任單位、廠商等資訊。主要使用者為生管、品保與現場人員，用於追蹤不良來源、區分責任，以及後續的報廢／退庫處理。

在生產流程中，它與製令派工（WKPAPER）、生產資訊（PDTINF）同屬現場回報的一環：派工開立工單、現場生產回報工時與產出，而例外不良則記錄這條產線上「做壞」的部分與其後續處置。

資料結構

此功能是「主檔＋明細」結構。新版的資料模型已備妥：

主檔 Source：Twork_pdt_vw_wkngmaSource（對應 DB view vw_wkngma／實表 wkngma）
明細 Source：Twork_pdt_vw_wkngdeSource（對應 DB view vw_wkngde／實表 wkngde）

但沒有對應的 ViewModel 與 BLL，因此尚無法載入、編輯或儲存。

前置需求¶

權限：F.生產 → F-050 例外不良 的瀏覽／修改權限（功能上線後生效）。
基礎資料：登錄不良時會引用下列主檔與代碼，建議先維護完整——

資料	影響的內容
生產部門（客戶廠商部門主檔）	主檔的生產部門代號與簡稱
品號主檔（SK_INVENT）	明細的品號／品名、不良主件／不良主件品名
廠商主檔（SK_SPDATA）	明細的廠商代號／廠商簡稱
不良原因代碼（VFP cmb_219）	明細的不良原因碼對照名稱
不良類別代碼（VFP cmb_218）	明細的不良類別碼對照名稱
處理方式代碼（VFP cmb_220）	明細的處理方式碼（如 `2.報廢`）

操作步驟¶

以下為規劃中流程

下列步驟描述舊版 VFP wkng 的操作邏輯，作為新版實作藍本。新版目前無法執行這些動作。

從主選單開啟 F.生產 → 例外不良 視窗。
點選 新增。
在主檔區輸入：
1. 生產部門：輸入代號，系統帶出簡稱。
2. 不良日期：格式 yyyy/MM/dd。
3. 不良備註：選填，最長 80 字。
在明細格線逐列輸入不良項目（見欄位說明）：品號、不良數、不良原因碼、不良類別碼、處理方式碼、不良主件、廠商代號、責任單位、備註。
點選 儲存。儲存前系統會做檢核（見欄位連動與附加功能）：必須有生產部門與不良日期；若有任一列處理方式為「報廢」卻未填責任單位，會擋下儲存。
需修改既有單據時，先以 瀏覽／查詢 帶出單號，再按 修改。
需列印時按 列印（舊版報表程式 WKNG_P）。

列印與報表

舊版以報表程式 WKNG_P（搭配 SCX_PDTP）列印例外不良單。新版報表尚未移植。

欄位說明¶

主檔¶

欄位	必填	說明/格式/預設
單號	是	系統自動產生（最長 20 字），不可手動輸入。對應 `DocumentNo`
生產部門	是	輸入部門代號（最長 10 字），帶出部門簡稱。對應 `ProductionDepartmentCode`／顯示名 `CustVendDeptName`
不良日期	是	格式 `yyyy/MM/dd`。對應 `ProductionDate`
不良備註	否	自由輸入，最長 80 字。對應 `Notes`

明細（每筆不良項目一列）¶

欄位	必填	說明/格式/預設
序號	是	明細列序號，自動帶入。對應 `LineNo_`
品號	是	不良品的品號（最長 30 字），帶出品名。對應 `SKU`／顯示 `SKUDescription`
不良數	是	不良數量。資料型別為數值（`decimal`，精度 15、小數 2 位）；舊版畫面以千分位整數格式（`999,999`）顯示。對應 `DefectQuantity`
不良原因碼	否	代碼，帶出不良原因名稱（VFP cmb_219）。對應 `DefectReasonCode`
不良類別碼	否	代碼，帶出不良類別名稱（VFP cmb_218）。對應 `DefectCategoryCode`
處理方式碼	否	代碼，帶出處理方式名稱（VFP cmb_220）；`2` 代表「報廢」。對應 `ReprocessCode`
不良主件	否	造成不良的主件品號，帶出不良主件品名；可用搜尋鈕自動帶出。對應 `DefectMainPart`／顯示 `DefectMainPartDescription`
廠商代號	否	不良主件的供應廠商，帶出廠商簡稱；搜尋不良主件時會一併帶入。對應 `VendorCode`／顯示 `VendorName`
責任單位	視情況	處理方式為「報廢」時必填。對應 `RelatedDepartment`
備註	否	自由輸入，最長 40 字。對應 `Notes`
退庫日期	唯讀	系統帶入，不可編輯。對應 `ReturnToWarehouseDate`
領料日期	唯讀	系統帶入，不可編輯。對應 `PickingDate`

欄位連動與附加功能¶

以下行為來自舊版 VFP wkng 程式，是新版實作時應對齊的設計重點：

生產部門輸入後帶簡稱：在主檔的生產部門欄輸入代號後，系統以代號查客戶廠商部門主檔，自動顯示對應的部門簡稱。
明細各代碼欄自動帶名稱：當你在明細輸入下列代碼，系統會即時對照代碼表帶出名稱顯示——
- 品號 → 由品號主檔（SK_INVENT）帶出品名。
- 不良原因碼 → 由 cmb_219 帶出 不良原因。
- 不良類別碼 → 由 cmb_218 帶出 不良類別。
- 處理方式碼 → 由 cmb_220 帶出 處理方式。
- 廠商代號 → 由廠商主檔（SK_SPDATA）帶出 廠商簡稱。
- 不良主件 → 由品號主檔帶出 不良主件品名。
「搜尋不良主件」按鈕：明細列有一個搜尋功能。當你已輸入品號後，按下搜尋鈕，系統會開啟主件／廠商查詢視窗（VFP SEEKWKQ），讓你挑選該品號的不良主件，選定後自動回填該列的 不良主件 與 廠商代號。
- 若該列品號為空就按搜尋，系統提示「請先輸入品號，才可進行搜尋」。
- 此搜尋鈕只在新增／修改模式下可用；瀏覽模式下停用。
代碼欄位的啟用時機：不良原因碼、不良類別碼、處理方式碼 與搜尋不良主件鈕，只有在進入新增／修改／複製新增模式時才可編輯；瀏覽時這些欄位停用、無法更動。
退庫日期／領料日期為唯讀：明細的 退庫日期、領料日期 由系統依後續退庫／領料作業帶入，畫面上不可手動編輯。
儲存前檢核（AllowSave）：按儲存時，系統依序檢查——
1. 生產部門 不可空白（也不可為「新增」或 +++ 之類的預設佔位字）；否則提示「請先輸入生產部門」並擋下儲存。
2. 不良日期 不可空白；否則提示「請先輸入不良日期」並擋下儲存。
3. 若有任一明細列的處理方式為報廢（處理方式碼＝2）卻沒填責任單位，提示「報廢請先輸入責任單位」並擋下儲存。
4. 通過後，系統會把品號為空白的明細列自動標記為刪除（不寫入），避免存進空列。

規劃中／尚未提供

上述連動、搜尋視窗、檢核與報表在新版 TsERP 尚未實作。目前 repo 只有資料模型，沒有承載這些行為的 ViewModel / BLL，故無法在系統中操作。

常見問題¶

在新版選單找不到「例外不良」可以用嗎？

目前新版尚未提供此功能的操作畫面。系統內僅完成資料模型與程式代號註冊，畫面、儲存與報表都還在規劃中，無法實際登錄不良資料。

為什麼處理方式選了報廢卻存不進去？

依規劃，處理方式為「報廢」（處理方式碼＝2）的明細列必須填寫責任單位，否則系統會擋下儲存並提示「報廢請先輸入責任單位」。先補上責任單位再儲存即可。

明細的退庫日期、領料日期為什麼不能改？

這兩個欄位是唯讀，由系統依後續的退庫與領料作業自動帶入，並非由本表單手動輸入。

輸入了代碼但沒有帶出名稱（不良原因／類別／處理方式空白）？

名稱來自對應的代碼表（不良原因 cmb_219、不良類別 cmb_218、處理方式 cmb_220）。若代碼表沒有該筆代碼，名稱欄就會空白。請先到代碼維護補齊對應代碼。

按「搜尋不良主件」沒反應或提示要先輸入品號？

搜尋鈕需要先輸入該列的品號才能查詢主件與廠商；品號空白時系統會提示「請先輸入品號，才可進行搜尋」。此外，搜尋鈕只在新增／修改模式下可用。