1. 概述
2. 申請小程序
若用戶已有非個人主體的小程序,本操作可忽略。
1)配置微信小程序,首先需要準備以下内容:
一個郵箱地址賬号
企業營業執照注冊号
銀行卡
管理員身份證手機
準備好 https 協議的報表環境,端口使用默認的 443 端口
2)申請微信小程序:點擊申請
依次完成申請步驟:
1)填寫個人信息注冊
2)小程序激活
3)信息登記
注:由於個人類型的小程序不支持使用 web-view 組件,無法将H5項目以小程序的形式發布,必須使用非個人主體注冊。
4)完善小程序信息
3. 配置業務域名
1)首先小程序只支持 https 的域名,準備一個https工程。例如:https://www.finereporthelp.com/h5/decision
2)下面配置業務域名。進入微信公共平台,打開「開發管理>開發設置>業務域名」,點擊「下載校驗文件」。如下圖所示:
将校驗文件放置到工程域名根目錄下,以 Tomcat 工程爲例,是在 %Tomcat%/webapps/ROOT路徑下,如下圖所示:
添加業務域名,如下圖所示:
存在問題可參考文檔:業務域名設置--校驗文件檢查失敗自查指引
4. 代碼開發
代碼開發暫時只能依靠用戶自己開發,有兩種方式:
通過微信開發者工具導入項目進行代碼修改:可以通過微信開發者工具看到小程序展示效果,比較推薦。
通過其他編輯器修改代碼:需要開發者有一定代碼能力。
4.1 微信開發者工具代碼修改
1)下載并打開微信開發者工具:點擊下載
2)在「開發者管理>開發設置」頁面查看 AppID 和 AppSecret ,如下圖所示:
3)在「微信開發者工具」中導入項目并填寫 appID 。如下圖所示:
4)将項目中的 src 修改爲我們希望發布的 h5 項目的 url 地址。
4.2 使用其他編輯器修改代碼
4.3 對設置的URL進行說明
若客戶只是單純集成報表平台,僅實現能訪問報表環境即可,無需單點登錄。
則配置 url 爲:https://www.finereporthelp.com/webroot/decision
配置好以後小程序訪問時直接到 H5 登錄頁,需要用戶登錄,此場景無需查看第7、8節内容。
若客戶設置了跨域單點集成,參見文檔:HTML5 單點登錄,這部分單點實現需要客戶自行開發。
則配置 url 爲:https://www.finereporthelp.com/webroot/login.html
配置好以後小程序訪問時可直接單點登錄訪問平台目錄,此場景無需查看第7、8節内容。
則配置 url 的格式參見本文 8.4 節。
5. 代碼上傳
代碼上傳有兩種方式,一種是通過可視化界面操作上傳代碼,一種是通過命令行進行代碼上傳。推薦使用第一種。
示例爲可視化頁面點擊「上傳」,如下圖所示:
6. 小程序發布
進入小程序管理後台。打開「目錄管理>版本管理」找到「開發版本」中上傳的版本,提交審核。如下圖所示:
若客戶想要利用微信插件實現微信集成單點。還需進行以下步驟:
7. 個人微信添加企業微信公衆号
1)管理員登錄企業微信管理平台,前往「通訊錄」,添加個人微信賬号。
2)個人微信掃描二維碼加入企業。
3)個人微信關注企業公衆号。
4)取消勾選設置「 成員使用微信插件時需要使用企業微信客戶端」。
5)顯示效果如圖所示:
點開後效果如下圖所示:
8. 配置企業微信集成單點配置
請事先将報表環境配置好 https 環境,以及工程域名端口用默認的 443端口 訪問。例如:https://www.finereporthelp.com/h5/decision
8.1 新建應用
企業微信管理平台新建微信應用。
注:這裏設置的「可見範圍」一定要選擇「部門/标簽」,不可選擇單個用戶,否則會導緻集成失敗。
8.2 微信管理設置
8.2.1 安裝插件
報表平台上,插件管理安裝微信插件。
點擊下載插件:微信管理、HTML5 移動端展現插件
設計器插件安裝方法請參見:設計器插件管理
服務器安裝插件方法請參見:服務器插件管理
注:微信/釘釘集成過程中,必須确保各版本相對應,詳情參見:微信、釘釘、H5、服務器、JAR 之間的依賴關系
8.2.2 添加報表服務器地址
在「微信管理>應用管理」頁面配置服務器地址。示例爲:https://www.finereporthelp.com/h5/decision
8.2.3 新建微信應用
1)新建企業微信應用,輸入信息。
2)新建應用需要使用的兩個參數,獲取如下:
打開「企業微信管理平台>我的企業>企業信息」獲取 CorpID 。
打開「應用管理」獲取 Secret 。
8.2.4 同步與匹配用戶信息
在「微信管理>成員原理」,設置匹配方式,同步更新通訊錄,做好報表用戶和微信用戶之間的匹配關聯,具體匹配步驟參見:企業微信集成 第 4.3 節 成員管理。
8.2.5 一鍵配置
在「微信管理>應用快捷配置」,進行一鍵配置。
8.3 進行域名校驗
打開微信管理平台,進行域名校驗。步驟參見文檔:微信集成後文件控件&文本控件掃碼無法使用
8.4 驗證集成是否成功
用戶直接在微信點擊企業微信号,打開進入目錄列表,無需登錄即說明配置正常。
8.4 生成小程序所需URL
詳情可參見 企業微信集成 4.2 節 應用快捷配置。
實現單點登錄平台
打開「微信管理>應用快捷配置」,鏈接頁面選擇「決策平台」生成鏈接,複制獲取 URL 。
實現單點登錄打開某個模板
打開「微信管理>應用快捷配置」,鏈接頁面選擇「單個模板」生成鏈接,複制獲取 URL。