Bereitstellen einer benutzerdefinierten Assembly
Platzieren Sie die Assembly in den Anwendungsordnern des Berichtsservers und des Berichts-Designers, um eine benutzerdefinierte Assembly in SQL Server Reporting Services bereitzustellen. Standardmäßig wird benutzerdefinierten Assemblys die Execution-Berechtigung in Reporting Services erteilt. Um benutzerdefinierte Assemblys Berechtigungen zu gewähren, die über die Berechtigung "Execute" hinausgehen, müssen Sie die Konfigurationsdatei "rssrvpolicy.config" für den Berichtsserver und die Konfigurationsdatei "rspreviewpolicy.config" für das Berichts-Designer Vorschaufenster bearbeiten. Alternativ dazu können Sie die benutzerdefinierte Assembly auch im globalen Assemblycache (Global Assembly Cache, GAC) installieren.
Hinweis
Es stehen zwei Vorschaumodi für den Berichts-Designer zur Verfügung: die Registerkarte „Vorschau“ und das Popup-Vorschaufenster, das beim Start Ihres Berichtsprojekts im DebugLocal-Modus 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.
Bereitstellen einer benutzerdefinierten Assembly in Reporting Services
Kopieren Sie die benutzerdefinierte Assembly aus dem Build-Verzeichnis in das BIN-Verzeichnis des Berichtsservers oder in den Ordner des Berichts-Designers.
Wenn Sie Ihre benutzerdefinierte Assembly im Ordner „Bin“ des Berichtsservers speichern, können Sie Berichte veröffentlichen, die auf die benutzerdefinierte Assembly verweisen. Der Standardspeicherort des Ordners „bin“ für den Berichtsserver ist wie folgt:
Reporting Services 2016
%ProgramFiles%\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\binAb Reporting Services 2017
%ProgramFiles%\Microsoft SQL Server Reporting Services\SSRS\ReportServer\binWenn Sie ihn im Ordner „Berichts-Designer“ ablegen, können Sie Berichte ausführen und debuggen, die auf die benutzerdefinierte Assembly im Berichts-Designer verweisen. Der Standardspeicherort des Berichts-Designers ist wie folgt:
Visual Studio 2012
C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssembliesVisual Studio 2013
C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\PrivateAssembliesVisual Studio 2015
C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\PrivateAssembliesVisual Studio 2017
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRSVisual Studio 2019
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRSÖffnen Sie die entsprechende Konfigurationsdatei. Der Standardspeicherort der Datei „rssrvpolicy.config“ für den Berichtsserver ist wie folgt:
Reporting Services 2016
%ProgramFiles%\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServerAb Reporting Services 2017
%ProgramFiles%\Microsoft SQL Server Reporting Services\SSRS\ReportServerDie für den Berichts-Designer zu aktualisierenden Dateien sind wie folgt:
Visual Studio 2012
C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\PreviewProcessingService.exe.config C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\RSPreviewPolicy.config C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\RSReportDesigner.config C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies\RSReportHost11.exe.configVisual Studio 2013
C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\PrivateAssemblies\PreviewProcessingService.exe.config C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\PrivateAssemblies\RSPreviewPolicy.config C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\PrivateAssemblies\RSReportDesigner.config C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\PrivateAssemblies\RSReportHost.exe.configVisual Studio 2015
C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\PrivateAssemblies\PreviewProcessingService.exe.config C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\PrivateAssemblies\RSPreviewPolicy.config C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\PrivateAssemblies\RSReportDesigner.config C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\PrivateAssemblies\RSReportHost.exe.configVisual Studio 2017
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\PreviewProcessingService.exe.config C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSPreviewPolicy.config C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSReportDesigner.config C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSReportHost.exe.configVisual Studio 2019
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\PreviewProcessingService.exe.config C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSPreviewPolicy.config C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSReportDesigner.config C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\SSRS\RSReportHost.exe.configFügen Sie eine Codegruppe für die benutzerdefinierte Assembly hinzu. Weitere Informationen finden Sie unter Sichere Entwicklung (Reporting Services).
Aktualisieren von benutzerdefinierten Assemblys
Irgendwann müssen Sie möglicherweise eine Version einer benutzerdefinierten Assembly aktualisieren, auf die von mehreren veröffentlichten Berichten verwiesen wird. Wenn diese Assembly bereits im Bin-Verzeichnis des Berichtsservers oder Berichts-Designer vorhanden ist und die Versionsnummer der Assembly auf irgendeine Weise erhöht oder geändert wird, funktionieren die aktuell veröffentlichten Berichte nicht ordnungsgemäß. Sie müssen die Version der Assembly aktualisieren, auf die im CodeModules-Element der Berichtsdefinition verwiesen wird, und die Berichte erneut veröffentlichen. Wenn Sie wissen, dass Sie häufig eine benutzerdefinierte Assembly aktualisieren und ihre aktuell veröffentlichten Berichte auf die neue Assembly verweisen müssen, sollten Sie in Erwägung ziehen, die gleiche Versionsnummer für alle Updates einer bestimmten Assembly zu verwenden.
Wenn Sie Ihre aktuell veröffentlichten Berichte nicht benötigen, um auf die neue Version der Assembly zu verweisen, können Sie Ihre 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 „ReportingServicesService.exe.config“ ändern. Der Eintrag könnte wie im folgenden Beispiel 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>
Zugehöriger Inhalt
Verwenden benutzerdefinierter Assemblys mit Berichten
Arbeiten mit Assemblys und dem globalen Assemblychache
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für