FVS範本匯出

適用場景：安裝了「FineVis企業戰情室編輯模式」插件的使用者，可參考本文了解 FineVis 範本的相關功能。

1.1 版本

1.2 應用場景

FVS 視覺化看板支援匯出為 PDF 、圖片 和 PPT，可直接在 URL 後新增參數後綴匯出，也支援設定 JavaScript 事件匯出 。

範本 JS 匯出API可參考：exportTemplate  。

FVS 表格組件匯出可使用 FVS表格工具欄按鈕 ，也可使用API：exportReportToExcel  。

2.1 匯出方法

方法一：透過給 URL 新增參數後綴 &op=export&format=xxx ，進行匯出。還可以連接 merge、delay 和 scale 參數 。

方法二：在範本中設定 JavaScript 點選事件，透過 exportTemplate({format,merge,delay}) API匯出 。

2.2 匯出參數

2.1.1 format 參數

format 參數可設定匯出的格式，不區分大小寫。如下表所示：

2.1.2 merge 參數

format 參數為 pdf 和 image 時，支援再連結 merge 參數設定匯出形式，適用於多分頁的情況。如下表所示：

format 參數為 ppt 時，merge 參數不生效，僅支援匯出為一個單獨的 pptx 檔案。

2.1.3 delay 參數

delay 參數可設定延遲多少秒再匯出，常用於載入時間可能比較久的範本。

不連結時，預設為 0s ，連結 &delay=5 ，表示延遲 5s 再匯出。

2.1.4 scale 參數

scale 參數可用於指定匯出影像與螢幕顯示元素之間的比例 。

連接 &scale = X， X大於 1時，生成的圖片為原始元素大小的 X 倍，圖片更清晰、細節更豐富；X 小於 1 時生成的圖片會相對模糊、檔案尺寸也較小 。

2.2 匯出規則

1）匯出內容為範本頁面展示的全部內容，若有動態變化的內容，以匯出時機為準儲存其靜態效果。

2）若範本有多個分頁，則從預覽時所在頁面開始，按順序匯出到最後一頁。若 分頁隱藏 則不匯出。

3）匯出的檔案名稱，預設為範本名稱或分頁名稱，不支援自訂。

4）匯出程式中，範本預覽介面出現正在匯出進度條提示，無法進行任何操作，僅支援關閉瀏覽器視窗；若匯出程式中關閉視窗，則匯出不成功。

2.3 注意事項

• 不支援行動端；

• 不支援匯出 Unity 組件；
  

• 對於應用了「點九圖填充」的組件邊框背景，匯出時會自動將其調整為「普通填充>拉伸」；

• 不支援匯出組件陰影、倒影、毛玻璃效果；不支援匯出標題文字陰影效果；
  

• 不支援匯出跨域視頻和圖片；

• 點地圖，鑽取點地圖，流向地圖無法匯出地圖GIS圖層；

• 圖表系列使用圖片填充時，無法匯出圖片填充樣式；
  

• 部分內容匯出效果可能會有細微差；

• 匯出 pdf 單張頁面的寬度或者高度不能超過 9600px，超過了會等比例尺到 9600px 

3.1 建立範本

點選設計器「檔案>建立視覺化看板>從範本建立看板」，從線上資源中選擇一張範本後，並自訂範本名稱，最後點選「建立範本」。如下圖所示：

3.2 URL匯出

點選範本「右上角」預覽，建立範本後初次預覽會提示「請將範本檔案儲存在當前運作環境目錄下」，儲存後再預覽即可。

在 URL 連結後新增後綴 &op=export&format=pdf 後回車，效果如下圖所示：

下載後效果如下圖所示：

4.1 新增點選事件

以 3.1 節範本為例，在範本中新增一個「標題組件」，修改標題內容為「點選匯出範本」。如下圖所示：

再給標題組件新增 JavaScript 點選事件，輸入 JavaScript 程式碼：

duchamp.exportTemplate({format: "pdf",merge: true});

步驟如下圖所示：

注：若範本包含多個分頁，而該事件設定在第二頁，在第二頁點選匯出，則從第二頁開始匯出到最後一頁，而不是匯出完整範本。

4.2 效果預覽

預覽範本，點選標題組件，效果如下圖所示：

4.3 範本下載

點選下載：帆軟智慧園區監控.fvs