第三方唤醒数据分析 App

  • 文档创建者:文档助手1
  • 编辑次数:17次
  • 最近更新:Carly 于 2020-09-25
  • 1. 概述

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

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

    2. Scheme 参数简介

    注1:若用户需要打开某张模板,则必须要传至少 3 个参数serverNameserverUrlreportUrl

    注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 反馈功能。如下图所示:

    2020-07-02_10-59-15.png

    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 服务器列表中,自动登录后跳转至服务器首页,如下图所示:

    1.gif

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

    image.png

    5. 示例二:免登录登出

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

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

    2020-07-02_11-09-42.png

    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 服务器列表中,免登录直接跳转到对应模板位置/服务器首页,如下图所示:

    2.gif

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

    • HTML 中未传递用户名密码参数,首次使用帆软 App 登录该工程

    • HTML 中未传递用户名密码参数,之前使用过帆软 App 登录该工程,但是未勾选自动登录

    • HTML 中传递的用户名密码参数有误

    • HTML 中传递的服务器不存在

    image.png

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

    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!