Teams整合範例及訊息派送

1.1 版本

1.2 功能簡介

• 安裝Teams integration 插件，可實現Teams 整合

• 在排程管理的匯出設定中，可以配置並派送Teams訊息

• 支援整合多個Teams應用

1.3 注意事項

注意事項 1 

報表伺服器一定是可以被外網存取的，且需要配置為https存取。

域名位址舉例：https://xxx.xxx.com ；https://xxx/webroot/decision。

注意事項 2 

報表伺服器需要能存取Teams伺服器。

若報表伺服器在內網，無法存取到Teams伺服器的話，支援正向代理配置。

2.1 Teams環境準備

參照 Teams整合環境準備 完成準備工作。

2.2 插件下載

插件下載：點選下載

伺服器-設計器插件安裝方法請參見：伺服器-設計器插件管理

3.1 應用管理

3.1.1 報表伺服器

必須設定「報表伺服器位址」並儲存，如果不設定，派送的時候可能會有問題，報表伺服器位址範例：https://域名:埠號/webroot/decision

注：

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代理跳轉

注：若報表伺服器配置在外網環境中，則不需要設定代理伺服器位址。

若伺服器是配置在內網，存取不到Teams伺服器，存取不到外網的時候需要配置「代理伺服器位址」。

若伺服器是配置在內網，且客戶伺服器和外網能互相存取到，網路正常，則「Teams管理>應用快捷配置>代理伺服器位址」，不需要填寫。

1）先判斷報表伺服器上，ping login.microsoftonline.com 以及https://graph.microsoft.com/v1.0，如果能 ping 通，代理伺服器配置這邊不用填寫。

2）ping不通，找兩個代理伺服器配置nginx正向代理，代理伺服器配置需要配置兩個代理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的測試訊息。

1）點選工具欄內的「+」，在跳出的應用選項卡中選擇「網站」。

2）自訂選項卡的名稱，URL部分輸入3.2.2節生成的單點登入到平台目錄的URL即可儲存。

3）點選剛剛建立的選項卡，即可查看FineReport決策系統，並且會根據 3.2節 成員管理的配置實現單點登入效果。

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效果
連結訊息
圖文訊息
檔案訊息
圖片訊息