程式資訊
- 程式 ID:
PERDATA1 - 所屬子系統:F.生產管理
- 狀態:stable
人員資料表¶
此功能尚未移植到新版
本頁描述的「人員資料表(PERDATA1,F-060)」目前只存在於 VFP 舊版系統,新版 TsERP 尚未提供對應的程式(無 ViewModel、XAML、BLL,僅在 Common/ProgramClass.cs 中保留了 PERDATA1 的識別碼)。下方內容依 VFP 原始程式(scx_pdt.vcx 的 perdata1 class)整理,作為移植前的功能規格參考,畫面與操作步驟在新版上線後可能調整。
功能簡介¶
「人員資料表」是維護員工基本資料的主檔表單,提供員工編號、姓名、所屬部門與到職/離職日期等核心人事欄位。生管、生產相關功能(如工時、績效統計)會以此處登錄的員工編號與部門對應,作為人員歸屬的依據;它在整個流程中扮演「人員主檔」的角色,後續任何以員工為單位的查詢與統計都需要先在這裡建立資料。
在 VFP 舊版中,本表單是 PERDATA 人事資料程式家族的一個頁面(程式名稱 ?= PERDATA),以單筆主檔方式呈現,每次顯示一位員工的資料。
前置需求¶
- 權限:F.生產 →
F-060 人員資料表的瀏覽/修改權限。 - 基礎資料:建立員工資料前,相關主檔需先維護妥當——
| 資料 | 影響什麼 |
|---|---|
| 部門主檔 | 部門代號欄位的下拉選取與部門簡稱顯示;找不到部門代號時無法存檔 |
| 員工編號編碼規則 | 員工編號為主鍵且不可重複,需先確定編號規則 |
部門簡稱來源
VFP 舊版以 SK_DEPT 查詢游標把部門代號對應到部門簡稱:選取或輸入部門代號後,系統自畫面快取帶出對應的部門簡稱。新版移植時,部門簡稱應由部門主檔 JOIN 帶出,不需在本表單手動輸入。
操作步驟¶
規劃中
以下步驟為依 VFP 舊版行為整理的預期操作流程,新版尚未提供,實際畫面以上線版本為準。
- 從主選單開啟 F.生產 → 人員資料表 視窗。
- 點選工具列的
新增按鈕,畫面切換為可輸入狀態。 - 輸入 員工編號(主鍵,不可與既有員工重複)。
- 輸入 姓名。
- 選取 部門代號,系統帶出對應的部門簡稱。
- 視需要輸入 到職日期、離職日期(格式
yyyy/MM/dd)。 -
點選
儲存。系統會檢核員工編號、姓名、部門代號皆已填寫,通過後寫入。小技巧
可用 Ctrl+S 快速儲存。
-
要修改既有員工資料時,先以工具列的查詢(
SEEK)功能定位到該員工,按修改後調整欄位再儲存。 - 要移除員工資料,定位後按
刪除。

欄位說明¶
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| 員工編號 | 是 | 主鍵,最長 10 碼;不可重複(VFP is_noduplicate);輸入值不可為空、不可為 新增 或 +++ |
| 姓名 | 是 | 員工姓名,不可為空 |
| 部門代號 | 是 | 由部門主檔選取(VFP sqlnm_dept 下拉);不可為空,並帶出部門簡稱 |
| 到職日期 | 否 | 格式 yyyy/MM/dd(VFP InputMask 9999/99/99) |
| 離職日期 | 否 | 格式 yyyy/MM/dd(VFP InputMask 9999/99/99) |
唯讀欄位
VFP 舊版把姓名、到職日期、離職日期、員工編號設為 ReadOnly,實際可編輯狀態由表單的新增/修改模式控制。移植時應比照「新增模式可編輯員工編號、修改模式鎖定主鍵」的慣例。
欄位連動與附加功能¶
以下行為來自 VFP perdata1 class 的程式碼,整理成「當你⋯,系統會⋯」:
-
輸入/選取部門代號 → 帶出部門簡稱:表單以
SK_DEPT查詢游標把部門代號對應到部門簡稱(moverec_sk_cursor程序)。選到一個尚未在快取中的部門代號時,系統會把該部門寫入查詢游標;已存在時則更新其部門簡稱。對使用者而言:選好部門代號,旁邊就會顯示對應的部門簡稱。 -
員工編號不可重複:員工編號設定了 no-duplicate 檢核(VFP
is_noduplicate = "perdata"、noduplicate_tag = 員工編號)。當你輸入一個已存在的員工編號要新增時,系統會擋下。 -
存檔前檢核(
allowsave):按儲存時,系統依序檢查——- 員工編號不可為空、且不可是
新增或+++,否則提示「請先輸入員工編號 !!!」並中止存檔。 - 姓名不可為空,否則提示「請先輸入姓名 !!!」。
- 部門代號不可為空,否則提示「請先輸入部門代號 !!!」。
三項全部通過才會真正寫入。
- 員工編號不可為空、且不可是
-
單筆主檔瀏覽:本表單為單筆主檔(VFP
browsetype = "-KM"、alias_r0 = 人事資料表),以員工編號為鍵;工具列提供上一筆/下一筆/首筆/末筆與SEEK查詢,一次顯示一位員工的資料。
新版尚未提供的部分
上述連動與檢核均取自 VFP 舊版。新版 TsERP 目前沒有對應的 ViewModel/BLL,因此這些自動帶值與檢核在新版尚未實作。移植時建議至少保留:部門代號帶部門簡稱、員工編號不可重複、以及存檔前三項必填檢核。
常見問題¶
在新版 TsERP 找不到「人員資料表」這支程式?
這是正常的——本功能目前尚未移植到新版,只在 VFP 舊版系統提供。新版僅保留了 PERDATA1 識別碼。請暫時於舊版維護員工資料,或洽系統管理員確認移植排程。
存檔時跳出「請先輸入部門代號 !!!」?
部門代號為必填且不可為空。請先在部門主檔建立該部門,再回到本表單選取部門代號後存檔。同樣地,員工編號與姓名留空時也會分別出現「請先輸入員工編號 !!!」「請先輸入姓名 !!!」。
選了部門代號,部門簡稱卻沒有顯示?
部門簡稱是由部門代號對應帶出的(VFP 用 SK_DEPT 查詢游標)。若沒帶出,多半是該部門代號在部門主檔中不存在或尚未建立——請先到部門主檔確認該部門資料完整。
員工編號可以重複嗎?
不行。員工編號是主鍵且設有不可重複檢核,輸入既有編號要新增時會被擋下。每位員工的編號必須唯一。
相關功能¶
需補截圖清單
本功能新版尚未實作,待移植上線後再補拍(放 docs/F-Production/images/):
perdata1-step1.png— 人員資料表主畫面(含員工編號、姓名、部門、到職/離職日期欄位)