第三方唤醒数据分析App- FineReport帮助文档 - 全面的报表使用教程和学习资料

文档创建者：文档助手1

编辑次数：18次

最近更新：知识库于 2022-12-13

1. 概述

用户可以通过自定义的 URL 链接去启动 App，不需要手动点击 App 图标去启动。

com.fr.finereport://?serverName=xxx&serverUrl=xxx
//or finereport://?serverName=xxx&serverUrl=xxx

2. Scheme 参数简介

注1：若用户需要打开某张模板，则必须要传至少 3 个参数「serverName」、「serverUrl」、「reportUrl」。

注2：直接打开 App 的调用方式为「com.fr.finereport://」或「finereport://」，本文以「com.fr.finereport://」为例进行演示

参数名称	说明	示例
serverName	服务器名称	com.fr.finereport://?serverName=服务器名称&serverUrl=http://IP:端口号/webroot/decision&reportUrl=模板路径&reportName=模板名称
serverUrl	服务器地址
reportUrl	模板地址，只能采用相对路径（文件夹开始的路径），且使用时必需指定服务器
reportName	模板名称
keepDemo	是否保留 demo 服务器，不设置则默认为 false true：保留 demo 服务器 false：不保留 demo 服务器	com.fr.finereport://?keepDemo=true
removeLogin	版本在 V10.4.80 之前的 App，不支持该参数，等同于 false 版本在 V10.4.80 及之后的 App，支持该参数是否屏蔽登录、登出等功能，不设置则默认为false true：屏蔽登录、登出等功能 false：保留登录、登出等功能	com.fr.finereport://?removeLogin=true

4. 示例一：保留登录登出

通过该方式打开帆软 App，保留「登录页」和「注销」功能，保留「修改密码」、「手势密码」功能，保留「需求提交」、「bug 反馈」功能。如下图所示：

4.1 新建 HTML 文件

新建 HTML1 文件，内容如下：

<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8">
		<title>第三方启动app登录测试</title>
	</head>
	<body>
		<p>com.fr.finereport://调用</p>
		<p><a href="com.fr.finereport://?keepDemo=true&removeLogin=false&serverName=Carly&serverUrl=http://172.16.0.200:8075/webroot/decision">点击跳转至帆软App</a></p>

		<p>finereport://调用</p>
		<p><a href="finereport://?keepDemo=true&removeLogin=false&serverName=Carly&serverUrl=http://172.16.0.200:8075/webroot/decision">点击跳转至帆软App</a>
		</p>
	</body>
</html>

4.2 效果预览

Android 设备可直接在浏览器预览该 HTML 文件，iOS 设备需下载 CHM 查看器再查看。

打开 HTML 文件，点击超链，即可打开帆软 App，服务器信息自动添加到 App 服务器列表中，自动登录后跳转至服务器首页，如下图所示：

注：若首次使用帆软 App 登录该工程，或 App 端未勾选「自动登录」，则提示「用户名和密码不匹配」，如下图所示：

5. 示例二：免登录登出

版本在 V10.4.80 及之后的 App，支持使用 removeLogin 参数实现第三方免登录打开帆软 App。

通过该方式打开帆软 App，取消「登录页」和「注销」功能，无「修改密码」、「手势密码」功能，无「需求提交」、「bug 反馈」功能。如下图所示：

5.1 新建 HTML 文件

新建 HTML1 文件，内容如下：

<!DOCTYPE html>
<html>
	<head>
		<meta charset="utf-8">
		<title>第三方启动app免登录</title>
	</head>
	<body>
		<p>com.fr.finereport://调用</p>
		<p><a href="com.fr.finereport://?keepDemo=true&removeLogin=true&serverName=Carly&serverUrl=http://172.16.0.200:8075/webroot/decision&reportUrl=GettingStarted.cpt&reportName=测试模板">点击跳转至帆软App</a></p>

		<p>finereport://调用</p>
		<p><a href="finereport://?keepDemo=true&removeLogin=true&serverName=Carly&serverUrl=http://172.16.0.200:8075/webroot/decision&reportUrl=GettingStarted.cpt&reportName=测试模板">点击跳转至帆软App</a>
		</p>
	</body>
</html>

5.2 效果预览

Android 设备可直接在浏览器预览该 HTML 文件，iOS 设备需下载 CHM 查看器再查看。

打开 HTML 文件，点击超链，即可打开帆软 App，服务器信息自动添加到 App 服务器列表中，免登录直接跳转到对应模板位置/服务器首页，如下图所示：

注1：以下四种情况下，会出现提示「启动/登录异常，请联系管理员」。点击确定即可退出帆软 App。如下图所示：

HTML 中未传递用户名密码参数，首次使用帆软 App 登录该工程
HTML 中未传递用户名密码参数，之前使用过帆软 App 登录该工程，但是未勾选自动登录
HTML 中传递的用户名密码参数有误
HTML 中传递的服务器不存在

注2：登录超时，提示「您很久未操作，登录已超时，请重新登录」。点击确定即可退出帆软 App。

上一篇：[App]iOS设备越狱环境检测

下一篇：[App]设置

有帮助
没帮助
只是浏览

售前咨询电话

400-811-8890转1

在线技术支持

请前往「服务平台」，选择「在线支持」

热线电话：400-811-8890转2

总裁办24H投诉

热线电话：173-1278-1526

文档反馈

鼠标选中内容，快速反馈问题

鼠标选中存在疑惑的内容，即可快速反馈问题，我们将会跟进处理。

不再提示

10s后关闭

第三方唤醒数据分析App