Programmabilità della web part Visualizzatore report nell'integrazione con SharePointReport Viewer Web Part Programmability in SharePoint Integration

La web part Visualizzatore di report è un controllo server contenente un set di API pubbliche che consentono agli sviluppatori di creare applicazioni di SharePoint personalizzate.The Report Viewer Web Part is a server control, which contains a set of public application programming interfaces (API) that enables developers to create custom SharePoint applications. È possibile creare web part personalizzate che forniscono parametri e percorsi di report a web part Visualizzatore report tramite connessioni web part.You can create custom Web Parts that supply report path and parameters to Report Viewer Web Part using Web Part connections. È inoltre possibile incorporare la web part in una pagina web part di SharePoint personalizzata e personalizzarla usando l'API pubblica.You can also embed the Web Part in a custom SharePoint Web Part page and customize it using the public API.

Connessione a web part Visualizzatore report con web part personalizzateConnecting to Report Viewer Web Part with Custom Web Parts

La web part Visualizzatore di report è una connessione dell'utente a web part di SharePoint che implementano IWebPartRow o T:Microsoft.SharePoint.WebPartPages.IFilterValues.The Report Viewer Web Part is a connection consumer to SharePoint Web Parts that implement IWebPartRow or T:Microsoft.SharePoint.WebPartPages.IFilterValues. Una web part IWebPartRow, ad esempio la web part Documenti, può fornire il percorso di un report a una web part Visualizzatore di report quando viene inserita nella stessa pagina web part della web part Visualizzatore di report.An IWebPartRow Web Part, such as the Documents Web Part can supply a report path to a Report Viewer Web Part when placed on the same Web Part page as the Report Viewer Web Part. In modo analogo, una web part T:Microsoft.SharePoint.WebPartPages.IFilterValues, ad esempio Filtro testo o Filtro scelte, può fornire un parametro del report a una web part Visualizzatore di report quando viene inserita nella stessa pagina web part della web part Visualizzatore di report.Likewise, an T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Part, such as the Text Filter or the Choice Filter, can supply a report parameter to a Report Viewer Web Part when placed on the same Web Part page as the Report Viewer Web Part.

Implementazione di un provider del percorso report con IWebPartRowImplementing a Report Path Provider with IWebPartRow

Per fornire il percorso di un report a una web part Visualizzatore report tramite connessioni web part, eseguire le operazioni seguenti:To supply a report path to the Report Viewer Web Part through Web Part connections, do the following:

  1. Creare una web part che implementa l'interfaccia IWebPartRow.Create a Web Part that implements the IWebPartRow interface.

  2. Aggiungere la web part alla stessa pagina web part della web part Visualizzatore report.Add the Web Part to the same Web Part page as the Report Viewer Web Part.

  3. Connettere la web part alla web part Visualizzatore report nell'interfaccia utente di progettazione delle web part basata sul Web.Connect your Web Part to the Report Viewer Web Part in the Web-based Web Part design user interface.

    Nota

    Alla web part Visualizzatore di report è possibile connettere una sola web part IWebPartRow alla volta e non è possibile connettervi contemporaneamente una web part IWebPartRow e una web part T:Microsoft.SharePoint.WebPartPages.IFilterValues.You can only connect one IWebPartRow Web Part to the Report Viewer Web Part at a time, and you cannot connect both an IWebPartRow Web Part and an T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Part to the Report Viewer Web Part at the same time.

    Per consentire il funzionamento corretto della web part IWebPartRow con la web part T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewer, è necessario eseguire le operazioni seguenti nel metodo GetRowData:For your IWebPartRow Web Part to work properly with the T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart, you must do the following in the GetRowData method:

  • Richiamare il metodo di callback con un oggetto DataRowView come parametro di input.Invoke the callback method with a DataRowView object as the input parameter.

  • Verificare che l'oggetto DataRowView contenga una colonna denominata "DocUrl" contenente il percorso del report.Make sure that the DataRowView object contains a column called "DocUrl" that contains the report path.

    Nota

    La web part Visualizzatore report nel componente aggiuntivo per Office SharePoint ServerOffice SharePoint Server supporta inoltre la ricezione del percorso del report tramite la colonna "FileRef".The Report Viewer Web Part in the add-in for Office SharePoint ServerOffice SharePoint Server 2010 also supports receiving the report path using the "FileRef" column.

Implementazione del provider di un parametro di report con IFilterValuesImplementing a Report Parameter Provider with IFilterValues

Una web part che implementa T:Microsoft.SharePoint.WebPartPages.IFilterValues può fornire un unico parametro di report alla web part Visualizzatore di report.A Web Part that implements T:Microsoft.SharePoint.WebPartPages.IFilterValues can provide one parameter value to the Report Viewer Web Part. Il valore del parametro inviato alla web part Visualizzatore report è soggetto alle stesse restrizioni esistenti per il parametro del report come specificato nella definizione del report, ad esempio tipo di dati, valori validi e così via.The parameter value sent to the Report Viewer Web Part is subject to the same restrictions placed on the report parameter as specified in the report definition, such as data type, valid values, and so on

Per fornire un parametro di report a una web part Visualizzatore report, eseguire le operazioni seguenti:To supply a report parameter to the Report Viewer Web Part, do the following:

  1. Creare una web part che implementa l'interfaccia T:Microsoft.SharePoint.WebPartPages.IFilterValues.Create a Web Part that implements the T:Microsoft.SharePoint.WebPartPages.IFilterValues interface.

  2. Aggiungere la web part alla stessa pagina della web part T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewer.Add the Web Part to the same page as the T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.

  3. Connettere la web part T:Microsoft.SharePoint.WebPartPages.IFilterValues alla web part Visualizzatore di report nell'interfaccia utente di progettazione delle web part basata sul Web.Connect your T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Part to the Report Viewer Web Part in the Web-based Web Part design user interface.

    Nota

    È possibile connettere più web part T:Microsoft.SharePoint.WebPartPages.IFilterValues alla web part Visualizzatore di report.You can connect multiple T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Parts to the Report Viewer Web Part at a time. Tuttavia, non è possibile connettere contemporaneamente una web part IWebPartRow e una web part T:Microsoft.SharePoint.WebPartPages.IFilterValues alla web part Visualizzatore di report.However, you cannot connect both an IWebPartRow Web Part and an T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Part to the Report Viewer Web Part at the same time.