1. 概述
本文介绍如何将 cpt 模板转换为 cptx 格式。
2. 单张模板转换
任意打开一张 cpt 模板，设计器上方工具栏会出现一个转换按钮，点击该按钮，弹出提示框信息转换成功，请查看设计器目录同名文件，即表示 cptx 成功生成。
注：cptx 生成后，不需要刷新目录树，cptx 模板会自动出现在同名 cpt 模板的同级目录下。
3. 批量转换
批量转换面向有较多老模板需要验证新引擎是否能够支持的用户。FineReport 提供可批量选择模板的设置，并对所选择的模板进行批量转换，解决只能一张张转换的问题。
转换过程中同时进行是走新引擎还是老引擎的检测，明确是否支持及原因，报错是预期外情况，主要是做记录或用于反馈。
3.1 功能入口
安装插件之后，设计器菜单栏文件下，新增批量转换的入口批量格式转换。如下图所示：
3.2 功能面板
功能面板主要由 3 部分组成，如下图所示：
3.2.1 模板选择区
模板选择区以树的形式展示工程内的模板，只能显示 cpt 模板（无法选择被锁定了的模板）。
注：批量转换模板的模板选择区也要受到远程设计权限的控制，无权限的模板不显示。
3.2.2 待转换模板区
1）在待转换模板区中，被勾选了的模板会在其中显示，如下图所示：
2）选择完成模板后点击「开始转换」即开始批量转换所选模板，模板按顺序进行转换。在原窗口基础上弹窗显示如下（进度条为真实进度）：
注：未完成情况下点击中止则返回到原窗口，待转换模板区清空，已完成转换的模板显示在转换结果区。
3.2.3 转换结果区
点击模板转换区中已经完成转换的模板，可在下面的转换日志处看到模板对应的转换信息。
转换结果由 3 种，分别如下：
转换成功走新引擎：转换日志为“转换成功”，模板右侧的提示图标为
转换成功走老引擎：转换日志显示相应报错信息，模板右侧的提示图标为
转换失败：转换日志显示相应报错信息，模板右侧的提示图标为
注1：成功转换的数量包括转换成功走新引擎和转换成功走老引擎的兼容模式模板。
注2：批量转换中的转换逻辑和单个模板转换保持一致，转换后的文件将生成在原文件同一目录下，如已存在此文件则进行覆盖。
4. 新分页预览
插件安装后，报表预览按钮下拉选择项新增新分页预览，如下图所示：
注：cpt 和 cptx 都可以使用新分页预览。
新分页预览跟分页预览的区别在于报表 Web 预览前端效果的改变，如下图所示：
目前 cpt 和 cptx 格式的模板分别在新分页预览和分页预览时，所使用的引擎和前端展现效果如下表所示：
注：目前 cptx 优先对分页预览做支持，所以 cptx 模板选择其他预览方式时，比如填报预览之类，由于暂未支持，效果和分页预览是一致的。
| 模板格式 | 分页预览 | 新分页预览 |
|---|---|---|
| cpt | 旧引擎，旧前端 | 旧引擎，新前端 |
| cptx | 新引擎，新前端 | 新引擎，新前端 |
5. 兼容性模式
当模板转换成了 cptx，但因为功能不支持所以要走老引擎时，其实是不影响用户使用的。
但是此时无法发挥新引擎对模板性能的优化，走老引擎的 cptx 模板会在模板名称后，显示兼容性模式（预览模板无额外变化，和原本一致），如下图所示：
注1：兼容性模式是指模板能够支持正常的访问及编辑保存，但是无法使用新引擎对其性能进行优化。
注2：当兼容性模式的 cptx 模板在修改保存后不再有新引擎不支持功能，此时保存后兼容性模式的显示消失，变为正常的新引擎 cptx 模板。