mapbox地圖更換私有token- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表服務器版本	插件版本	功能變更
11.0	V1.0	-

1.2 功能簡介

由於產品地圖註冊服務依賴於第三方廠商提供的公有token，為了提高系統的安全性和穩定性，產品進行了一次重要的安全升級。
為了確保系統使用體驗不會受到影響，本文提供透過插件方式將公有token改為私有token的解決方案。

注1：產品內寘的地圖URL為localhost的私有token，部署正式環境後請按如下步驟更換URL，否則將無法使用地圖服務，預覽後圖層將無法顯示。

注2：使用8、9版本的使用者無需參照本文檔更換私有token。使用10.0版本的使用者無需安裝插件。

2. 插件介紹

2.1 插件安裝

點選下載插件：插件下載

伺服器安裝插件方法請參見：伺服器插件管理

2.2 操作方法

2.2.1 mapbox地圖網址生成

注：如已獲得URL，可跳過本節操作步驟。

1. 點選「https://studio.mapbox.com/」進入mapbox studio 。登入後，如下圖所示：

地圖樣式可以選擇直接匯入，或自訂屬於自己的地圖樣式。

2. 點選「new style」按鈕，選擇「upload style」，上傳地圖樣式檔案：style_TW.zip。如下圖所示：

3. 點選「details」，選擇「share」，生成地圖網址連結。如下圖所示：

4. 點選「Production」，選擇「Third party > Fulcrum」,點選按鈕，複製連結。如下圖所示：

2.2.2 平台配置

1. 安裝插件後無需重啓，超管進入平台，點選「管理系統>地圖設定」。如下圖所示：

注1：未更新私有token狀態下，地理資訊tab的底部圖層為高德地圖，區域名顯示為簡體。

注2：使用10.0版本的使用者只需操作本節第三步，無需操作第1、2步。

2. 在紅框處輸入上文中複製的私有token 的地圖網址，輸入完成後回車並重新整理頁面。如下圖所示：

注：更新私有token後，地理資訊tab的底部圖層為mapbox地圖，區域名顯示為mapbox中配置的語言（英、日、繁、韓），語言配置請自行參考 mapbox幫助文檔。

3. 點選「自訂GIS圖層頁面」，歷史添加/修改過的自訂圖層會在此處顯示，更新地圖網址，更換後點選儲存。如下圖所示：

注：若未在期限內將地圖網址更新，則大屏中的地圖部分將無法顯示。

如需修改歷史內置的GIS圖層（mapbox、黑色、素雅、清新、午夜），需要通過以下2種方法進行手動更新：

注：以下2種方法請謹慎操作，操作前務必進行備份以免影響系統正常使用。

1）修改 db.script

在tomcat/webapps/webroot/WEB-INF/embed/finedb目錄下找到下db.script並打開，搜尋關鍵詞standardLayerMap ，找到MapLayerConf.standardLayerMap.圖層名.url的key，將對應value的值替換成自己的mapbox位址。儲存後重啟工程。

2）修改finedb

如果配置了外接資料庫，也可備份後對finedb中 fine_conf_entity 表進行修改。

查詢SQL：SELECT * FROM FINE_CONF_ENTITY WHERE ID Like '%standardLayerMap%'

找到MapLayerConf.standardLayerMap.圖層名.url的ID列，將對應的Value欄位值修改為自己的mapbox位址。儲存後重啟工程。