SharePoint 통합의 보고서 뷰어 웹 파트 프로그래밍 기능Report Viewer Web Part Programmability in SharePoint Integration

보고서 뷰어 웹 파트는 서버 컨트롤로, 개발자가 사용자 지정 SharePoint 응용 프로그램을 만드는 데 사용할 수 있는 공용 API(응용 프로그래밍 인터페이스) 집합을 포함합니다.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. 웹 파트 연결을 사용하여 보고서 뷰어 웹 파트에 보고서 경로 및 매개 변수를 제공하는 사용자 지정 웹 파트를 만들 수 있습니다.You can create custom Web Parts that supply report path and parameters to Report Viewer Web Part using Web Part connections. 사용자 지정 SharePoint 웹 파트 페이지 내에 웹 파트를 포함하고 공용 API를 사용하여 웹 파트를 사용자 지정할 수도 있습니다.You can also embed the Web Part in a custom SharePoint Web Part page and customize it using the public API.

사용자 지정 웹 파트를 사용하여 보고서 뷰어 웹 파트에 연결Connecting to Report Viewer Web Part with Custom Web Parts

보고서 뷰어 웹 파트는 IWebPartRow 또는 T:Microsoft.SharePoint.WebPartPages.IFilterValues를 구현하는 SharePoint 웹 파트에 대한 연결 소비자입니다.The Report Viewer Web Part is a connection consumer to SharePoint Web Parts that implement IWebPartRow or T:Microsoft.SharePoint.WebPartPages.IFilterValues. 문서 웹 파트와 같은 IWebPartRow 웹 파트는 보고서 뷰어 웹 파트와 동일한 웹 파트 페이지에 배치되는 경우 보고서 뷰어 웹 파트에 보고서 경로를 제공할 수 있습니다.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. 마찬가지로, 텍스트 필터 또는 선택 필터와 같은 T:Microsoft.SharePoint.WebPartPages.IFilterValues 웹 파트는 보고서 뷰어 웹 파트와 동일한 웹 파트 페이지에 배치되는 경우 보고서 뷰어 웹 파트에 보고서 매개 변수를 제공할 수 있습니다.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.

IWebPartRow를 사용하여 보고서 경로 공급자 구현Implementing a Report Path Provider with IWebPartRow

웹 파트 연결을 통해 보고서 뷰어 웹 파트에 보고서 경고를 제공하려면 다음을 수행하십시오.To supply a report path to the Report Viewer Web Part through Web Part connections, do the following:

  1. IWebPartRow 인터페이스를 구현하는 웹 파트를 만듭니다.Create a Web Part that implements the IWebPartRow interface.

  2. 이 웹 파트를 보고서 뷰어 웹 파트와 동일한 웹 파트 페이지에 추가합니다.Add the Web Part to the same Web Part page as the Report Viewer Web Part.

  3. 웹 기반 웹 파트 디자인 사용자 인터페이스에서 웹 파트를 보고서 뷰어 웹 파트에 연결합니다.Connect your Web Part to the Report Viewer Web Part in the Web-based Web Part design user interface.

    참고

    보고서 뷰어 웹 파트에는 한 번에 하나의 IWebPartRow 웹 파트만 연결할 수 있으며, IWebPartRow 웹 파트와 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.

    IWebPartRow 웹 파트를 T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart와 함께 제대로 작동하려면 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:

  • 입력 매개 변수로 DataRowView 개체를 사용하여 콜백 메서드를 호출합니다.Invoke the callback method with a DataRowView object as the input parameter.

  • DataRowView 개체에 보고서 경로를 포함하는 "DocUrl"이라는 열이 있는지 확인합니다.Make sure that the DataRowView object contains a column called "DocUrl" that contains the report path.

    참고

    Office SharePoint ServerOffice SharePoint Server 2010용 추가 기능의 보고서 뷰어 웹 파트에서도 "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.

IFilterValues를 사용하여 보고서 매개 변수 공급자 구현Implementing a Report Parameter Provider with IFilterValues

T:Microsoft.SharePoint.WebPartPages.IFilterValues를 구현하는 웹 파트는 보고서 뷰어 웹 파트에 하나의 매개 변수 값을 제공할 수 있습니다.A Web Part that implements T:Microsoft.SharePoint.WebPartPages.IFilterValues can provide one parameter value to the Report Viewer Web Part. 보고서 뷰어 웹 파트로 전달되는 이 매개 변수 값에는 보고서 정의에서 보고서 매개 변수에 대해 설정된 것과 동일한 제한(예: 데이터 형식, 유효한 값 등)이 적용됩니다.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

보고서 뷰어 웹 파트에 보고서 매개 변수를 제공하려면 다음을 수행하십시오.To supply a report parameter to the Report Viewer Web Part, do the following:

  1. T:Microsoft.SharePoint.WebPartPages.IFilterValues 인터페이스를 구현하는 웹 파트를 만듭니다.Create a Web Part that implements the T:Microsoft.SharePoint.WebPartPages.IFilterValues interface.

  2. 웹 파트를 T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart와 동일한 페이지에 추가합니다.Add the Web Part to the same page as the T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.

  3. 웹 기반 웹 파트 디자인 사용자 인터페이스에서 T:Microsoft.SharePoint.WebPartPages.IFilterValues 웹 파트를 보고서 뷰어 웹 파트에 연결합니다.Connect your T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Part to the Report Viewer Web Part in the Web-based Web Part design user interface.

    참고

    한 번에 여러 개의 T:Microsoft.SharePoint.WebPartPages.IFilterValues 웹 파트를 보고서 뷰어 웹 파트에 연결할 수 있습니다.You can connect multiple T:Microsoft.SharePoint.WebPartPages.IFilterValues Web Parts to the Report Viewer Web Part at a time. 그러나 IWebPartRow 웹 파트와 T:Microsoft.SharePoint.WebPartPages.IFilterValues 웹 파트를 보고서 뷰어 웹 파트에 동시에 모두 연결할 수 없습니다.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.