Freigeben über

  • Artikel

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-Datei kompiliert wurde, können Sie einen Eintrag in der Datei rsreportserver.config im Ordner C:\Programme\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin vornehmen, wenn der Speicherort der Standardinstallation während der Installation ausgewählt wurde. 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.

Attribute

Beschreibung

Name

Ein eindeutiger Name für die Erweiterung, z. B. „EXCEL“ für die Microsoft Excel-Renderingerweiterung. 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.

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 zur Datei "RSReportServer.config" 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

  1. Kopieren Sie die Assembly aus dem Bereitstellungsverzeichnis in das BIN-Verzeichnis des Berichtsservers, auf dem Sie die Renderingerweiterung verwenden möchten. Das Standardverzeichnis des Berichtsserver-BIN-Verzeichnisses lautet C:\Programme\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin.

  2. 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 Microsoft Visual Studio .NET oder mit einem einfachen Text-Editor wie dem Microsoft-Editor öffnen.

    Weitere Informationen finden Sie unter RSReportServer-Konfigurationsdatei.

  3. 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>
      <Your extension configuration information goes here>
   </Render>
</Extensions>

  4. Fügen Sie einen Eintrag für die Renderingerweiterung hinzu. Der Eintrag sollte ein Element mit den Werten 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 Sie es auf false fest.

Überprüfen der Bereitstellung

Sie können überprüfen, ob Ihre Renderingerweiterung erfolgreich auf dem Berichtsserver bereitgestellt wurde, indem Sie die Webdienstmethode ListExtensions 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.