跳轉到

程式資訊

  • 程式 ID_INFODB
  • 所屬子系統:A.系統資料
  • 狀態:stable

訊息資料表

功能簡介

「訊息資料表」(_INFODB,A-030)是系統內維護訊息文字內容的設定主檔。每一筆訊息由一個單號識別,內含一段訊息名稱(標題)與一段較長的訊息資料(內文)。它對應後端的 twork_sys_vw_infodb View,是系統管理者用來集中保管制式訊息/公告文字的地方,供其他流程(例如聯絡單)引用。

這支表單屬於最單純的「單一主檔」型態:一張表單一筆資料、沒有明細子表、沒有金額計算,只負責建立/維護一段文字內容並存檔。通常由系統管理員或具修改權限的人員維護。

資料表用途說明

此表的資料來源 View 內含 聯絡單id工作流程審核人員已審核 等欄位,與「聯絡單」訊息流程相關;但在本表單畫面上只開放維護單號、日期、訊息名稱、訊息資料四個欄位,其餘欄位由資料表本身或關聯流程帶入,畫面上看不到,也不需在此手動填寫。

前置需求

  • 權限:A.系統設定 → A-030 訊息資料表 的瀏覽/修改權限(見 frontmatter 的 permissions)。沒有修改權限時只能查詢、不能存檔。
  • 基礎資料:本表單為純文字主檔,不依賴其他主檔即可建立資料。下表說明它與系統其他部分的關係:
資料 影響的結果
本表單建立的訊息(單號+訊息名稱+訊息資料) 提供制式訊息文字供其他流程引用
聯絡單流程 透過 聯絡單id 與本資料表關聯(由流程帶入,非本表單手動維護)

操作步驟

新增一筆訊息

  1. 從主選單開啟 A.系統設定 → 訊息資料表(A-030)
  2. 點選工具列的 新增,畫面清空成一張空白表單。
  3. 單號 欄輸入此筆訊息的識別碼(最長 20 碼,為主鍵,存檔後不建議再改)。
  4. 日期 欄選擇或輸入日期(格式 yyyy/MM/dd,可用日期挑選器)。
  5. 訊息名稱 欄輸入這段訊息的標題(最長 30 字)。
  6. 訊息資料 欄輸入訊息內文。此欄位是多行文字框、可換行(最長 999 字),右側有捲軸。

    小技巧

    訊息資料欄支援 Enter 換行,可貼上多行文字。輸入較長內容時用右側捲軸瀏覽。

  7. 點選 儲存。系統會把這筆資料寫回伺服器。

新增訊息資料

修改既有訊息

  1. 用工具列的 查詢(或上一筆/下一筆導覽)找到要修改的單號。
  2. 直接在欄位上修改 日期訊息名稱訊息資料
  3. 點選 儲存 覆蓋原內容。

    注意

    單號 是主鍵,是這筆資料的識別碼。如需更換單號,建議改以新單號 新增 一筆,再刪除舊資料,避免引用該訊息的其他流程對不到。

刪除訊息

  1. 查詢並切換到要刪除的單號。
  2. 點選工具列的 刪除,確認後該筆訊息即從資料表移除。

查詢/瀏覽

  • 點選 查詢 帶出查詢條件,依單號等條件找出資料。
  • 用工具列的導覽按鈕(第一筆/上一筆/下一筆/最後一筆)逐筆切換瀏覽既有訊息。

欄位說明

欄位 必填 格式 說明/預設
單號 文字,最長 20 碼 訊息的主鍵識別碼。畫面上以紅色標示為重點欄位。新增時為空,需自行輸入;存檔後即為該筆資料的鍵值。
日期 yyyy/MM/dd(ShortDate) 訊息日期,使用日期輸入框(可挑選)。程式未設定預設值,新增時為空白。
訊息名稱 文字,最長 30 字 這段訊息的標題/代號。
訊息資料 多行文字,最長 999 字 訊息內文,可換行、可貼上多行。右側有垂直捲軸。

畫面外的欄位

資料表另含 建檔日期聯絡單id工作流程審核人員審核日期已審核 等欄位(程式內部 增刪修 預設為 A=新增)。這些欄位不在本表單畫面上,由資料表或關聯的聯絡單流程處理,維護訊息時無需理會。

欄位連動與附加功能

這支表單是最單純的單一主檔維護程式:ViewModel(_infodbViewModel)只註冊了一個主資料來源 DataManager<Twork_sys_vw_infodbSource>沒有自訂的預設值設定(SetNewData)、金額/數量重算(Calculate)、欄位輸入連動(HandleDataBeforeEndEdit)、ExtensionFunction、報表(GetReports)、簽核或附件等加值邏輯。因此頁面上各欄位之間彼此獨立、不互相連動*,輸入任一欄不會自動帶值或重算其他欄。

實際可用的行為來自共用的 ERP 程式骨架(ERPProgramViewModelItemsBindingManager):

  • 當你按 新增:系統清出一張空白表單,內部把這筆資料標記為新增(增刪修 = A),游標可開始輸入單號。畫面不會自動帶入日期或任何預設值——四個欄位都從空白開始,需自行填寫。
  • 當你在 單號 欄輸入並切換焦點:單號欄為主鍵輸入框(TsPrimaryKeyTextBox),系統以此值作為該筆資料的鍵值。輸入超過 20 碼會被限制(欄位長度上限 20)。
  • 當你輸入 日期:日期框以 ShortDate 遮罩驗證,需符合日期格式才會被接受,格式錯誤會以紅框提示。
  • 當你輸入 訊息名稱 / 訊息資料:兩欄皆為純文字輸入,分別受 30 字、999 字長度上限約束;訊息資料為多行框,支援換行與捲動。輸入內容不會觸發任何其他欄位變動。
  • 當你按 儲存:系統把目前這筆主檔資料(單號/日期/訊息名稱/訊息資料)上傳寫回伺服器資料表。若主鍵單號為空或重複,存檔會被擋下。
  • 當你按 刪除:將目前顯示的這筆訊息標記刪除並寫回伺服器。
  • 當你按 查詢 或導覽按鈕:透過共用導覽機制(DataNavigate)讀取既有訊息資料逐筆顯示,瀏覽時欄位呈唯讀檢視狀態,按 修改 後才可編輯。

目前版本未提供的功能

本表單目前沒有列印頁、Excel 匯入/匯出、複製新增、簽核工作流程或開啟其他視窗的附加按鈕——程式碼中均無對應實作。若日後新增,會反映在此節與工具列上。

常見問題

存檔時提示單號不可為空 / 重複?

單號 是這筆訊息的主鍵,必填且不可與既有資料重複。請確認已輸入單號,且該單號尚未被其他訊息使用。若要沿用相近內容,建議改用新的單號 新增 一筆。

新增後日期欄是空的,是不是壞了?

不是。本表單程式碼沒有設定日期預設值,新增時四個欄位都從空白開始,日期需自行輸入或挑選。這是設計如此,並非異常。

畫面上怎麼沒有審核 / 工作流程 / 聯絡單相關欄位?

這些欄位(建檔日期、聯絡單id、工作流程、審核人員、審核日期、已審核)存在於後端資料表,但刻意不放在本表單畫面上,由資料表或聯絡單流程處理。維護訊息文字時只需填寫單號、日期、訊息名稱、訊息資料四欄即可。

訊息資料貼了很長的內容存不進去?

訊息資料 欄上限為 999 字。若內容超過此長度會被截斷或無法存入,請精簡內容或拆成多筆訊息。

改了單號之後,原本引用這段訊息的地方對不到了?

因為單號是主鍵(識別碼)。直接改單號等於換了一個鍵值。若有其他流程(如聯絡單)以舊單號引用此訊息,改名後會找不到。建議改以新單號 新增 一筆、再刪除舊筆。

相關功能


需補截圖清單

以下截圖待 runtime 驗收後補拍(放 docs/A-System/images/):

  1. _infodb-step1.png — 新增訊息資料的空白表單(單號/日期/訊息名稱/訊息資料四欄)