Teams整合範例

1.1 版本

1.2 功能簡介

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

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

• 支援整合多個Teams應用

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

2.1 Teams環境準備

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

2.2 插件下載

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

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

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應用成功後，可對資訊進行修改和刪除，支援整合多個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已經被成功新增到所選團隊中。

注：此處webhook所使用的域名需要能在報表伺服器上ping通，詳情可參見 Teams整合環境準備 第1.3.1節

5）在決策平台的Teams管理介面，應用快捷配置選項卡下，點選新增Webhook，下拉框選擇所用的「Teams應用」，填寫「Webhook名稱」、「Webhook位址」，這裏的「Webhook位址」需要填寫上述第 4 步驟中複製獲取到的URL。

填寫完成後，點選「測試連結並儲存」

6）若測試連結成功，可以在teams團隊頻道中看到一條Webhook的測試訊息。

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

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

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