1. 概述
1.1 版本 報表伺服器版本 jar版本 插件版本 功能變動 11.0.9 2022-10-24 1.3.8
1.2 功能簡介 注:目前僅teams用戶端支援使用單點登入功能。
1.3 準備工作 1.3.1 環境準備 參照 Teams整合環境準備 完成準備工作。
1.3.2 Teams整合 參照 Teams整合範例 完成Teams整合。
2. 排程管理派送Teams訊息
2.1 基本設定 需要選擇 Teams整合範例 中已經進行過Teams使用者匹配的平台使用者。
2.2 排程物件 注:需要勾選「除通用結果外,根據預設使用者組內的使用者單獨生成結果」,否則使用者無法正常按照決策平台權限設定看到報表結果,且無法使用提及功能,具體參見下述 2.4節 檔案處理。
2.3 調度週期
2.4 檔案處理 處理方式選擇「使用者端通知」,派送終端選擇「Teams通知」,點選下拉框,選擇需要派送的Teams Webhook
訊息型別支援 連結訊息,圖文訊息,圖片訊息
連結訊息:報表連結的形式派送,且點選連結預覽報表時能自動單點到登入使用者
圖文訊息:fr伺服器必須要能被teams存取,且必須是https
圖片訊息: 當前範本將作為快照傳送
檔案訊息:檔案以連結的形式傳送,點選連結可下載檔案
注:根據不同使用者生成不同結果的時候,派送訊息支援提及使用者(需要配置固定佔位,使用<at> </at>標籤包裹,佔位可以是任意字串,最終會被更換成平台帳號,例如:<at>Test</at>)
4)下面依次展示述連結訊息、 圖文訊息、圖片訊息、檔案訊息
注:派送訊息的卡片展現可能會出現一些文字修剪,原因是雖然我們可以透過佈局和內容來影響訊息卡片的寬度,但在 Microsoft Teams 中,具體的卡片寬度可能受到Teams平台的限制和自動調整。Teams 可能會根據螢幕尺寸、裝置型別和顯示佈局等因素來自動調整卡片的寬度,以確定最佳的使用者體驗。因此,雖然可以進行一些調整,但無法完全控制和固定卡片的寬度。建議根據實際需求設計和編排卡片內容,確定卡片在不同裝置和螢幕上都能正常顯示和適應。
訊息型別 設定介面 Teams效果 連結訊息 圖文訊息 檔案訊息 圖片訊息
3. 範本訊息派送Teams訊息
範本訊息V1.8.0及之後版本適配teams webhook派送,升級範本訊息插件後,在配置介面可以看到webhook配置,並能按照配置進行訊息派送。
範本訊息事件完整功能簡介參考 範本訊息事件 。
注:設計器本地環境和伺服器環境都必須安裝Teams插件以及範本訊息事件插件且保持版本一致。
3.1 事件設定 1)新增一個範本訊息事件,填寫接收物件。
2)進入「應用快捷配置」,點選「單個範本」並選擇需要傳送的範本,點選「生成連結」後 ,複製「Teams連結」。
3)用戶端選擇「Teams派送」,「Teams應用」下拉框中選擇所用的應用。 「連結」處填寫上一步複製的「Teams連結」,「標題」、「內容」自訂即可。
注:內容部分可以使用 2.4節 所用到的佔位實現Teams提及功能。
3.2 效果查看
注:點擊連結後會在預設瀏覽器中打開,請保證該瀏覽器已登入同該Teams帳號綁定的決策平台用戶,否則將無法正常訪問連結內容。
4. 數據預警派送Teams訊息
數據預警V1.6.4及之後版本適配teams webhook派送。
數據預警完整功能簡介參考 數據預警插件使用說明 。
4.1 Webhook設定 1)參照 應用API配置 新增一個應用。
各項配置如下表:
配置項 說明 應用名稱 必填,使用者可自訂輸入應用名稱 應用說明 選填,使用者可自訂輸入應用說明 應用狀態 單選必選,預設選擇「啟用」狀態,不可取消選擇 請求地址URL 必填,請輸入Teams的Webhook URL
請求頭 必填,可參考下述配置填寫
鍵 值 Accept */* Connection keep-alive Accept-Encoding gzip,deflate,br Content-Type application/json
請求body 必填,按照teams官方文檔的格式填寫即可。此處提供2種常用格式,更多格式請參考 微軟官方文檔 。
1)派送連結
{ "type" : "message" , "attachments" : [ { "contentType" : "application/vnd.microsoft.card.adaptive" , "contentUrl" : null , "content" : { "type" : "AdaptiveCard" , "body" : [ { "type" : "Container" , "items" : [ { "type" : "TextBlock" , "text" : "${notifyContent}" , "wrap" : true } ] } ], "msteams" : { "width" : "Full" }, "$schema" : "http://adaptivecards.io/schemas/adaptive-card.json" , "version" : "1.5" } } ] }
2)派送訊息並提醒使用者
{"type" : "message" ,"attachments" : [ {"contentType" : "application/vnd.microsoft.card.adaptive" ,"content" : {"type" : "AdaptiveCard" ,"body" : [ {"type" : "TextBlock" ,"size" : "Medium" ,"weight" : "Bolder" ,"text" : "Sample Adaptive Card with User Mention" }, {"type" : "TextBlock" ,"text" : "Hi <at>Adele UPN</at>, <at>Adele Azure AD</at>" } ],"$schema" : "http://adaptivecards.io/schemas/adaptive-card.json" ,"version" : "1.0" ,"msteams" : {"entities" : [ {"type" : "mention" ,"text" : "<at>Adele UPN</at>" ,"mentioned" : {"id" : "AdeleV@contoso.onmicrosoft.com" ,"name" : "Adele Vance" } }, {"type" : "mention" ,"text" : "<at>Adele Azure AD</at>" ,"mentioned" : {"id" : "87d349ed-44d7-43e1-9a83-5f2406dee5bd" ,"name" : "Adele Vance" } } ] } } }] }
4.2 設定預警任務 1)點選「建立預警任務>預警通知>應用API通知 」,「派送終端 」選擇上一步建立的應用。
2)如需換列顯示,需要預警內容中手動添加換列符號 \n ,如下圖所示: