Déploiement d’une extension de rendu

Une fois que vous avez écrit et compilé votre extension de rendu de rapport Reporting Services dans une bibliothèque .NET Framework, vous devez le rendre détectable par le serveur de rapports et par le Concepteur de rapports. Pour ce faire, copiez l’extension dans le répertoire approprié et ajoutez des entrées aux fichiers de configuration Reporting Services appropriés.

Élément d’extension de rendu de fichier de configuration

Une fois qu’une extension de rendu a été compilée dans un .DLL, vous ajoutez une entrée dans le fichier rsreportserver.config. Par défaut, l’emplacement est %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. L’élément parent est <Render>. Sous l’élément Render, il s’agit d’un élément Extension pour chaque extension de rendu. L’élément Extension contient deux attributs, Name et Type.

Le tableau suivant décrit les attributs de l’élément pour les Extension extensions de rendu :

Caractéristique	Descriptif
Nom	Nom unique de l’extension. La longueur maximale de l'attribut Name est de 255 caractères. Le nom doit être unique parmi toutes les entrées de l’élément Extensions d’un fichier de configuration. Si un nom en double est présent, le serveur de rapports retourne une erreur.
Type	Liste séparée par des virgules qui inclut l’espace de noms complet, ainsi que le nom de l’assembly.
visible	Une valeur indiquant `false` que l’extension de rendu ne doit pas être visible dans les interfaces utilisateur. Si l’attribut n’est pas inclus, la valeur par défaut est `true`.
LogAllExecutionRequests	Une valeur indiquant `false` qu’une entrée est enregistrée uniquement pour la première exécution du rapport dans une session. Si l’attribut n’est pas inclus, la valeur par défaut est `true`. Par exemple, ce paramètre détermine s’il faut enregistrer une entrée uniquement pour la première page rendue dans un rapport (quand `false`) ou une entrée pour chaque page rendue dans le rapport (quand `true`).

Pour plus d’informations, consultez le fichier de configuration RSReportServer.

Déploiement de l’extension sur le serveur de rapports

Le serveur de rapports utilise des extensions de rendu pour exporter des rapports vers d’autres formats. Vous devez déployer votre assembly d’extension de rendu sur le serveur de rapports en tant qu’assembly privé. Vous devez également entrer dans le fichier de configuration du serveur de rapports, rsreportserver.config.

Pour déployer l’assembly

Copiez votre assembly à partir de votre emplacement intermédiaire vers le répertoire bin du serveur de rapports sur lequel vous souhaitez utiliser l’extension de rendu. L’emplacement par défaut du répertoire Bin du serveur de rapports est %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\Bin.
Une fois le fichier d’assembly copié, ouvrez le fichier rsreportserver.config. Le fichier rsreportserver.config se trouve également dans le répertoire bin du serveur de rapports. Vous devez entrer une entrée dans le fichier de configuration de votre fichier d’assembly d’extension. Vous pouvez ouvrir le fichier avec Visual Studio ou un éditeur de texte simple.

Pour plus d’informations, consultez le fichier de configuration RSReportServer.
Recherchez l’élément Render dans le fichier Rsreportserver.config. Une entrée pour votre extension nouvellement créée doit être effectuée à l’emplacement suivant :
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
Ajoutez une entrée pour votre extension de rendu. Votre entrée doit inclure un élément qui a des valeurs pour Name et Type, et peut ressembler à ce qui suit :
```
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
```
La valeur de Name est le nom unique de l’extension de rendu. La valeur de Type est une liste séparée par des virgules qui inclut une entrée pour l’espace de noms complet de votre IRenderingExtension implémentation, suivie du nom de votre assembly (sans inclure l’extension de fichier .dll). Par défaut, les extensions de rendu sont visibles. Pour masquer une extension des interfaces utilisateur, comme le Gestionnaire de rapports, ajoutez un attribut Visible à l’élément et définissez-la Extensionfalsesur .

Vérification du déploiement

Vous pouvez également ouvrir le Gestionnaire de rapports et vérifier que votre extension est incluse dans la liste des types d’exportation disponibles pour un rapport.

Voir aussi

Implémentation d’une extension de rendu
Vue d’ensemble des extensions de rendu
Implémentation de l’interface IRenderingExtension
Considérations sur la sécurité pour les extensions

Last updated on 2017-06-13

Partager via