程式資訊
- 程式 ID:
_INFODB - 所屬子系統:A.系統資料
- 狀態:stable
訊息資料表¶
功能簡介¶
「訊息資料表」(_INFODB,A-030)是系統內維護訊息文字內容的設定主檔。每一筆訊息由一個單號識別,內含一段訊息名稱(標題)與一段較長的訊息資料(內文)。它對應後端的 twork_sys_vw_infodb View,是系統管理者用來集中保管制式訊息/公告文字的地方,供其他流程(例如聯絡單)引用。
這支表單屬於最單純的「單一主檔」型態:一張表單一筆資料、沒有明細子表、沒有金額計算,只負責建立/維護一段文字內容並存檔。通常由系統管理員或具修改權限的人員維護。
資料表用途說明
此表的資料來源 View 內含 聯絡單id、工作流程、審核人員、已審核 等欄位,與「聯絡單」訊息流程相關;但在本表單畫面上只開放維護單號、日期、訊息名稱、訊息資料四個欄位,其餘欄位由資料表本身或關聯流程帶入,畫面上看不到,也不需在此手動填寫。
前置需求¶
- 權限:A.系統設定 →
A-030 訊息資料表的瀏覽/修改權限(見 frontmatter 的permissions)。沒有修改權限時只能查詢、不能存檔。 - 基礎資料:本表單為純文字主檔,不依賴其他主檔即可建立資料。下表說明它與系統其他部分的關係:
| 資料 | 影響的結果 |
|---|---|
| 本表單建立的訊息(單號+訊息名稱+訊息資料) | 提供制式訊息文字供其他流程引用 |
| 聯絡單流程 | 透過 聯絡單id 與本資料表關聯(由流程帶入,非本表單手動維護) |
操作步驟¶
新增一筆訊息¶
- 從主選單開啟 A.系統設定 → 訊息資料表(A-030)。
- 點選工具列的
新增,畫面清空成一張空白表單。 - 在 單號 欄輸入此筆訊息的識別碼(最長 20 碼,為主鍵,存檔後不建議再改)。
- 在 日期 欄選擇或輸入日期(格式
yyyy/MM/dd,可用日期挑選器)。 - 在 訊息名稱 欄輸入這段訊息的標題(最長 30 字)。
-
在 訊息資料 欄輸入訊息內文。此欄位是多行文字框、可換行(最長 999 字),右側有捲軸。
小技巧
訊息資料欄支援 Enter 換行,可貼上多行文字。輸入較長內容時用右側捲軸瀏覽。
-
點選
儲存。系統會把這筆資料寫回伺服器。

修改既有訊息¶
- 用工具列的
查詢(或上一筆/下一筆導覽)找到要修改的單號。 - 直接在欄位上修改 日期、訊息名稱 或 訊息資料。
-
點選
儲存覆蓋原內容。注意
單號 是主鍵,是這筆資料的識別碼。如需更換單號,建議改以新單號
新增一筆,再刪除舊資料,避免引用該訊息的其他流程對不到。
刪除訊息¶
- 查詢並切換到要刪除的單號。
- 點選工具列的
刪除,確認後該筆訊息即從資料表移除。
查詢/瀏覽¶
- 點選
查詢帶出查詢條件,依單號等條件找出資料。 - 用工具列的導覽按鈕(第一筆/上一筆/下一筆/最後一筆)逐筆切換瀏覽既有訊息。
欄位說明¶
| 欄位 | 必填 | 格式 | 說明/預設 |
|---|---|---|---|
| 單號 | 是 | 文字,最長 20 碼 | 訊息的主鍵識別碼。畫面上以紅色標示為重點欄位。新增時為空,需自行輸入;存檔後即為該筆資料的鍵值。 |
| 日期 | 否 | yyyy/MM/dd(ShortDate) |
訊息日期,使用日期輸入框(可挑選)。程式未設定預設值,新增時為空白。 |
| 訊息名稱 | 否 | 文字,最長 30 字 | 這段訊息的標題/代號。 |
| 訊息資料 | 否 | 多行文字,最長 999 字 | 訊息內文,可換行、可貼上多行。右側有垂直捲軸。 |
畫面外的欄位
資料表另含 建檔日期、聯絡單id、工作流程、審核人員、審核日期、已審核 等欄位(程式內部 增刪修 預設為 A=新增)。這些欄位不在本表單畫面上,由資料表或關聯的聯絡單流程處理,維護訊息時無需理會。
欄位連動與附加功能¶
這支表單是最單純的單一主檔維護程式:ViewModel(_infodbViewModel)只註冊了一個主資料來源 DataManager<Twork_sys_vw_infodbSource>,沒有自訂的預設值設定(SetNewData)、金額/數量重算(Calculate)、欄位輸入連動(HandleDataBeforeEndEdit)、ExtensionFunction、報表(GetReports)、簽核或附件等加值邏輯。因此頁面上各欄位之間彼此獨立、不互相連動*,輸入任一欄不會自動帶值或重算其他欄。
實際可用的行為來自共用的 ERP 程式骨架(ERPProgramViewModel + ItemsBindingManager):
- 當你按
新增:系統清出一張空白表單,內部把這筆資料標記為新增(增刪修 = A),游標可開始輸入單號。畫面不會自動帶入日期或任何預設值——四個欄位都從空白開始,需自行填寫。 - 當你在
單號欄輸入並切換焦點:單號欄為主鍵輸入框(TsPrimaryKeyTextBox),系統以此值作為該筆資料的鍵值。輸入超過 20 碼會被限制(欄位長度上限 20)。 - 當你輸入
日期:日期框以ShortDate遮罩驗證,需符合日期格式才會被接受,格式錯誤會以紅框提示。 - 當你輸入
訊息名稱/訊息資料:兩欄皆為純文字輸入,分別受 30 字、999 字長度上限約束;訊息資料為多行框,支援換行與捲動。輸入內容不會觸發任何其他欄位變動。 - 當你按
儲存:系統把目前這筆主檔資料(單號/日期/訊息名稱/訊息資料)上傳寫回伺服器資料表。若主鍵單號為空或重複,存檔會被擋下。 - 當你按
刪除:將目前顯示的這筆訊息標記刪除並寫回伺服器。 - 當你按
查詢或導覽按鈕:透過共用導覽機制(DataNavigate)讀取既有訊息資料逐筆顯示,瀏覽時欄位呈唯讀檢視狀態,按修改後才可編輯。
目前版本未提供的功能
本表單目前沒有列印頁、Excel 匯入/匯出、複製新增、簽核工作流程或開啟其他視窗的附加按鈕——程式碼中均無對應實作。若日後新增,會反映在此節與工具列上。
常見問題¶
存檔時提示單號不可為空 / 重複?
單號 是這筆訊息的主鍵,必填且不可與既有資料重複。請確認已輸入單號,且該單號尚未被其他訊息使用。若要沿用相近內容,建議改用新的單號 新增 一筆。
新增後日期欄是空的,是不是壞了?
不是。本表單程式碼沒有設定日期預設值,新增時四個欄位都從空白開始,日期需自行輸入或挑選。這是設計如此,並非異常。
畫面上怎麼沒有審核 / 工作流程 / 聯絡單相關欄位?
這些欄位(建檔日期、聯絡單id、工作流程、審核人員、審核日期、已審核)存在於後端資料表,但刻意不放在本表單畫面上,由資料表或聯絡單流程處理。維護訊息文字時只需填寫單號、日期、訊息名稱、訊息資料四欄即可。
訊息資料貼了很長的內容存不進去?
訊息資料 欄上限為 999 字。若內容超過此長度會被截斷或無法存入,請精簡內容或拆成多筆訊息。
改了單號之後,原本引用這段訊息的地方對不到了?
因為單號是主鍵(識別碼)。直接改單號等於換了一個鍵值。若有其他流程(如聯絡單)以舊單號引用此訊息,改名後會找不到。建議改以新單號 新增 一筆、再刪除舊筆。
相關功能¶
需補截圖清單
以下截圖待 runtime 驗收後補拍(放 docs/A-System/images/):
_infodb-step1.png— 新增訊息資料的空白表單(單號/日期/訊息名稱/訊息資料四欄)