Programmierbarkeit des Berichtsanzeige-Webparts in der SharePoint-Integration

  • Artikel

Das Berichts-Viewer-Webpart ist ein Serversteuerelement, das einen Satz von öffentlichen Anwendungsprogrammierschnittstellen (API) enthält, mit dem Entwickler benutzerdefinierte SharePoint-Anwendungen erstellen können. Sie können benutzerdefinierte Webparts erstellen, die Berichtspfad und Parameter mit Webpartverbindungen zu Berichts-Viewer-Webparts angeben. Sie können auch das Webpart in eine benutzerdefinierte SharePoint-Webpartseite einbetten und es mit der öffentlichen API anpassen.

Verbinden zum Berichtsanzeige-Webpart mit benutzerdefinierten Webparts

Der Berichts-Viewer-Webpart ist ein Verbindungsconsumer zu SharePoint-Webparts, die IWebPartRow oder T:Microsoft.SharePoint.WebPartPages.IFilterValues implementieren. Ein IWebPartRow-Webpart wie das Dokumente-Webpart kann einen Berichtspfad zu einem Berichts-Viewer-Webpart angeben, wenn es auf der gleichen Webpartseite wie das Berichts-Viewer-Webpart platziert wird. Genauso kann ein T:Microsoft.SharePoint.WebPartPages.IFilterValues-Webpart, wie z.B. der Textfilter oder der Auswahlfilter, einen Berichtsparameter zu einem Berichts-Viewer-Webpart angeben, wenn es auf der gleichen Webpartseite wie das Berichts-Viewer-Webpart platziert wird.

Implementieren eines Berichtspfadanbieters mit IWebPartRow

Führen Sie die folgenden Schritte aus, um einen Berichtspfad zum Berichtsanzeige-Webpart über Webpartverbindungen zur Verfügung zu stellen:

  1. Erstellen Sie einen Webpart, der die IWebPartRow-Schnittstelle implementiert.

  2. Fügen Sie den Webpart zur selben Webpartseite wie den Berichts-Viewer-Webpart hinzu.

  3. Verbinden Sie den Webpart mit dem Berichts-Viewer-Webpart in der webbasierten Webpart-Entwurfsbenutzeroberfläche.

    Hinweis

    Sie können nur jeweils ein IWebPartRow-Webpart mit dem Berichts-Viewer-Webpart verbinden, und Sie können nicht gleichzeitig ein IWebPartRow-Webpart und ein T:Microsoft.SharePoint.WebPartPages.IFilterValues-Webpart mit dem Berichts-Viewer-Webpart verbinden.

Damit Ihr IWebPartRow Webpart ordnungsgemäß mit dem T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart funktioniert, müssen Sie die folgenden Schritte für die GetRowData Methode ausführen:

  • Rufen Sie die Rückrufmethode mit einem DataRowView-Objekt als Eingabeparameter auf.

  • Stellen Sie sicher, dass das DataRowView-Objekt eine Spalte mit dem Namen "DocUrl" enthält, die den Berichtspfad enthält.

    Hinweis

    Das Berichts-Viewer-Webpart im Add-In für Office SharePoint Server 2010 unterstützt auch das Empfangen von Berichtspfaden, die die Spalte "FileRef" verwenden.

Implementieren eines Berichtsparameteranbieters mit IFilterValues

Ein Webpart, das T:Microsoft.SharePoint.WebPartPages.IFilterValues implementiert, kann einen Parameterwert für das Berichts-Viewer-Webpart bereitstellen. Der an das Berichtsanzeige-Webpart gesendete Parameterwert unterliegt den gleichen Einschränkungen, die für den Berichtsparameter gelten, wie in der Berichtsdefinition angegeben, z. B. Datentyp, gültige Werte usw.

Führen Sie die folgenden Schritte aus, um dem Berichtsanzeige-Webpart einen Berichtsparameter zur Verfügung zu stellen:

  1. Erstellen Sie ein Webpart, das die T:Microsoft.SharePoint.WebPartPages.IFilterValues-Schnittstelle implementiert.

  2. Fügen Sie das Webpart zu derselben Seite wie das T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewer-Webpart hinzu.

  3. Verbinden Sie Ihr T:Microsoft.SharePoint.WebPartPages.IFilterValues-Webpart mit dem Berichts-Viewer-Webpart in der webbasierten Webpart-Entwurfsbenutzeroberfläche.

    Hinweis

    Sie können mehrere T:Microsoft.SharePoint.WebPartPages.IFilterValues-Webparts gleichzeitig mit dem Berichts-Viewer-Webpart verbinden. Allerdings können Sie nicht gleichzeitig ein IWebPartRow-Webpart und ein T:Microsoft.SharePoint.WebPartPages.IFilterValues-Webpart mit dem Berichts-Viewer-Webpart verbinden.