Bereitstellen von Renderingerweiterungen
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 P%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 Extension-Element für Renderingerweiterungen 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 doppelter Name 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. |
Sichtbar |
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-Konfigurationsdatei.
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. Das Standardverzeichnis für das BIN-Verzeichnis des Berichtsservers lautet %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\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 mit Visual Studio oder einem einfachen Text-Editor öffnen.
Weitere Informationen finden Sie unter RSReportServer-Konfigurationsdatei.
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 Typ enthalten 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 Typ ist eine durch Trennzeichen 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 auf Benutzeroberflächen wie dem Berichts-Manager auszublenden, fügen Sie dem Extension-Element das Attribut Visible hinzu und legen es auf false fest.
Überprüfen der Bereitstellung
Sie können prüfen, ob Ihre Renderingerweiterung erfolgreich auf dem Berichtsserver bereitgestellt wurde, indem Sie die Webdienstmethode ListExtensions(ExtensionTypeEnum) verwenden. 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.