設定 SMTP 伺服器和自訂警示和意見要求的電子郵件

Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018-TFS 2013

注意

Azure DevOps Server 先前命名為 Visual Studio Team Foundation Server。

若要讓意見反應要求和警示運作,您必須為 Azure DevOps Server 設定 SMTP 伺服器,其先前命名 Visual Studio Team Foundation Server (TFS) 。 SMTP 伺服器支援下列功能:

必要條件

  • 若要執行這些程式,您必須是 Azure DevOps 應用層伺服器上 [ Administrators ] 安全性群組的成員。

設定 SMTP 伺服器

  1. 如果您不是 Azure DevOps 系統管理員,請 立即加入

  2. 從 [ 開始 ] 功能表開啟 Azure DevOps Server 管理主控台。 或者,在命令提示字元中,輸入 TFSMgmt.exe。 如需詳細資訊,請參閱 開啟管理主控台

  3. 選擇 [ 警示設定]。

    開啟應用程式層的電子郵件警示

    開啟應用程式層的電子郵件警示

  4. 啟用電子郵件警示,並指定 SMTP 伺服器以及要用於傳送電子郵件的電子郵件地址。

    啟用及設定 SMTP 伺服器

    啟用及設定 SMTP 伺服器

    如果部署已設定為使用 SSL,接下來請選取第二個核取方塊並輸入憑證。 另請參閱 使用安全通訊端層 (SSL) 設定 HTTPS

    提示

    • 請確定您的防火牆已設定為允許 Azure DevOps 與 SMTP 伺服器之間的通訊。
    • 必須將 SMTP 伺服器設定為允許匿名寄件者傳送電子郵件,或者您之前必須特別建立帳戶做為警示的電子郵件帳戶。 如果您指定 Azure DevOps 服務帳戶 (TFSService) ,此帳戶必須是具有傳送電子郵件許可權的網域帳戶。
    • 如果您使用系統帳戶 (例如 Network Service) 作為 Azure DevOps 服務帳戶,請將 [使用者] 和 [密碼] 欄位保留為空白,以進行 advanced 設定,並確定您的 SMTP 伺服器已設定為允許匿名使用者傳送郵件。 此外,請指定有啟用電子郵件的網域帳戶,以當做警示的電子郵件帳戶來使用。 如果沒有指定,就不會傳送電子郵件通知。
  5. 若要確認您的設定,請 開啟您的個人通知。 如果您最近啟用 SMTP 伺服器,您可能需要重新整理瀏覽器才能看到這個選項。

    開啟個人通知設定

    開啟個別警示

    建立警示,然後執行將會觸發警示的動作。

自訂電子郵件警示格式

您可以自訂小組成員訂閱之電子郵件通知或警示的格式。 當工作項目、程式碼檢閱、原始檔控制檔案和組建發生變更時,會傳送這些通知。 若要自訂其格式,您可以修改其關聯的 XSL 轉換檔案。 此外,您的小組成員可以在 Team Web Access (TWA) 中設定各種通知的 專案警示 ,並指定他們是否想要 HTML 或純文字格式。

警示格式轉換檔案儲存在應用程式層伺服器的下列資料夾中:

磁片磁碟機: \ %programfiles%\Azure DevOps Server 2019 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

磁片磁碟機: \ %programfiles%\Team Foundation Server 2018 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

磁片磁碟機: \ %programfiles%\Team Foundation Server 15.0 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

磁片磁碟機: \ %programfiles%\Team Foundation Server 14.0 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

磁片磁碟機: \ %programfiles%\Team Foundation Server 12.0 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

您可以使用 XML 編輯器(例如 Visual Studio)來變更任何轉換檔。 下表列出在傳送工作項目變更事件的電子郵件通知時所使用的兩個轉換檔案:

轉換檔 格式
WorkItemChangedEvent.xsl HTML 電子郵件
WorkItemChangedEvent.plaintextXsl 純文字電子郵件

事件服務使用 .xsl 和 plaintextXsl 檔案,將事件的 XML 資料轉換為電子郵件訊息。 您可以編輯 .xsl 檔,取得電子郵件通知的不同格式。 如果是 HTML 格式的電子郵件訊息,則所有事件的核心配置都儲存在 TeamFoundation.xsl 中。 您應該備份任何想要變更的檔案,然後測試變更。 進行變更之後,TFS 會在下次產生事件的通知時,使用修改的轉換。

注意

所發出電子郵件的內容,會從 TeamFoundation.xsl 檔案和上面的 WorkItemChangedEvent xsl 檔案自動產生。 不建議您修改 TeamFoundation.xsl 檔案。 如果您一定要修改此檔案的內容,則必須徹底地測試您的修改。 不正確修改此檔案,可能會造成 TFS 電子郵件警示失敗,並讓您無法在 Web 瀏覽器中檢視工作項目、變更集或檔案。

修改工作項目變更的警示格式

  1. 在您的應用層伺服器上,開啟您正在執行之版本的資料夾,例如:

    磁片磁碟機: \ %programfiles%\Azure DevOps Server 2019 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

    磁片磁碟機: \ %programfiles%\Team Foundation Server 2018 \ 應用程式 Tier\TFSJobAgent\Transforms\1033

  2. 在 [記事本] 或其他文字編輯器中開啟 WorkItemChangedEvent。

  3. 編輯該檔案,顯示要在電子郵件通知內出現的訊息。

    注意

    對於所有已要求純文字訊息的使用者,您應該進行類似的 WorkItemChangedEvent.plaintextXsl 變更。

  4. 儲存 WorkItemChangedEvent.xsl 檔。