历史版本7 :新计算引擎使用说明 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

本文介绍新计算引擎中的「模板转换」功能。

注1:该插件支持的功能与不支持的功能介绍请参见:适用范围

注2:新计算引擎插件使用过程中,遇到的问题及解决方案请参见:新计算引擎插件试用注意事项

2. 操作方法编辑

2.1 模板格式转换

打开 cpt 模板,设计器上方工具栏会出现一个转换按钮,点击该按钮,弹出提示框信息“转换成功,请查看设计器目录同名文件”,即表示 cptx 成功生成。

注:cptx 生成后,不需要刷新目录树,cptx 模板会自动出现在同名 cpt 模板的同级目录下。

Snag_4289c5b0.png

2.2 新分页预览

插件安装后,报表预览按钮下拉选择项新增新分页预览,如下图所示:

注:cpt 和 cptx 都可以使用新分页预览。

Snag_42c73cdc.png

新分页预览分页预览的区别在于报表 Web 预览前端效果的改变,如下图所示:

1625813315731161.png

目前 cpt 和 cptx 格式的模板分别在新分页预览和分页预览时,所使用的引擎和前端展现效果如下表所示:

注:目前 cptx 优先对分页预览做支持,所以 cptx 模板选择其他预览方式时,比如填报预览之类,由于暂未支持,效果和分页预览是一致的。

模板格式分页预览新分页预览
                     cpt       旧引擎,旧前端        旧引擎,新前端
                    cptx       新引擎,新前端        新引擎,新前端

2.3 计算属性

新引擎设置计算属性的操作步骤:打开一张 cptx 模板,设计器菜单栏选择「模板>计算属性」。计算属性设置界面如下图所示:

注:插件安装后,只有 cptx 模板的菜单栏模板下才会显示计算属性这个功能。

17.png

2.3.1 查询缓存/多源优化

  • 查询缓存:就是数据集缓存,勾选后可缓存查询结果,从而降低服务器压力,提升报表的展现速度。

  • 多源优化:勾选后,将对跨数据源的取数进行优化。

2.3.2 实验性功能

点击「实验性功能」按钮,界面如下图所示:

注1:新引擎折叠树支持冻结及调整折叠按钮所在单元格的内容样式。

注2:新引擎折叠树所有折叠树层级都需要设置折叠树按钮,而老引擎支持最后一层级不设置折叠树按钮,如碰到此问题,可在最后一层增加折叠树按钮解决。

1625815794302262.png

1)新引擎支持的折叠树分为两类:异步取数折叠树和非异步取数折叠树。主要说明如下所示:

异步取数折叠树:

主要针对结构比较标准的单棵纵向折叠树,通过异步取数+异步加载,从取数阶段就进行折叠树性能的优化。

场景限制(只支持同时满足以下条件的场景):

注:折叠树模板转换为 cptx 后,若显示兼容模式则不支持,兼容模式参考本文 4.4 节内容。

  • 单数据集。

  • 折叠树按钮纵向排布。

  • 数据列公式仅支持sum()汇总和行内计算。

  • 单棵折叠树。

  • 折叠树按钮所在行的数据列左父格需设置为折叠树按钮所在单元格。

非异步取数折叠树:

主要优化前台数据加载的性能问题,实现前台异步加载,优化折叠树的前端性能。

支持场景:

  • 折叠树纵向扩展。

  • 单棵折叠树。

2)选择「折叠树」按钮,计算属性会增加折叠树设置相关面板,默认为非异步取数,可自行对单模板开关异步取数。如下图所示:

注:「展开层级」功能暂未支持。

1625817400929977.png

3)「折叠树——异步取数」为全局开关,打开后所有模板默认优先异步取数。

3. 批量转换编辑

3.1 应用场景

主要面向有较多老模板需要验证新引擎是否能够支持的用户。

提供可批量选择模板的设置,并对所选择的模板进行批量转换,解决只能一张张转换的问题。

转换过程中同时进行是走新引擎还是老引擎的检测,明确是否支持及原因,报错是预期外情况,主要是做记录或用于反馈。

注:V1.0.3 及之后版本新增批量转换功能。

3.2 功能入口

安装插件之后,设计器菜单栏文件下,新增批量转换的入口批量格式转换。如下图所示:

Snag_f41bfb4.png

3.3 功能面板

功能面板主要由 3 部分组成,如下图所示:

Snag_f4f9c1a.png

3.3.1 模板选择区

模板选择区以树的形式展示工程内的模板,只能显示 cpt 模板(无法选择被锁定了的模板)。

注:批量转换模板的模板选择区也要受到远程设计权限的控制,无权限的模板不显示。

3.3.2 待转换模板区

1)在待转换模板区中,被勾选了的模板会在其中显示,如下图所示:

Snag_f4b8692.png

2)选择完成模板后点击「开始转换」即开始批量转换所选模板,模板按顺序进行转换。在原窗口基础上弹窗显示如下(进度条为真实进度):

Snag_f4d8e1a.png

注:未完成情况下点击中止则返回到原窗口,待转换模板区清空,已完成转换的模板显示在转换结果区。

3.3.3 转换结果区

点击模板转换区中已经完成转换的模板,可在下面的转换日志处看到模板对应的转换信息。

转换结果由 3 种,分别如下:

  • 转换成功走新引擎:转换日志为“转换成功”,模板右侧的提示图标为转换成功.png

  • 转换成功走老引擎:转换日志显示相应报错信息,模板右侧的提示图标为走老引擎.png

  • 转换失败:转换日志显示相应报错信息,模板右侧的提示图标为转换失败.png

注1:成功转换的数量包括转换成功走新引擎和转换成功走老引擎的兼容模式模板。

注2:批量转换中的转换逻辑和单个模板转换保持一致,转换后的文件将生成在原文件同一目录下,如已存在此文件则进行覆盖。

3.4 兼容性模式

当模板转换成了 cptx,但因为功能不支持所以要走老引擎时,其实是不影响用户使用的。

但是此时无法发挥新引擎对模板性能的优化,走老引擎的 cptx 模板会在模板名称后,显示兼容性模式(预览模板无额外变化,和原本一致),如下图所示:

Snag_f5b46cc.png

注1:兼容性模式是指模板能够支持正常的访问及编辑保存,但是无法使用新引擎对其性能进行优化。

注2:当兼容性模式的 cptx 模板在修改保存后不再有新引擎不支持功能,此时保存后兼容性模式的显示消失,变为正常的新引擎 cptx 模板。