程式資訊

程式 ID：CULBL
所屬子系統：H.庫存管理
狀態：stable

客戶標籤檔¶

功能簡介¶

「客戶標籤檔」是一張單檔主檔（只有抬頭、沒有明細），用來登錄某一客戶的寄送／包裝標籤所需資料——客戶代號、客戶名稱、公司地點、公司電話，以及這批貨的件數與重量，再加上要印在標籤上的備註與頁尾備註。出貨／包裝人員填好後，搭配標籤報表列印出黏貼在箱外的客戶標籤。

它的內容大多由客戶主檔（CUDATA）帶出，因此只要先維護好客戶基本資料，建立一張標籤通常只要輸入客戶代號就能自動帶齊抬頭，再補上件數、重量即可。

本頁程式碼位置

本功能的選單分類為 H-130，但程式實際歸在銷售訂單模組（TsERP/E.Order/Culbl.xaml、ViewModel/E.Order/CulblViewModel.cs），與客戶主檔同源，屬正常配置。

前置需求¶

權限：H-130 客戶標籤檔 的瀏覽／修改權限。
基礎資料：抬頭欄位的自動帶值取決於下列主檔的維護狀況——

資料	影響的結果
客戶主檔（CUDATA）	輸入客戶代號後自動帶出客戶名稱／公司地點／公司電話；查無代號會擋下並提示
單據編號設定（`_sheetno`，單據別 CULBL）	單號自動產生（編碼方式 0、流水號長度 3）

操作步驟¶

新增一張客戶標籤¶

從主選單開啟 客戶標籤檔。
點選工具列的 新增。單號會在存檔時依單據編號設定自動產生，無需手動輸入。
輸入日期（必填，格式 yyyy/MM/dd）。
在 客戶代號 欄輸入或查詢客戶。離開欄位後，系統自動帶出 客戶名稱／公司地點／公司電話（詳見欄位連動與附加功能）。
視需要修改帶出的 客戶名稱／公司地點／公司電話（可覆寫，存的是標籤上要印的內容）。
輸入件數、重量，以及備註、頁尾備註。
點選 儲存。

小技巧

可用 Ctrl+S 快速儲存。

新增客戶標籤

修改／刪除¶

用工具列的查詢或上一筆／下一筆功能找到要處理的標籤。
修改：點 修改，調整欄位後 儲存。
刪除：確認是正確的標籤後點 刪除。

列印標籤¶

規劃中：標籤列印尚未提供

VFP 舊版以報表 CULBL_P(SCX_ORDP) 列印客戶標籤，新版 C# 目前尚未移植此報表（程式內已標記為 TODO）。在報表移植完成前，請以舊系統列印標籤；本頁的列印步驟待功能提供後補述。

欄位說明¶

欄位	必填	說明／格式／預設
單號	自動	存檔時依單據編號設定（單據別 CULBL）自動產生，唯讀，不可手改
日期	是	格式 `yyyy/MM/dd`；新增時不帶預設值，需自行輸入，空白會被擋存
客戶代號	—	輸入後離開欄位自動帶出客戶名稱／公司地點／公司電話；支援查詢按鈕
客戶名稱	—	預設由客戶代號帶出，最長 80 字，可覆寫
公司地點	—	預設由客戶代號帶出，可覆寫
公司電話	—	預設由客戶代號帶出，最長 18 字，可覆寫
備註	—	標籤備註，最長 40 字
件數	—	整數（VFP InputMask `9999`），預設顯示 0
重量	—	數值，整數 6 位、小數 2 位（VFP InputMask `9,999.99`）
頁尾備註	—	多行文字（可換行），最長 80 字

沒有審核與工作流程欄位

客戶標籤檔是純登錄用的單檔主檔，不掛集中式審核／工作流程，存檔後即生效，無需簽核。

欄位連動與附加功能¶

這一節整理「輸入某欄位或按某動作後，系統會做什麼」，全部依實際程式碼整理。

輸入「客戶代號」→ 自動帶出客戶抬頭¶

當你在 客戶代號 欄輸入代號並離開該欄位（對應 VFP 的 客戶代號.LostFocus、新版的 客戶代號Binding → SetCustomerData()），系統會：

以你輸入的代號去查客戶主檔 cudata（透過 DARB_GETDATA4，撈客戶代號／客戶名稱／公司地點／公司電話）。
查得到 → 自動把 客戶名稱、公司地點、公司電話 三欄填入。
查不到 → 跳出提示「查無客戶代號 !!!」，三欄維持原狀。

帶出後仍可改

帶出的客戶名稱／地點／電話只是「初值」，你可以直接覆寫——存檔存的是標籤上實際要印的內容，因此同一客戶可依不同收件需求調整地址或電話。

空白代號不查詢

若客戶代號留空，系統不會去查 cudata，也不會清掉已填的抬頭欄位。

存檔檢核：日期不可空白¶

按 儲存 時（對應 VFP 的 allowsave、新版的 CulblSave.AllowSave），系統會檢查日期是否已填。若日期空白，存檔被擋下並提示「請輸入[日期]」（VFP 舊版提示文字為「請先輸入日期 !!!」）。這是本單據唯一的必填檢核。

新增時不帶預設值¶

VFP 舊版的新增動作（addclick/addagain）沒有設定任何欄位預設值，新版沿用相同行為：

日期新增時是空白的，需自行輸入（並由上述存檔檢核強制把關），不會自動帶今天。
件數／重量為數值欄，顯示為 0。

尚未提供／不移植的桌面整合¶

公司地點開地圖、公司電話撥號：不移植

VFP 舊版可在 公司地點 上雙擊開啟地圖（U_IELINK MAP）、在 公司電話 上雙擊以 Skype 撥號（U_IELINK SKYPEOUT）。這兩個桌面整合功能屬舊系統特性，新版刻意不移植，請勿預期可用。

標籤列印（報表）：規劃中

列印用的報表 CULBL_P(SCX_ORDP) 尚未移植，詳見列印標籤。

常見問題¶

按儲存時提示「請輸入[日期]」？

日期是本單據唯一的必填欄，而且新增時不會自動帶今天。請在日期欄輸入有效日期（格式 yyyy/MM/dd）後再存檔。

輸入客戶代號後，客戶名稱／公司地點／公司電話沒有自動帶出？

自動帶值來自客戶主檔 cudata。請確認：

你輸入的客戶代號確實存在於客戶主檔——若跳出「查無客戶代號 !!!」表示查無此代號。
已離開客戶代號欄位（帶值是在離開欄位時觸發的）。
代號未留空白（空白不會觸發查詢）。

自動帶出的地址／電話不是我要的，可以改嗎？

可以。帶出的客戶名稱／公司地點／公司電話都是可覆寫的初值，直接在欄位修改即可，存檔會存你改後的內容。

想列印客戶標籤，找不到列印按鈕？

標籤列印報表 CULBL_P 在新版尚未移植（規劃中）。在功能提供前，請以舊系統列印標籤。

件數／重量顯示 0 正常嗎？

正常。這兩個是數值欄，新增時沒有預設值、顯示為 0，請依實際包裝數量與重量輸入。