Déploiement d'une extension de remiseDeploying a Delivery Extension

Les extensions de remise fournissent leurs informations de configuration sous la forme d'un fichier de configuration XML.Delivery extensions supply their configuration information in the form of an XML configuration file. Le fichier XML est conforme au schéma XML défini pour les extensions de remise.The XML file conforms to the XML schema defined for delivery extensions. Les extensions de remise fournissent l'infrastructure nécessaire pour définir et modifier le fichier de configuration.Delivery extensions provide infrastructure for setting and modifying the configuration file.

Si une extension de remise est remplacée ou mise à niveau, tous les abonnements qui référencent cette extension restent valides.If a delivery extension is replaced or upgraded, all subscriptions that reference the delivery extension remain valid.

Après avoir écrit et compilé votre Reporting ServicesReporting Services extension de remise dans un MicrosoftMicrosoft .NET Framework.NET Framework bibliothèque, vous devez copier l’extension dans le répertoire approprié et ajoutez une entrée approprié Reporting ServicesReporting Services fichier de configuration afin que le serveur de rapports peut le trouver.After you have written and compiled your Reporting ServicesReporting Services delivery extension into a MicrosoftMicrosoft .NET Framework.NET Framework library, you must copy the extension to the appropriate directory and add an entry to the appropriate Reporting ServicesReporting Services configuration file so the report server can locate it.

Élément Extension du fichier de configurationConfiguration-File Extension Element

Extensions de remise que vous déployez sur le serveur de rapports doivent être entrées en tant que Extension éléments dans le fichier de configuration.Delivery extensions that you deploy to the report server need to be entered as Extension elements in the configuration file. Le fichier de configuration du serveur de rapports est RSReportServer.config.The configuration file for the report server is RSReportServer.config.

Le tableau suivant décrit les attributs de la Extension , élément pour les extensions de remise.The following table describes the attributes for the Extension element for delivery extensions.

AttributeAttribute DescriptionDescription
NomName Nom unique de l'extension (par exemple, « Messagerie électronique du serveur de rapports » pour l'extension de remise par messagerie ou « Partage de fichiers du serveur de rapports » pour l'extension de remise par partage de fichiers).A unique name for the extension (for example, "Report Server E-Mail" for the e-mail delivery extension or "Report Server FileShare" for the file share delivery extension). La longueur maximale de l'attribut Name est de 255 caractères.The maximum length for the Name attribute is 255 characters. Le nom doit être unique au sein de toutes les entrées de l’élément Extension d’un fichier de configuration.The name must be unique among all entries within the Extension element of a configuration file. Si un nom existe en double, le serveur de rapports retourne une erreur.If a duplicate name is present, the report server returns an error.
TypeType Liste séparée par des virgules qui inclut l'espace de noms complet, ainsi que le nom de l'assembly.A comma-separated list that includes the fully qualified namespace along with the name of the assembly.
VisibleVisible La valeur false indique que l’extension de remise ne doit pas être visible dans les interfaces utilisateur.A value of false indicates that the delivery extension should not be visible in user interfaces. Si cet attribut n'est pas défini, la valeur par défaut est true.If the attribute is not included, the default value is true.

Pour plus d’informations sur le fichier RSReportServer.config, consultez fichiers de Configuration de Reporting Services.For more information about the RSReportServer.config file, see Reporting Services Configuration Files.

Déploiement de l'extension sur le serveur de rapportsDeploying the Extension to the Report Server

Le serveur de rapports utilise des extensions de remise pour traiter et remettre des notifications ou des rapports.The report server uses delivery extensions for processing and delivering notifications or reports. Vous devez déployer l'assembly d'extension de remise sur le serveur de rapports sous la forme d'un assembly privé.You should deploy your delivery extension assembly to the report server as a private assembly. Vous devez également créer une entrée dans le fichier de configuration du serveur de rapports, à savoir dans le fichier dénommé RSReportServer.config.You also need to make an entry in the report server configuration file, RSReportServer.config.

Pour déployer un assembly d'extension de remise sur un serveur de rapportsTo deploy a deliver extension assembly to a report server

  1. Copiez l'assembly depuis son emplacement vers le répertoire bin du serveur de rapports sur lequel l'extension de remise doit être utilisée.Copy your assembly from your staging location to the bin directory of the report server on which you want to use the delivery extension. L’emplacement par défaut du répertoire bin de serveur de rapports est %ProgramFiles%\Microsoft SQL Server\MSRS13. <InstanceName > \Reporting.The default location of the report server bin directory is %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin.

    Important

    Si vous essayez de remplacer un assembly d'extension de remise existant, vous devez commencer par arrêter le service Report Server avant de copier l'assembly mis à jour.If you are attempting to overwrite an existing delivery extension assembly, you must first stop the Report Server service before copying the updated assembly. Redémarrez le service une fois l'assembly copié.Restart your service after the assembly is through copying.

  2. Une fois le fichier correspondant à l'assembly copié, ouvrez le fichier RSReportServer.config.After the assembly file is copied, open the RSReportServer.config file. Le fichier RSReportServer.config se trouve dans %ProgramFiles%\Microsoft SQL Server\MSRS13. <InstanceName > \Reporting active.The RSReportServer.config file is located in the %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer directory. Vous devez créer une entrée pour le fichier d'assembly d'extension de remise dans le fichier de configuration.You need to make an entry in the configuration file for your delivery extension assembly file. Vous pouvez ouvrir le fichier de configuration avec MicrosoftMicrosoft Visual StudioVisual Studio ou un éditeur de texte simple, tel que le bloc-notes.You can open the configuration file with MicrosoftMicrosoft Visual StudioVisual Studio or a simple text editor, such as Notepad.

  3. Recherchez le remise élément dans le fichier RSReportServer.config.Locate the Delivery element in the RSReportServer.config file. Une entrée correspondant à votre nouvelle extension de remise doit être créée à l'emplacement suivant :An entry for your newly created delivery extension should be made in the following location:

    <Extensions>  
       <Delivery>  
          <Your extension configuration information goes here>  
       </Delivery>  
    </Extensions>  
    
  4. Ajoutez une entrée pour votre extension de remise.Add an entry for your delivery extension. Votre entrée doit contenir un Extension élément avec des valeurs pour nom et Type, peut se présenter comme suit :Your entry should include an Extension element with values for Name and Type, and might look like the following:

    <Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryExtensionClass, AssemblyName" />  
    

    La valeur de nom est le nom unique de l’extension de remise.The value for Name is the unique name of the delivery extension. La valeur de Type est une liste séparée par des virgules qui comporte une entrée pour l’espace de noms qualifié complet de la classe qui implémente le IDeliveryExtension interface, suivi du nom de votre assembly (sans l’extension de fichier .dll).The value for Type is a comma-separated list that includes an entry for the fully qualified namespace of your class that implements the IDeliveryExtension interface, followed by the name of your assembly (not including the .dll file extension). Par défaut, les extensions de remise sont visibles.By default, delivery extensions are visible. Pour masquer des interfaces utilisateur, tels que le portail web, ajoutez un Visible d’attribut pour le Extension élément et affectez-lui la valeur false.To hide an extension from user interfaces, such as the web portal, add a Visible attribute to the Extension element, and set it to false.

  5. Enfin, ajoutez un groupe de codes pour votre assembly personnalisé octroyant FullTrust autorisation pour votre extension de remise.Finally, add a code group for your custom assembly that grants FullTrust permission for your delivery extension. Pour cela, vous devez en ajoutant le groupe de codes au fichier rssrvpolicy.config qui se trouve par défaut dans %ProgramFiles%\Microsoft SQL Server\MSRS13. <InstanceName > \Reporting.You do this by adding the code group to the rssrvpolicy.config file located by default in %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer. Ce groupe de codes peut se présenter comme suit :Your code group might look like the following:

    <CodeGroup class="UnionCodeGroup"  
       version="1"  
       PermissionSetName="FullTrust"  
       Name="MyExtensionCodeGroup"  
       Description="Code group for my delivery extension">  
          <IMembershipCondition class="UrlMembershipCondition"  
             version="1"  
             Url="C:\Program Files\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"  
           />  
    </CodeGroup>  
    

    L'appartenance URL n'est qu'une des nombreuses conditions d'appartenance que vous pouvez sélectionner pour l'extension de remise.URL membership is only one of many membership conditions you might choose for your delivery extension. Pour plus d’informations sur la sécurité d’accès du code dans SSRSSSRS, consultez. Sécuriser le développement ( Reporting Services )For more information about code access security in SSRSSSRS, see.Secure Development (Reporting Services)

Vérification du déploiementVerifying the Deployment

Vous pouvez vérifier que votre extension de remise a été correctement déployée sur le serveur de rapports en utilisant la méthode ListExtensions du service Web.You can verify whether your delivery extension was deployed successfully to the report server by using the Web service ListExtensions method. Vous pouvez également ouvrir le portail web et vérifiez que votre extension est incluse dans la liste des extensions de remise disponibles pour un abonnement.You can also open the web portal and verify that your extension is included in the list of available delivery extensions for a subscription. Pour plus d’informations sur le portail web et les abonnements, consultez abonnements et remise ( Reporting Services ) .For more information about the web portal and subscriptions, see Subscriptions and Delivery (Reporting Services).

Voir aussiSee Also

Implémentation d’une Extension de remise Implementing a Delivery Extension
Bibliothèque d’Extension de Reporting Services Reporting Services Extension Library