• Artikel

Berichts-Viewer-Webpart-Programmierbarkeit in SharePoint-Integration

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

Herstellen einer Verbindung mit Berichts-Viewer-Webpart mit benutzerdefinierten Webparts

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

Implementieren eines Berichtspfadanbieters mit IWebPartRow

Um durch Webpartverbindungen einen Berichtspfad zum Berichts-Viewer-Webpart anzugeben, gehen Sie wie folgt vor:

  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.

    HinweisHinweis

    Sie können nur jeweils ein IWebPartRow-Webpart mit dem Berichts-Viewer-Webpart verbinden, und Sie können nicht ein IWebPartRow-Webpart und ein IFilterValues-Webpart mit dem Berichts-Viewer-Webpart verbinden.

Damit der IWebPartRow-Webpart ordnungsgemäß mit dem ReportViewerWebPart-Webpart funktioniert, müssen Sie Folgendes in der GetRowData(RowCallback)-Methode durchfü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.

    HinweisHinweis

    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, der IFilterValues implementiert, kann einen Parameterwert für den Berichts-Viewer-Webpart bereitstellen. Der an den Berichts-Viewer-Webpart gesendete Parameterwert unterliegt gemäß der Angabe in der Berichtsdefinition denselben Einschränkungen wie der Berichtsparameter, zum Beispiel Datentyp, gültige Werte usw.

Um dem Berichts-Viewer-Webpart einen Berichtsparameter bereitzustellen, gehen Sie wie folgt vor:

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

  2. Fügen Sie den Webpart zur selben Seite wie den [T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.]-Webpart hinzu.

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

    HinweisHinweis

    Sie können mehrere IFilterValues-Webparts gleichzeitig mit dem Berichts-Viewer-Webpart verbinden. Sie können jedoch nicht sowohl ein IWebPartRow-Webpart als auch ein IFilterValues-Webpart gleichzeitig mit dem Berichts-Viewer-Webpart verbinden.