當前為10.0版本文檔,更多實例內容將在最新幫助文檔中展現,點選跳轉至 最新版幫助文檔

微信小程序集成

1. 概述

1.1 版本

報表服務器版本

10.0

1.2 功能簡介

幫助用戶實現将微信小程序集成。

示例演示的小程序爲「帆軟平台開發」小程序。

2. 申請小程序

若用戶已有非個人主體的小程序,本操作可忽略。

1)配置微信小程序,首先需要準備以下内容:

  • 一個郵箱地址賬号

  • 企業營業執照注冊号

  • 銀行卡

  • 管理員身份證手機

  • 準備好 https 協議的報表環境,端口使用默認的 443 端口

2)申請微信小程序:點擊申請

依次完成申請步驟:

1)填寫個人信息注冊

2)小程序激活

3)信息登記

注:由於個人類型的小程序不支持使用 web-view 組件,無法将H5項目以小程序的形式發布,必須使用非個人主體注冊。

4)完善小程序信息

3. 配置業務域名

1)首先小程序只支持 https 的域名,準備一個https工程。例如:https://www.finereporthelp.com/h5/decision

2)下面配置業務域名。進入微信公共平台,打開「開發管理>開發設置>業務域名」,點擊「下載校驗文件」。如下圖所示:

2021-02-22_17-00-10.png

将校驗文件放置到工程域名根目錄下,以 Tomcat 工程爲例,是在 %Tomcat%/webapps/ROOT路徑下,如下圖所示:

1600053766z9bS3C7B.jpg

添加業務域名,如下圖所示:

1613985241959927.png

存在問題可參考文檔:業務域名設置--校驗文件檢查失敗自查指引 

4. 代碼開發

代碼開發暫時只能依靠用戶自己開發,有兩種方式:

  • 通過微信開發者工具導入項目進行代碼修改:可以通過微信開發者工具看到小程序展示效果,比較推薦。

  • 通過其他編輯器修改代碼:需要開發者有一定代碼能力。

4.1 微信開發者工具代碼修改

1)下載并打開微信開發者工具:點擊下載

1600053766d3w1fHko.jpg

2)在「開發者管理>開發設置」頁面查看 AppID 和 AppSecret ,如下圖所示:

2021-02-22_10-16-14.png

3)在「微信開發者工具」中導入項目并填寫 appID 。如下圖所示:

2021-02-19_15-21-01.png

4)将項目中的 src 修改爲我們希望發布的 h5 項目的 url 地址。

2021-02-19_15-22-09.png

4.2 使用其他編輯器修改代碼

1)打開 project.config.json,填寫 appid 。如下圖所示

1600053766bvxY8qRR.jpg

2)将項目中的 src 修改爲我們希望發布的 h5 項目的 url 地址。

1600053766P5x8UW38.jpg

4.3 對設置的URL進行說明

  • 若客戶只是單純集成報表平台,僅實現能訪問報表環境即可,無需單點登錄。

則配置 url 爲:https://www.finereporthelp.com/webroot/decision

配置好以後小程序訪問時直接到 H5 登錄頁,需要用戶登錄,此場景無需查看第7、8節内容。

  • 若客戶設置了跨域單點集成,參見文檔:HTML5 單點登錄,這部分單點實現需要客戶自行開發。

則配置 url 爲:https://www.finereporthelp.com/webroot/login.html

配置好以後小程序訪問時可直接單點登錄訪問平台目錄,此場景無需查看第7、8節内容。

  • 若客戶想要利用微信插件實現微信集成單點,則具體微信集成配置步驟參見第7、8節内容

則配置 url 的格式參見本文 8.4 節。

5. 代碼上傳

代碼上傳有兩種方式,一種是通過可視化界面操作上傳代碼,一種是通過命令行進行代碼上傳。推薦使用第一種。

示例爲可視化頁面點擊「上傳」,如下圖所示:

2021-02-19_15-22-09.png

6. 小程序發布

進入小程序管理後台。打開「目錄管理>版本管理」找到「開發版本」中上傳的版本,提交審核。如下圖所示:

2021-02-23_10-54-14.png

若客戶想要利用微信插件實現微信集成單點。還需進行以下步驟:

7. 個人微信添加企業微信公衆号

1)管理員登錄企業微信管理平台,前往「通訊錄」,添加個人微信賬号。

2021-02-23_11-36-00.png

2)個人微信掃描二維碼加入企業。

1614058680223510.png

3)個人微信關注企業公衆号。

2021-02-23_14-26-12.png

4)取消勾選設置「 成員使用微信插件時需要使用企業微信客戶端」。

2021-02-23_14-26-12.png

5)顯示效果如圖所示:

1614062246168351.jpg    

點開後效果如下圖所示:

1614062246868904.jpg

8. 配置企業微信集成單點配置

請事先将報表環境配置好 https 環境,以及工程域名端口用默認的 443端口 訪問。例如:https://www.finereporthelp.com/h5/decision

8.1 新建應用

企業微信管理平台新建微信應用。

1614063650834050.jpg

注:這裏設置的「可見範圍」一定要選擇「部門/标簽」,不可選擇單個用戶,否則會導緻集成失敗。

1614063708548248.jpg

8.2 微信管理設置

8.2.1 安裝插件

報表平台上,插件管理安裝微信插件。

點擊下載插件:微信管理HTML5 移動端展現插件

設計器插件安裝方法請參見:設計器插件管理

服務器安裝插件方法請參見:服務器插件管理

注:微信/釘釘集成過程中,必須确保各版本相對應,詳情參見:微信、釘釘、H5、服務器、JAR 之間的依賴關系

8.2.2 添加報表服務器地址

在「微信管理>應用管理」頁面配置服務器地址。示例爲:https://www.finereporthelp.com/h5/decision

2021-02-23_16-00-39.jpg

8.2.3 新建微信應用

1)新建企業微信應用,輸入信息。

1614065974548747.jpg

2)新建應用需要使用的兩個參數,獲取如下:

打開「企業微信管理平台>我的企業>企業信息」獲取 CorpID 。

1614065555547844.jpg

打開「應用管理」獲取 Secret 。

8.2.4 同步與匹配用戶信息

在「微信管理>成員原理」,設置匹配方式,同步更新通訊錄,做好報表用戶和微信用戶之間的匹配關聯,具體匹配步驟參見:企業微信集成 第 4.3 節 成員管理。

8.2.5 一鍵配置

在「微信管理>應用快捷配置」,進行一鍵配置。

1614067697417709.jpg

8.3 進行域名校驗

打開微信管理平台,進行域名校驗。步驟參見文檔:微信集成後文件控件&文本控件掃碼無法使用

8.4 驗證集成是否成功

用戶直接在微信點擊企業微信号,打開進入目錄列表,無需登錄即說明配置正常。

1600053766p60wkRjI.jpg

8.4 生成小程序所需URL

詳情可參見 企業微信集成 4.2 節 應用快捷配置。

  • 實現單點登錄平台

打開「微信管理>應用快捷配置」,鏈接頁面選擇「決策平台」生成鏈接,複制獲取 URL 。

2021-02-23_16-20-06.jpg

  • 實現單點登錄打開某個模板

打開「微信管理>應用快捷配置」,鏈接頁面選擇「單個模板」生成鏈接,複制獲取 URL。

2021-02-23_16-19-27.jpg

附件列表


主題: 原簡體文檔
  • 有幫助
  • 沒幫助
  • 只是瀏覽

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉

反饋已提交

網絡繁忙