Configurer un serveur SMTP et personnaliser la messagerie pour les alertes et les demandes de commentaires

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

Notes

Azure DevOps Server a été précédemment nommé Visual Studio Team Foundation Server.

Pour que les demandes de commentaires et les alertes fonctionnent, vous devez configurer un serveur SMTP pour Azure DevOps Server, précédemment nommé Visual Studio Team Foundation Server (TFS). Le serveur SMTP prend en charge les fonctionnalités suivantes :

Prérequis

  • Pour exécuter ces procédures, vous devez être membre du groupe de sécurité administrateurs sur le serveur de couche application Azure DevOps.

Configurer un serveur SMTP

  1. Si vous n’êtes pas administrateur Azure DevOps, vous pouvez l’ajouter en tant que tel.

  2. Ouvrez la console d’administration Azure DevOps Server à partir du menu Démarrer . Ou, à l’invite de commandes, tapez TFSMgmt.exe. Pour plus d’informations, consultez ouvrir la console Administration.

  3. Choisissez paramètres d’alerte.

    Ouvrir des alertes par courrier électronique pour la couche application

    Ouvrir des alertes par courrier électronique pour la couche application

  4. Activez les alertes par courrier électronique et spécifiez le serveur SMTP et l'adresse de messagerie à utiliser pour envoyer des messages électroniques.

    Activer et configurer un serveur SMTP

    Activer et configurer un serveur SMTP

    Si votre déploiement est configuré pour utiliser SSL, cochez la deuxième case et entrez un certificat. Voir aussi configuration de HTTPS avec SSL (Secure Sockets Layer) (SSL).

    Conseil

    • Assurez-vous que votre pare-feu est configuré pour autoriser les communications entre Azure DevOps et votre serveur SMTP.
    • Votre serveur SMTP doit être configuré pour autoriser les expéditeurs anonymes à envoyer des messages électroniques, ou vous devez déjà avoir créé un compte à utiliser spécifiquement comme compte de messagerie pour les alertes. Si vous spécifiez le compte de service Azure DevOps (TFSSERVICE), ce compte doit être un compte de domaine autorisé à envoyer des courriers électroniques.
    • Si vous avez utilisé un compte système (tel que service réseau) comme compte de service Azure DevOps, laissez les champs utilisateur et mot de passe vides pour la configuration avancée, et assurez-vous que votre serveur SMTP est configuré pour autoriser les utilisateurs anonymes à envoyer des messages électroniques. Ou bien, spécifiez un compte de domaine activé par message électronique à utiliser comme compte de messagerie pour les alertes. Si vous ne le faites pas, les notifications par courrier électronique ne seront pas envoyées.
  5. Pour vérifier votre configuration, Ouvrez vos notifications personnelles. Vous devrez peut-être actualiser votre navigateur pour voir cette option si vous avez récemment activé un serveur SMTP.

    Ouvrir les paramètres de notification personnels

    Ouvrir des alertes individuelles

    Créez une alerte, puis exécutez une action qui déclenche l'alerte.

Personnaliser le format d'alerte par courrier électronique

Vous pouvez personnaliser le format des notifications par courrier électronique ou des alertes auxquelles les membres de l'équipe sont abonnés. Ces notifications sont envoyées lorsque des modifications sont apportées aux éléments de travail, aux révisions du code, aux fichiers du contrôle de code source et aux builds. Pour personnaliser leur format, vous pouvez modifier leurs fichiers de transformation XSL associés. En outre, les membres de votre équipe peuvent configurer des alertes de projet dans Team Web Access (TWA) pour différentes notifications et spécifier s’ils souhaitent un format HTML ou texte brut.

Les fichiers de transformation de format d'alerte sont stockés dans le dossier suivant du serveur de couche Application :

Lecteur: \ %ProgramFiles%\Azure DevOps Server 2019 \ application Tier\TFSJobAgent\Transforms\1033

Lecteur: \ %ProgramFiles%\Team Foundation Server 2018 \ application Tier\TFSJobAgent\Transforms\1033

Lecteur: \ %ProgramFiles%\Team Foundation Server 15 \ application Tier\TFSJobAgent\Transforms\1033

Lecteur: \ %ProgramFiles%\Team Foundation Server 14.0 \ application Tier\TFSJobAgent\Transforms\1033

Lecteur: \ %ProgramFiles%\Team Foundation Server 12.0 \ application Tier\TFSJobAgent\Transforms\1033

Vous pouvez utiliser un éditeur XML, tel que Visual Studio, pour modifier l’un des fichiers de transformation. Le tableau suivant répertorie les deux fichiers de transformation utilisés lorsque des notifications par courrier électronique sont envoyées pour les événements de modification d'éléments de travail :

Fichier de transformation Format
WorkItemChangedEvent.xsl Courrier électronique HTML
WorkItemChangedEvent.plaintextXsl courrier électronique en texte clair

Le service d'événement utilise les fichiers .xsl et .plaintextXsl pour transformer les données XML pour un événement en un message électronique. Modifiez le fichier .xsl pour obtenir une mise en forme différente pour la notification par courrier électronique. Pour les messages électroniques au format HTML, la disposition principale pour tous les événements est stockée dans TeamFoundation.xsl. Vous devez faire une copie de sauvegarde de tous fichiers que vous souhaitez modifier, puis tester vos modifications. Une fois vos modifications effectuées, TFS utilisera la transformation modifiée lors de la prochaine génération d'une notification pour un événement.

Notes

Le contenu des messages électroniques émis est généré automatiquement par le fichier TeamFoundation.xsl et les fichiers xsl WorkItemChangedEvent ci-dessus. La modification du fichier TeamFoundation.xsl n'est pas recommandée. Si vous modifiez le contenu de ce fichier, vous devez tester intégralement vos modifications. Les modifications incorrectes de ce fichier peuvent provoquer l'échec des alertes par courrier électronique de TFS et l'impossibilité d'afficher les éléments de travail, les ensembles de modifications ou les fichiers dans un navigateur Web.

Pour modifier le format d'alerte pour les modifications d'éléments de travail

  1. Sur votre serveur de couche application, ouvrez le dossier correspondant à la version que vous exécutez, par exemple :

    Lecteur: \ %ProgramFiles%\Azure DevOps Server 2019 \ application Tier\TFSJobAgent\Transforms\1033

    Lecteur: \ %ProgramFiles%\Team Foundation Server 2018 \ application Tier\TFSJobAgent\Transforms\1033

  2. Ouvrez WorkItemChangedEvent. xsl dans le bloc-notes ou un autre éditeur de texte.

  3. Modifiez le fichier de façon à afficher le message souhaité dans le courrier électronique de notification.

    Notes

    Vous devez apporter des modifications similaires au fichier WorkItemChangedEvent.plaintextXsl pour tous les utilisateurs qui ont demandé des messages en texte en clair.

  4. Enregistrez le fichier WorkItemChangedEvent.xsl.