1. 概述
1.1 版本
报表服务器版本 | 功能变动 |
---|---|
11.0 | - |
11.0.6 | 新增「切换工作目录」校验 |
1.2 应用场景
工作目录,是指当前设计器所工作的工程。
比如说有 A,B,C 三个报表工程,用户只需安装 1 个设计器,通过切换工作目录在这三个工程中来回切换,修改对应工程下面的模板。
2. 新增工作目录
点击「文件>切换工作目录>其它......>+加号」,即可新增本地目录或远程服务器,如下图所示:
2.1 本地目录
如果要添加一个本地目录,可点击添加按钮,选择
,在右侧的文件目录中选中需要添加的目录路径即可,如下图所示:注:远程服务器不要使用「本地目录」的方式连接,尤其是在远程服务器工程已启动的情况下。否则会因为 FineDB 被占用,报错配置数据库出错。
2.2 远程服务器
如果需要操作的工作目录不在本地,而在服务器上。FineReport 支持远程设计功能,用户可直接使用设计器进行远程连接。
点击「」按钮,选择「远程服务器」,在「远程服务器配置」界面连接远程服务器。如下图所示:
具体操作流程可参考:远程设计
当多个用户都连接了同一个远程服务器进行设计时,同一时间内,远程服务器上的模板只能由一个用户编辑 。当一个用户打开模板的时候,其他用户将看到该模板已锁定且无法编辑,如下图所示:
当该用户关闭此模板,其它用户点击刷新后将恢复正常,模板不再显示已锁定且可正常编辑。
2.3 本地目录与远程服务器区别
2.3.1 本地目录
从官网下载安装的设计器已部署 Tomcat 服务器,可以直接使用,一般在使用本地默认的工作目录的设计器从「服务器>报表平台管理」处进入数据决策系统均为设计器内置的服务器。决策平台地址为:http://localhost:8075/webroot/decision 。如下图所示:
2.3.2 服务器决策平台
如果用户需要使用远程设计或者将 FineReport 报表工程部署到其他服务器上时,就不属于本地工程,是另外创建的一个工程,详情可参考:服务器部署原理 。此时需要通过设计器中的「文件>切换工作目录」来连接远程服务器,切换为远程工程服务器后,从设计器「服务器>报表平台管理」进入数据决策平台时地址为:http://ip:端口/webroot/decision。如下图所示:
3. 切换工作目录
点击菜单栏「文件>切换工作目录」,选择相应的报表目录,即可切换工作目录,如下图所示:
3.1 切换工作目录逻辑
当前设计器的模板存在未保存的操作时进行切换工作目录或关闭设计器时,设计器将会出现弹出提示:选择要储存的项目,如下图示所示:
勾选对应的模板并选择「确定」,当前模板将在工作目录 A 中关闭保存,并在工作目录 B 中再打开;选择「取消」,当前模板将在工作目录 A中关闭,并在工作目录 B 中再打开。
3.2 注意事项
打开设计器时,设计器默认切换在上次关闭设计器前设计器所在的工作目录。关闭设计器前建议切换回本地目录再关闭,否则下次打开设计器,设计器默认切换至远程服务器会影响其开启的速度。如遇到此情况,设计器无法启动,可以尝试删除缓存目录文件 FineReportEnv.xml,详细步骤可参考: 报表安装目录结构
4. 注意事项
1. FineReport 11 设计器禁止跨版本切换工作目录。例如 FineReport 11 连接 FineReport 10 版本的远程服务器会弹出报错,报错内容:不匹配的工作目录版本。如下图所示:
2. 低版本的设计器无法打开高版本设计器中开发的模板,例如 FineReport 10 设计器无法打开 FineReport 11设计器中开发的模板,会弹出报错,报错内容为:您当前打开的模板文件是由更高版本的设计器制作的,打开会有出错或丢失原有模板属性的风险。假如需要打开此模板请您将您的设计器升级至XXX。请您将设计器升级至 FineReport 11,升级请参考:10-11 兼容说明,10-11 升级工具 。
3. 禁止将设计器内置的 Tomcat 作为正式服务器使用,理由如下:
设计器占用内存和 cpu 资源
内置数据库性能差
设计器如果发现闪退等问题对服务器影响较大