历史版本37 :远程设计 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本
10.0

1.2 应用场景

FineReport 报表工程部署到远程服务器上,当需要对工程里面的模板进行设计修改时,可直接通过本地设计器连接到远程服务器上的工作目录进行工作,其修改直接保存在服务器端,对服务器上的模板起作用。

1.3 功能简介

远程设计分为三个部分,首先报表工程管理员对远程设计进行权限分配,然后工作人员在本地设计器上建立远程目录连接,最后工作人员对自己可操作的模板进行模板设计,如下图所示:


注1:不支持分级权限。
注2:登录优先级说明:Web 端登录是 a 用户,远程设计是 b 用户,预览时按照 b 用户处理。
注3:远程设计的 JAR 包和插件,必须要保持和服务器一致。

2. 操作步骤编辑

本章以本地连接 Tomcat 服务器 为例,介绍远程连接的步骤。

注:使用 FineReport 设计器切换工作目录到远程工程时,若提示远程连接失败,请查看日志是否提示没有注册「远程设计」功能点,具体请参见:平台未注册功能点表现形式 文档中的 2.9 节内容。

2.1 管理员连接远程服务器

1)在本地 FineReport 设计器中,点击文件>切换工作目录>其它,新建远程服务器,如下图所示:

13.png

2)配置远程目录,点击测试连接,连接成功后点击确定按钮,进入远程服务器。如下图所示:

注1:「主机位置」是主机名、端口、Web 应用、Servlet 的组合,填写主机名、端口、Web 应用、Servlet 后自动生成主机位置,或输入主机位置后自动生成其他四项。

注2:管理员进入远程服务器后,服务器 Tab 下没有「插件管理」选项。

1589796839659204.png

2.2 普通用户连接远程服务器

2.2.1 分配权限

参考本文 2.1 节内容,管理员进入远程服务器后,点击服务器>远程设计权限管理,添加用户并为用户分配模板权限,如下图所示:

注1:远程设计权限分配已独立出来,区别于平台的模板权限控制,请参见:远程设计模板权限管理

注2:设计器连接集群的负载均衡地址时,随机访问集群的任一节点。

15.png

2.2.2 普通用户本地配置远程目录

在本地 FineReport 设计器中,点击文件>切换工作目录>其它>Tomcat(远程服务器),输入 Alice 用户的账密,如下图所示:

注:平台内置用户的密码为 123456 。

1589798868870956.png

2.2.3 普通用户权限

远程设计包括对模板设计数据连接两方面的权限分配,数据连接的权限分配请参见: 远程设计之数据连接

  • 「模板设计权限」指将具体模板的编辑设计权限分配给不同的用户,使不同用户只能编辑其职责范围内的模板,以保证数据的安全性以及模板的稳定性。

  • 「模板设计权限」和「数据连接权限」是相辅相成的,如果只有模板设计权限,没有数据连接权限,会从界面上将数据连接屏蔽。

1)模板权限

Alice 可以对本文 2.2.1 节所分配权限下的目录及模板进行编辑删除重命名新建的操作。如下图所示:

17.png

若多个用户同时拥有同一文件夹的权限,为了保持数据一致性,如果用户 A 和用户 B 同时连接远程目录,A 删除了模板 M,由于用户 B 已经登录,不会自动刷新模板面板,当 B 打开 M 模板时,会提示模板被删除,无法打开

2)数据连接权限

Alice 连接远程目录时,其拥有 FRDemo 数据连接的使用权限,新建一个数据库查询,可看到 FRDemo 数据连接下所有数据表,但是数据连接配置按钮灰化不可用,以及菜单栏里面的服务器菜单项没有显示,这是因为普通用户对共享资源没有编辑权限。如下图所示:

注:以普通用户账密切换到远程工作目录时,不能查看「服务器」菜单项。

18.png

注:普通用户新建模板时,模板只能保存在被授予权限的非根目录下。否则报错:没有权限。如下图所示:

1589800587809706.png

3. IP 和端口配置外网映射编辑

IP 和端口配置外网映射可参考 Tomcat 下通过 IP 直接访问数据决策系统 ,参考文档中可通过访问http://localhost进入数据决策系统。

本章介绍服务器的 IP 和端口配置了外网映射时,远程连接的步骤。

3.1 管理员连接远程服务器

管理员远程连接步骤如下图所示:

注:FineReport 10.0 在远程设计时,必须要加「Servlet」(即 decison)。

1589792428519784.png

3.2 普通用户连接远程服务器

请参见本文 2.2 节内容。

4. https 认证的服务器编辑

注:若启用 https 或修改 https 配置(证书路径、https 密钥),必须重启设计器才能生效。

当服务器使用了 https 认证时,登录到远程服务器时,需要勾选启用https,然后再填写详细信息。如下图所示:

1589801381763104.png

注:证书路径和 https 密钥详细请查看 配置SSL 

1)证书路径:

点击右侧按钮选择到证书在本地的位置,根据实际情况选择.keysotre或者.jks等其他证书。

jks 证书的设置,证书可以复制到本地,选择本地 jks 存储路径,密钥使用 jks 生成时使用的密钥(可从 Tomcat 根目录/conf/server.xml 文件的SSLHostConfig标签中找到,certificateKeystoreFile是 jks 证书存储路径,certificateKeystorePassword 是 jks 证书密钥)。

2)https 密钥:

填写 ssl 认证中设置的 keystore 密码。

5. 注意事项编辑

2020-08-03 及之后的 JAR ,FineReport 设计器切换工作目录到开启数字签名认证的远程服务器,模板预览URL 后不用添加「&fine_digital_signature=值」,可直接预览模板。当远程设计用户退出时,模板预览 URL 随之失效。具体请参见 数字签名认证 第三章内容。