Bereitstellen einer Übermittlungserweiterung

2017-03-06

Übermittlungserweiterungen stellen ihre Konfigurationsinformationen in Form einer XML-Konfigurationsdatei bereit. Die XML-Datei entspricht dem XML-Schema, das für Übermittlungserweiterungen definiert ist. Übermittlungserweiterungen bieten Infrastruktur zum Festlegen 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 der entsprechenden Reporting Services-Konfigurationsdatei einen Eintrag hinzufügen, damit der Berichtsserver sie finden kann.

Configuration-File Erweiterungselement

Übermittlungserweiterungen, die Sie auf dem Berichtsserver bereitstellen, müssen als Extension Elemente in der Konfigurationsdatei eingegeben werden. Die Konfigurationsdatei für den Berichtsserver ist RSReportServer.config.

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

Merkmal	BESCHREIBUNG
`Name`	Ein eindeutiger Name für die Erweiterung (z. B. "Report Server E-Mail" für die E-Mail-Übermittlungserweiterung oder "Report Server FileShare" für die Dateifreigabe-Übermittlungserweiterung). Die maximale Länge für das `Name` Attribut beträgt 255 Zeichen. Der Name muss zwischen allen Einträgen innerhalb des `Extension` Elements einer Konfigurationsdatei eindeutig sein. Wenn ein doppelter Name vorhanden ist, gibt der Berichtsserver einen Fehler zurück.
`Type`	Eine durch Trennzeichen getrennte Liste, die den vollqualifizierten Namespace zusammen mit dem Namen der Assembly enthält.
`Visible`	Ein Wert, der `false` angibt, dass die Übermittlungserweiterung nicht in Benutzeroberflächen sichtbar sein sollte. Wenn das Attribut nicht enthalten ist, lautet `true`der Standardwert .

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

Bereitstellen der Erweiterung auf dem Berichtsserver

Der Berichtsserver verwendet Übermittlungserweiterungen für die Verarbeitung und Bereitstellung von Benachrichtigungen oder Berichten. Sie sollten Die Bereitstellungserweiterungsassembly als private Assembly auf dem Berichtsserver bereitstellen. Sie müssen auch einen Eintrag in der Berichtsserverkonfigurationsdatei RSReportServer.configvornehmen.

So stellen Sie eine Bereitstellungserweiterungsassembly auf einem Berichtsserver bereit

Kopieren Sie die Assembly vom Stagingspeicherort in das Bin-Verzeichnis des Berichtsservers, auf dem Sie die Übermittlungserweiterung verwenden möchten. Der Standardspeicherort des Berichtsservercontainerverzeichnisses ist %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\bin.

Von Bedeutung

Wenn Sie versuchen, eine vorhandene Übermittlungserweiterungsassembly zu überschreiben, müssen Sie zuerst den Report Server-Dienst beenden, bevor Sie die aktualisierte Assembly kopieren. Starten Sie den Dienst neu, nachdem die Assembly kopiert wurde.
Öffnen Sie nach dem Kopieren der Assemblydatei die RSReportServer.config Datei. Die RSReportServer.config Datei befindet sich im %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<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 einem einfachen Text-Editor öffnen, z. B. Editor.
Suchen Sie das Delivery Element in der RSReportServer.config Datei. Ein Eintrag für Die neu erstellte Übermittlungserweiterung sollte an folgendem Ort erfolgen:
```
<Extensions>  
   <Delivery>  
      <Your extension configuration information goes here>  
   </Delivery>  
</Extensions>  
```
Fügen Sie einen Eintrag für Ihre Übermittlungserweiterung hinzu. Ihr Eintrag sollte ein Extension Element mit Werten enthalten NameTypeund kann wie folgt aussehen:
```
<Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryExtensionClass, AssemblyName" />  
```
Der Wert ist Name der eindeutige Name der Übermittlungserweiterung. Der Wert für Type ist eine durch Trennzeichen getrennte Liste, die einen Eintrag für den vollqualifizierten Namespace Ihrer Klasse enthält, der die IDeliveryExtension Schnittstelle implementiert, gefolgt vom Namen der Assembly (nicht einschließlich der .dll Dateierweiterung). Standardmäßig sind Übermittlungserweiterungen sichtbar. Um eine Erweiterung aus Benutzeroberflächen wie dem Berichts-Manager auszublenden, fügen Sie dem Extension Element ein Visible Attribut hinzu, und legen Sie sie auf false.
Fügen Sie schließlich eine Codegruppe für Ihre benutzerdefinierte Assembly hinzu, die berechtigungen für Ihre Übermittlungserweiterung erteilt FullTrust . Dazu fügen Sie die Codegruppe der rssrvpolicy.config Datei hinzu, die sich standardmäßig in %ProgramFiles%\Microsoft SQL Server\MSRS10_50 befindet.<InstanceName>\Reporting Services\ReportServer. Ihre Codegruppe sieht möglicherweise wie folgt aus:
```
<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\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"  
       />  
</CodeGroup>  
```
Die URL-Mitgliedschaft ist nur eine von vielen Mitgliedschaftsbedingungen, die Sie für Ihre Übermittlungserweiterung auswählen können. Weitere Informationen zur Codezugriffssicherheit in SSRS finden Sie unter. Sichere Entwicklung (Reporting Services)

Bereitstellen der Erweiterung im Berichts-Manager

Wenn Ihre Übermittlungserweiterung die ISubscriptionBaseUIUserControl Schnittstelle implementiert, kann Ihre Übermittlungserweiterung mit der Berichts-Manager-Abonnementseite verwendet werden. Um die Benutzeroberfläche des Abonnements verfügbar zu machen, müssen Sie Ihre Erweiterung im Berichts-Manager bereitstellen.

So stellen Sie eine Erweiterungsassembly für den Berichts-Manager bereit

Kopieren Sie Die Assembly vom Stagingspeicherort in das Bin-Verzeichnis des Berichts-Managers. Der Standardspeicherort des Berichts-Manager-Bin-Verzeichnisses ist %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportManager\bin.
Öffnen Sie nach dem Kopieren der Assemblydatei die RSReportServer.config Datei. Die RSReportServer.config Datei befindet sich im %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<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 Visual Studio .NET oder einem einfachen Text-Editor öffnen, z. B. Editor.
Suchen Sie das DeliveryUI Element in der RSReportServer.config Datei. Ein Eintrag für Die neu erstellte Übermittlungserweiterung sollte an folgendem Ort erfolgen:
```
<Extensions>  
   <DeliveryUI>  
      <Your extension configuration information goes here>  
   </DeliveryUI>  
</Extensions>  
```
Fügen Sie einen Eintrag für Ihre Übermittlungserweiterung hinzu. Ihr Eintrag sollte ein Extension Element mit Werten Name enthalten und Type sieht möglicherweise wie folgt aus:
```
<Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryUIExtensionClass, AssemblyName" />  
```
Der Wert ist Name der eindeutige Name der Übermittlungserweiterung. Der Wert für Type ist eine durch Trennzeichen getrennte Liste, die einen Eintrag für den vollqualifizierten Namespace Ihrer Klasse enthält, der die ISubscriptionBaseUIUserControl Schnittstelle implementiert, gefolgt vom Namen der Assembly (nicht einschließlich der .dll Dateierweiterung).

Von Bedeutung

Der Wert des Name Attributs muss für die Konfigurationsdateieinträge "Report Server" und "Report Manager" identisch sein. Wenn sie nicht identisch sind, ist die Serverkonfiguration ungültig.

Fügen Sie schließlich eine Codegruppe für Ihre benutzerdefinierte Assembly hinzu, die berechtigungen für Ihre Übermittlungserweiterung erteilt FullTrust . Dazu fügen Sie die Codegruppe zur RSmgrpolicy.config Datei hinzu, die sich standardmäßig in "C:\Programme\Microsoft SQL Server\MSRS10_50" befindet.<InstanceName>\Reporting Services\ReportManager. Ihre Codegruppe sieht möglicherweise wie folgt aus:
```
<CodeGroup class="UnionCodeGroup"  
   version="1"  
   PermissionSetName="FullTrust"  
   Name="MyExtensionCodeGroup"  
   Description="Code group for my delivery UI extension">  
      <IMembershipCondition class="UrlMembershipCondition"  
         version="1"  
         Url="C:\Program Files\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportManager\bin\MyExtensionAssembly.dll"  
       />  
</CodeGroup>  
```
Die URL-Mitgliedschaft ist nur eine von vielen Mitgliedschaftsbedingungen, die Sie für Ihre Übermittlungserweiterung auswählen können. Weitere Informationen zur Codezugriffssicherheit in SSRS finden Sie unter Secure Development (Reporting Services)

Überprüfen der Bereitstellung

Mithilfe der Webdienstmethode ListExtensions können Sie überprüfen, ob die Übermittlungserweiterung erfolgreich auf dem Berichtsserver bereitgestellt wurde. Sie können auch den Berichts-Manager öffnen und überprüfen, ob Ihre Erweiterung in der Liste der verfügbaren Übermittlungserweiterungen für ein Abonnement enthalten ist. Weitere Informationen zum Berichts-Manager und zu Abonnements finden Sie unter Abonnements und Übermittlung (Reporting Services).For more information about Report Manager and subscriptions, see Subscriptions and Delivery (Reporting Services).

Siehe auch

Implementieren einer Übermittlungserweiterung
Erweiterungsbibliothek für Reporting Services

Freigeben über