自定义 TFS 邮件警报格式

您可以自定义团队成员订阅的电子邮件通知或警报的格式。 当工作项、代码审阅、源代码管理文件和生成发生变化时,将发送这些通知。 若要自定义这些项的格式,您可以修改其关联的 XSL 转换文件。 此外,团队成员可以在 Team Web Access (TWA) 中为各种通知配置项目警报,并指定是要使用 HTML 格式还是纯文本格式。

警报格式转换文件存储在应用层服务器上的以下文件夹中:

Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Application 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 浏览器中查看工作项、变更集或文件。

要求

若要执行这些过程,必须是 Team Foundation 应用层服务器上 Administrators 安全组的成员。

修改工作项更改的警报格式

  1. 在应用层服务器上,打开下面的文件夹:

    Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Application Tier\TFSJobAgent\Transforms\1033

  2. 在记事本或其他某种文本编辑器中打开 WorkItemChangedEvent.xsl。

  3. 编辑文件以显示通知电子邮件中所需的消息。

    备注

    应为请求了纯文本消息的任何用户,对 WorkItemChangedEvent.plaintextXsl 进行类似更改。

  4. 保存 WorkItemChangedEvent.xsl 文件。

相关内容

请参见

概念

设置警报,发生更改时获得通知

其他资源

配置 SMTP 服务器以支持警报和反馈请求