Paramètres de messagerie dans le mode natif de Reporting Services ( Gestionnaire de configuration du serveur de rapports)

  • Article

SQL Server Reporting Services comprend une extension de remise d’e-mails que vous pouvez utiliser pour distribuer les rapports par e-mail. Selon la configuration de l'abonnement de messagerie électronique, la distribution peut inclure une notification, un lien, une pièce jointe ou un rapport incorporé. L’extension de remise de courrier électronique fonctionne avec votre technologie de serveur de messagerie existante, qui utilise un serveur ou un redirecteur SMTP (Simple Mail Transfer Protocol). Le serveur de rapports se connecte à un serveur SMTP par le biais de bibliothèques CDO (Collaboration Data Objects) (cdosys.dll) fournies par le système d'exploitation.

L'extension de remise du courrier électronique par le serveur de rapports n'est pas configurée par défaut. Vous utilisez le Gestionnaire de configuration du serveur de rapports pour effectuer une configuration minimale de l’extension. Pour définir des propriétés avancées, modifiez le fichier RSReportServer.config. Si vous ne pouvez pas configurer le serveur de rapports afin qu'il utilise cette extension, vous pouvez remettre les rapports dans un dossier partagé à la place. Pour plus d’informations, consultez Remise par partage de fichiers dans Reporting Services.

Exigences de configuration

La remise du courrier électronique par le serveur de rapports est implémentée sur des objets de données de collaboration (CDO) et nécessite un serveur SMTP local ou distant, ou encore un redirecteur SMTP. Le protocole SMTP n'est pas pris en charge sur tous les systèmes d'exploitation Windows. Si vous utilisez l'édition Itanium de Windows Server 2008, le protocole SMTP n'est pas pris en charge. Pour plus d'informations sur les options de configuration fournies par le biais des objets CDO, consultez Configuration CoClass.

Le compte d’authentification configuré doit être autorisé à envoyer des e-mails sur le serveur SMTP. L'extension de remise du courrier électronique utilise l'encodage UTF-8 dans les pièces jointes électroniques. Vous ne pouvez pas modifier l’encodage. L’extension de rendu HTML prend uniquement en charge UTF-8.

Remarque

L'extension par défaut de la remise du courrier électronique ne prend pas en charge la signature numérique et le chiffrement des messages sortants.

Options de configuration

Avant d'utiliser la remise du courrier électronique par le serveur de rapports, vous devez définir les valeurs de configuration fournissant des informations sur le mode d'utilisation du serveur SMTP. Le tableau suivant décrit les deux façons dont vous pouvez configurer un serveur de rapports pour la remise :

Méthode Description
Gestionnaire de configuration service Web Report Server Utilisez le Gestionnaire de configuration du serveur de rapports si vous spécifiez simplement un serveur SMTP et un compte d’utilisateur ayant l’autorisation d’envoyer des e-mails. Ce sont les paramètres minimum requis pour configurer l'extension de remise du courrier électronique par le serveur de rapports.
Facultatif
Fichier rsreportserver.config		 Utilisez un éditeur de texte pour configurer des paramètres supplémentaires si vous utilisez un serveur SMTP local ou que vous limitez la remise de courrier électronique à des hôtes spécifiques. Le fichier rsreportserver.config contient tous les paramètres de configuration pour la remise du courrier électronique par le serveur de rapports. Pour plus d’informations sur la recherche et la modification des fichiers de configuration, consultez Modifier un fichier de configuration Reporting Services (rsreportserver.config).

Remarque

Les paramètres du courrier électronique pour le serveur de rapports dépendent du CDO. Pour plus d’informations sur les paramètres spécifiques, consultez la documentation de production de CDO.

Configurer l’e-mail du serveur de rapports à l’aide du Gestionnaire de configuration du serveur de rapports

  1. Démarrez le Gestionnaire de configuration du serveur de rapports, puis connectez-vous à l’instance du serveur de rapports.

  2. Accédez aux Paramètres de messagerie.

  3. Dans Adresse de l’expéditeur, entrez l’adresse électronique à utiliser dans le champ De : d’un message généré. Spécifiez un compte d'utilisateur qui a l'autorisation d'envoyer des e-mails depuis le serveur SMTP. La valeur indiquée pour l’Adresse de l’expéditeur est enregistrée dans le champ <From> du fichier rsreportserver.config.

  4. Dans Serveur SMTP, spécifiez le serveur ou la passerelle SMTP à utiliser. La valeur indiquée pour le Serveur SMTP est enregistrée dans le champ <SMTPServer> du fichier rsreportserver.config. Cette valeur peut être :

    • Une adresse IP
    • Un nom NetBIOS d’un ordinateur sur votre intranet d’entreprise
    • Nom de domaine complet

  5. Dans la liste déroulante Authentification spécifiez le mode d’authentification auprès du serveur SMTP.

    Type d’authentification Description
    Aucune authentification Se connecte anonymement au serveur de messagerie.

    Cette option définit <SendUsing> sur la valeur 2 et <SMTPAuthenticate> sur la valeur 0 dans le fichier rsreportserver.config.
    Nom d’utilisateur et mot de passe (de base) Spécifiez un nom d’utilisateur et un mot de passe pour la connexion au serveur de messagerie. Vous pouvez également sélectionner Utiliser une connexion sécurisée pour recourir à une connexion chiffrée à votre serveur de messagerie.

    Cette option définit <SendUsing> sur la valeur 2 et <SMTPAuthenticate> sur la valeur 1 dans le fichier rsreportserver.config. Sélectionner Utiliser une connexion sécurisée définit SMTPUseSSL sur True. Nom d’utilisateur est défini dans <SendUserName> sous forme chiffrée. Mot de passe est défini dans <SendPassword> sous forme chiffrée.
    Compte de service Report Server (NTLM) Utilise le compte de service que vous avez spécifié pour le serveur de rapports. Si vous utilisez le compte de service du serveur de reports pour l’authentification, vérifiez que le compte de service dispose des autorisations Envoyer en tant que sur le serveur SMTP.

    Cette option définit <SendUsing> sur la valeur 2 et <SMTPAuthenticate> sur la valeur 2 dans le fichier rsreportserver.config.

  6. Sélectionnez Appliquer.

Si vous souhaitez ajuster d’autres champs pour la configuration de la messagerie, utilisez le fichier rsreportserver.config, comme décrit dans les sections suivantes.

Exemple de configuration du courrier électronique pour Report Server

L'exemple suivant illustre les paramètres dans le fichier rsreportserver.config pour un serveur SMTP distant. Pour plus d’informations sur les descriptions des paramètres et les valeurs valides, consultez Fichier de configuration Rsreportserver.config.

<RSEmailDPConfiguration>
     <SMTPServer>mySMTPServer.Adventure-Works.com</SMTPServer>
     <SMTPServerPort></SMTPServerPort>
     <SMTPAccountName></SMTPAccountName>
     <SMTPConnectionTimeout></SMTPConnectionTimeout>
     <SMTPServerPickupDirectory></SMTPServerPickupDirectory>
     <SMTPUseSSL>False</SMTPUseSSL>
     <SendUsing>2</SendUsing>
     <SMTPAuthenticate>2</SMTPAuthenticate>
     <From>my-rs-email-account@Adventure-Works.com</From>
     <EmbeddedRenderFormats>
          <RenderingExtension>MHTML</RenderingExtension>
     </EmbeddedRenderFormats>
     <PrivilegedUserRenderFormats></PrivilegedUserRenderFormats>
     <ExcludedRenderFormats>
          <RenderingExtension>HTMLOWC</RenderingExtension>
          <RenderingExtension>NULL</RenderingExtension>
          <RenderingExtension>RGDI</RenderingExtension>
     </ExcludedRenderFormats>
     <SendEmailToUserAlias>True</SendEmailToUserAlias>
     <DefaultHostName></DefaultHostName>
     <PermittedHosts>
          <HostName>Adventure-Works.com</HostName>
          <HostName>hotmail.com</HostName>
     </PermittedHosts>
     <SendUserName></SendUserName>
     <SendPassword></SendPassword>
</RSEmailDPConfiguration>

Options de configuration pour la définition du champ À : dans un message

Les abonnements définis par l’utilisateur qui sont créés selon les autorisations accordées par la tâche Gérer les abonnements individuels contiennent un nom d’utilisateur prédéfini qui repose sur le compte d’utilisateur de domaine. Quand l’utilisateur crée l’abonnement, le nom du destinataire dans le champ À : est configuré automatiquement à l’adresse de la personne qui crée l’abonnement, au moyen du compte d’utilisateur de domaine.

Si vous utilisez un redirecteur ou un serveur SMTP qui utilise des comptes de messagerie différents du compte d'utilisateur de domaine, la remise des rapports échouera lorsque le serveur SMTP tentera de remettre le rapport.

Pour contourner ce problème, modifiez les paramètres de configuration qui permettent aux utilisateurs d'entrer un nom dans le champ À :

  1. Ouvrez RSReportServer.config dans un éditeur de texte.
  2. Affectez à <SendEmailToUserAlias> la valeur False.
  3. Définissez <DefaultHostName> au nom DNS (Domain Name System) ou à l'adresse IP du redirecteur ou du serveur SMTP.
  4. Enregistrez le fichier .

Options de configuration pour le service SMTP distant

La connexion entre le serveur de rapports et le serveur ou redirecteur SMTP est déterminée par les paramètres de configuration suivants :

Setting Description
<SendUsing> Spécifie une méthode pour l’envoi de messages. Vous pouvez choisir entre un service SMTP réseau ou un répertoire de collecte du service SMTP local. Pour utiliser un service SMTP distant, définissez cette valeur sur 2 dans le fichier RSReportServer.config.
<SMTPServer> Spécifie le serveur ou le redirecteur SMTP distant. Cette valeur est obligatoire si vous utilisez un serveur ou un redirecteur SMTP distant.
<From> Définit la valeur qui s’affiche sur la ligne De : d’un e-mail. Cette valeur est obligatoire si vous utilisez un serveur ou un redirecteur SMTP distant.

Le tableau suivant présente les autres paramètres utilisés pour le service SMTP distant :

Remarque

Vous n’avez pas besoin de spécifier ces valeurs, sauf si vous souhaitez remplacer celles par défaut.

Setting Description
<SMTPServerPort> Configuré pour le port 25 par défaut.
<SMTPAuthenticate> Spécifie le mode de connexion du serveur de rapports au serveur SMTP distant. La valeur par défaut est 0 (ou aucune authentification). Dans ce cas, la connexion est effectuée par un accès anonyme. En fonction de la configuration de votre domaine, il est possible que le serveur de rapports et le serveur SMTP soient obligés d'être des membres du même domaine.

Pour envoyer des e-mails aux listes de distribution limitée (par exemple, les listes de distribution qui acceptent des messages entrants uniquement à partir de comptes authentifiés), définissez <SMTPAuthenticate> sur 1 ou 2. Si vous le définissez sur 1, vous devez définir <SendUserName> et <SendPassword>. La meilleure pratique consiste à modifier ce paramètre via le Gestionnaire de configuration du serveur de rapports, car il chiffre les valeurs pour <SendUserName> et <SendPassword>.

Configurer un service SMTP distant pour le serveur de rapports

Remarque

Nous vous recommandons de configurer le serveur de messagerie au moyen du Gestionnaire de configuration du serveur de rapports.

  1. Vérifiez que le service Report Server Windows a des autorisations Send As sur le serveur SMTP.
  2. Ouvrez le fichier RSReportServer.config dans un éditeur de texte.
  3. Vérifiez que <UrlRoot> est paramétré à l'adresse URL du serveur de rapports. Cette valeur est définie lorsque vous configurez le serveur de rapports et elle devrait normalement être déjà définie. Si elle n'est pas définie, tapez l'adresse URL du serveur de rapports.
  4. Définissez <SMTPServer> sur le nom du serveur SMTP. Il peut s'agir d'une adresse IP, du nom de convention d'affectation des noms (UNC) d'un ordinateur sur l'intranet de votre entreprise ou d'un nom de domaine complet.
  5. Définissez <SendUsing> sur 2 pour utiliser le compte de service pour le serveur de rapports. Définissez <SendUsing> sur 1 pour une authentification de base. Si vous le définissez sur 1, vous devez en plus fournir des valeurs pour <SendUserName> et <SendPassword>. Si vous souhaitez que ces valeurs soient chiffrées, définissez l’authentification dans le Gestionnaire de configuration du serveur de rapports.
  6. Définissez <SMTPAuthenticate> sur 1 si vous définissez <SendUsing> sur 1 ou 2.
  7. Définissez <From> sur un compte qui a l'autorisation d'envoyer des messages électroniques à partir du serveur SMTP.
  8. Enregistrez le fichier.

Le serveur de rapports utilise automatiquement les nouveaux paramètres. Vous n’avez pas besoin de redémarrer le service. Vous pouvez spécifier des paramètres SMTP supplémentaires pour configurer comment le serveur SMTP est utilisé pour la remise par messagerie du serveur de rapports.

Options de configuration pour le service SMTP local

La configuration d'un service SMTP local est pratique si vous testez ou dépannez la remise du courrier électronique par le serveur de rapports. Par défaut, le service SMTP local n'est pas activé.

La connexion entre le serveur de rapports et le serveur ou le redirecteur SMTP local est déterminée par les paramètres de configuration suivants :

  • <SendUsing> est défini sur 1.
  • Définissez <SMTPServerPickupDirectory> sur un dossier de lecteur local.

    Remarque

    Assurez-vous de ne pas définir <SMTPServer> si vous utilisez un serveur SMTP local.

  • <From> définit la valeur qui s’affiche sur la ligne De : d’un e-mail. Cette valeur est obligatoire.

Pour configurer un service SMTP local pour le serveur de rapports

  1. Dans le Panneau de configuration, sélectionnez Activer ou désactiver des fonctionnalités Windows pour démarrer l’Assistant Ajout de rôles et de fonctionnalités.
  2. Sélectionnez Installation basée sur un rôle ou une fonctionnalité et sélectionnez Suivant.
  3. Sélectionnez le serveur sur lequel installer Internet Information Server (IIS), puis sélectionnez Suivant.
  4. Sélectionnez Suivant dans la page Rôles du serveur.
  5. Dans la page Fonctionnalités , sélectionnez Serveur SMTP , puis sélectionnez Suivant. Si vous êtes invité à ajouter des fonctionnalités requises pour le serveur SMTP, sélectionnez Ajouter des fonctionnalités.
  6. Dans la page Rôle Web Server (IIS) , sélectionnez Suivant .
  7. Dans la page Services de rôle , sélectionnez Suivant .
  8. Sélectionnez Installer sur la page Confirmer les sélections pour l’installation.
  9. Vérifiez que le service Windows SMTP (Simple Mail Transfer Protocol) s’exécute dans la console Services. Pour configurer le serveur SMTP local, vous devez utiliser le Gestionnaire IIS 6.0 sous Outils d’administration.
  10. Ouvrez le fichier RSReportServer.config dans un éditeur de texte.
  11. Vérifiez que <UrlRoot> est paramétré à l'adresse URL du serveur de rapports. Cette valeur est définie lorsque vous configurez le serveur de rapports,
  12. et devrait déjà être renseignée. Si elle n’est pas définie, tapez l’adresse URL du service web pour votre serveur de rapports.
  13. Assurez-vous que <SMTPServer> est présent, mais vide.
  14. Définissez <SendUsing> sur 1.
  15. Définissez <SMTPAuthenticate> sur 0.
  16. Définissez <SMTPServerPickupDirectory> sur le dossier Collecte du Service SMTP. L’emplacement par défaut est C:\inetpub\mailroot\Pickup.
  17. Définissez <From> sur un compte qui a l'autorisation d'envoyer des messages électroniques à partir du serveur SMTP. Ce paramètre définit la valeur qui s’affiche sur la ligne De : d’un e-mail.
  18. Enregistrez le fichier.

Contenu connexe