模板消息事件插件

1.1 版本

注：安裝此插件必須開通 WebSocket 端口，否則平台消息提醒時不會彈出提示框，詳情參見文檔：WebSocket端口未開放提醒

1.2 應用場景

實時推送消息至移動端，可以做到信息的快速傳輸。無論是一線人員還是企業管理者，都可以随時随地通過手機了解業務狀态，提高數據的信息價值。

• 員工進行信息填報後，需要實時推送微信消息，告知上級及時審批。

• 領導填寫信息後，可以選擇不同責任人，責任人第一時間收到消息提醒和對應任務。

• 銀行登記 ETC 客戶後，需要将 ETC 客戶情況實時推送給領導，領導可以及時了解到 ETC 客戶信息。

1.3 功能簡介

模板消息事件支持移動端，填報成功後，即時推送消息至微信或釘釘，讓消息的快速和精準傳遞變得更加簡單。

通過 模板消息事件 插件、釘釘管理 插件、微信管理 插件，達成此功能。

設計器插件安裝方法參照 設計器插件管理 。

服務器安裝插件方法參照 服務器插件管理 。

安裝 釘釘管理 插件、微信管理 插件并綁定數據決策系統。建議設置好單點登錄。

安裝「模板消息事件」插件後，

1）右擊某一單元格，選擇控件設置>事件編輯，新增事件中，增加「模板消息」，如下圖所示：

2）點擊菜單模板>模板 Web 屬性，三種預覽方式下的「事件設置」中都增加「模板消息」，如下圖所示：

下面以一個簡單的實例進行說明，填報成功後，通知對應人查看模板。

3.1 添加模板 Web 屬性

打開模板：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Form\LineForm\LineForm.cpt

點擊模板>模板 Web屬性，選擇填報頁面設置，選擇「爲該模板單獨設置」，添加「填報成功」事件，事件類型爲「模板消息」，如下圖所示：

3.1.1 設置消息接收對象

模板消息可以發送給平台用戶、角色和機構部門，最終接收對象爲三項的并集。

這裏以用戶做示例，發送模板消息給 Alice 。

注：可以輸入多用戶，以逗号隔開，例如：用戶1,用戶2,用戶3。

注：用戶、角色、部門不能同時爲空。

3.1.2 填寫消息内容

1）客戶端：

• 默認支持 PC 平台。用戶可通過安裝釘釘 / 微信管理插件，增加微信 / 釘釘客戶端。

• 「微信／釘釘應用」選擇框下拉讀取微信／釘釘插件中配置的應用名稱。

• 不勾選微信／釘釘複選框時，微信 / 釘釘應用下拉框灰化不可編輯。

2）鏈接：

• 示例：decision/view/report?viewlet=LineForm.cpt&op=h5
  

• 表示模板消息發送後打開的模板，該模板以「分頁預覽」的方式打開。

• 鏈接不能爲空。

3）标題：模板消息發送的标題。

4）内容：消息提示内容。

5）封面圖：

• 選填建議尺寸 640*320，即寬高比 2：1，5M 以内 JPG、PNG 格式圖片。

• 選擇圖片後顯示樣式爲适應。

• 封面圖只在微信、釘釘中有效

如下圖所示：

注：鏈接、标題、内容中都支持輸入公式。使用參數時，參數默認值只能取到模板參數和全局參數，數據集參數默認值獲取不到

注：鏈接、标題、内容中如有中文或特殊字符（如+ \ /）等需要正确轉換

3.1.3 模板消息事件全局校驗

模板消息事件的設置需滿足以下條件，按照優先順序，只提示第一個錯誤信息。

3.2 決策系統中添加模板

設置完點擊事件後，将模板保存。啓動内置服務器。

在浏覽器中輸入http://localhost:8075/webroot/decision，登錄管理員賬号，打開 FineReport 報表平台。

點擊管理系統>目錄管理将報表 添加 到決策系統中。

打開模板，修改數據後，點擊提交，跳出「消息發送成功」提示，即将消息發送給 Alice，如下圖所示：

注：如果消息不在平台裏發送，單獨訪問模板時發送，取不到用戶時，跳出「消息發送失敗，無發送者」提示。如下圖所示：

3.3 效果查看

3.3.1 PC 端

登錄 Alice 的賬号，模板消息已經發送過來，點擊右上角，點擊我的消息>模板消息>處理，即可跳轉到對應模板。

或者直接點擊右下角新消息的處理，即可跳轉到對應模板。如下圖所示：

3.3.2 微信

使用與 Alice 匹配的賬号登錄企業微信，可以看到綁定的應用發送了模板消息事件通知，點擊即可查看。如下圖所示：

3.3.3 釘釘

使用與 Alice 匹配的賬号登錄釘釘，可以看到綁定的應用發送了模板消息事件通知，點擊即可查看。如下圖所示：