Vorgehensweise: Durchführen eines Upgrades benutzerdefinierter Assemblys und Erweiterungen

  • Artikel

Neu: 15. September 2007

SQL Server Reporting Services bietet eine erweiterbare Architektur, die es Entwicklern ermöglicht, freigegebene Assemblys für die benutzerdefinierte Verarbeitung, Übermittlung, Sicherheitserweiterungen und benutzerdefiniertes Rendering zu erstellen. Sie unterstützt darüber hinaus die Verwendung benutzerdefinierter Assemblys für Berichtselementwerte, Formate und Formatierungen.

Wenn Sie benutzerdefinierte Erweiterungen oder Assemblys in Ihrer SQL Server 2000 Reporting Services-Installation bereitgestellt haben, blockiert das Setupprogramm ein automatisches Upgrade Ihrer Installation und zeigt die folgende Fehlermeldung an: "Benutzerdefinierte Assemblys werden für diesen Berichtsserver bereitgestellt." Wenn Sie mehrere Komponenten für das Upgrade ausgewählt haben, können Sie damit fortfahren, andere SQL Server 2005-Komponenten zu aktualisieren. Um Reporting Services zu aktualisieren, müssen Sie das Setupprogramm jetzt schließen und die folgenden Schritte ausführen:

  1. Entfernen Sie benutzerdefinierte Einstellungen in der Datei rsreportserver.config. Um eine benutzerdefinierte Installation zu aktualisieren, können Sie die Konfigurationseinstellungen für die benutzerdefinierten Assemblys oder Erweiterungen vorübergehend aus der Datei rsreportserver.config entfernen. Dies bewirkt, dass das Setupprogramm die Upgradesuche nach benutzerdefinierten Assemblys umgeht, weil Ihre Installation ohne die benutzerdefinierten Einstellungen wie eine Standardinstallation aussieht.
  2. Führen Sie das Setupprogramm aus, um Reporting Services zu aktualisieren.
  3. Falls notwendig, kompilieren Sie die benutzerdefinierte Assembly oder Erweiterung neu.
    • Benutzerdefinierte Sicherheitserweiterungen müssen immer neu kompiliert werden. Alle Sicherheitserweiterungen auf einem Berichtsserver müssen Verweise für Berichtsmodelle und die Modellelementsicherheit enthalten, unabhängig davon, ob Sie Modelle oder die Modellelementsicherheit verwenden möchten.
    • Andere Erweiterungen und Assemblys müssen nur dann neu kompiliert werden, wenn sie von einer Datei- oder Dateipfadinformation der alten Installation abhängig sind. In einer aktualisierten Installation nehmen Ordner Instanzinformationen in die Programmordnernamen auf (Beispiel: MSSQL.1 für die Standardinstanz des Datenbankmoduls). Wenn die Erweiterung oder Assembly auf einen Pfad verweist, der nicht mehr existiert, wird zur Laufzeit ein Fehler angezeigt. Die folgende Fehlermeldung informiert beispielsweise darüber, ob Sie eine Datenverarbeitungserweiterung neu kompilieren müssen: "Fehler bei der Berichtsverarbeitung. Es wurde versucht, eine <Name>-Datenerweiterung zu verwenden, die für diesen Berichtsserver nicht registriert ist."
      Wenn Sie sie neu kompilieren müssen, verwenden Sie Visual Studio 2005, oder laden Sie eine Visual Studio 2005 Express Edition-Komponente herunter. Die Programmdateien von SQL Server 2005 Reporting Services sind verwaltete, in Microsoft .NET Framework 2.0 erstellte Assemblys. Um auf die SQL Server 2005-Version der Microsoft.ReportingServices.Interfaces.dll in Ihrem Projekt zu verweisen, müssen Sie das Projekt mit einer Visual Studio 2005-Entwicklungsumgebung kompilieren, die .NET Framework 2.0-Anwendungen erstellt.
  4. Verschieben Sie benutzerdefinierte Assemblys oder Erweiterungen in den richtigen Ordner in der aktualisierten Installation. Sie müssen den Ordner suchen, der die Programmdateien von Reporting Services enthält, und die benutzerdefinierten Dateien an den neuen Speicherort kopieren. Wenn Sie lediglich die Standardinstanz des Datenbankmoduls und von Reporting Services installiert haben, befinden sich die Programmdateien von Reporting Services wahrscheinlich in MSSQL.2.
  5. Fügen Sie benutzerdefinierte Einstellungen der Datei rsreportserver.config hinzu.

So entfernen Sie benutzerdefinierte Einstellungen und aktualisieren Reporting Services

  1. Sichern Sie die Datei RSReportServer.config.

  2. Entfernen Sie benutzerdefinierte Erweiterungseinstellungen aus der Datei rsreportserver.config. Sie brauchen keine Einträge aus anderen Konfigurationsdateien oder Sicherheitsrichtliniendateien zu entfernen. Diese Dateien werden während des Upgrades aktualisiert und verschoben Benutzerdefinierte Einstellungen werden beibehalten.

  3. Führen Sie das Setup aus, um die Berichtsserverinstallation zu aktualisieren.

Bb839481.note(de-de,SQL.90).gifWichtig:
Der Upgradeprozess löscht alte Beispiele und ersetzt sie durch neue Versionen, wenn Sie während des SQL Server 2005-Setups die neuen SQL Server 2005-Beispiele auswählen. Wenn Sie Beispielerweiterungen oder -anwendungen aktiv nutzen, kopieren Sie die Quelldateien vor dem Upgrade an einen anderen Speicherort.
  1. Kopieren Sie die benutzerdefinierten Assemblys in die neue Verzeichnisstruktur. Legen Sie die Dateien im Ordner \Programme\Microsoft SQL Server\MSSQL.x\Reporting Services\ReportServer\Bin ab.
  2. Bearbeiten Sie die Datei rsreportserver.config, und fügen Sie die benutzerdefinierten Erweiterungseinstellungen wieder in die Datei ein.

So kompilieren Sie eine benutzerdefinierte Assembly neu

  1. Kompilieren Sie benutzerdefinierte Sicherheitserweiterungen oder Assemblys, die von einer Datei in der Verzeichnisstruktur des Berichtsservers abhängen:

    1. Starten Sie Visual Studio 2005.
    2. Öffnen Sie die Projektmappe. Sie werden aufgefordert, die Dateien zu konvertieren.
    3. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Verweis hinzufügen.
    4. Klicken Sie auf Durchsuchen.
    5. Wechseln Sie zum Ordner Programme\Microsoft SQL Server\MSSQL.x\Reporting Services\ReportServer\Bin, und wählen Sie Microsoft.ReportingServices.Interfaces.dll aus.
    6. Erstellen Sie das Projekt bzw. die Projektmappe.

  2. Kopieren Sie die benutzerdefinierte Erweiterung oder die benutzerdefinierte Assembly in den Ordner \ReportServer\Bin.

  3. Ist kein Eintrag dafür vorhanden, fügen Sie die Einstellungen für die benutzerdefinierte Erweiterung oder Assembly der Datei rsreportserver.config hinzu.

  4. Überprüfen Sie die Datei rsreportdesigner.config, die Datei rswebapplication.config und die Konfigurationsdatei für die Sicherheitsrichtlinien, um sicherzugehen, dass die benutzerdefinierten Einstellungen noch gültig sind. Das bedeutet, wenn die benutzerdefinierten Einstellungen einen Pfad zu einem Reporting Services-Ordner beinhalten, bearbeiten Sie den Wert, indem Sie den alten Pfad durch den zum neuen Ordner ersetzen.

  5. Testen Sie die Anwendungen und die Berichte.

Siehe auch

Konzepte

Aktualisieren von Reporting Services

Andere Ressourcen

Using Custom Assemblies with Reports
Reporting Services Extensions

Hilfe und Informationen

Informationsquellen für SQL Server 2005