Bereitstellen von Renderingerweiterungen

Artikel
06/13/2017

Wenn Sie die Reporting Services-Berichtsrenderingerweiterung geschrieben und in eine .NET Framework-Bibliothek kompiliert haben, müssen Sie sie für den Berichtsserver und den Berichts-Designer erkennbar machen. Hierzu müssen Sie lediglich die Erweiterung in das entsprechende Verzeichnis kopieren und Einträge zu den zugehörigen Reporting Services -Konfigurationsdateien hinzufügen.

Renderingerweiterungselement der Konfigurationsdatei

Sobald eine Renderingerweiterung in eine .DLL kompiliert wurde, fügen Sie eine Eintragung in die Datei rsreportserver.config hinzu. Standardmäßig ist der Speicherort „%ProgramFiles%\Microsoft SQL Server\MSRS10_50.<Instanzname>\Reporting Services\ReportServer“. Das übergeordnete Element ist <Render>. Unter dem Render-Element befindet sich ein Erweiterungselement für jede Renderingerweiterung. Das Extension-Element enthält zwei Attribute: Name und Typ.

In der folgenden Tabelle werden die Attribute für das Element für Renderingerweiterungen Extension beschrieben:

Attribut	BESCHREIBUNG
Name	Ein eindeutiger Name für die Erweiterung. Die maximale Länge für das Name -Attribut beträgt 255 Zeichen. Der Name muss für sämtliche Einträge im Extension -Element einer Konfigurationsdatei eindeutig sein. Wenn ein Name doppelt vorhanden ist, gibt der Berichtsserver einen Fehler zurück.
Typ	Eine durch Trennzeichen getrennte Liste, die den vollqualifizierten Namespace und den Namen der Assembly enthält
Visible	Der Wert `false` gibt an, dass die Renderingerweiterung auf Benutzeroberflächen nicht sichtbar sein soll. Wenn das Attribut nicht enthalten ist, ist `true` der Standardwert.
LogAllExecutionRequests	Der Wert `false` gibt an, dass nur für die erste Berichtsausführung in einer Sitzung ein Eintrag protokolliert wird. Wenn das Attribut nicht enthalten ist, ist `true` der Standardwert. Diese Einstellung legt zum Beispiel fest, ob nur für die erste Seite eines Berichts (`false`) oder für alle Seiten eines Berichts ein Eintrag protokolliert werden soll (`true`).

Weitere Informationen finden Sie unter RSReportServer Configuration File.

Bereitstellen der Erweiterung auf dem Berichtsserver

Der Berichtsserver exportiert Berichte mithilfe von Renderingerweiterungen in andere Formate. Sie sollten Ihre Assembly für Renderingerweiterungen auf dem Berichtsserver als private Assembly bereitstellen. Sie müssen auch einen Eintrag in der Konfigurationsdatei des Berichtsservers rsreportserver.config vornehmen.

So stellen Sie die Assembly bereit

Kopieren Sie die Assembly aus dem Bereitstellungsverzeichnis in das BIN-Verzeichnis des Berichtsservers, auf dem Sie die Renderingerweiterung verwenden möchten. Der Standardspeicherort des Verzeichnisses „Bin“ des Berichtsservers lautet „%ProgramFiles%\Microsoft SQL Server\MSRS10_50.<Instanzname>\Reporting Services\ReportServer\Bin“.
Nachdem die Assemblydatei kopiert wurde, öffnen Sie die Datei rsreportserver.config. Die Datei rsreportserver.config befindet sich auch im BIN-Verzeichnis des Berichtsservers. Sie müssen einen Eintrag in der Konfigurationsdatei für die Datei Ihrer Erweiterungsassembly vornehmen. Sie können die Datei in Visual Studio oder einem einfachen Text-Editor öffnen.

Weitere Informationen finden Sie unter RSReportServer Configuration File.
Suchen Sie das Render -Element in der Datei Rsreportserver.config. Im folgenden Verzeichnis muss ein Eintrag für Ihre neu erstellte Erweiterung erstellt werden:
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
Fügen Sie einen Eintrag für die Renderingerweiterung hinzu. Der Eintrag sollte ein Element mit Werten für Name und Typenthalten und kann folgendermaßen aussehen:
```
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
```
Der Wert für Name ist ein eindeutiger Name der Renderingerweiterung. Der Wert für Type ist eine durch Komma getrennte Liste, die einen Eintrag für den vollqualifizierten Namespace Ihrer IRenderingExtension-Implementierung enthält, gefolgt vom Namen Ihrer Assembly (ohne die DLL-Dateierweiterung). Standardmäßig sind Renderingerweiterungen sichtbar. Um eine Erweiterung vor Benutzeroberflächen wie berichts-Manager auszublenden, fügen Sie dem Extension -Element ein Visible-Attribut hinzu, und legen Sie es auf festfalse.

Überprüfen der Bereitstellung

Sie können auch den Berichts-Manager öffnen und prüfen, ob die Erweiterung in der Liste der für einen Bericht verfügbaren Exporttypen enthalten ist.

Weitere Informationen

Implementing a Rendering Extension (Implementieren von Renderingerweiterungen)
Rendering Extensions Overview (Übersicht über Renderingerweiterungen)
Implementing the IRenderingExtension Interface (Implementieren der IRenderingExtension-Schnittstelle)
Security Considerations for Extensions (Überlegungen zur Sicherheit von Erweiterungen)

Freigeben über