1. 概述
1.1 版本
1.2 功能簡介
1.3 注意事項
https://xxx.xxx.com ；https://xxx/webroot/decision。
2. 環境準備
2.1 Teams環境準備
參照 Teams整合環境準備 完成準備工作。
2.2 插件下載
插件下載：點選下載
伺服器-設計器插件安裝方法請參見：伺服器-設計器插件管理
3. 平台配置
3.1 應用管理
3.1.1 報表伺服器
注：
1）請使用二級或二級以上域名，且需透過ICP備案，埠推薦使用80或443；
2）該位址將用於快捷配置中生成平台單點連結、範本單點連結，以及派送的結果連結，請確定該位址的域名和埠與Teams後臺網頁授權及JS-SDK中設定的可信域名一緻；
3）該位址需要外網可存取，位址格式為https://域名:埠/decision或https://域名:埠/decision，配置後請儲存
3.1.2 建立Teams應用
點選「應用程式註冊>概覽」，在Microsoft中找到如下表所示的內容，去決策平台進行對應配置：顯示名稱、App_id、租戶ID、App_Secret，填寫完成後點選「確定」，配置項說明及操作如下所示：
配置項
| 值 | 範例 |
|---|
| Teams應用名稱 | 自訂即可 | teams integreation test |
| App_id | Microsoft Azure中，應用程式註冊內找到「應用程式(用戶端) 識別碼」 | |
| 租戶ID | Microsoft Azure中，應用程式註冊內找到「目錄(租用戶) 識別碼」 | |
| App_Secret | Teams整合環境準備 中 2.3節 儲存的「用戶端密碼」 | |
建立Teams應用成功後，可對資訊進行修改和刪除，支援整合多個Teams應用。如下圖所示：
3.2 成員管理
可根據實際情況選擇一種使用者匹配方式。
使用者匹配方式：Teams帳號匹配、手動匹配、自訂匹配。「成員管理」頁面如下圖所示：
注1：不管整合幾個Teams應用，使用者統一進行管理。
注2：切換了匹配方式後，都需要點選儲存，同步一下使用者。
注3：匹配方式會直接關係到排程管理訊息派送中的使用者身份認證。
3.2.1 Teams帳號匹配
Teams帳號號匹配，則是Teams帳號與報表系統內使用者帳號匹配，為一對一匹配。
Teams通訊錄資訊展示：「姓名」、「Teams帳號」、「Teams成員ID」、「部門」，如下圖所示：
3.2.2 手動匹配
當匹配方式為「手動匹配」時，成員列表中多出「帳號」一欄資訊，點選出現下拉框，選擇相應的報表系統內帳號，進行手動匹配。如下圖所示：
注1：手動匹配時，報表帳號支援選擇「不選」選項。
注2：手動匹配方式是使用者可以自由選擇與Teams使用者匹配的報表使用者，可實現多個Teams使用者匹配同一個報表使用者。
3.2.3 自訂匹配
即透過設定的「伺服器資料集」，將對應資料列的Teams使用者和報表使用者相匹配。若出現一個Teams使用者對應了多個報表使用者的情況，預設匹配第一個報表使用者
選擇自訂匹配時，下方多出「匹配設定」項，選擇「資料集」、「Teams成員ID」及「帳號」，進行匹配。如下圖所示：
3.3 應用快捷配置
3.3.1 Teams代理跳轉
注：若報表伺服器配置在外網環境中，則不需要設定代理伺服器位址。
login.microsoftonline.comhttps://graph.microsoft.com/v1.0，如果
代理伺服器配置需要配置兩個代理URL：login.microsoftonline.com以及https://graph.microsoft.com/v1.0
3）平台配置如下圖所示：
正文框中輸入正確的「代理伺服器位址」，兩個「代理伺服器位址」之間用分號";"分隔，點選「測試連結」，提示「連結成功」並「儲存」。
3.2.2 生成Teams連結
注：生成連結的時候一定要選擇對應Teams應用名稱。
可以生成兩種Teams連結：一是用來單點登入到平台目錄的；二是用來單點登入到範本的。
1）單點登入到平台目錄
首先要選擇「Teams應用名稱」，連結頁面下拉選擇「決策平台」，點選「生成連結」後，點選「複製」按鈕即可，如下圖所示：
2）單點登入到範本
首先要選擇「Teams應用名稱」，連結頁面下拉選擇「單個範本」，然後選擇一張範本，如果需要設定參數，可以點選「設定參數預設值」進行設定，設定了參數後點選「解析參數值」，最後點選「生成連結」，點選「複製」按鈕即可，如下圖所示：
3.3.3 Teams Webhook
1）在teams中找到「應用」，搜尋尋找「Incoming Webhook」，按照如下操作完成Webhook的建立。
2）建立時可以選擇講Webhook新增到需要傳送Teams訊息的團隊以及頻道。
3）設定名稱，點選「建立」。
4）建立後會產生一個Webhook的URL，點選按鈕複製成功後，點選「完成」，至此該Incoming Webhook已經被成功新增到所選團隊中。
5）在決策平台的Teams管理介面，應用快捷配置選項卡下，點選新增Webhook，下拉框選擇所用的「Teams應用」，填寫「Webhook名稱」、「Webhook位址」，這裏的「Webhook位址」需要填寫上述第 4 步驟中複製獲取到的URL。
填寫完成後，點選「測試連結並儲存」
6）若測試連結成功，可以在teams團隊頻道中看到一條Webhook的測試訊息。
4. 整合步驟及場景
1）點選工具欄內的「+」，在跳出的應用選項卡中選擇「網站」。
2）自訂選項卡的名稱，URL部分輸入3.2.2節生成的單點登入到平台目錄的URL即可儲存。
3）點選剛剛建立的選項卡，即可查看FineReport決策系統，並且會根據 3.2節 成員管理的配置實現單點登入效果。
5. 排程管理派送Teams訊息
5.1 基本設定
需要選擇 Teams整合範例 中已經進行過Teams使用者匹配的平台使用者。
5.2 排程物件
注：需要勾選「除通用結果外，根據預設使用者組內的使用者單獨生成結果」，否則使用者無法正常按照決策平台權限設定看到報表結果，且無法使用提及功能，具體參見下述 5.4節 檔案處理。
5.3 調度週期
5.4 檔案處理
處理方式選擇「使用者端通知」，派送終端選擇「Teams通知」，點選下拉框，選擇需要派送的Teams Webhook
訊息型別支援連結訊息，圖文訊息，圖片訊息
連結訊息：報表連結的形式派送，且點選連結預覽報表時能自動單點到登入使用者
圖文訊息：fr伺服器必須要能被teams存取，且必須是https
圖片訊息：當前範本將作為快照傳送
檔案訊息：檔案以連結的形式傳送，點選連結可下載檔案
注：根據不同使用者生成不同結果的時候，派送訊息支援提及使用者（需要配置固定佔位，使用<at> </at>標籤包裹，佔位可以是任意字串，最終會被更換成平台帳號，例如：<at>Test</at>）
4）下面依次展示述連結訊息、圖文訊息、圖片訊息、檔案訊息
注：派送訊息的卡片展現可能會出現一些文字修剪，原因是雖然我們可以透過佈局和內容來影響訊息卡片的寬度，但在 Microsoft Teams 中，具體的卡片寬度可能受到Teams平台的限制和自動調整。Teams 可能會根據螢幕尺寸、裝置型別和顯示佈局等因素來自動調整卡片的寬度，以確定最佳的使用者體驗。因此，雖然可以進行一些調整，但無法完全控制和固定卡片的寬度。建議根據實際需求設計和編排卡片內容，確定卡片在不同裝置和螢幕上都能正常顯示和適應。
訊息型別
| 設定介面 | Teams效果 |
|---|
| 連結訊息 | | |
| 圖文訊息 | | |
| 檔案訊息 | | |
| 圖片訊息 | | |
