自訂工作項目變更的郵件警示格式
修改工作項目的相關 xsl 轉換檔案,就可以自訂電子郵件通知的內容和格式,而這則通知是通知您或您小組成員對工作項目進行的變更。您的小組成員可以在 Team Explorer中設定各種通知的「專案警示」(Project Alert),以及指定他們是要使用 HTML 還是純文字格式。例如,您可以產生專案、工作項目和組建事件的通知,也可以自訂傳送給 Team Foundation 使用者之通知的外觀及操作。
電子郵件通知轉換檔案是存放於應用程式層伺服器的下列資料夾中:
Drive:\Program Files\Microsoft Visual Studio 2010 Team Foundation Server\Application Tier\TFSJobAgent\Transforms
您可以使用 XML 編輯器 (例如 Visual Studio) 變更任何轉換檔案。下列清單是工作項目事件的兩個轉換檔案:
WorkItemChangedEvent.xsl |
HTML 電子郵件格式 |
WorkItemChangedEvent.plaintextXsl |
純文字電子郵件格式 |
事件服務使用 .xsl 和 plaintextXsl 檔案,將事件的 XML 資料轉換為電子郵件訊息。您可以編輯 .xsl 檔,取得電子郵件通知的不同格式。如果是 HTML 格式的電子郵件訊息,則所有事件的核心配置都是存放於 TeamFoundation.xsl 中。您應該備份任何想要變更的檔案,然後測試變更。在您進行變更之後,Team Foundation Server 會在下次產生事件的通知時使用修改的轉換。
注意事項 |
---|
所發出電子郵件的內容是從 TeamFoundation.xsl 檔案和上面的 WorkItemChangedEvent xsl 檔案自動產生。不建議您修改 TeamFoundation.xsl 檔案。如果您一定要修改此檔案的內容,則必須徹底地測試您的修改。不正確地修改此檔案可能會造成 Team Foundation 電子郵件警示失敗,並讓您無法在 Web 瀏覽器中檢視 Team Foundation 工作項目、變更集或檔案。 |
必要的使用權限
您必須是 Team Foundation 應用程式層伺服器上 [Administrators] 安全性群組的成員,才能執行這些程序。
若要編輯電子郵件範本以便針對工作項目變更傳送電子郵件通知
在應用程式層伺服器上,開啟下列資料夾:
Drive:\Program Files\Microsoft Visual Studio 2010 Team Foundation Server\Application Tier\TFSJobAgent\Transforms
使用 [記事本] 或一些其他文字編輯器,開啟 WorkItemChangedEvent.xsl。
注意事項 即使您已使用系統管理使用權限登入,還是必須以系統管理員的身分開啟 [記事本] 或一些其他編輯器,在執行 Windows Server 2008 的伺服器上執行此功能。若要以系統管理員身分開啟 [記事本],請按一下 [開始],以滑鼠右鍵按一下 [命令提示字元],再按一下 [以系統管理員身分執行]。如需詳細資訊,請參閱 Microsoft 網站:使用者帳戶控制。
編輯該檔案,顯示您要在電子郵件通知內使用的訊息。
注意事項 對於所有已要求純文字訊息的使用者,您應該進行類似的 WorkItemChangedEvent.plaintextXsl 變更。
儲存 WorkItemChangedEvent.xsl 檔。