遠程設計

1. 版本資訊如下表所示。

2. 應用場景：FineReport 報表正式工程一般都部署在遠端伺服器上，當需要對工程裏面的範本進行設計修改時，可直接透過本地設計器連結到遠端伺服器上的工作區間進行範本設計。

3. 功能簡介：在設計器菜單欄【檔案】→【切換工作區間】處，支援切換到【遠端伺服器】。輸入伺服器資訊和報表工程中的使用者帳號密碼即可連結遠端伺服器。報表工程的超級管理者預設可遠程連結報表工程，非超管使用者預設不允許遠程連結報表工程，必須由超管使用者統一分配權限後方可遠程連結。

1

遠程設計功能點。

1. 場景描述：遠程設計連結前，需要先應答遠程的工程是否支援遠程設計功能點。

2. 解決方案：登入數據決策系統，查看http://IP:port/webroot/decision/remote/design/vt的返回值，若返回{"data":"success"}，代表支援，否則請聯絡銷售增購遠程設計功能點。

2

遠程設計權限。

1. 場景描述：非超管賬戶預設沒有遠程設計權限，遠程設計連結失敗。

2. 解決方案：超管登入數據決策系統，查看是否為使用者分配了遠程設計的相關權限，詳情請參見本文第四章。

3

JAR包版本。

1. 場景描述：本地設計器版本和遠端伺服器工程的JAR包版本不一致，會導致很多問題。

2. 解決方案：遠程連結時，若版本不匹配，會提示版本不一致，遠程設計時部分功能將受影響。建議及時更新，保證伺服器和設計器版本一致。

1. 開啟本地設計器：

   進入【檔案】→【切換工作區間】→【其它】。

   選擇【遠端伺服器】，建立遠端伺服器目錄。如下圖所示。

1

遠端伺服器。

1. 本地主機位置是報表伺服器工程的本地主機名、埠、Web應用、Servlet的組合。

2. 本地主機位置是進入報表伺服器對應的數據決策系統的 URL，形如http://IP:port/webroot/decision。

3. 使用者可填寫本地主機名、埠、Web應用、Servlet後自動生成本地主機位置，或輸入本地主機位置後自動生成其他四項。

4. 若報表工程配置了外網映射，或者配置了短域名訪問（形如http://IP，或http://域名/decision）。

5. 填寫【本地主機位置】資訊後，需要確認【Servlet】資訊是否為空，若為空需要手動填寫。如下圖1所示。

6. 管理者登入數據決策系統，進入【管理系統】→【系統管理】→【標準】，即可查看本工程的Servlet路徑名，一般為【decision】，如下圖2所示。

2

啟用https。

1. 當遠程報表伺服器使用了 https 認證時，登入到該遠端伺服器時，需要勾選啟用https，然後再填寫詳細資訊。如果伺服器所用憑證是從 CA 機構正式簽發，遠程設計時一般無需填寫憑證路徑和https金鑰。

   如果伺服器所用憑證為自簽章憑證，則需要填寫憑證路徑和https金鑰。如下圖1所示。

2. 憑證路徑：點擊右側按鈕選擇憑證在本地的位置，根據實際情況選擇 .keysotre 或者 .jks 等其他憑證。jks 憑證可以複製到本地，對應的憑證路徑可以為本地路徑，金鑰使用 jks 生成時使用的金鑰。憑證和祕鑰可從 Tomcat 根目錄/conf/server.xml 檔案的 SSLHostConfig 標籤中找到，certificateKeystoreFile 是 jks 憑證儲存路徑，certificateKeystorePassword 是 jks 憑證金鑰。

3. https 金鑰：填寫 ssl 認證中設定的 keystore 密碼。

注1：若啟用 https 或修改 https 配置（憑證路徑、https 金鑰），必須重啓設計器才能生效。

注2：憑證路徑和 https 金鑰如何生成可參考： CAS單點登入  。

3

決策系統帳號。

1. 連結遠端伺服器時，輸入數據決策系統中的帳號、密碼，驗證，連接成功即可切換到相應的遠端伺服器。如下圖1所示。

2. 登入優先說明：遠程設計登入的使用者，按照瀏覽器平台登入的權限進行繼承。例如：Web 端登入是 a 使用者，遠程設計是 b 使用者，預覽時按照 a 使用者處理。

3. 登入驗證：若帳號密碼輸入錯誤，或輸入被禁用的平台使用者帳號密碼，點擊【測試連結】時，跳出提示【連結失敗，遠程設計帳號密碼錯誤，錯誤代碼11300105】，此時點擊【顯示錯誤堆疊】，可查看詳細報錯，如下圖2所示。

4. 密碼策略：10.0.11 及之後版本的設計器，除驗證帳號密碼之外，還支援登入鎖定、弱密碼校驗、定期修改密碼、初始密碼強制更新等密碼安全策略。各功能的效果如表格所示。

注：若想使用新增的密碼安全策略功能，伺服器和設計器二者都要滿足 JAR 包版本要求。

1. 報表工程的超級管理者預設可遠程連結報表工程，非超管使用者預設不允許遠程連結報表工程，必須由超管使用者統一分配權限後方可遠程連結。遠程設計權限分為三種，如表格所示。

注：本文僅介紹權限分配的功能，超管為使用者分配遠程設計權限的具體操作範例請參見：遠程設計模板權限管理 。

1

遠程連結權限。

1. 分配遠程連結權限：

   點擊【伺服器】→【遠程設計權限管理】，超管可為某個使用者/某個角色分配遠程連結權限，本範例選擇使用者eoco。點擊【】。勾選使用者【eoco】，點擊【確定】，即代表將使用者eoco新增到了支援遠程連結的使用者列表中。如下圖2所示。

2. 若無遠程連結權限的使用者試圖遠程連結該工程，提示【連結失敗，遠程設計無權限，錯誤代碼：11300112】。如下圖2所示。

2

遠程設計範本權限。

1. 分配遠程設計範本權限：

   超管點擊【伺服器】→【遠程設計權限管理】，超管可為已經擁有遠程連結權限的某個使用者/某個角色分配範本設計權限，本範例選擇使用者eoco。選中使用者eoco。勾選需要讓eoco編輯的範本【決策報表入門.frm】，點擊【確定】，即代表使用者eoco擁有了該範本的查看、編輯、刪除、重命名權限。如下圖1所示。

2. 該使用者遠程連結工程後，能看到的範本只有自己有權限的範本。如下圖2所示。

3

資料連結權限。

1. 該權限需在數據決策系統中分配，詳情請參見：B03-05 權限設定-資料連結 。

2. 若不想對使用者的資料權限進行限制（即數據決策系統中不開啓【資料連結控制】），可忽略本節權限配置。

3. 但數據決策系統中若開啓了【資料連結控制】，則必然要為使用者配置相應的資料連結使用權限和伺服器資料集使用權限。如下圖1、圖2所示。

4. 普通使用者切換至遠端伺服器下，若管理者沒有為其分配資料連結權限，在製作報表時，將看不到資料連結，無法使用對應資料庫的資料，如下圖3所示。

1

超級管理者。

1. 超級管理者使用設計器遠程連結伺服器成功後。

2. 遠程設計時，不支援在設計器端使用【插件管理】功能 ，必須在數據決策系統中管理插件，詳情請參見：A11-18 伺服器-插件管理 。

3. 遠程設計時：超管點擊【伺服器】→【遠程設計權限管理】，可為已經擁有遠程連結權限的某個使用者/某個角色分配範本設計權限，本範例選擇使用者eoco。

   選中使用者eoco。

   勾選需要讓eoco編輯的範本【決策報表入門.frm】，點擊【確定】，即代表使用者eoco擁有了該範本的查看、編輯、刪除、重命名權限。如下圖所示。

2

非超管使用者。

1. 非超管使用者在遠程設計時，在設計器菜單欄無【伺服器】Tab，對應功能均不支援設定。

2. 功能區功能說明如表格所示。註：若使用者想將範本儲存到根目錄reportlets下，需要擁有所有目錄檔案夾和範本的使用權限，建議使用者把自己權限的範本放到一個檔案夾中，只開放一個檔案夾的權限就行。

3. 非超管使用者在遠程設計時，在檔案區顯示使用者有權限使用的範本。【】代表使用者有該檔案夾和檔案夾下所有範本的使用權限。【】代表使用者僅有該檔案夾中部分範本的使用權限，不完全擁有該檔案夾的使用權限。如下圖2所示。

4. 若多個使用者擁有同一檔案夾的權限，如果使用者 A 和使用者 B 同時連結遠程目錄，A 刪除了範本 M，使用者 B 在不知情的情況下開啟 M 範本，會提示【範本被刪除，無法開啟】，重新整理範本面板後可以看到該範本已經不存在。

5. 無論使用者有沒有資料連結的使用、管理權限，遠程連結時，非超管使用者在設計器端不可【定義資料連結】。

6. 非超管使用者遠程設計時，所有涉及選擇資料連結的地方，使用者只能使用自己權限下的資料連結，比如新增資料集時【資料庫查詢】、【儲存程式】等。如下圖3所示。

1. 2020-08-03 及之後的 JAR ，FineReport 設計器切換工作區間到開啓數字簽名認證的遠端伺服器，範本預覽URL 後不用新增【&fine_digital_signature=值】，可直接預覽範本。當遠程設計使用者跳出時，範本預覽 URL 隨之失效。