程式資訊

程式 ID：APROJ
所屬子系統：B.基本資料
狀態：stable

專案資料¶

功能簡介¶

「專案資料」用來建立並維護專案／工程案主檔（資料表 View Twork_bas_vw_aproj）。每一筆代表一個專案或工程案，記錄它的專案代號、所屬客戶、案號、執行期間（起迄日）、經常／資本支出預算、委辦單位、派駐人員與結算方式等基本資訊。

它是一張典型的單檔（master-only）設定主檔，沒有明細列、沒有沖帳或轉傳票。建立好的專案代號可在其他需要「依專案歸屬」的單據或查詢中被引用，作為成本歸集與專案管理的依據。通常由管理部或專案管理人員在專案立案時建檔。

前置需求¶

權限：B.基本資料 → B-130 專案資料，依操作需要具備 新增／修改／刪除／瀏覽 權限。
基礎資料：本表單欄位多為自由輸入，僅「客戶代號」會連到客戶主檔——

資料	影響的內容
客戶主檔（CUDATA）	客戶代號的搜尋來源與客戶簡稱的自動帶出（見欄位連動與附加功能）

備註

除了客戶代號之外，案號、委辦單位、派駐人員、結算方式、專案類別 等欄位皆為純文字輸入，沒有對應主檔，由建檔人自行填寫，方便依公司內部命名習慣自由運用。

操作步驟¶

本表單為標準的單檔維護畫面，操作沿用系統共用工具列（新增／修改／刪除／查詢／儲存）。

新增專案¶

從選單進入「專案資料」。
按工具列 新增，游標會自動停在 專案代號 欄位（系統會把游標聚焦到第一個欄位）。
在 專案代號 輸入唯一代號（最長 10 碼，紅色標示為主鍵，存檔後不可重複）。
填寫 專案簡稱、專案名稱、地點。
在 客戶代號 欄位輸入或按搜尋按鈕挑選客戶，系統會自動帶出 客戶簡稱（詳見欄位連動與附加功能）。
視需要填寫案號、專案類別、專案負責人、經常支出、資本支出、起始日期、截止日期、委辦單位、派駐人員、結算方式 及多行的 專案說明。
按工具列 儲存 完成建檔。

修改 / 刪除既有專案¶

按工具列 查詢 找到要處理的專案（可用瀏覽視窗依專案代號／簡稱挑選）。
要改內容時按 修改，調整欄位後按 儲存。
要刪除整筆時按 刪除，確認後即移除該專案。

注意

專案代號 是主鍵，一經存檔即代表此專案的唯一識別。若已被其他單據引用，請勿任意刪除，以免造成資料勾稽缺漏。

欄位說明¶

欄位	必填	說明／格式／預設
專案代號	✔	主鍵，最長 10 碼；畫面以紅色（重要色）標示。新增後不可重複。
專案簡稱	—	最長 30 字，專案的簡短名稱。
專案名稱	—	最長 120 字，專案的完整名稱。
地點	—	最長 50 字，專案執行地點。
客戶代號	—	最長 10 碼，對應客戶主檔；可用搜尋按鈕挑選。輸入後自動帶出客戶簡稱。
客戶簡稱	—	最長 40 字，依客戶代號自動帶出，亦可手動覆寫。
案號	—	最長 20 字，自由輸入的案件編號。
專案類別	—	最長 30 字，自由輸入的分類標籤。
專案負責人	—	最長 30 字。
經常支出	—	金額欄位，依本位幣格式顯示小數位（`PlaceEnum=Local`），底層精度為 (19,4)，預設 0。
資本支出	—	金額欄位，依本位幣格式顯示小數位（`PlaceEnum=Local`），底層精度為 (19,4)，預設 0。
起始日期	—	短日期格式（ShortDate），專案開始日。
截止日期	—	短日期格式（ShortDate），專案結束日。
委辦單位	—	最長 80 字。
派駐人員	—	最長 30 字。
結算方式	—	最長 50 字。
專案說明	—	多行文字（最長 999 字），支援換行（`AcceptsReturn`）。

新增時的預設值

按 新增 時，所有文字欄位預設為空字串、金額欄位預設為 0，內部異動別（增刪修）預設為 A（新增）。畫面上沒有需要先選的下拉預設值。

欄位連動與附加功能¶

本表單的互動行為相對單純，但有幾個關鍵連動務必了解：

客戶代號 → 自動帶出客戶簡稱¶

當你在 客戶代號 欄位輸入代號並離開欄位（失焦）時，系統會以該代號到客戶主檔查詢，自動把 客戶簡稱 填好。

此連動由 客戶代號Binding 屬性觸發：設定客戶代號的同時，系統呼叫 DescriptionHelper.GetCustomerName(客戶代號) 取得客戶名稱寫入 客戶簡稱。
因此你不需要手動打客戶簡稱——輸入代號即可帶出。若代號查不到對應客戶，簡稱會被帶成空白。
帶出後的客戶簡稱仍可手動修改（欄位本身可編輯），覆寫後以你輸入的為準。

客戶搜尋按鈕（CustomerSearch）¶

客戶代號 欄位套用了系統共用的 CustomerSearch 樣式，旁邊附帶搜尋按鈕。

當你按下搜尋按鈕，系統會開啟客戶查詢視窗，可依代號／簡稱挑選客戶。
選定後客戶代號回填到欄位，並同步觸發上述「自動帶出客戶簡稱」的連動。

工具列與資料維護¶

本表單繼承系統共用的程式框架（ERPProgramViewModel），因此自動具備：

共用工具列：新增、修改、刪除、查詢、儲存 等標準動作。
瀏覽 / 導覽：按 查詢 可開啟瀏覽視窗挑選既有專案，並支援上一筆／下一筆導覽。
權限控管：各動作依 B-130 的權限設定決定是否可用。
焦點控制：按 新增 後游標會自動定位到 專案代號，方便直接輸入。

無報表、無轉拋

本表單沒有實作列印報表（無 GetReports），也沒有沖帳、轉傳票、Excel 匯入匯出或計算重算（無 Calculate*／ExtensionFunction）等附加功能。它是純粹的主檔維護畫面。

保留款比率（尚未提供）

資料結構中雖保留了 保留款比率 欄位，但畫面上對應的輸入框已被註解、目前不顯示，因此此欄位無法在介面維護。若日後有「工程案保留款」需求才會啟用。

常見問題¶

輸入了客戶代號，客戶簡稱卻是空白？

客戶簡稱是依客戶代號到客戶主檔即時查回來的。若簡稱沒帶出，多半是該客戶代號在客戶主檔中不存在（打錯代號），或客戶尚未建檔。建議改用 客戶代號 旁的搜尋按鈕挑選，避免代號輸入錯誤。

存檔時提示專案代號重複 / 無法存檔？

專案代號 是主鍵，不可與既有專案重複。請先按 查詢 確認該代號是否已被使用；若要修改既有專案，應先查出該筆再按 修改，而不是用 新增 重打同一個代號。

為什麼找不到「保留款比率」欄位？

該欄位的輸入框目前在畫面上被停用（已註解），屬於規劃中未啟用的功能，因此介面上看不到，也無法輸入。詳見欄位連動與附加功能中的說明。

經常支出 / 資本支出顯示 0，是沒存到嗎？

這兩個金額欄位在 新增 時的預設值就是 0。若你確實沒輸入金額，存檔後維持 0 是正常的；需要編列預算時直接在欄位輸入數字即可，顯示小數位依本位幣設定（底層精度為 (19,4)）。

改了專案內容後按了儲存，列表沒更新？

請確認是以 修改 狀態存檔（而非仍在瀏覽狀態）。修改既有資料的正確流程是：查詢 找到該筆 →按 修改 →調整欄位 →按 儲存。