Поделиться через


Настройка формата оповещений по электронной почте в TFS

Формат отправляемых по электронной почте уведомлений или оповещений, на которые подписываются члены команды, можно настраивать. Эти уведомления отправляются, когда в рабочих элементах, проверках кода, файлах системы управления версиями и сборках происходят изменения. Для настройки их формата достаточно внести изменения в соответствующие им файлы XSL-преобразования. Кроме того, члены команды могут настраивать в Team Web Access (TWA) оповещения проекта для различных уведомлений и задавать в качестве формата HTML или обычный текст.

Файлы преобразования формата оповещений хранятся в следующей папке на сервере уровня приложений:

Диск:\%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 и упомянутым выше XSL-файлам WorkItemChangedEvent.Не рекомендуется изменять файл TeamFoundation.xsl.Если изменяется содержимое этого файла, необходимо тщательно протестировать изменения.Неправильное внесение изменений в этот файл может привести к сбою отправки оповещений TFS по электронной почте, а также к невозможности просмотра рабочих элементов, наборов изменений или файлов в веб-браузере.

Требования

Для выполнения этих процедур необходимо быть членом группы безопасности Администраторы на сервере уровня приложений Team Foundation.

Изменение формата оповещений об изменениях рабочего элемента

  1. На сервере уровня приложений откройте следующую папку:

    Диск:\%programfiles%\Microsoft Team Foundation Server 12.0\Application Tier\TFSJobAgent\Transforms\1033

  2. Откройте файл WorkItemChangedEvent.xsl в Блокноте или другом текстовом редакторе.

  3. Отредактируйте файл, чтобы в уведомлении по электронной почте отображалось нужное сообщение.

    Примечание

    Аналогичные изменения следует внести в файл WorkItemChangedEvent.plaintextXsl для любых пользователей, запросивших сообщения в формате открытого текста.

  4. Сохраните файл WorkItemChangedEvent.xsl.

Связанное содержимое

См. также

Основные понятия

Получение уведомлений при внесении изменений

Другие ресурсы

Настройка SMTP-сервера на поддержку оповещений и запросов на отзывы