程式資訊
- 程式 ID:
COMMPRNOTE - 所屬子系統:L.聯絡傳訊
- 狀態:stable
聯絡單便條¶
功能簡介¶
「聯絡單便條」是聯絡單(COMMPR)背後的便條/註記主檔(資料表 commpr_note)。一張便條代表一筆掛在某張單據上的內部聯絡記事——記錄主旨、內容、製表人、追蹤對象與關聯來源單據,是 ERP 各單據「發聯絡單/加註記」時實際寫入的那筆資料。
本表單與聯絡單共用同一張資料表,但定位不同:
- 聯絡單(COMMPR)是完整的查詢/簽核入口,含明細(待通知部門、附件)與工作流程簽核區。
- 聯絡單便條(COMMPRNOTE) 是這張便條本身的單筆主檔編輯畫面,欄位較精簡,供維護便條的基本內容與其指向的來源單據。
本表單為共用程式,非主選單功能
COMMPRNOTE 沒有獨立的主選單入口,也不在程式對照表(program map)中。它由其他單據在「加註記/發聯絡單」時帶出,ProgramClass/其他單據id/關聯資料表等欄位即用來標記「這張便條是哪一支程式、哪一筆單據產生的」。要綜覽與簽核所有便條,請改用聯絡單。
前置需求¶
- 權限:L.聯絡傳訊 → 聯絡單相關的
瀏覽/修改權限(與聯絡單L-010同一群組)。 - 前置資料:本便條的關聯欄位需對應到既有單據才有意義——
| 資料 | 影響什麼 |
|---|---|
| 來源單據(如預示單、進貨單、收款單…) | 其他單據id、單據別(ProgramClass)必須指向實際存在的單據,便條才能被該單據連回 |
| 使用者/員工主檔 | 製表人、追蹤人 的代號需為有效員工 |
| 客戶/廠商/部門主檔 | 客戶廠商部門代號 用來標記便條對象 |
| 工作流程樣板 | 若便條要走簽核,需有對應的流程樣板號(此表單畫面未提供樣板選取,見欄位連動與附加功能) |
操作步驟¶
本表單採標準單筆主檔維護模式,沿用系統共用工具列(新增/修改/刪除/查詢/儲存),畫面僅有一個編輯區、無明細格線。
新增便條¶
- 開啟聯絡單便條畫面。
- 點工具列
新增,畫面進入新增狀態,各欄位帶入空白預設值(見欄位說明)。 - 填寫 主旨(
Notes Subject,上限 120 字)與 內容(Notes Content)。 - 視需要填入 聯絡單號、建檔日期、製表人、以及關聯來源資訊(關聯資料表、其他單據id)。
-
點
儲存。新增成功後系統會配發本筆記錄的內部管制碼(系統主鍵),並回到瀏覽狀態。commprpkid 不會自動帶值
畫面上的 commprpkid 欄是唯讀的「父聯絡單主鍵」標記欄,由產生本便條的來源流程寫入,並不會在你按儲存後由系統自動回填。在這個單筆編輯畫面新增時它通常維持原值(多為 0)。
修改便條¶
- 用
查詢帶出要編輯的便條。 - 點
修改,調整 主旨/內容/追蹤日期/追蹤人 等欄位。 - 點
儲存。
刪除便條¶
- 帶出目標便條後點
刪除。 -
確認後送出。
注意
便條常被其他單據以 其他單據id 連回(例如預示單→聯絡單)。刪除便條僅移除這筆
commpr_note記錄,不會回頭清掉來源單據上的連結欄位;若來源單據仍指向已刪便條,從該單據點開時會找不到對應便條。建議改由聯絡單端的結案/取消流程處理,而非直接刪除。
欄位說明¶
下表依畫面由上而下、左右兩欄列出。各欄預設值來自 Commpr_noteModel 建構式——所有文字欄預設為空字串,數值欄(其他單據id、commprpkid)預設 0。
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| 聯絡單號(Notes No) | — | 便條單號,最長 20 碼;預設空白 |
| 建檔日期(Notes Created Date) | — | 短日期格式,預設空白 |
| 製表人員(Notes Owner) | — | 製表員工代號,最長 10 碼;預設空白 |
| 關聯資料表(Associate Table) | — | 此便條關聯的來源資料表名,最長 20 碼;標記便條來源 |
| 其他單據id(Other Doc ID) | — | 來源單據的主鍵(整數),預設 0;與 單據別 一起把便條連回原單據 |
| 客戶廠商部門代號(Cust Vend Dept Code) | — | 便條對象(客戶/廠商/部門)代號 |
| 追蹤日期(Follow By Date) | — | 短日期格式,記錄此便條的追蹤期限 |
| 追蹤人(Follow By Name) | — | 追蹤負責人 |
| 參考碼(Reference Code) | — | 自由參考碼 |
| 參考單號(Reference No) | — | 自由參考單號 |
| 表參考單號(Table Reference No) | — | 關聯資料表上的參考單號 |
| commprpkid | — | 父聯絡單主鍵標記,唯讀;由來源流程寫入,本畫面不會自動回填 |
| 結案(Is Closed) | — | 結案旗標(單一字元);預設空白 |
| 主旨(Notes Subject) | 建議 | 便條主旨,上限 120 字 |
| 內容(Notes Content) | 建議 | 便條內容;此畫面輸入框 MaxLength 設為 60,資料表欄位本身較長 |
畫面欄位標籤目前為英文
本表單的 XAML 標籤是直接寫死的英文字串(Notes No:、Notes Owner: 等),尚未做多語系,因此實際畫面顯示的就是英文。上表的中文名部分取自系統欄位對照(Common/Lang/Xaml/Commpr.json,例如 NotesNo→聯絡單號、NotesOwner→製表人員),其餘較少用的欄位(如關聯資料表、追蹤日期等)為依用途對應的中文說明。
欄位連動與附加功能¶
本節最重要——請完整閱讀
聯絡單便條目前是精簡的單筆主檔編輯程式,沒有自訂的欄位重算、帶值或彈窗。以下逐條說明此表單「實際會發生什麼」,以及哪些便條相關能力不在本畫面、需到聯絡單操作。
此表單實際會做的事¶
本表單是用系統標準維護機制(ItemsBindingManager + 標準 SaveBll)綁定的單筆主檔,沒有任何自訂的儲存檢核、帶值或重算。因此它的行為就是平台預設行為:
- 存檔時不做必填檢核:標準儲存流程的
AllowSave直接放行(無自訂驗證),不會擋空白主旨或內容。唯一會擋下的是欄位本身的格式/長度限制(綁定設了ValidatesOnExceptions,例如超過長度上限)。主旨/內容留空仍存得進去——是否填寫由使用者自律。 - commprpkid 永遠唯讀:此欄在畫面上設為唯讀(
IsReadOnly),不可手動輸入,也不會在存檔後自動帶值。 - 取消編輯會釋放單號占用:按工具列取消(放棄編輯)時,標準流程會呼叫
DeletePassNumber()釋放本次取得的流水號占用,回到一般瀏覽狀態。 - 關聯欄位是「標記」而非「連動查詢」:關聯資料表、其他單據id、單據別(ProgramClass)三者共同描述「這張便條屬於哪一支程式的哪一筆單據」。在此畫面輸入它們不會自動去查來源單據帶值,畫面上也沒有任何欄位連動或開窗;真正用到它們的是反向流程——來源單據(如聯絡單切換記錄時)以 單據別 + 其他單據id 去資料庫撈回對應便條與其簽核步驟。
不在本畫面、需到聯絡單(COMMPR)操作的能力¶
下列欄位雖然存在於 commpr_note 資料表(會簽、待通知部門、傳真、處理狀態等),但本「聯絡單便條」畫面並未提供對應的輸入或按鈕。要使用這些便條相關功能,請改用聯絡單:
-
工作流程簽核:便條的審核(會簽、退件、流程步驟)由聯絡單的工作流程區處理;切換到某筆便條時,系統會以 單據別 + 其他單據id 撈出該便條的主檔、附件與簽核步驟。本便條表單上的 流程樣板號 欄位(資料表有、但畫面未放輸入)即對應簽核流程,需到聯絡單端設定。
規劃中/本畫面尚未提供
會簽(Cosign)、待通知部門(DeptToInform)、是否須傳真/是否已傳真(IsFaxRequired/IsFaxed)、是否已處理/處理人(IsProcessed/Processer)、取消意見(CommentOnCancel)等欄位在資料表中存在,但此聯絡單便條畫面未提供對應的編輯介面。請勿期待在本表單上做簽核或傳真;相關操作請見聯絡單。
-
附件:便條附件由聯絡單/附件視窗管理,本畫面不提供上傳。
- 列印:此表單未掛報表來源,無獨立列印功能。需要便條相關報表時,請至聯絡單或對應來源單據。
常見問題¶
主旨/內容沒填也能存檔,是不是有問題?
不是 bug。本表單用系統標準維護機制綁定,未加任何必填檢核(標準 AllowSave 直接放行),主旨與內容留空仍會寫入。請依公司規範自行填妥主旨與內容後再存。
commprpkid 一直是 0/空白,要怎麼填?
commprpkid 是「父聯絡單主鍵」標記欄,畫面上唯讀、不可手動輸入,也不會在你按儲存後自動帶值。它的值是由產生這張便條的來源流程寫入的。在此單筆編輯畫面新增便條時它通常維持原值,這是正常現象,不代表存檔失敗。
從原單據(如預示單)點開便條卻找不到資料?
便條是用 單據別(ProgramClass)+ 其他單據id 連回來源單據的。若這兩個欄位沒對到正確的程式名與單據主鍵,來源單據就撈不到便條。請確認便條上的 其他單據id 等於來源單據的主鍵、單據別 等於該程式代碼。便條若已被刪除,連結也會落空。
在這個畫面要怎麼做簽核(會簽、退件)?
本「聯絡單便條」畫面沒有簽核介面。便條的工作流程簽核、會簽、待通知部門都在聯絡單(COMMPR)處理,請改由該功能進入。
畫面欄位怎麼都是英文(Notes No、Notes Owner…)?
本表單尚未中文化,畫面標籤目前是英文。各欄真正的中文意義請對照欄位說明。
相關功能¶
- 聯絡單:便條的完整查詢/簽核入口,含附件與工作流程
- 事件範本(舊版):排程事件範本維護
- 事件專案
- 程式類別:單據別(ProgramClass)對照
- L 聯絡傳訊模組首頁
需補截圖清單
以下截圖待功能 runtime 驗收後補拍(放 docs/L-Communication/images/):
commprnote-step1.png— 新增便條的編輯畫面(主旨/內容區)commprnote-step2.png— 關聯欄位區(關聯資料表/其他單據id/唯讀的 commprpkid 欄)