程式資訊

程式 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。
範本檔（只有選朝陽範本／公版範本才需要）：範本放在該台電腦的範本資料夾——朝陽範本 C:\dglibrary\REPORTSROOT\Template\業務課報告表範本-新版.xlsx、公版範本 C:\dglibrary\REPORTSROOT\Template\業務課報告表範本-公版.xlsx（路徑可在畫面上改）。檢核模式不需要範本。
客戶資料的交易類別（用公版範本時）：公版範本靠客戶資料的 交易類別 分國外向／國內向——D＝國外，其他（含空白）一律算國內。產公版之前請先確認外銷客戶都已設成 D。

畫面區塊¶

區塊	位置	內容
工具列	最上方	`報告月份` 日期欄、`重新整理` 按鈕；右側顯示最後更新時間
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-09-25 起改成產法下拉。以前勾過的使用者，升版後開窗會自動顯示為 朝陽範本；沒勾過的維持 檢核模式。產法與範本路徑的選擇會記在這台電腦，下次開窗沿用。

三種產法怎麼選¶

產法	產出檔	客戶列怎麼來	適用
檢核模式	`<年>-<月>業務課報告表-原始資料.xlsx`（全新 Excel）	不套範本，資料直接倒進各分頁	核對資料、追數字來源
朝陽範本	`<年>-<月>業務課報告表.xlsx`（13 頁）	寫死在範本上，系統逐列比對客戶代號／名稱填值	已自備客戶清單範本的公司（朝陽）
公版範本	`<年>-<月>業務課報告表.xlsx`（13 頁）	系統自動列出當年 1 月到報告月份有出貨的全部客戶	其他客戶；不必維護範本上的客戶清單

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

朝陽範本與公版範本是同一套 13 頁，兩者只差在五張逐客戶頁：

分頁	朝陽範本	公版範本
營業額、遲延	兩者相同：營業額頁會另讀前一年度出貨填「前一年實績」列，所以比檢核模式多花一點時間	同左
汽車市場佔有率、機車市場佔有率、4W 銷售、2W 銷售、4W 銷售趨勢圖、2W 銷售趨勢圖（公會六頁）	相同	相同
國外向出貨數、國內向出貨數、國外 LOT、國內 LOT	客戶寫在範本列上，逐列比對填值	系統自動展開客戶列（規則見下）
渡邊總工程／各客戶出貨數	頁名「渡邊總工程」	頁名改叫「各客戶出貨數」，列出全部有出貨客戶（不分國內外），只放當月出貨數

公版範本的客戶列規則

哪些客戶：報告年度 1 月到報告月份有出貨的全部客戶（報告月份之後才出貨的不列，所以同一份月報哪天重跑名單都一樣），一家一列（出貨數頁一家兩列：納品個數＋Lot 數）。以 ERP 客戶代號歸戶；出貨明細沒有客戶代號的，會以「(無代號)客戶名」列出並留一條警告。
排序：依 1 月到報告月份的累計出貨金額由大到小；同額依客戶代號。
國外向／國內向：依客戶資料的 交易類別——D＝國外，其他（含 L 與空白）＝國內。交易類別空白的客戶會全部算國內，請先到客戶資料補好。同一客戶的明細同時有內外銷時，取筆數多的一邊並留警告。
TOTAL 列：由系統依實際客戶列數重寫公式，客戶增減都不會漏列。
月欄：填到報告月份為止，之後的月份留空；數值 0 也留空白。

什麼時候用朝陽範本、什麼時候用公版？

範本上的客戶清單是公司自己固定排好的（要照特定順序、只列特定客戶），用朝陽範本；想要「有出貨就列出來、大客戶排前面」、不想每年手動維護客戶清單，用公版範本。

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

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

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

步驟④ 核對產出¶

檢核模式打開檔案後建議先對三處：

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

公版範本打開檔案後建議先對三處：

國外向出貨數／國內向出貨數：外銷客戶是否都落在國外向。有外銷客戶跑到國內向，就是客戶資料的交易類別沒設成 D——補好後重產一次。
各客戶出貨數：當月出貨數最大的幾家，與儀表板客戶 Top 15 的數量是否一致。
警告清單「ℹ 供參考」區的「公版範本已展開客戶列：國外向 N 家、國內向 N 家…」，家數是否合理。

步驟⑤ 顧外部資料¶

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

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

與排程共用同一份紀錄

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

步驟⑥ 不想每月手動按¶

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

排程與畫面是分開設定的——畫面上選的產法不會帶進排程，要在排程參數裡指定：

參數	值	說明
`TemplateMode`	`檢核模式`／`朝陽範本`／`公版範本`	產法。不填＝檢核模式；填其他字會直接失敗並回報「TemplateMode 只接受檢核模式／朝陽範本／公版範本」
`UserTemplatePath`	預設 `C:\dglibrary\REPORTSROOT\Template\業務課報告表範本-新版.xlsx`	朝陽範本的路徑
`GenericTemplatePath`	預設 `C:\dglibrary\REPORTSROOT\Template\業務課報告表範本-公版.xlsx`	公版範本的路徑
`SkipTtvma`	`false`（預設）	`true`＝不帶汽機車市場資料

範本路徑是排程那台電腦上的路徑

排程在執行排程的電腦上產檔，範本與輸出資料夾都要在那台電腦上存在。

欄位說明¶

查詢條件與工具列¶

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

KPI 卡¶

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

本月客戶 Top 15¶

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

業務課報告表產生¶

欄位／按鈕	預設	說明
範本	依產法而定（見下三列）	跟著產法切換顯示該模式的範本路徑，可直接修改；改過的朝陽範本／公版範本路徑會記在這台電腦
檢核模式時	`C:\dglibrary\REPORTSROOT\Template\業務課報告表範本.xlsx`	舊版範本路徑，檢核模式產生時不讀此檔
朝陽範本時	`C:\dglibrary\REPORTSROOT\Template\業務課報告表範本-新版.xlsx`	朝陽 13 頁範本（客戶寫在範本上）
公版範本時	`C:\dglibrary\REPORTSROOT\Template\業務課報告表範本-公版.xlsx`	公版 13 頁範本（客戶由系統展開）
輸出	`C:\temps\業務課報告表`	產出檔的存放資料夾
產法	檢核模式	範本模式三選一：`檢核模式（原始資料檔供核對）`／`朝陽範本（客戶寫在範本上）`／`公版範本（自動列出有出貨客戶）`；選擇會記在這台電腦
含 TTVMA 市場資料	勾選	是否一併帶出汽機車市場統計（自資料庫讀取，不連外網）；只有檢核模式可改；朝陽範本下變灰沿用原狀態；公版範本一律帶出
`產生報告表`	—	開始產生；產生中按鈕鎖住
`開啟輸出`	—	產生成功後才出現；在檔案總管中選取最新產出檔
結果訊息	—	成功為綠字、失敗為紅字
警告清單	—	分「⚠ 需要處理」與「ℹ 供參考」兩區逐條列出（例：客戶未設交易類別、市場統計當期未公布改用前一期）

外部資料擷取¶

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

常見問題¶

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

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

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

產法選的是 檢核模式（預設），產出的是「原始資料檔」（全新 Excel，各分頁呈現系統抓到的資料），用來核對資料正確性。要出正式報告，把產法改成 朝陽範本 或 公版範本 再產一次。

我們不是朝陽，要用哪個範本？

用 公版範本。朝陽範本的客戶清單是寫死在範本上的（朝陽自己的客戶），其他公司套用會對不到客戶；公版範本由系統自動列出貴公司當年 1 月到報告月份有出貨的全部客戶，不需要改範本。

公版範本的國外向出貨數是空的，客戶全跑到國內向？

公版範本依客戶資料的 交易類別 分國內外：只有 D 算國外，空白也算國內。請到客戶資料把外銷客戶的交易類別設成 D，再產一次。警告清單「⚠ 需要處理」區會寫出有幾家客戶未設交易類別。

公版範本的客戶順序可以自己排嗎？

不行，固定依 1 月到報告月份的累計出貨金額由大到小。需要固定順序或只列特定客戶，請改用自行維護客戶清單的範本（朝陽範本的做法）。

按產生報告表立刻出現「找不到範本檔」？

選朝陽範本或公版範本時，系統會先檢查範本欄的檔案在不在。確認這台電腦 C:\dglibrary\REPORTSROOT\Template\ 底下有對應的範本檔（公版為 業務課報告表範本-公版.xlsx），或把範本欄改成實際存放位置。沒有範本檔請洽 IT。

範本模式下「含 TTVMA 市場資料」為什麼是灰的？

這個勾選只在檢核模式可改。公版範本一律帶出市場資料，不看勾選。朝陽範本沿用切換前的狀態；若朝陽範本產出的公會六頁是空的，先切回檢核模式確認已勾選，再切回朝陽範本產生。

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

汽機車市場統計由外部單位每月公布，通常上月數據要到當月 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 日。要排程產公版範本，參數 TemplateMode 填 公版範本（不填＝檢核模式），參數表見上方「步驟⑥ 不想每月手動按」。設定見排程作業。

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

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

公版範本例外：公版的客戶頁以 ERP 客戶代號歸戶（不做名稱正規化），名稱顯示該代號最近一筆出貨單上的寫法。