範本訊息事件

1.1 版本

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

1.2 應用場景

實時派送訊息至行動端，可以做到資訊的快速傳輸。無論是一線人員還是企業管理者，都可以隨時隨地透過手機瞭解業務狀態，提高資料的資訊價值。

• 員工進行資訊填報後，需要實時派送微信訊息，告知上級即時審批。

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

• 銀行登記 ETC 客戶後，需要將 ETC 客戶情況實時派送給領導，領導可以即時瞭解到 ETC 客戶資訊。

1.3 功能簡介

範本訊息事件支援行動端，填報成功後，即時派送訊息至 App、微信、釘釘，讓訊息的快速和精準傳遞變得更加簡單。

透過 範本訊息事件 插件、釘釘管理 插件、微信管理 插件，達成此功能。

1.4 注意事項

1）若微信釘釘整合要透過範本訊息事件插件傳送單個範本的連結。支援在整合插件中，直接生成單個範本存取連結，併為範本設定參數，在本文 3.1.2 節使用。不需要自己連接連結。

• 微信整合參見文檔：企业微信集成 2.2.3 節。

• 釘釘整合參見：釘釘管理插件 2.7.2 節。

2）範本訊息插件不支援派送至二級及以下部門使用者。

2.1 準備工作

安裝「 範本訊息事件 」插件。

若要派送至 App，需安裝並配置好 App ，參考文檔：APP下載安裝及使用

若要派送至微信釘釘，需安裝 釘釘管理 插件、微信管理 插件並綁定數據決策系統。建議設定好單點登入。

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

• 伺服器安裝插件方法參照：伺服器插件管理

2.2 範本訊息設定入口

1）右擊某一儲存格，選擇「元件設定>事件編輯」，新增事件中，增加「範本訊息」，如下圖所示：

2）點選「範本>範本 Web 屬性」，三種預覽方式下的「事件設定」中都增加「範本訊息」，如下圖所示：

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

3.1 新增範本 Web 屬性

開啟範本：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doctw\Form\LineForm\LineForm.cpt

點選「範本>範本 Web屬性」，選擇「填報頁面設定」，選擇「為該範本單獨設定」，新增「填報成功」事件，事件型別為「範本訊息」，如下圖所示：

3.1.1 設定訊息接收物件

範本訊息可以傳送給平台使用者、角色和機構部門，最終接收物件為三項的並集。

這裏以使用者做範例，傳送範本訊息給 Alice 。

注：可以輸入多使用者，以逗號隔開，例如：使用者1,使用者2,使用者3。

注：使用者、角色、部門不能同時為空。

3.1.2 填寫訊息內容

1）用戶端：

• 預設支援 PC 平台及 App 。使用者可透過安裝釘釘 / 微信管理插件，增加微信 / 釘釘用戶端。

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

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

2）連結：

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

• 表示範本訊息傳送後開啟的範本，該範本以「分頁預覽」的方式開啟。

• 連結不能為空。

注1：透過“生成釘釘連結”，參數名和參數值中都不能包含中文，否則 PC 端傳參會失敗。

注2：微信釘釘整合後，如果想生成範本派送連結，在「應用快捷配置」中「生成單個範本連結」，同時可以為範本新增設定參數。微信整合參見文檔：企业微信集成  2.2.3 節；釘釘整合參見：釘釘管理插件 2.7.2 節。

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 App

使用與 Alice 匹配的帳號登入 App ，可以在訊息中看到範本訊息事件通知。如下圖所示：

3.3.3 微信

使用與 Alice 匹配的帳號登入企業微信，可以看到綁定的應用傳送了範本訊息事件通知，點選即可查看。

3.3.4 釘釘

使用與 Alice 匹配的帳號登入釘釘，可以看到綁定的應用傳送了範本訊息事件通知，點選即可查看。