自定义工作项更改的邮件警报格式
通过修改与工作项相关联的 xsl 转换文件,可以针对您或团队成员对工作项进行的更改自定义电子邮件通知的内容和格式。团队成员可以在团队资源管理器中配置项目警报以用于各种通知,并指定要使用 HTML 格式还是纯文本格式。例如,可以为项目、工作项和生成事件生成通知,并且可以自定义发送给 Team Foundation 用户的通知的外观。
电子邮件通知转换文件存储在应用层服务器上的以下文件夹中:
驱动器:\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 应用层服务器上**“管理员”**安全组的成员。
编辑发送工作项变更的电子邮件通知所用的电子邮件模板
在应用层服务器上,打开下面的文件夹:
驱动器:\Program Files\Microsoft Visual Studio 2010 Team Foundation Server\Application Tier\TFSJobAgent\Transforms
在记事本或其他某种文本编辑器中打开 WorkItemChangedEvent.xsl。
说明 即使您是使用管理权限登录的,也必须以管理员身份打开记事本或其他某种编辑器,才能在运行 Windows Server 2008 的服务器上执行此功能。若要以管理员身份打开记事本,请单击“开始”,右击“命令提示符”,然后单击“以管理员身份运行”。有关更多信息,请参见 Microsoft 网站:用户帐户控制。
编辑文件以显示通知电子邮件中所需的消息。
说明 应为请求了纯文本消息的任何用户,对 WorkItemChangedEvent.plaintextXsl 进行类似更改。
保存 WorkItemChangedEvent.xsl 文件。