1. 概述
1.1 版本
報表服務器版本 | JAR | 功能變動 |
---|---|---|
10.0 | - | - |
10.0 | 2019-12-05 | 「郵箱」支持包含符号#和& |
10.0 | 2020-06-08 | 新增「保留信息」選項 導入用戶時可保留已存在用戶的姓名、密碼、手機、郵箱信息 |
10.0 | 2020-08-31 | 導入「樹數據集」不清空之前添加/導入的用戶數據 |
10.0.10 | 2020-11-02 | 支持「多源用戶」,在同步用戶開啓狀态下可手動「導入用戶」,平台多種類型用戶可并存 |
10.0.12 | 2020-12-28 | 支持使用「文件數據集」導入用戶 用戶手機号支持綁定中國大陸、中國台灣、中國香港、土耳其、韓國、日本、新加坡、馬來西亞手機号 |
1.2 應用場景
管理員可将整理好的用戶信息表一次性導入數據決策系統。
管理員可多次導入用戶信息,部門,角色。
管理員可對導入的用戶進行編輯、禁用、删除
用戶希望平台用戶是由多個數據集組成的集合。
1.3 功能簡介
根據用戶信息表創建 服務器數據集 ,可将用戶信息導入到數據決策系統中。導入用戶信息後,若服務器數據集中新增用戶或删除用戶,需要再次手動導入。平台用戶可以是多個數據集組成的集合。
導入數據集時,如不切換加密方式,則不會清空之前添加/導入的用戶數據。
2. 準備用戶數據
導入的用戶數據來自服務器數據集,支持用戶部門有層級和無層級兩種。
用戶可根據自身用戶結構選擇其中一種。
2.1 無層級結構-SQL數據集
本節示例所用的用戶信息表部門職務間無層級結構。導入的用戶的部門都是并列在「所有部門」下,如下圖所示:
2.1.1 準備用戶信息表
準備一張用戶信息表,表結構如下圖所示:
點擊下載用戶信息表:導入用戶1.xlsx
注1:導入用戶時,用戶名、姓名、密碼爲必填項,此外内容可以不填。
注2:10.0.12 之前的報表工程版本,僅支持綁定中國大陸手機号,手機号無需加區号
10.0.12 及之後的報表工程版本,用戶手機号支持綁定中國大陸、中國台灣、中國香港、土耳其、韓國、日本、新加坡、馬來西亞手機号
中國大陸手機号可自行選擇是否加區号,其他地區手機号需要加區号。
2.1.2 創建服務器數據集
使用 Navicat 等第三方工具,将上表導入數據庫,并建立系統與該數據庫的 數據連接 。下文将以 FRDemo 數據庫爲例。
管理員登錄數據決策系統,點擊「管理系統>數據連接>服務器數據集」,創建「SQL數據集」。如下圖所示:
設置數據集名稱爲「導入用戶1」,數據連接選擇「FRDemo」,SQL 語句爲:
select * from 導入用戶1
2.2 無層級結構-文件數據集
注:10.0.12 及之後的報表工程,支持通過「文件數據集」導入用戶。
本節示例所用的用戶信息表部門職務間無層級結構。導入的用戶的部門都是并列在「所有部門」下,如下圖所示:
2.2.1 準備用戶信息表
準備一張用戶信息表,表結構如下圖所示:
點擊下載用戶信息表:導入用戶1.xlsx
注1:導入用戶時,用戶名、姓名、密碼爲必填項,此外内容可以不填。
注2:10.0.12 之前的報表工程版本,僅支持綁定中國大陸手機号,手機号無需加區号
10.0.12 及之後的報表工程版本,用戶手機号支持綁定中國大陸、中國台灣、中國香港、土耳其、韓國、日本、新加坡、馬來西亞手機号
中國大陸手機号可自行選擇是否加區号,其他地區手機号需要加區号。
注3:也可使用 TXT / XML 文件,設置方式請參見:文件數據集
2.2.2 創建服務器數據集
将該表保存在本地,或者上傳至報表工程的%FR_HOME%\webapps\webroot\WEB-INF\reportlets目錄下。
管理員登錄數據決策系統,點擊「管理系統>數據連接>服務器數據集」,創建「文件數據集」。如下圖所示:
設置數據集名稱爲「導入用戶-文件」,選擇上文準備的表格。
注1:若選擇服務器文件,則選擇報表工程的%FR_HOME%\webapps\webroot\WEB-INF\reportlets目錄下的文件。
若選擇本地文件,上傳後文件自動保存至報表工程的%FR_HOME%\webapps\webroot\WEB-INF\reportlets\excel目錄下。
注2:也可使用 TXT / XML / 遠程 URL 文件,支持數據集參數,設置方式請參見:文件數據集 。
2.3 有層級結構-樹數據集
本節示例所用的用戶信息表部門職務間有層級結構。導入用戶的部門如下圖所示:
2.3.1 準備用戶信息表
準備一張用戶信息表,表結構如下圖所示:
點擊下載用戶信息表:導入用戶2.xls
注1:導入用戶時,用戶名、姓名、密碼爲必填項,此外内容可以不填。
注2:10.0.12 之前的報表工程版本,僅支持綁定中國大陸手機号,手機号無需加區号
10.0.12 及之後的報表工程版本,用戶手機号支持綁定中國大陸、中國台灣、中國香港、土耳其、韓國、日本、新加坡、馬來西亞手機号
中國大陸手機号可自行選擇是否加區号,其他地區手機号需要加區号。
注3:同步用戶數據集時,若服務器數據集爲樹數據集 ,頂層機構的父機構應爲空值。如下圖所示的 Abby 用戶,fid 字段爲空。
2.3.2 創建SQL數據集
使用 Navicat 等第三方工具,将上表導入數據庫,并建立系統與該數據庫的 數據連接 。下文将以 FRDemo 數據庫爲例。
管理員登錄數據決策系統,點擊「管理系統>數據連接>服務器數據集」,創建「SQL數據集」。如下圖所示:
設置數據集名稱爲「導入用戶2」,數據連接選擇「FRDemo」,SQL 語句爲:
select * from 導入用戶2
2.3.3 創建樹數據集
管理員登錄數據決策系統,點擊「管理系統>數據連接>服務器數據集」,創建「樹數據集」。如下圖所示:
設置數據集名稱爲「導入用戶-有層級」,構建自數據集「導入用戶2」,原始标記字段爲「did」,父标記字段爲「fid」,如下圖所示:
3. 導入用戶
管理員登錄數據決策系統,點擊「管理系統>用戶管理>所有用戶」,點擊「導入用戶」,配置用戶信息。如下圖所示:
具體設置項如下所示:
3.1 保留信息
場景 | JAR 包 | 選擇 | 結果 |
---|---|---|---|
服務器數據集中存在、平台不存在的用戶 | - | - | 導入用戶時,将用戶信息更新到平台 |
服務器數據集中不存在、平台存在的用戶 | - | - | 導入用戶時,平台用戶信息保持不變 |
服務器數據集中存在、平台也存在的用戶 平台現有用戶來自「同步用戶」 | - | - | 若導入用戶與同步用戶存在相同數據,則重複數據導入失敗,不會更新。 |
服務器數據集中存在、平台也存在的用戶 平台現有用戶來自「手動添加用戶」或「導入用戶」 | 2020-08-31 之前 | - | SQL 數據集:
樹數據集:
|
2020-08-31 及之後 | 不勾選「保留信息」 | 用戶的姓名、手機、郵箱、密碼覆蓋更新 用戶的部門、角色增量更新,取原平台用戶和服務器數據集中用戶信息的并集 | |
勾選「保留信息」 | 用戶的姓名、密碼、手機、郵箱不更新 用戶的部門、角色增量更新,取原平台用戶和服務器數據集中用戶信息的并集 |
3.2 服務器數據集
選擇用戶信息對應的服務器數據集。
3.3 字段名稱
用戶名、姓名、密碼、部門名稱、職務名稱、角色名稱、手機、郵箱爲對應服務器數據集中的字段名稱。
注1:用戶管理配置的用戶郵箱信息與系統管理郵件配合使用,可通過 FineReport 平台直接發送郵件至不同平台用戶郵箱。
注2:部門、職務配置後無法恢複未選擇狀态,只能删除重新添加。
3.4 加密方式
注:導入成功後,用戶登錄密碼爲本文 2.1 節用戶信息表中的密碼,非 fine_user用戶表 中加密的密碼。
有兩種加密方式,「内置 SHA 加密」和「自定義密碼加密」。
1)内置 SHA 加密
數據決策系統采用 SHA256 加密方式,以保證密碼安全。
用戶通過接口自定義修改密碼後,會自動進行 SHA256 加密。
2)自定義密碼加密
自定義密碼加密,即自定義一個密碼加密類,加密方式在類中描述,并保存在%FR_Home%\webapps\webroot\WEB-INF\classes文件夾中。
數據決策系統會在用戶自定義加密算法的基礎上再進行 SHA256 二次加密,以保證密碼安全。
自定義加密示例詳情參見:簡單權限之密碼加密
注:自定義加密算法,必須繼承 AbstractPasswordValidator 類,并加上返回判斷明文密碼和密文密碼是否一緻結果方法才可行。
4. 用戶管理
管理員可對導入的用戶進行編輯、禁用、删除,詳情請參見 添加用戶 第 3、4、5 章