程式資訊

程式 ID：SALESDASH
所屬子系統：E.營業收款
狀態：stable

業務儀表板（含業務課報告表產生）¶

功能簡介¶

業務儀表板一頁做三件事：

看本月銷售：4 張 KPI 卡（銷售金額、出貨數量、LOT 數、交易客戶數）＋整年各月銷售長條圖＋本月客戶 Top 15。
產生業務課報告表：按一下把整年銷售資料與汽機車市場統計彙整成 Excel 月報，省去逐頁手工查貼。
顧外部資料：顯示汽機車市場統計等外部來源的最近一次擷取結果，必要時可立即重抓。

主要使用者為業務助理與業務主管。儀表板與報告表資料同源，不會出現兩份數字打架。

銷售數字以出貨單為準

2026-08-06 起，本頁與報告表的銷售金額一律取自出貨單（依交易日期分月、金額為本幣未稅），出貨退回以負數計入，合計即淨銷售額——不是訂單金額。2026-08-27 起畫面上殘留的「訂單」字樣（KPI 卡、趨勢圖）一併改為「銷售」，口徑本身沒有變動。

汽機車市場統計（TTVMA）改讀資料庫

2026-08-27 起，報告表要用的汽機車市場統計直接從資料庫取（twork_auto_ttvma），不再於產生報告表時另外連一次公會網站下載、另外解析一次。因此：產生變快、不會再出現「儀表板抓到了、月報卻說沒有」的落差，且沒有網路也產得出來（只要資料先前已由擷取排程入庫）。資料怎麼進資料庫見外部資料擷取。

前置需求¶

權限：E 營業收款 → 業務儀表板 的瀏覽權限。
輸出資料夾：預設 C:\temps\業務課報告表，需該台電腦有寫入權限（不存在會自動建立）。
外部資料存放位置：預設 C:\dglibrary\ExternalData。
對外連線：只有按 立即擷取 去抓外部資料時才需要；產生報告表本身不連外網。
基礎資料：出貨單（含交易日期、客戶、品號、數量、金額）。
外部資料已入庫：報告表的市場統計來自資料庫，需先由外部資料擷取（畫面或排程）把公會統計寫進 twork_auto_ttvma，且該環境已跑過 sql/extdata-table-deploy-20260827.sql 與 sql/extdata-procparam-log-20260827.sql。

畫面區塊¶

區塊	位置	內容
工具列	最上方	`報告月份` 日期欄、`重新整理` 按鈕；右側顯示最後更新時間
KPI 卡列	工具列下方	4 張卡：本月銷售金額／本月出貨數量／本月 LOT 數／本月交易客戶數
各月銷售金額	中段左（較寬）	報告月份所屬年度 1～12 月的銷售金額長條圖
本月客戶 Top 15	中段右	該月銷售金額前 15 名客戶清單
業務課報告表產生	下段	範本路徑、輸出資料夾、含市場資料勾選、`產生報告表`／`開啟輸出`、結果與警告訊息
外部資料擷取	最下方	最近一次擷取的摘要與各來源明細，可勾選來源、`立即擷取`、`開啟資料夾`

操作步驟¶

步驟① 開啟並選定報告月份¶

主選單進入 E 營業收款 → 業務儀表板。
工具列的 報告月份 預設為今天；它同時決定三件事——KPI 卡看哪一個月、客戶 Top 15 看哪一個月、以及按 產生報告表 要產出哪一個年月。
改好日期後按 重新整理（或工具列的查詢）重新取數。

編上個月的月報就把日期改成上個月的任一天

月份只看年與月，日不影響結果。

步驟② 掃本月數字¶

KPI 卡：本月銷售金額（副標顯示是哪一年哪一月）、本月出貨數量、本月 LOT 數、本月交易客戶數。
各月銷售金額：整年逐月長條，看得出這個月在全年中的位置。
本月客戶 Top 15：依銷售金額由高到低，含數量與 LOT 數。

步驟③ 產生業務課報告表¶

確認範本與輸出兩個路徑（預設值見欄位說明，可直接在欄位內修改）。
決定是否勾選 含 TTVMA 市場資料（每月 10~18 日後才有上月數據）：
- 勾選（預設）：一併帶出汽機車市場統計（自資料庫讀取，不連外網）。
- 不勾：只出自家銷售數字。
按 產生報告表。畫面出現進度條與「產生中…」，產生期間按鈕會鎖住避免重複觸發。

市場資料的月份是這樣挑的

取資料庫裡不晚於報告月份的最新一個資料月份。當期尚未公布時會自動退到前一期，並在警告清單留下一行（例：「TTVMA 汽車：2026-08 尚未公布，改用最近一期 2026-07」）。資料庫裡完全查不到、或資料庫端尚未部署時，也各有一行對應的警告，自家銷售數字照樣產完。

完成後：
- 成功——訊息以綠字顯示產出路徑，檔案自動開啟；也可按 開啟輸出 在檔案總管中選取該檔。
- 失敗——訊息以紅字顯示原因。
- 不論成敗，過程中的提醒會逐條列在下方（⚠ 開頭），例如市場統計當期尚未公布。

目前產出的是「檢核模式」原始資料檔

自 2026-08-05 起，產生報告表 暫時不填寫 Excel 範本，改產一份全新的原始資料檔 C:\temps\業務課報告表\<年>-<月>業務課報告表-原始資料.xlsx，各分頁直接呈現系統抓到的資料供人工核對（分頁清單見下）。範本模式並未移除，資料檢核確認無誤後會恢復；需要提前切回範本輸出請洽開發窗口。

原始資料檔的分頁：出貨明細（整年逐筆）、月份彙總（全客戶每月合計）、客戶月彙總（每客戶 × 月的 PCS／LOT／金額）、汽車TTVMA原始／機車TTVMA原始（公會月報版面，見下）、汽車解析結果／機車解析當月／機車解析累計（各廠內外銷台數）、警告。

「汽車TTVMA原始／機車TTVMA原始」兩頁改由資料庫重建（2026-08-27）

以前這兩頁是把下載的公會 xls 整張原樣貼上；現在改由資料庫的統計資料重新排出同一個版面（標題、直排的內銷／外銷／總計標籤、廠牌兩列表頭、合計欄、％欄與 % 列、表尾備註都在）。數字經真檔逐格比對完全相同，可以照舊拿來核對。三處刻意的差異：

百分比一律重新計算（顯示兩位小數），不繼承公會原檔的公式——原檔偶爾會出現 #DIV/0!，重建版會算成 0。
公會逐月手打的臨時附註不會出現（例：「*三陽工業產銷統計資料彙整中」）。那是人工加在 xls 上的一行字，沒有進資料庫；要看原文請開落地的原始檔（路徑見外部資料擷取）。
直排標籤的字數與位置略有出入（原檔「去年同期銷售」6 字，重建為「去年同期」置中）、欄寬非逐欄照抄。

步驟④ 核對產出¶

打開檔案後建議先對三處：

月份彙總該月的金額，與儀表板 KPI 卡的本月銷售金額是否一致。
客戶月彙總前幾大客戶的金額，與客戶 Top 15 是否一致。
汽車／機車解析結果是否為預期的資料月份（市場統計未公布時可能退回較舊的月份，警告訊息會註明）。

步驟⑤ 顧外部資料¶

畫面最下方的「外部資料擷取」讀的是最近一次實際擷取的紀錄——不論那次是排程跑的還是有人在這裡按的，看到的都是同一份。

顯示來源：勾選你關心的來源（勾選會記住，下次開窗沿用）。只有勾選的來源會顯示，也只有勾選的來源會被 立即擷取 抓。
強制重抓（本期已有也重新下載）：預設不勾；不勾時本期已抓過的來源會直接標記為「本期已有」略過。
按 立即擷取 手動抓一輪——期別跟著上方的報告月份。每個檔約 2~5 MB，抓取期間按鈕鎖住。抓完會一併寫進資料庫，摘要文字附上入庫筆數（例：「TTVMA_QTA1 入庫 234 筆（新增 234／更新 0）」）；本期已有而被跳過的來源也會補入庫。
抓完清單自動更新：狀態欄綠字為正常、紅字要人看一眼；把滑鼠停在「訊息」欄可看到該檔的存檔路徑。入庫失敗會直接寫在摘要裡（例：「入庫失敗：取不到資料庫連線」），不會靜默略過。
按 開啟資料夾 在檔案總管中開啟存放位置（若清單中有實際存在的檔案，會直接選取該檔）。

與排程共用同一份紀錄

背景排程的外部資料擷取作業寫的是同一個紀錄檔，所以這一區永遠反映最近一次實際擷取結果。若顯示「尚無擷取紀錄」，表示這台電腦的存放位置底下還沒有任何擷取紀錄——按 立即擷取 或請管理員掛排程。

步驟⑥ 不想每月手動按¶

業務課報告表可掛進背景排程，每月固定日期自動產出上一個月的報告表（AutoPilot 任務 ORMAST / SalesMonthlyReport，月份參數用 {-d1} 於觸發當下展開成實際年月）。設定方式見排程作業。

欄位說明¶

查詢條件與工具列¶

欄位／按鈕	必填	預設	說明
報告月份	✔	今天	只取年與月：決定 KPI／客戶 Top 15 的月份、報告表的產出年月、外部資料擷取的期別
`重新整理`	—	—	以目前報告月份重新取數
最後更新	—	—	這一頁資料的取數時間

KPI 卡¶

卡片	內容
本月銷售金額	該月出貨金額合計（本幣未稅，退回為負）；副標顯示「<年> 年 <月> 月」
本月出貨數量	該月出貨數量合計
本月 LOT 數	該月 LOT 數合計
本月交易客戶數	該月有出貨往來的客戶家數

本月客戶 Top 15¶

欄位	說明
客戶	客戶名稱（已做名稱正規化，同一客戶的不同寫法會歸為一家）
銷售金額	該月銷售金額（排序依據）
數量	該月出貨數量
LOT	該月 LOT 數

業務課報告表產生¶

欄位／按鈕	預設	說明
範本	`C:\dglibrary\REPORTSROOT\Template\業務課報告表範本.xlsx`	範本模式使用的 Excel 範本；檢核模式不讀此檔。2026-08-27 起範本模式的表頭標題由「(預訂交期)」改為「(交易日期)」，與出貨單口徑一致
輸出	`C:\temps\業務課報告表`	產出檔與市場統計原始檔的存放資料夾
含 TTVMA 市場資料	勾選	是否一併帶出汽機車市場統計（自資料庫讀取，不連外網）
`產生報告表`	—	開始產生；產生中按鈕鎖住
`開啟輸出`	—	產生成功後才出現；在檔案總管中選取最新產出檔
結果訊息	—	成功為綠字、失敗為紅字
警告清單	—	`⚠` 開頭的逐條提醒（例：市場統計當期未公布）

外部資料擷取¶

欄位／按鈕	說明
存放位置	外部資料根目錄，預設 `C:\dglibrary\ExternalData`
顯示來源	勾選要顯示／要擷取的來源；選擇會記住
強制重抓	忽略「本期已有」，重新下載
`立即擷取`	以報告月份為期別，抓取勾選的來源
`開啟資料夾`	開啟存放位置（有實際檔案時直接選取）
來源	來源顯示名稱
狀態	`已擷取`／`本期已有`／`來源無此期`／`失敗`；後兩者為紅字
抓取時間	該來源最近一次抓取的時間
檔案大小／實際格式	下載檔的大小與偵測到的實際格式
訊息	該來源的處理結果；滑鼠停留可看存檔路徑

常見問題¶

KPI 顯示的是訂單還是出貨？

是出貨。2026-08-06 起銷售額改以出貨單為準（依交易日期分月、本幣未稅），出貨退回以負數計入。

產生報告表後打開，怎麼不是原本那份範本的版面？

目前預設為檢核模式，產出的是「原始資料檔」（全新 Excel，各分頁呈現系統抓到的資料），用來核對資料正確性。範本模式未移除，待檢核確認後恢復——詳見上方警告框。

市場資料抓不到、或抓到的是更早的月份？

汽機車市場統計由外部單位每月公布，通常上月數據要到當月 10~18 日以後才有。當期尚未公布時，系統會退用資料庫裡最近的一期並把提醒留在警告清單，自家銷售數字照樣產完。做法：晚幾天再產一次，或先不勾「含 TTVMA 市場資料」出一版。若警告寫的是「公會資料查詢派發失敗」，那是資料庫端尚未部署，請洽 IT（見外部資料擷取的部署說明）。

TTVMA 原始那兩頁，看起來跟公會網站上的表格有一點點不一樣？

2026-08-27 起這兩頁由資料庫重建版面而非原樣貼上。數字完全相同；不同的是百分比由系統重算（原檔算錯的格會變成 0）、公會逐月手打的臨時附註不會出現、直排標籤的字數與欄寬略有出入。要看一模一樣的原檔，開 C:\dglibrary\ExternalData 底下該期的公會 xls。

按了「立即擷取」卻說沒有勾選任何來源？

「顯示來源」的勾選同時決定要抓哪些來源。至少勾一個再按 立即擷取。

同一個月重抓，狀態顯示「本期已有」沒有重新下載？

這是刻意的（每個檔 2~5 MB）。要重新下載請勾 強制重抓（本期已有也重新下載） 再按 立即擷取。

產生一次要多久？

2026-08-27 起市場資料改讀資料庫、不再連外網下載，比以前快。時間主要花在整年出貨明細的取數。產生期間按鈕會鎖住，請勿重複點擊。

報告表可以每月自動產嗎？

可以，掛 AutoPilot 排程任務 ORMAST / SalesMonthlyReport，月份參數填 {-d1} 即為「上一個月」，建議設在每月 18~20 日。設定見排程作業。

客戶名稱怎麼跟單據上的寫法不一樣？

清單與報告表會做客戶名稱正規化，把同一家客戶的不同寫法歸成一個名字，避免同一家被拆成好幾列。原始寫法在原始資料檔的「出貨明細」分頁中保留對照欄。