Programmabilità della web part Visualizzatore report nell'integrazione con SharePoint

La web part Visualizzatore report è un controllo server ReportViewerWebPart contenente un set di API pubbliche che consentono agli sviluppatori di creare applicazioni di SharePoint personalizzate. È possibile creare web part personalizzate che forniscono parametri e percorsi di report a web part Visualizzatore report tramite connessioni web part. È inoltre possibile incorporare la web part in una pagina web part di SharePoint personalizzata e personalizzarla utilizzando l'API pubblica.

Connessione a web part Visualizzatore report con web part personalizzate

La web part Visualizzatore report è una connessione dell'utente a web part di SharePoint che implementano IWebPartRow o IFilterValues. Una web part IWebPartRow, ad esempio la web part Documenti, può fornire il percorso di un report a una web part Visualizzatore report quando viene inserita nella stessa pagina web part della web part Visualizzatore report. In modo analogo, una web part IFilterValues, ad esempio Filtro testo o Filtro scelte, può fornire un parametro del report a una web part Visualizzatore report quando viene inserita nella stessa pagina web part della web part di Visualizzatore report.

Implementazione di un provider del percorso report con IWebPartRow

Per fornire il percorso di un report a una web part Visualizzatore report tramite connessioni web part, effettuare le operazioni seguenti:

  1. Creare una web part che implementa l'interfaccia IWebPartRow.

  2. Aggiungere la web part alla stessa pagina web part della web part Visualizzatore report.

  3. Connettere la web part alla web part Visualizzatore report nell'interfaccia utente di progettazione delle web part basata sul Web.

    Nota

    Alla web part Visualizzatore report è possibile connettere una sola web part IWebPartRow alla volta e non è possibile connettervi contemporaneamente una web part IWebPartRow e una web part IFilterValues.

Per garantire il funzionamento corretto della web part IWebPartRow con ReportViewerWebPart, è necessario effettuare le operazioni seguenti nel metodo GetRowData(RowCallback):

  • Richiamare il metodo di callback con un oggetto DataRowView come parametro di input.

  • Verificare che l'oggetto DataRowView contenga una colonna denominata "DocUrl" contenente il percorso del report.

    Nota

    La web part Visualizzatore report nel componente aggiuntivo per Office SharePoint Server supporta inoltre la ricezione del percorso del report tramite la colonna "FileRef".

Implementazione del provider di un parametro di report con IFilterValues

Una web part che implementa IFilterValues può fornire un unico parametro di report alla web part Visualizzatore report. 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.

Per fornire un parametro di report a una web part Visualizzatore report, effettuare le operazioni seguenti:

  1. Creare una web part che implementa l'interfaccia IFilterValues.

  2. Aggiungere la web part alla stessa pagina della web part [T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.]

  3. Connettere la web part IFilterValues alla web part Visualizzatore report nell'interfaccia utente di progettazione delle web part basata sul Web.

    Nota

    Alla web part Visualizzatore report è possibile connettere più web part IFilterValues alla volta. Alla web part Visualizzatore report non è tuttavia possibile connettere contemporaneamente una web part IWebPartRow e una web part IFilterValues.