決策報表新自适應插件（公測中）

1.1 版本

注1：此插件僅優化決策報表 PC 端模板的設計和展現效果，不作用於 CPT 模板和 FRM移動端 模板。

注2：此插件已适配官方插件，暫不支持與第三方插件結合使用，不支持使用 圖表(舊版本) 插件。

1.2 應用場景

在PC端預覽決策報表，開啓自适應的模板可自動适應不同屏幕分辨率的浏覽器，展示出與設計相符的效果。

1.3 功能介紹

• 采用全新控件UI效果，優化滾動條樣式，提升決策報表PC端展示的視覺體驗。
  

• 決策報表的報表塊設計标尺使用像素單位，使報表塊内外設計單位保持一緻。

• 設計模板時，body大小（即決策報表設計區域）與組件大小比例固定爲1:1，不再受電腦分辨率影響。

• 設計和預覽盡可能做到“設計所見即展示所得”，模板設計時看到的文字換行和截斷即爲展示時的換行和截斷，便於調試模板到最佳效果。
  

• 提供PC端預覽和開發者預覽兩種預覽方式。開發者預覽爲模板固定寬高比例展示，寬高比例不受浏覽器分辨率影響，在開發者預覽模式下可檢查模板是否出現截斷或滾動條等異常，在PC端預覽模式下可查看模板在當前浏覽器分辨率下的最終展示效果。

• 内置決策報表導出功能，默認按照決策報表設計寬高尺寸導出，允許自定義寬高尺寸導出模板。

• 參數面板para可手動輸入設計高度，并實現預覽時的縮放效果。

2.1 插件安裝

點擊下載插件：插件公測期間，請聯系技術支持或其他帆軟工作人員獲取。

說明1：公測期間，插件可能存在少量問題，請知悉此風險。但是由於新決策報表采用新的邏輯，因此風險問題不會影響到原有決策報表模板及其他功能模塊；

說明2：新決策報表的報表塊展示邏輯進行了重新設計，當模板的報表塊行列很多時，新決策報表的模板展示加載性能比老的決策報表要好，當模板的報表塊行列較少時，新決策報表的模板展示加載性能要低於老的決策報表，報表塊特别多的模板差異會比較明顯，試用插件前請知悉此問題。

設計器插件安裝方法參照：設計器插件管理

服務器插件安裝方法參照：服務器插件管理

2.2 模板整體自适應設置

點擊模板>PC端自适應屬性，彈出「PC端自适應屬性」面板。如下圖所示：

全局配置使用方式與原來的一緻，參考 自适應屬性 2.1 章節。

注1：此處設置對模板整體生效。

注2：在絕對布局和自适應布局下，均能操作此處設置模板的自适應屬性，布局方式不影響自适應屬性。

注3：新老操作界面下，全局配置的修改不會互相影響。

邏輯說明：

自适應屬性設置	類型	效果	描述
報表縮放方式	雙向自适應（默認值）		模板雙向充滿浏覽器窗口大小，在不同屏幕分辨率下，内容全部呈現在一頁中。
	橫向自适應		模板橫向充滿浏覽器窗口寬度，高度等比例縮放，在不同屏幕分辨率下，單頁顯示不全時，縱向會出現滾動條。
	不自适應		模板按照設計時分辨率大小，原樣展示在浏覽器窗口，在不同屏幕分辨率下，單頁顯示不全時，會出現縱向或橫向滾動條。
字體	自适應（默認值）		字體大小會随模板縮放的效果進行縮放 注：字體自适應屬性設置，作用於模板中所有組件字體
	不自适應		字體按照設計時的大小，原樣展示

2.3報表塊的内容顯示方式設置

報表塊進入編輯狀态後，顯示報表塊大小的邊界虛線，form中的報表塊内容顯示範圍爲邊界虛線裏的内容，如下圖所示：

注：邊界虛線外的單元格有内容（包括内容、格式）時，會出現橫向或縱向滾動條，可選中邊界虛線外區域，點擊鼠标右鍵進行 清除>全部 操作。

在右上角的組件中選中報表塊，在下面的屬性中可以看到内容顯示方式設置項，可調整報表塊的内容在報表塊中的顯示效果。如下圖所示：

邏輯說明：

設置項	效果	描述
不自動調整（默認值）		預覽時報表塊的内容原樣輸出。 注：報表塊的内容超出報表塊大小時，會出現縱向或橫向滾動條。
寬度鋪滿報表塊		報表塊的内容橫向鋪滿報表塊的寬度，高度等比例縮放，可能出現縱向滾動條。 注：選擇該項後，字體開啓自适應下，該報表塊的字體縮放比例可能與整體不一緻。
雙向鋪滿報表塊		報表塊的内容雙向鋪滿報表塊的寬度和高度。 注：選擇該項後，字體開啓自适應下，該報表塊的字體縮放比例可能與整體不一緻。

其他說明：

1）取消老設計模式下，form中報表塊的行序号和列序号顯示。

2）報表塊設計标尺采用像素單位。

3）在絕對布局下，body大小（即決策報表設計區域）與組件大小比例爲1:1。

2.4參數面板設置

将「參數面板」拖入到決策報表中，可設置參數面板的高度，如下圖所示：

注：當在參數界面中添加控件時，若最底部控件所處的位置大於參數界面的「設計高度」，此時不支持修改參數界面的「設計高度」。建議用戶設置具體的「設計高度」後，再添加控件。

2.5 預覽方式

安裝插件後，新增PC端預覽和開發者預覽兩種預覽模式。

1）PC端預覽

作用：根據模板中的自适應屬性配置，呈現最終展示效果的預覽模式。

2）開發者預覽

作用：通過該預覽方式檢查是否存在截斷或滾動條，并基於預覽效果調整模板。

效果	描述	應用場景
	默認爲字體自适應，模板的寬高固定比例縮放的效 果。在不同屏幕分辨率下，模板保持原始比例。	此種預覽方式，适用於報表塊單元格中有公式、引用或擴展等，可查看模板的真實展示效果。 注：屏幕分辨率和模板分辨率比例不同時，會出現留白。

注1：開發者預覽效果固定，用來彌補設計器内不能完美做到"所見即所得"的缺點，該預覽方式不受 模板>PC端自适應屬性 設置的影響。

注2：開發者預覽模式下不出現截斷或滾動條現象，則開啓字體自适應和報表雙向自适應下，使用 PC端預覽 也不會出現截斷或滾動條現象。

爲了讓大家更簡單地把一張舊模板轉換爲新自适應下可使用的模板，我們提供了新舊決策報表轉換的功能，操作步驟如下：

第一步：打開一張舊的決策報表模板，會默認打開舊的決策報表操作界面。

第二步：點擊設計器頂部工具欄中的轉換按鈕，切換成新決策報表。

第三步：在确認彈窗中，選擇是否切換，點擊是按鈕，完成舊模板轉換爲新自适應下的模板。

注1：打開舊模板，切換至新版決策報表後卸載插件，body大小會發生變化。切換至舊版決策報表後卸載插件，則不會改變body大小。

注2：打開舊模板，切換爲新版決策報表後，會在同級目錄下，自動備份舊模板。

注3：新舊決策報表操作界面，全局配置的設置相互獨立。

導出的内容默認使用模板設計時的寬高尺寸，允許自定義寬高導出，功能使用方式：

4.1 URL添加後綴直接導出

在報表預覽的URL後輸入&export_format=pdf&width=1920&height=1080 ，通過給export_format參數賦一個格式，實現URL直接導出。

注：重命名等其他操作與原來的方式一緻。見參考文檔：URL 直接導出 。

4.2 帶參決策報表的導出

見參見文檔：決策報表導出插件 （第三節），URL添加後綴的步驟需要調整，改動如下：

老的方式：URL後綴加上&op=export&format=excel&sessionID=xx

新的方式：URL後綴加上&export_format=excel&sessionID=xx

注1：該方式的其他操作步驟和幫助文檔一緻。

注2：該方式同樣允許自定義寬高導出，方法見上述4.1。

4.3 JS 實現點擊按鈕導出帶參決策報表

見參考文檔：決策報表導出插件 （第四節），給按鈕添加點擊事件需要調整，改動如下：

修改前：

var REPORT_URL = '${servletURL}?viewlet=doc/frm/example.frm&op=export&format=excel&sessionID=' + aaa;
window.location = encodeURI(REPORT_URL);

修改後：

var REPORT_URL = '${servletURL}?viewlet=doc/frm/example.frm&op=form_adaptive&export_format=excel&sessionID=' + aaa;
window.location = encodeURI(REPORT_URL);

注1:該方式的其他操作步驟和幫助文檔一緻。

注2：該方式同樣允許自定義寬高導出，方法見上述4.1。

在部分場景中，需要添加參數 op=form_adaptive，說明是新自适應調動。

1）使用網頁框時

2）添加鏈接-網絡報表

6.1 報表設計

1）模板的右上角組件管理處選中body，下方屬性面板的「布局方式」設置爲自适應布局。

2）模板中的所有報表塊，其右側屬性處「内容顯示方式」默認爲不自動調整。

3）模板>PC端自适應屬性彈窗中，取消勾選使用全局配置，「字體」設置爲自适應，「報表縮放方式」設置爲雙向自适應。

4）使用PC端預覽，查看模板展示效果。

6.2 效果預覽

6.3 模板下載

點擊下載已完成的模板：

監控看板.frm

綜合分析.frm

在線demo體驗：決策報表新自适應在線demo（賬号：demo；密碼：demo）