Freigeben über

  • Artikel

Bereitstellen einer benutzerdefinierten Assembly

Um eine benutzerdefinierte Assembly in SQL ServerReporting Services einzusetzen, stellen Sie die Assembly in die Anwendungsordner des Berichtsservers und des Berichts-Managers. Standardmäßig wird benutzerdefinierten Assemblys die Execution-Berechtigung in Reporting Services erteilt. Um benutzerdefinierten Assemblys Privilegien über die Ausführungsberechtigung hinaus zu erteilen, müssen Sie die Konfigurationsdatei rssrvpolicy.config für den Berichtsserver und die Konfigurationsdatei rspreviewpolicy.config für das Vorschaufenster des Berichts-Designers bearbeiten. Alternativ dazu können Sie die benutzerdefinierte Assembly auch im globalen Assemblycache (Global Assembly Cache, GAC) installieren.

HinweisHinweis

Es stehen zwei Vorschaumodi für den Berichts-Designer zur Verfügung: die Vorschauregisterkarte und das Popup-Vorschaufenster, das beim Start des Berichtsprojekts im DebugLocal aufgerufen wird. Die Vorschauregisterkarte führt alle Berichtsausdrücke mithilfe des FullTrust-Berechtigungssatzes aus und wendet keine Sicherheitsrichtlinieneinstellungen an. Im Popup-Vorschaufenster sollen die Berichtsserverfunktionen simuliert werden. Es enthält daher eine Richtlinienkonfigurationsdatei, die von Ihnen oder einem Administrator verändert werden muss, damit benutzerdefinierte Assemblys im Berichts-Designer verwendet werden können. Diese automatische Vorschau sperrt auch die benutzerdefinierte Assembly. Daher müssen Sie das Vorschaufenster schließen, um den Code der benutzerdefinierten Assembly ändern oder aktualisieren zu können.

So stellen Sie benutzerdefinierte Assemblys in Reporting Services bereit

  1. Kopieren Sie die benutzerdefinierte Assembly aus dem Build-Verzeichnis in das BIN-Verzeichnis des Berichtsservers oder in den Ordner des Berichts-Designers. Das Standardverzeichnis des Bin-Ordners für den Berichtsserver ist das Verzeichnis C:\Programme\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin. Das Standardverzeichnis für den Berichts-Designer ist C:\Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.

    Wenn Sie Ihre benutzerdefinierte Assembly im BIN-Verzeichnis des Berichtsservers speichern, können Sie Berichte veröffentlichen, die auf die benutzerdefinierte Assembly verweisen. Speichern Sie die Assembly im Ordner des Berichts-Designers, können Sie im Berichts-Designer Berichte ausführen und debuggen, die auf die benutzerdefinierte Assembly verweisen.

    Wenn Sie dem Code der benutzerdefinierten Assembly Berechtigungen erteilen möchten, die über die Standardausführung hinausgehen, gehen Sie wie folgt vor:

  2. Öffnen Sie die entsprechende Konfigurationsdatei. Das Standardverzeichnis von rssrvpolicy.config ist das Verzeichnis C:\Programme\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer. Das Standardverzeichnis der Datei rspreviewpolicy.config ist das Verzeichnis C:\Programme\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.

  3. Fügen Sie eine Codegruppe für die benutzerdefinierte Assembly hinzu. Weitere Informationen finden Sie unter Sichere Entwicklung (Reporting Services).

Aktualisieren von benutzerdefinierten Assemblys

Irgendwann kann es sein, dass Sie eine Version einer benutzerdefinierten Assembly aktualisieren müssen, auf die derzeit diverse veröffentlichten Berichte verweisen. Wenn die Assembly bereits im Bin-Verzeichnis des Berichtsservers oder des Berichts-Designers vorhanden ist und die Versionsnummer der Assembly erhöht oder geändert wird, funktionieren die aktuell veröffentlichten Berichte nicht mehr ordnungsgemäß. Sie müssen die Version der Assembly, auf die im CodeModules-Element der Berichtsdefinition verwiesen wird, aktualisieren und die Berichte erneut veröffentlichen. Wenn Sie wissen, dass Sie eine benutzerdefinierte Assembly häufig aktualisieren müssen und wenn Ihre derzeit veröffentlichten Berichte auf die neue Assembly verweisen müssen, sollten Sie überlegen, ob es nicht besser ist, dieselbe Versionsnummer in allen Aktualisierungen einer bestimmten Assembly zu verwenden.

Wenn in den derzeit veröffentlichten Berichten nicht auf die neue Versionsnummer verwiesen werden muss, können Sie die benutzerdefinierte Assembly im globalen Assemblycache bereitstellen. Im globalen Assemblycache können mehrere Versionen derselben Assembly verwaltet werden, sodass aktuelle Berichte auf frühere Versionen der Assembly und neu veröffentliche Berichte auf die aktualisierte Assembly verweisen können. Ein weiteres Konzept wäre es, die bindende Umleitung des Berichtsservers so einzustellen, dass eine Umleitung aller Anforderungen für die alte Assembly zur neuen Assembly durchgesetzt würde. Sie müssten dann die Berichtsserver-Dateien Web.config und ReportService.exe.config ändern. Der Eintrag könnte folgendermaßen aussehen:

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <bindingRedirect oldVersion="1.0.0.0"
                             newVersion="2.0.0.0"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>