Bereitstellen einer Übermittlungserweiterung

  • Artikel

Übermittlungserweiterungen geben ihre Konfigurationsinformationen in Form einer XML-Konfigurationsdatei an. Die XML-Datei entspricht dem für Übermittlungserweiterungen definierten XML-Schema. Übermittlungserweiterungen verfügen über eine Infrastruktur zum Einstellen und Ändern der Konfigurationsdatei.

Wenn eine Übermittlungserweiterung ersetzt oder aktualisiert wird, bleiben alle Abonnements, die auf die Übermittlungserweiterung verweisen, gültig.

Nachdem Sie ihre Reporting Services-Übermittlungserweiterung in eine Microsoft .NET Framework-Bibliothek geschrieben und kompiliert haben, müssen Sie die Erweiterung in das entsprechende Verzeichnis kopieren und einen Eintrag zur entsprechenden Reporting Services-Konfigurationsdatei hinzufügen, damit der Berichtsserver sie finden kann.

Konfigurationsdateierweiterungselement

Übermittlungserweiterungen, die Sie für den Berichtsserver bereitstellen, müssen in der Konfigurationsdatei als Extension-Elemente hinzugefügt werden. Die Konfigurationsdatei für den Berichtsserver heißt RSReportServer.config.

In der folgenden Tabelle werden die Attribute für das Extension-Element für Übermittlungserweiterungen beschrieben.

Attribut Beschreibung
Name Ein eindeutiger Name für die Erweiterung (z. B. "Berichtsserver-E-Mail" für eine E-Mail-Übermittlungserweiterung oder "Berichtsserver-Dateifreigabe" für eine Dateifreigabe-Übermittlungserweiterung). 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 Der Wert " false " gibt an, dass die Übermittlungserweiterung nicht in Benutzeroberflächen sichtbar sein sollte. Wenn das Attribut nicht enthalten ist, ist der Standardwert "true".

Weitere Informationen zur Datei RSReportServer.config finden Sie unter Reporting Services-Konfigurationsdateien.

Bereitstellen der Erweiterung auf dem Berichtsserver

Der Berichtsserver verwendet Übermittlungserweiterungen zur Verarbeitung und Übermittlung von Benachrichtigungen oder Berichten. Sie sollten die Assembly für Übermittlungserweiterungen auf dem Berichtsserver als private Assembly bereitstellen. Sie müssen auch einen Eintrag in der Konfigurationsdatei des Berichtsservers RSReportServer.config vornehmen.

Bereitstellen einer Übermittlungserweiterungsassembly auf einem Berichtsserver

  1. Kopieren Sie die Assembly aus dem Bereitstellungsverzeichnis in das BIN-Verzeichnis des Berichtsservers, auf dem Sie die Übermittlungserweiterung verwenden möchten. Der Standardspeicherort des Berichtsserver-Bin-Verzeichnisses lautet %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer\bin.

    Wichtig

    Wenn Sie versuchen, eine vorhandene Assembly für Übermittlungserweiterungen zu überschreiben, müssen Sie zuerst den Berichtsserverdienst anhalten, bevor Sie die aktualisierte Assembly kopieren können. Starten Sie den Dienst neu, nachdem die Assembly kopiert wurde.

  2. Nachdem die Assemblydatei kopiert wurde, öffnen Sie die Datei RSReportServer.config. Die Datei "RSReportServer.config" befindet sich im %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer Verzeichnis. Sie müssen einen Eintrag in der Konfigurationsdatei für die Assemblydatei der Übermittlungserweiterung vornehmen. Sie können die Konfigurationsdatei mit Microsoft Visual Studio oder in einem einfachen Text-Editor wie Windows-Editor öffnen.

  3. Suchen Sie das Delivery-Element in der Datei „RSReportServer.config“. In folgendem Verzeichnis muss ein Eintrag für die neu erstellte Übermittlungserweiterung erstellt werden:

    <Extensions>  
   <Delivery>  
      <Your extension configuration information goes here>  
   </Delivery>  
</Extensions>

  4. Fügen Sie einen Eintrag für die Übermittlungserweiterung hinzu. Der Eintrag sollte ein Extension-Element mit den Werten Name und Typ enthalten und kann folgendermaßen aussehen:

    <Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryExtensionClass, AssemblyName" />

    Der Wert für Name ist der eindeutige Name der Übermittlungserweiterung. Der Wert für Typ ist eine durch Trennzeichen getrennte Liste, die einen Eintrag für den vollqualifizierten Namespace der Klasse enthält, die die Schnittstelle IDeliveryExtension implementiert, gefolgt vom Namen der Assembly (ohne die DLL-Dateierweiterung). Übermittlungserweiterungen sind standardmäßig sichtbar. Fügen Sie dem Extension-Element das Attribut Visible hinzu und legen es auf FALSE fest, um eine Erweiterung auf Benutzeroberflächen wie dem Webportal auszublenden.

  5. Zum Schluss müssen Sie eine Codegruppe für die benutzerdefinierte Assembly hinzufügen, die die Berechtigung FullTrust für Ihre Erweiterung erteilt. Dazu fügen Sie die Codegruppe der Datei "rssrvpolicy.config" hinzu, die sich standardmäßig in %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServerder Datei befindet. Ihre Codegruppe könnte wie im folgenden Beispiel aussehen:

    <CodeGroup class="UnionCodeGroup"  
   version="1"  
   PermissionSetName="FullTrust"  
   Name="MyExtensionCodeGroup"  
   Description="Code group for my delivery extension">  
      <IMembershipCondition class="UrlMembershipCondition"  
         version="1"  
         Url="C:\Program Files\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"  
       />  
</CodeGroup>

    Die URL-Mitgliedschaft ist eine der vielen Mitgliedschaftsbedingungen, die Sie für die Übermittlungserweiterung auswählen können. Weitere Informationen zur Codezugriffssicherheit in SSRS finden Sie unter Secure Development (Reporting Services)

Überprüfen der Bereitstellung

Sie können prüfen, ob die Übermittlungserweiterung erfolgreich auf dem Berichtsserver bereitgestellt wurde, indem Sie die Webdienstmethode ListExtensions verwenden. Sie können auch das Webportal öffnen und prüfen, ob die Erweiterung in der Liste der für ein Abonnement verfügbaren Übermittlungserweiterungen enthalten ist. Weitere Informationen zum Webportal und zu Abonnements finden Sie unter Abonnements und Übermittlung (Reporting Services).

Zugehöriger Inhalt