Anpassen des Formats von TFS-E-Mail-Benachrichtigungen

Sie können das Format von E-Mail-Benachrichtigungen oder Warnungen anpassen, die Teammitglieder abonnieren. Diese Benachrichtigungen werden gesendet, wenn Änderungen an Arbeitsaufgaben, Codeüberprüfungen, Quellcodeverwaltungsdateien und Builds vorgenommen werden. Um ihr Format anzupassen, können Sie ihre zugeordneten XSL-Transformationsdateien ändern. Außerdem können die Teammitglieder Projektwarnungen in Team Web Access (TWA) für verschiedene Benachrichtigungen konfigurieren und angeben, ob sie HTML oder Nur-Text als Format verwenden möchten.

Transformationsdateien für Warnungsformate werden im folgenden Ordner auf dem Anwendungsebenenserver gespeichert:

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

Zum Ändern der Transformationsdateien können Sie einen XML-Editor wie Visual Studio verwenden. In der folgenden Tabelle sind die beiden Transformationsdateien aufgeführt, die verwendet werden, wenn E-Mail-Benachrichtigungen für Arbeitsaufgabenänderungsereignisse gesendet werden:

WorkItemChangedEvent.xsl

Formatierung für E-Mails im HTML-Format

WorkItemChangedEvent.plaintextXsl

Formatierung für Nur-Text-E-Mails

Der Ereignisdienst wandelt die XML-Daten für ein Ereignis mithilfe der XSL- und der plaintextXsl-Dateien in eine E-Mail-Nachricht um. Bearbeiten Sie die XSL-Datei, um ein anderes Format für die E-Mail-Benachrichtigung zu erhalten. Für HTML-formatierte E-Mail-Nachrichten wird das Hauptlayout für alle Ereignisse in der Datei "TeamFoundation.xsl" gespeichert. Sie sollten eine Sicherungskopie der Dateien erstellen, die Sie ändern möchten, und die Änderungen anschließend testen. Nachdem Sie die Änderungen vorgenommen haben, verwendet TFS die geänderte Transformation bei der nächsten Erstellung einer Benachrichtigung für ein Ereignis.

Hinweis

Der Inhalt der ausgegebenen E-Mail-Nachrichten wird automatisch von der Datei "TeamFoundation.xsl" und den oben erwähnten WorkItemChangedEvent-XSL-Dateien generiert.Es wird nicht empfohlen, die Datei "TeamFoundation.xsl" zu ändern.Wenn Sie den Inhalt dieser Datei ändern, müssen Sie die Änderungen gründlich testen.Nicht korrekte Änderungen an dieser Datei können dazu führen, dass TFS-E-Mail-Benachrichtigungen einen Fehler verursachen und Sie Arbeitsaufgaben, Changesets oder Dateien nicht in einem Webbrowser anzeigen können.

Anforderungen

Um diese Schritte ausführen zu können, müssen Sie Mitglied der Administratoren-Sicherheitsgruppe auf dem Team Foundation-Anwendungsebenenserver sein.

So ändern Sie das Warnungsformat für Arbeitsaufgabenänderungen

  1. Öffnen Sie auf dem Anwendungsebenenserver folgenden Ordner:

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

  2. Öffnen Sie die Datei "WorkItemChangedEvent.xsl" in Editor oder einem anderen Text-Editor.

  3. Bearbeiten Sie die Datei so, dass in der Benachrichtigungs-E-Mail der gewünschte Inhalt angezeigt wird.

    Hinweis

    Nehmen Sie an der Datei "WorkItemChangedEvent.plaintextXsl" für alle Benutzer, die Nur-Text-Nachrichten erhalten, ähnliche Änderungen vor.

  4. Speichern Sie die Datei WorkItemChangedEvent.xsl.

Verwandter Inhalt

Siehe auch

Konzepte

Einrichten von Benachrichtigungen über Änderungen

Weitere Ressourcen

Konfigurieren eines SMTP-Servers zur Unterstützung von Warnungen und Feedbackanforderungen