Bereitstellen einer Renderingerweiterung

  • Artikel

Nachdem Sie die Reporting Services-Berichtsrenderingerweiterung in eine .NET Framework-Bibliothek geschrieben und kompiliert haben, müssen Sie sie vom Berichtsserver und von Berichts-Designer auffindbar 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.

Konfigurationsdateirenderingerweiterungselement

Sobald eine Renderingerweiterung in eine DLL kompiliert wird, fügen Sie einen Eintrag in die Datei "rsreportserver.config" hinzu. Standardmäßig ist der Speicherort %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer. Das übergeordnete Element ist \<Render>. Unter dem Render-Element handelt es sich um 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 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 Ein Wert von "false " gibt an, dass die Renderingerweiterung nicht in Benutzeroberflächen sichtbar sein sollte. Wenn das Attribut nicht enthalten ist, ist der Standardwert "true".
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 der Standardwert "true".

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 in der Konfigurationsdatei "RsReportServer.config".

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.

Bereitstellen der Assembly

  1. Kopieren Sie die Assembly aus dem Bereitstellungsverzeichnis in das BIN-Verzeichnis des Berichtsservers, auf dem Sie die Renderingerweiterung verwenden möchten. Der Standardspeicherort des Berichtsserver-Bin-Verzeichnisses lautet %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<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 in Visual Studio oder einem einfachen Text-Editor öffnen.

    Weitere Informationen finden Sie in der Konfigurationsdatei "RsReportServer.config".

  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>  
      <extension configuration>  
   </Render>  
</Extensions>

  4. 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 auf Benutzeroberflächen wie dem Berichts-Manager auszublenden, fügen Sie dem Extension -Element das Attribut Visible hinzu und legen es auf falsefest.

Ü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.

Zugehöriger Inhalt