1. 概述
1.1 版本
報表服務器版本 | JAR 包版本 | 微信管理插件版本 | 功能變動 |
|---|---|---|---|
| 10.0 | 2019-05-20 | V10.2.39 | 微信集成 |
| 10.0 | 2020-04-26 | V10.4.69 | 支持集群 |
| 10.0 | 2020-07-08 | V10.4.80 | 支持推送微信群消息 |
| 10.0 | 2020-08-03 | V10.4.97 | 支持是否解析參數值 |
1.2 功能簡介
安裝微信管理插件，可實現微信集成
在定時調度的輸出設置中，可以配置并推送微信消息
支持集成多個應用
注1：視頻教程參見：FineMobile—微信集成
注2：報表服務器必須是能夠訪問外網的，http 協議訪問端口推薦使用 80，https 協議訪問端口推薦使用 443
注3：微信管理插件支持代理服務器的配置，若有些用戶報表服務器配置在内網，則需要配置代理服務器地址，來進行微信的訪問，配置方法參考： 代理服務器配置
注4：微信集成下若使用「掃碼控件」、「文件控件」， 則要求單點登錄、且域名必須經過校驗。校驗方法請參考：「微信集成」文件控件&文本控件掃碼無法使用
2. 安裝插件
點擊下載插件：微信管理、HTML5 移動端展現插件
設計器插件安裝方法請參見：設計器插件管理
服務器安裝插件方法請參見：服務器插件管理
注：微信/釘釘集成過程中，必須确保各版本相對應，詳情參見：微信、釘釘、H5、服務器、JAR 之間的依賴關系
3. 新建應用
3.1 微信後台創建應用
1）管理員登錄企業微信後，在「應用管理」Tab 下點擊創建應用，如下圖所示：
2）上傳應用 logo，填寫應用名稱，應用介紹選填，設置可見範圍，設置完成後，點擊創建應用，如下圖所示：
若「可見範圍」不是部門而是單獨的微信用戶，那麽在平台「微信管理」的成員管理 Tab下會看不到用戶信息，因爲右邊的組織機構是空的，而用戶是屬於部門的，所以也是空的。
3.2 獲取微信應用參數
微信應用創建成功之後，需要關注兩個參數：
| 參數 | 含義 |
|---|---|
| CorpID | 企業 ID |
| Secret | 授權碼 |
3.2.1 CorpID
點擊我的企業，可查看企業ID，如下圖所示：
注：企業 logo 和簡稱可以修改。
3.2.2 Secret
1）點擊應用管理，點擊已創建的應用，如下圖所示：
2）可查看 Secret ，如下圖所示：
4. 平台微信管理
以管理員身份進入數據決策系統，點擊管理系統>微信管理，如下圖所示：
4.1 應用管理
4.1.1 報表服務器地址
必須設置報表服務器地址并保存，如果不設置，推送的時候可能會有問題，報表服務器地址示例：
http://域名:端口号/webroot/decision
注：請使用二級或二級以上域名，且需通過 ICP 備案，如果是 http 協議則訪問端口推薦使用 80，如果是 https 協議訪問端口推薦使用 443 。
輸入「報表服務器地址」，如下圖所示：
4.1.2 新建微信應用
點擊新建微信應用，輸入相應的企業應用名稱、CorpID、Secret，點擊确定，如下圖所示：
注：請填寫合乎規範的信息，企業應用名稱、CorpID、Secret 不可爲空，且應用名稱不可與其他應用的重複。
新建微信應用成功後，可對信息進行修改和删除，支持集成多個微信應用。如下圖所示：
4.2 應用快捷配置
4.2.1 微信代理跳轉
若報表服務器是配置在内網，則需要配置代理服務器地址，來進行微信的訪問。如下圖所示：
注1：若報表服務器配置在外網環境中，則不需要設置代理服務器地址。
注2：内網環境下微信集成，既需要設置正向代理，也需要設置反向代理，配置方法請參見：代理服務器配置
文本框中輸入正确的代理服務器地址，點擊測試連接，當連接成功，提示連接成功
4.2.2 主頁型應用快速配置
該功能即對微信主頁應用進行快速配置，配置的内容包括：可信域名、應用主頁鏈接、自定義菜單中設置一個菜單并添加主頁鏈接。
默認爲企業微信列表中的第一個，通過下拉框選擇需要配置的企業應用名稱，然後點擊一鍵配置，即可快速的配置主頁型應用，不需要用戶再到微信後台配置。如下圖所示：
1）若配置前，微信應用的主頁鏈接和菜單爲空，點擊一鍵配置按鈕後，直接進行快速配置。
進入微信應用，可信域名、應用主頁鏈接、自定義菜單中設置一個菜單并添加主頁鏈接已設置完成，如下圖所示：
4.2.3 生成微信鏈接
該功能可以生成訪問決策平台或某個模板的鏈接，通過 模板消息事件插件 可以将該鏈接推送給移動端用戶，用戶點開後即可訪問鏈接對應的内容。
1）生成訪問決策平台的微信鏈接
首先要選擇企業應用名稱，鏈接頁面下拉選擇決策平台，點擊生成鏈接後，點擊複制按鈕即可，如下圖所示：
2）生成訪問某個模板的微信鏈接
首先要選擇企業應用名稱，鏈接頁面下拉選擇單個模板，然後選擇一張模板，如果需要設置參數，可以點擊設置參數默認值進行設置，設置了參數後可以根據自己的需要選擇是否解析參數值，最後點擊生成鏈接，點擊複制按鈕即可，如下圖所示：
下面介紹下如何配置參數，如果想要使用設置參數默認值功能需要将插件更新到 10.4.76 版本，如果想要使用解析參數值功能需要更新到 10.4.97 版本。
設置參數默認值
點擊設置參數默認值後，如果模板本身有參數，那麽會顯示在下方，用戶可以設置參數的默認值，當然也可以點擊右上角新增參數，如下圖所示：
注：如果想删除參數，可以鼠标懸浮在參數列表的右邊，會出現删除按鈕。
解析參數值
假如一張模板a.cpt設置了一個參數date，其值爲公式${today}。
如果勾選了解析參數值，那麽點擊生成鏈接後，鏈接中會自動解析出今天的日期，也就是變成了：a.cpt&date=2020-11-03。
如果不想鏈接中直接解析參數，想要保留這個公式，可以取消勾選解析參數值，點擊生成鏈接後，公式保留：a.cpt&date=${today}。
注1：微信/釘釘集成鏈接必須勾選解析參數值，否則将導緻參數丢失。
注2：模板消息推送的消息鏈接可選擇不解析參數值，從而實現推送的公式計算。
4.2.4 申請域名校驗
步驟請參考文檔：「微信集成」文件控件&文本控件掃碼無法使用
4.2.5 新建微信群
JAR 包在 2020-07-08 及之後，且企業微信管理插件在 V10.4.80 及之後的版本，新增微信群設置。
用戶可使用應用新建微信群，自定義微信群名稱、群主和群成員，支持通過定時調度推送群消息到微信群。
詳情請參見：微信定時推送消息
4.3 成員管理
4.3.1 用戶匹配方式
可根據實際情況選擇一種用戶匹配方式。
用戶匹配方式：微信号匹配、手機賬号匹配、手動匹配、自定義匹配。「成員管理」頁面如下圖所示：
注：不管集成幾個微信應用，用戶統一進行管理。
1）微信号/手機賬号匹配
微信号匹配和手機号匹配展示列相同。
微信号匹配，則是微信成員名與報表裏用戶名匹配，爲一對一匹配。
手機号匹配，微信用戶的手機号是唯一的，但是報表用戶可以設置多個用戶有同一個手機号，此時的匹配邏輯爲哪個報表用戶先創建則匹配哪個
選擇這兩個匹配方式時，微信通訊錄信息展示：微信成員名、姓名、微信部門和微信成員手機号，如下圖所示：
2）手動匹配
當匹配方式爲手動匹配時，微信成員列表中多出「報表用戶名」一列信息，點擊出現下拉框，選擇相應的報表用戶名，進行手動匹配。如下圖所示：
注1：手動匹配時，報表用戶名支持選擇「不選」選項。
注2：手動匹配方式是用戶可以自由選擇與微信用戶匹配的報表用戶，可實現多個微信用戶匹配同一個報表用戶。
3）自定義匹配
即通過設置的服務器數據集，将對應數據列的微信用戶和報表用戶相匹配。若出現一個微信用戶對應了多個報表用戶的情況，默認匹配第一個報表用戶
選擇自定義匹配時，下方多出「匹配設置」項，選擇數據集、微信用戶名及報表用戶名，進行匹配。如下圖所示：
注：自定義匹配時，微信用戶列填寫的是微信用戶名。
4.3.2 微信通訊錄
點擊左側立即更新按鈕，立即更新通訊錄内容。也可設置定時更新，點擊自動更新按鈕，彈出設置框，設置更新頻率。如下圖所示：
注1：用戶匹配方式爲「微信号匹配」或「手機号匹配」時，如果用戶增删改報表用戶或者在後台增删改微信用戶，需要手動同步通訊錄更新。
注2：用戶匹配方式爲「手動匹配」或「自定義匹配」時，如果用戶增删改報表用戶或者在後台增删改微信用戶，無需更新同步。
5. 效果查看
5.1 企業微信
進入企業微信，點擊工作台，點擊FineReport 微信集成，該用戶會看到自己權限内可以查看的目錄，如下圖所示：
注：不建議在電腦版企業微信訪問移動端模板。
5.2 個人微信
普通微信可以掃描二維碼關注，在普通微信中即可出現一個企業号，可在企業号中查看主頁内容或收到推送消息。
1）在「通訊錄」 Tab 頁下點擊微工作台，點擊微信邀請，邀請關注，掃描二維碼，即可加入此企業。如下圖所示：
2）進入企業後，點擊應用，看到的内容與是否勾選在微信插件中始終進入主頁有關，如下圖所示：
若勾選在微信插件中始終進入主頁，收不到推送消息。
若不勾選在微信插件中始終進入主頁，同時需要在企業微信>我>設置>新消息通知裏關閉僅在企業微信中接受消息，則可收到推送消息，可以查看推送的内容和配置的自定義菜單，如下圖所示：
6. 微信單點登錄及權限控制
6.1 單點登錄
在手機企業微信 App 裏，您可以看到是不需要登錄 FS，直接可以查看結果的。而如果您使用手機浏覽器訪問相同的報表，您會發現，是需要登錄的。那是因爲，将微信成員與報表用戶關聯後，通過微信企業應用進入查看報表時，在 FineReport 後台，我們會使用微信的 OAuth2.0 接口進行用戶驗證并獲取對應微信成員名，然後關聯報表用戶并自動登錄，從而實現微信單點登錄。
6.2 權限控制
微信應用的菜單是在微信中管理，所以哪些成員可以看到的哪些報表這是在微信中控制。比如您可以創建多個報表應用，每個應用的查看權限選擇不同的成員或組。
用戶在微信中打開報表，是否可以查看報表的内容，以及可以查看的數據這部分是在 FR 報表端控制的，控制方法與 PC 端是一樣的，比如可以通過角色控制可查看的報表，可以在報表模板中通過 SQL 語句通過用戶名過濾來實現不同用戶看到的數據不同等等。
