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：开发者预览模式下不出现截断或滚动条现象，则开启字体自适应和报表双向自适应下，使用新表单预览也不会出现截断或滚动条现象。

为了让大家更简单地把一张老模板转换为新自适应下可使用的模板，我们提供了新老决策报表切换的功能，操作步骤如下：

第一步：打开一张老的决策报表模板，会默认打开老决策报表操作界面。

第二步：点击设计器顶部工具栏中的切换按钮，切换成新决策报表操作界面。

第三步：在确认弹窗中，选择是否切换，点击是按钮，完成老模板转换为新自适应下的模板。

注1：打开老模板，切换至新决策报表操作界面后卸载插件，body大小会发生变化。切换至老决策报表操作界面后卸载插件，则不会改变body大小。

注2：打开老模板，切换至新决策报表操作界面时，会在同级目录下，自动备份模板。

部分老模板切换至新操作界面后，模板效果未必能达到完美，需要手动再进行调整，场景如下：

转换逻辑说明：

（一）取消勾选全局配置的模板

1.布局方式是什么转换逻辑？

新老操作界面来回切换，布局方式（指自适应布局和绝对布局）不会改变。

注：布局方式的转换逻辑与是否使用全局配置无关。

2.老的模板转换成新的操作界面，属性配置怎么转换？

a.老的模板如果单独修改过报表块的Pc浏览器自适应设置，转换成新的操作界面后，属性配置怎么转换？

b.未单独修改过报表块的Pc浏览器自适应属性设置，转成成新的操作界面后，属性配置怎么转换？

老的模板转换成新的操作界面，右侧属性栏中报表块的内容显示方式默认为“不自动调整”

3.新的模板转换成老的操作界面，属性配置怎么转换？

注1：绝对布局和自适应布局下的模板均采用该逻辑。

注：绝对布局下的模板，转换成老的操作界面，默认为绝对布局-固定大小；自适应布局下的模板，转换成老的操作界面，默认为自适应布局-双向自适应。

（二）勾选全局配置的模板，新老操作界面切换后，属性配置怎么转换？

针对使用全局配置的模板，转换成新决策报表操作界面后，将使用新的全局配置。

新的全局配置默认见下图：

注1：绝对画布块的缩放逻辑默认为【适应区域】。在老的模板下中绝对画布块，来回切换操作界面，不会影响其“缩放逻辑”的配置

导出的内容默认使用模板设计时的宽高尺寸，允许自定义宽高导出，功能使用方式：

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）

插件 1.8.8 版本对图表一些固定像素的属性进行了自适应优化，它们现在可以根据浏览器窗口整体缩放比例进行自适应调整，具体包含的属性如下：

• 饼图半径自定义大小

• 柱形图和条形图固定柱宽

• 折线图/面积图/雷达图/箱型图线宽、标记点大小（包括默认和自定义）

• 仪表盘固定半径大小

• 散点图标记点自定义半径大小

• 气泡图、力学气泡图最小直径和最大直径大小

• 热力地图渲染半径

• 词云指定大小

• 框架图节点半径自定义大小、连线自定义宽度

• 点地图标记点大小

• 试管型仪表盘滑槽固定长度、宽度

• 地图图例字符大小

• 雷达图轴标签字符大小

• 试管型仪表盘轴标签字符大小
  

• 组合图中相关的上述图表的属性、组合图-雷达图固定半径大小

注：图表自适应优化需要将插件更新到 1.8.8 版本，JAR 包更新到 2020-12-02 版本。