1. 概述
使用者可以透過自訂的 URL 連結去啟動 App，不需要手動點選 App 圖示去啟動。
com.fr.finereport://?serverName=xxx&serverUrl=xxx
//or finereport://?serverName=xxx&serverUrl=xxx2. 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
| com.fr.finereport://?keepDemo=true |
| removeLogin | 版本在 V10.4.80 之前的 App，不支援該參數，等同於 false 版本在 V10.4.80 及之後的 App，支援該參數 是否遮蔽登入、登出等功能，不設定則預設為false
| com.fr.finereport://?removeLogin=true |
3. 範例一：保留登入登出
透過該方式開啟帆軟 App，保留「登入頁」和「註銷」功能，保留「修改密碼」、「手勢密碼」功能，保留「需求提交」、「bug 反饋」功能
如下圖所示：
3.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>
3.2 效果預覽
Android 裝置可直接在瀏覽器預覽該 HTML 檔案，iOS 裝置需下載 CHM 查看器再查看。
開啟 HTML 檔案，點選超連結，即可開啟帆軟 App，伺服器資訊自動新增到 App 伺服器列表中，自動登入後跳轉至伺服器首頁，如下圖所示：
注：若首次使用帆軟 App 登入該工程，或 App 端未勾選「自動登入」，則提示「帳號和密碼不匹配」，如下圖所示：
4. 範例二：免登入登出
版本在 V10.4.80 及之後的 App，支援使用 removeLogin 參數實現第三方免登入開啟帆軟 App。
透過該方式開啟帆軟 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=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>4.2 效果預覽
Android 裝置可直接在瀏覽器預覽該 HTML 檔案，iOS 裝置需下載 CHM 查看器再查看。
開啟 HTML 檔案，點選超連結，即可開啟帆軟 App，伺服器資訊自動新增到 App 伺服器列表中，免登入直接跳轉到對應範本位置/伺服器首頁，如下圖所示：
注1：以下四種情況下，會出現提示「啟動/登入異常，請交握管理者」。點選確定即可跳出帆軟 App。如下圖所示：
HTML 中未傳遞帳號密碼參數，首次使用帆軟 App 登入該工程
HTML 中未傳遞帳號密碼參數，之前使用過帆軟 App 登入該工程，但是未勾選自動登入
HTML 中傳遞的帳號密碼參數有誤
HTML 中傳遞的伺服器不存在
注2：登入逾時，提示「您很久未操作，登入已逾時，請重新登入」。點選確定即可跳出帆軟 App。
