Teams整合訊息派送- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表伺服器版本	jar版本	插件版本	功能變動
11.0.9	2022-10-24	1.3.8	支援排程管理派送Teams訊息支援範本訊息派送Teams訊息支援數據預警派送Teams訊息（數據預警插件需為V1.6.4及之後版本）

1.2 功能簡介

安裝Teams integration 插件，可實現Teams 整合
在排程管理的匯出設定中，可以配置並派送Teams訊息
支援整合多個Teams應用

注：目前僅teams用戶端支援使用單點登入功能。

功能當前處於內測招募階段，如需試用本文介紹的功能，請填寫問卷或者直接掃描下方 QRCODE 報名，對於符合試用要求的用戶，報名後將會有工作人員聯絡您。

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"
}
}
]
}
}
}]
}

<at>Adele UPN</at>是佔位符，可自訂佔位符中的內容。
id為FineDB庫FINE_TEAMS_USER_RELATION表中，使用者對應的teamsUser欄位的值。

連結FineDB可參考：報表內建FineDB資料庫。

4.2 設定預警任務

1）點選「建立預警任務>預警通知>應用API通知」，「派送終端」選擇上一步建立的應用。

預設在teams內不換列顯示，可能會導致內容顯示不全，如圖所示：

2）如需換列顯示，需要預警內容中手動添加換列符號 \n ，如下圖所示：

換列效果查看：

已經是第一篇

已經是最後一篇

有幫助
沒幫助
只是瀏覽
圖片不清晰
用語看不懂
功能說明看不懂
操作說明太簡單
內容有錯誤

中文（简体） English 日本語

中文（繁體）

文檔回饋

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

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

不再提示

10s後關閉

Teams整合訊息派送