程式資訊

程式 ID：CUSTOMDASH
所屬子系統：M.主管資訊
狀態：stable

自訂查詢面板¶

版本狀態

本功能已實作（含儲存／載入設置、彙整列印 PDF、彙整匯出 Excel／PPT／HTML、整批換月、圖表區），runtime 驗收進行中。目前以開發注入方式提供；正式環境需於資料庫登錄程式與權限、並部署設定檔腳本後才能使用儲存／載入設置；圖表與匯出圖表另需部署圖表定義腳本。

功能簡介¶

「自訂查詢面板」讓你把多支既有的查詢程式組合在同一個畫面：在下方查詢區逐支選程式、用各程式原本的中文條件畫面設好條件加入清單，按一次 查詢 就把清單裡每支查詢都跑好，上方以分頁並列各查詢的原生結果表格。適合把每月固定要看的一組查詢（例如財務部月報用的損益表、資產負債表、毛利率分析、進貨廠商統計等）集中成一個面板，一次查完、一次列印。

主要能力：

一頁多查：清單裡的每支查詢各自帶自己的條件，按 查詢 一次全部跑好。
存／載設置：把整份查詢清單（選了哪些查詢、各自條件、順序）以名稱存起來，之後載入還原；設置存在伺服器，換電腦也看得到，並可依組織關係分享給部門同仁。
彙整列印（PDF）：把清單裡多支查詢各挑一張報表，合併成一份 PDF 預覽／匯出。
彙整匯出（Excel／PPT／HTML）：把清單裡多支查詢的結果，一鍵同時輸出成 Excel、PowerPoint、HTML 三個檔到指定資料夾（見彙整匯出）。
整批換月：把清單中所有查詢條件的日期，一鍵平移到指定的目標月份——月報配置每月換月不必逐支手改（見整批換月）。

唯讀、不影響單據

面板只是把既有查詢寄生在同一畫面執行，本身不建單、不沖帳，跑出來的結果與各查詢單獨開啟時一致。

前置需求¶

權限：M.主管資訊 → 自訂查詢面板 的瀏覽權限；彙整列印需列印權限。清單裡要放的每支查詢，也需具備各自的瀏覽權限（下拉只會列出你有權限、且可寄生的查詢型程式）。
設定檔部署：儲存／載入設置需先部署設定檔腳本（各客戶資料庫各跑一次）。未部署時面板照常可用，只是按「儲存設置／載入設置」會顯示失敗訊息。

操作步驟¶

步驟① 組出查詢清單¶

從主選單開啟 主管資訊 → 自訂查詢面板。
在下方查詢區的 查詢程式 下拉選一支查詢（下拉可直接打字篩選）。選定後，中間會顯示該程式自己的中文條件畫面。
在條件畫面設好條件，按 ＋加入清單，該查詢與當下條件會被加進右側查詢清單。
重複步驟 2～3 加入其他查詢。同一支查詢可用不同條件多次加入（例如同一張報表分別帶不同公司別）。
需要調整時：
- 點清單中的某一項，中間條件畫面會顯示它已存的條件，可修改後按 更新條件 寫回。
- 按項目上的 ✕ 移除單筆，或按 清空清單 全部清掉。

步驟② 查詢與檢視結果¶

按面板上的 查詢，系統會把清單裡每支查詢都跑好，上方以分頁並列（分頁標題＝程式名稱）。之後切換分頁只顯示既有結果、不會重查。

步驟③ 儲存／載入設置（可分享）¶

在查詢區上方的 查詢清單設置 區：於名稱欄輸入配置名稱、確認 使用部門（預設帶自己的部門，可改），按 儲存設置。
下次可從 查詢清單設置 下拉選出配置，按 載入設置 還原整份清單；按 刪除設置 刪除（只能刪自己建立的）。

分享給部門同仁

儲存時記錄的使用部門決定誰看得到：該部門與其上層部門的人、主管（看得到下屬各層）、代理人（看得到被代理人）都能在下拉看到這份配置。別人分享來的配置會標註擁有者、不可刪除，但可另存成自己的一份。

儲存的配置可以排程自動寄送

存起來的配置除了手動載入，還能交給排程作業無人值守定時產出並 Email 寄出：由系統管理者把配置掛到行事曆排程事件，系統即會定時把整頁跑一遍、產出 Excel／HTML 檔當附件寄給指定收件人（月報配置搭配 {-d1} 每月 1 號自動產「上個月」報表）。設定方式見排程報表自動寄送。

步驟④ 彙整列印（PDF）¶

先在各查詢的結果格線勾選要列印的資料列（彙整列印只會輸出勾選的列）。
按面板頂端的 彙整列印 (PDF)，在選擇視窗逐支查詢勾選、並用下拉挑一張報表（沒有報表的查詢會自動 disable）。
確認後系統把各報表合併成一份 PDF 預覽，於預覽視窗內可另存 PDF。

報表選擇會被記住

彙整列印時每支查詢選過的報表會被記住，並隨設置一起儲存；下次開彙整列印視窗會自動預選上次的報表（只有勾選列印的列才更新記憶）。

步驟⑤ 彙整匯出（Excel／PPT／HTML）¶

彙整列印產出的是一份 PDF；若要可再編輯的檔案（Excel 表、PowerPoint 簡報）或網頁，改用 彙整匯出。它直接以查詢的原始資料產表，並附上圖表（若該查詢已設定圖表）。

先在各查詢的結果格線勾選要輸出的資料列（與彙整列印相同，只輸出勾選的列）。
按面板頂端 彙整列印 (PDF) 旁的 彙整匯出，在選擇視窗逐支查詢勾選、並挑一張報表（挑法與彙整列印相同）。
確認後選一個存放資料夾。
系統在該資料夾一次產出三個檔案——Excel（.xlsx）／PowerPoint（.pptx）／HTML（.html），完成後自動開啟該資料夾。

PPT 圖表為占位文字框（一期限制）

一期的 PowerPoint 檔中，圖表位置以文字框標示，尚未產生可直接編輯的 PowerPoint 原生圖表（列為二期）。Excel 內為 Telerik 原生圖、HTML 內為 SVG 圖，皆為真圖。

沒有報表的查詢只出表格，不影響匯出

彙整匯出的表格沿用與彙整列印相同的取數方式，沒有報表的查詢不會有表格頁；但圖表不受此限（圖表直接取查詢畫面上的結果資料）。

圖表區¶

若某支查詢已由系統管理者設定「圖表定義」，該查詢的原生畫面會多出一塊圖表區（直條／圓餅／折線）。由於面板顯示的就是各查詢的原生畫面，這類查詢放進面板後，分頁裡也會一併顯示圖表。

圖表需先部署圖表定義才會出現

圖表由資料庫中的「圖表定義」驅動，需由系統管理者先部署（sql/chart-spec-deploy.sql）。未部署時畫面不顯示圖表、彙整匯出的檔案只有表格頁，功能仍可正常使用。新增一張圖只需在資料庫插入一筆定義，不必改程式。

整批換月¶

財務部月報通常是「同一組查詢，每個月只換月份重跑一次」。由於存下來的配置裡，各查詢的日期是存檔當下的固定值，載入舊月報配置後日期還停在上次那個月。整批換月 讓你一鍵把清單中所有查詢條件的日期平移到目標月份，不必逐支查詢手改起訖日期。

操作方式：

載入（或組好）要換月的查詢清單。
在查詢區上方 目標月份 欄輸入目標月份（格式同其他日期欄位 yyyy/MM/dd，系統只取年月，日不影響結果；預設帶「今天的上個月」）。
按 整批換月。系統會把清單裡每一支查詢條件的日期，整批平移到目標月份，並回報「由 YYYY/MM 平移至 YYYY/MM，共 N 支」。
換月後可點清單各項檢視換月後的日期，必要時用 更新條件 微調，再按 查詢。

換月規則¶

來源月份採「多數決」自動判斷：系統統計清單裡所有查詢條件的日期，出現最多的那個年月視為「目前月份」，再算出到目標月份的月差，整批平移。因此換月前請盡量讓清單裡的日期落在同一個月。
月底日自動對齊月底：若某個日期原本是當月最後一天（例如 5/31），平移到目標月後會取目標月的最後一天（6/30）；一般日號則保持同一天，遇到目標月沒有該天（例如 1/31 → 2 月）時對齊到月底。
平移的是清單裡的全部日期欄：包含「非報表期間」用途的日期欄也會一起平移，換月後可逐項檢視、用 更新條件 微調。

清單為空或沒有日期時

清單是空的、或清單裡的條件都沒有日期欄位時，系統無法判斷來源月份，會提示改用 更新條件 逐支手動調整。目標月份與目前月份相同時，系統會提示不需換月。

月報配置的每月例行流程

載入上個月存的月報配置 → 設 目標月份 → 按 整批換月 → 按 查詢 → 彙整列印 (PDF)，即可產出當月月報，日期完全不用逐支手改。

欄位說明¶

查詢清單設置區¶

欄位/按鈕	說明
查詢清單設置（下拉）	選要載入／刪除的既有設置；別人分享來的會標註擁有者
配置名稱（輸入框）	儲存時的名稱；留空＝覆蓋上面選定的、屬於自己的設置
使用部門（輸入框）	決定分享可見範圍；預設帶自己的部門，可改；留空儲存時會自動補回建立者當下部門
`儲存設置` / `載入設置` / `刪除設置`	儲存目前清單／還原選定配置／刪除選定配置（只能刪自己的）

整批換月區¶

欄位/按鈕	說明
目標月份	要平移到的月份（`yyyy/MM/dd`，只取年月）；預設帶今天的上個月
`整批換月`	把查詢清單裡每一支查詢條件的日期整批平移到目標月份

查詢區¶

欄位/按鈕	說明
查詢程式（下拉）	只列你有權限、可寄生的查詢型程式；可打字篩選
條件畫面	選定程式（或點清單項目）後顯示的該程式原生中文條件畫面
`＋加入清單` / `更新條件` / `清空清單`	加入目前條件為新項目／回寫選定項目／清空整份清單
查詢清單	面板要跑的查詢集合；點一列可在左邊檢視／修改其條件

常見問題¶

載入舊月報配置後，日期還是上個月的怎麼辦？

這是正常的——配置存的是當時的固定日期。設好 目標月份 後按 整批換月 即可一鍵平移到本月，不必逐支手改（見整批換月）。

按整批換月提示「無法判斷來源月份」？

表示清單裡的條件都沒有可辨識的日期欄位。這類查詢請改用 更新條件 逐支手動調整日期。

彙整列印出來是空的，或提示沒有可列印的報表資料？

彙整列印只會輸出結果格線中已勾選的資料列。請先在各查詢結果勾選要印的列，再按 彙整列印 (PDF)。另外，沒有報表的查詢在選擇視窗會是 disable 狀態、不能挑報表。

彙整列印和彙整匯出差在哪？

彙整列印 (PDF) 產出一份 PDF（樣式照 ERP 報表，適合直接列印／存檔）；彙整匯出 用查詢原始資料產出 Excel／PowerPoint／HTML 三個檔（可再編輯、可附圖表）。兩者的勾選列與挑報表流程相同，依需求擇一使用。

彙整匯出的 PowerPoint 裡看不到圖表，只有一個文字框？

這是一期的已知限制：PPT 的圖表位置目前以占位文字框標示，可直接編輯的 PowerPoint 原生圖表列為二期。Excel 與 HTML 檔內為真正的圖表。

為什麼查詢畫面／匯出檔裡沒有圖表？

圖表由資料庫中的「圖表定義」驅動，需由系統管理者先部署圖表定義腳本（sql/chart-spec-deploy.sql）。未部署時畫面不顯示圖表、匯出檔只有表格頁，其餘功能照常可用。請洽系統管理者確認是否已部署。

為什麼有些查詢在下拉裡看不到？

下拉只列出你有瀏覽權限、且可被寄生的查詢型程式。沒有權限、或不是查詢型（例如建單類）的程式不會出現。

按儲存設置失敗？

儲存／載入設置需先部署設定檔腳本。若尚未部署，面板其他功能照常可用，僅存／載設置會失敗，請洽系統管理者確認資料庫是否已部署。