Konfigurieren eines SMTP-Servers und Anpassen von e-Mail-Benachrichtigungen für Warnungen und Feedback Anforderungen

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Hinweis

Azure DevOps Server wurde zuvor als Visual Studio Team Foundation Server bezeichnet.

Damit Feedback Anforderungen und-Benachrichtigungen funktionieren, müssen Sie einen SMTP-Server für Azure DevOps Server konfigurieren, der zuvor Visual Studio Team Foundation Server (TFS) heißt. Der SMTP-Server unterstützt die folgenden Features:

Voraussetzungen

  • Zum Ausführen dieser Prozeduren müssen Sie Mitglied der Sicherheitsgruppe " Administratoren " auf dem Anwendungsebenenserver für Azure devops sein.

Konfigurieren eines SMTP-Servers

  1. Wenn Sie kein Azure devops-Administrator sind, lassen Sie sich jetzt hinzufügen.

  2. Öffnen Sie die Azure DevOps Server-Verwaltungskonsole über das Startmenü . Oder geben Sie an einer Eingabeaufforderung TFSMgmt.exe ein. Weitere Informationen finden Sie unter Öffnen der Verwaltungskonsole.

  3. Wählen Sie Warnungs Einstellungen aus.

    E-Mail-Warnungen für die Logikschichten öffnen

    E-Mail-Warnungen für die Logikschichten öffnen

  4. Aktivieren Sie E-Mail-Warnungen, und geben Sie den SMTP-Server und die E-Mail-Adresse an, die beim Senden verwendet werden sollen.

    SMTP-Server aktivieren und konfigurieren

    SMTP-Server aktivieren und konfigurieren

    Wenn die Bereitstellung für die Verwendung von SSL konfiguriert ist, aktivieren Sie das zweite Kontrollkästchen, und geben Sie ein Zertifikat ein. Siehe auch Einrichten von HTTPS mit Secure Sockets Layer (SSL).

    Tipp

    • Stellen Sie sicher, dass Ihre Firewall so konfiguriert ist, dass Sie die Kommunikation zwischen Azure devops und Ihrem SMTP-Server zulässt
    • Ihr SMTP-Server muss so konfiguriert sein, dass anonyme Absender E-Mails senden dürfen, oder Sie müssen zuvor ein Konto erstellt haben, das speziell als E-Mail-Konto für Warnungen dient. Wenn Sie das Azure devops-Dienst Konto (TFSService) angeben, muss dieses Konto ein Domänen Konto mit der Berechtigung zum Senden von e-Mails sein.
    • Wenn Sie ein Systemkonto (z. b. Netzwerkdienst) als Azure devops-Dienst Konto verwendet haben, lassen Sie die Felder Benutzer und Kennwort für die erweiterte Konfiguration leer, und stellen Sie sicher, dass der SMTP-Server so konfiguriert ist, dass anonyme Benutzer e-Mails senden können. Alternativ können Sie ein E-Mail-aktiviertes Domänenkonto spezifizieren, um dieses als E-Mail-Konto für Warnungen zu verwenden. Andernfalls werden keine E-Mail-Benachrichtigungen gesendet.
  5. Öffnen Sie Ihre persönlichen Benachrichtigungen, um Ihre Konfiguration zu überprüfen. Sie müssen möglicherweise den Browser aktualisieren, um diese Option anzuzeigen, wenn Sie einen SMTP-Server gerade erst aktiviert haben.

    Persönliche Benachrichtigungseinstellungen öffnen

    Einzelne Warnungen öffnen

    Erstellen Sie eine Warnung, und führen Sie dann eine Aktion aus, die die Warnung auslöst.

Anpassen des Formats von 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 Projekt Warnungen in Team Web Access (TWA) für verschiedene Benachrichtigungen konfigurieren und angeben, ob HTML oder nur-Text als Format verwendet werden soll.

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

Laufwerk: \ %ProgramFiles%\azure DevOps Server 2019 \ Application tier\tfsjobagent\transforms\1033

Laufwerk: \ %ProgramFiles%\Team Foundation Server 2018 \ Application tier\tfsjobagent\transforms\1033

Laufwerk: \ %ProgramFiles%\Team Foundation Server 15,0 \ Application tier\tfsjobagent\transforms\1033

Laufwerk: \ %ProgramFiles%\Team Foundation Server 14,0 \ Application tier\tfsjobagent\transforms\1033

Laufwerk: \ %ProgramFiles%\Team Foundation Server 12.0 \ Application tier\tfsjobagent\transforms\1033

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

Transformationsdatei Format
WorkItemChangedEvent.xsl HTML-e-Mail
WorkItemChangedEvent.plaintextXsl Klartext-e-Mail

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.

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

  1. Öffnen Sie auf dem Anwendungsebenenserver den Ordner für die Version, die Sie ausführen, z. b.:

    Laufwerk: \ %ProgramFiles%\azure DevOps Server 2019 \ Application tier\tfsjobagent\transforms\1033

    Laufwerk: \ %ProgramFiles%\Team Foundation Server 2018 \ Application tier\tfsjobagent\transforms\1033

  2. Öffnen Sie workitemchangedebug. xsl im Editor oder in 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.