보고서 뷰어 웹 파트를 사용자 지정Customize the Report Viewer web part

이 항목 적용 대상:THIS TOPIC APPLIES TO: 예SQL Server Reporting Services(2016)SQL Server Reporting Services (2016) 예SharePointSharePoint 아니요Power BI 보고서 서버Power BI Report Server 예SQL Server Reporting Services(2016)SQL Server Reporting Services (2016) 예SharePointSharePoint 아니요Power BI 보고서 서버Power BI Report Server

이전 버전의 SQL Server Reporting Services와 관련된 콘텐츠는 SQL Server Reporting Services 2014를 참조하세요.For content related to previous versions of SQL Server Reporting Services, see SQL Server Reporting Services 2014.

SharePoint 통합 모드로 구성 된 보고서 서버에서 실행 되는 보고서를 보려면 보고서 뷰어 웹 파트를 사용할 수 있습니다.You can use the Report Viewer web part to view reports that run on a report server that is configured for SharePoint integration. 표시할 수 있는 보고서에는 보고서 정의 파일(.rdl)과 보고서 작성기 보고서가 있습니다.Reports that you can display include report definition (.rdl) files and Report Builder reports. 보고서를 열어 새 페이지에 보고서 뷰어 웹 파트에서 자동으로 있지만 있습니다 수 추가할 수도 보고서 뷰어 웹 파트는 기존 웹 페이지 또는 사이트에 특정 보고서가 항상 해당 페이지에 표시 되도록 하려는 경우.Reports open in the Report Viewer web part in a new page automatically, but you can also add a Report Viewer web part to an existing web page or site if you want a particular report to always be visible on that page.

참고

보고서 뷰어 웹 파트를 통해 설치 된 동일한 이름가 없지만 Reporting ServicesReporting Services 인 추가 기능는 RSWebParts.cab 파일에 포함 된 보고서 뷰어 웹 파트와에서 다릅니다.Although they have identical names, the Report Viewer web part that is installed through the Reporting ServicesReporting Services Add-in is different from the Report Viewer web part that is included in the RSWebParts.cab file. 이 항목의 지침은 보고서 뷰어 웹 파트를 통해 설치를 위한 구체적으로 Reporting ServicesReporting Services 추가 기능을 합니다.The instructions in this topic are specifically for the Report Viewer web part that is installed through the Reporting ServicesReporting Services Add-in.

다음과 같은 방법으로 보고서 뷰어 웹 파트를 사용자 지정할 수 있습니다.You can customize the Report Viewer web part in the following ways:

  • 속성을 설정 하 여 웹 파트의 모양을 변경 합니다.Change the appearance of the web part by setting properties.

  • 보고서 도구 모음에서 사용할 대화형 보고 기능을 선택합니다.Choose which interactive reporting features are available on the report toolbar.

  • 사용할 보기 영역을 지정합니다.Specify which view areas are available. 보고서 뷰어 웹 파트에는 보고서 보기 영역, 매개 변수 영역 및 자격 증명 영역이 있습니다.The Report Viewer web part has a report view area, a Parameters area, and a Credentials area.

    다른 파일 유형을 지원 하도록 보고서 뷰어 웹 파트를 확장할 수 없습니다 및 기존 도구 모음에 새 기능을 추가 하거나 사용자 지정 도구 모음으로 보고서 도구 모음을 대체할 수 없습니다.You cannot extend the Report Viewer web part to support different file types, and you cannot replace the report toolbar with a custom toolbar or add new functionality to the existing toolbar. 사용자 지정 표준 기능 필요한 경우 사용자 지정 웹 파트를 만들어야 합니다.If you require customization of the standard features, you should create a custom web part.

웹 파트 속성 설정Setting web part properties

웹 파트에 특정 기능을 구성 하는 데 사용 되는 사용자 지정 속성이 있습니다.A web part has custom properties that are used to configure specific functionality. 웹 파트에는 다음과 같은 모든 웹 파트에 대 한 표준 공통 속성이 있습니다.A web part also has common properties that are standard for every web part.

기본 속성 변경Change default properties

보고서 뷰어 웹 파트에 라이브러리 또는 폴더에서 요청 시 보고서를 열에 적합 한 기본 속성이 있습니다.The Report Viewer web part has default properties that are ideally suited for opening reports on demand from a library or folder. 기본적으로 사용 가능한 모든 컨트롤이 도구 모음에 표시 됩니다 및 높이 너비는 웹 페이지에서 모든 사용 가능한 공간을 사용 하도록 설정 됩니다.By default, all available controls are displayed on the toolbar, and height and width are set to use all of the available space on the web page. 통해 웹 파트를 사용자 지정할 수는 기본 속성을 수정 하려는 경우 사이트 설정합니다.If you want to modify the default properties, you can customize the web part through Site Settings.

  1. 사이트 동작 메뉴에서 사이트 설정을 클릭합니다.On the Site Actions menu, click Site Settings.

  2. 갤러리에서 클릭 웹 파트합니다.Under Galleries, click web parts.

  3. ReportViewer.dwp를 클릭합니다.Click ReportViewer.dwp.

  4. 도구 창을 열고 사용할 속성을 설정합니다.Open the tool pane and set the properties you want to use.

웹 페이지에 포함된 된 보고서 뷰어 사용자 지정Customize an embedded Report Viewer in a web page

보고서 뷰어 웹 페이지 내에 포함 되도록 속성을 설정할 수 있습니다.You can set properties to make the Report Viewer fit within a web page. 보고서 뷰어는 속해 있는 페이지와 동일한 스타일 및 색을 사용할 수 있습니다.The report viewer can use the same style and colors as the page that contains it. 도구 모음, 문서 구조 및 매개 변수 영역의 전체 또는 일부를 숨겨 할당된 공간 내에서 보고서 보기 영역을 최대화할 수 있습니다.You can hide all or part of the toolbar, document map, and parameters area to maximize the report viewing area within the allocated space. 보고서는 항상 보고서가 생성될 때 정의된 스타일을 사용합니다. 보고서가 SharePoint 라이브러리에 게시된 후에는 보고서 모양을 사용자 지정할 수 없습니다.The report always uses the styles that are defined for it when it was created; you cannot customize report appearance after it is published to a SharePoint library.

웹 페이지에 보고서 뷰어 웹 파트를 포함 하는 경우 설정 해야는 보고서 URL 특정 보고서에는 속성입니다.If you are embedding the Report Viewer web part in a web page, you should set the Report URL property to a specific report. 그렇게 하지 않으면 보고서 뷰어에 보고서 연결에 대한 지침이 표시됩니다.If you do not, the Report Viewer will display instructions for linking to a report. 지침을 사용자 지정하거나 제거할 수는 없습니다.You cannot customize or remove the instructions.

보고서 뷰어 웹 파트의 사용자 지정 속성Custom properties of the Report Viewer web part

사용자 지정 속성을 설정할 때 유의 일부 속성은 보고서 뷰어 웹 파트가 페이지에 포함 된 경우에 사용 됩니다.When setting custom properties, be aware that some properties are used only when the Report Viewer web part is embedded in a page. 이러한 속성으로는 제목, 높이, 너비, 크롬 유형 및 영역을 들 수 있습니다.Examples include Title, Height, Width, Chrome type, and Zone. 도구 모음 설정 및 매개 변수 설정과 같은 기타 속성은 보고서 뷰어가 페이지 내에 나타나는지, 아니면 전체 페이지 모드로 보고서를 여는지에 관계없이 사용됩니다.Other properties, such as Toolbar settings and Parameters settings, are used regardless of whether the Report Viewer appears within a page or opens a report in full-page mode.

보고서 뷰어 웹 파트의 사용자 지정 속성은 다음과 같습니다.The custom properties of the Report Viewer web part are listed below.

속성Property DescriptionDescription
보고서Report 현재 SharePoint 사이트나 동일한 웹 응용 프로그램 또는 팜 내의 사이트에 있는 보고서에 대한 정규화된 경로여야 합니다.A fully-qualified path to a report that is on the current SharePoint site, or on a site within the same Web application or farm. 추가 속성을 설정할 때 최상의 결과를 얻으려면 보고서 URL을 지정한 다음 적용을 클릭합니다.For best results when setting additional properties, click Apply after you specify the report URL.
하이퍼링크 대상Hyperlink Target 현재 문서 내에 연결된 내용을 표시할 대상 프레임을 지정하는 표준 HTML입니다.Standard HTML that specifies the target frame for displaying linked content within the current document. 외부 웹 사이트에 대한 하이퍼링크가 포함된 보고서의 경우 대상 문서로 현재 창 내의 기존 보고서를 대체할지, 아니면 해당 문서를 새 브라우저 창에서 열지를 지정할 수 있습니다.For reports that include hyperlinks to external Web sites, you can specify whether a target document replaces the existing report within the current window, or opens in a new browser window. 유효한 값은 _Top, _Blank_Self입니다.Valid values include _Top, _Blank, and _Self. _Top 은 현재 창을 사용하고, _Blank 는 새 브라우저 창에서 문서를 로드하며 _Self 는 현재 프레임 내에서 문서를 엽니다._Top uses the current window, _Blank loads the document in a new browser window, and _Self opens the document within the current frame. 하지만 _Parent HTML의 대상 특성 사용 하지 마십시오 페이지에 포함 하는 보고서 뷰어 웹 파트에 대 한 유효한 값입니다.Although _Parent is a valid value for the Target attribute in HTML, do not use it for a Report Viewer web part that is embedded in a page.
웹 파트 제목 자동 생성Auto-Generate web part Title 보고서 뷰어 웹 파트의 이름과 대시로 구분 된 보고서의 이름을 포함 하는 생성 된 제목입니다.A generated title that includes the name of the Report Viewer web part plus the name of the report, separated by a dash. 보고서에 제목이 없는 경우 보고서 파일 이름이 사용됩니다.If the report does not have a title, the report file name is used. 페이지에 웹 파트를 추가 하면 제목이 표시 됩니다.The title is visible when you add a web part to a page. 이 확인란을 선택한 경우 페이지를 새로 고칠 때마다 제목이 생성됩니다.If this check box is selected, the title will be generated each time the page is refreshed.
웹 파트 제목 세부 정보 링크 자동 생성Auto-Generate web part Title Detail Link 웹 파트 위에 나타나는 생성 된 하이퍼링크입니다.A generated hyperlink that appears above the web part. 이 링크를 클릭하여 보고서를 전체 페이지 모드로 새 페이지에서 열 수 있습니다.You can click the link to open the report in a new page, in full-page mode.
보고서 작성기 메뉴 항목 표시Show report builder menu item 보고서 작성기를 여는 동작 메뉴 옵션을 표시하거나 숨깁니다.Shows or hides the Actions menu option to open Report Builder.
구독 메뉴 항목 표시Show subscription menu item 보고서에 대한 구독을 만드는 동작 메뉴 옵션을 표시하거나 숨깁니다.Shows or hides the Actions menu option to create a subscription for the report.
인쇄 메뉴 항목 표시Show print menu item 보고서를 인쇄하는 동작 메뉴 옵션을 표시하거나 숨깁니다.Shows or hides the Actions menu option to print the report.
내보내기 메뉴 항목 표시Show export menu item 보고서를 내보내는 동작 메뉴 옵션을 표시하거나 숨깁니다.Shows or hides the Actions menu option to export the report.
새로 고침 단추 표시Show refresh button 도구 모음에 새로 고침 단추를 표시하거나 숨깁니다.Shows or hides the refresh button on the toolbar.
페이지 탐색 컨트롤 표시Show page navigation controls 도구 모음에 보고서 탐색 단추를 표시하거나 숨깁니다.Shows or hides the report navigation buttons on the toolbar. 이 옵션은 모든 탐색 컨트롤의 표시 여부를 변경합니다.This option changes the visibility of all the navigation controls.
뒤로 단추 표시Show back button 도구 모음에 뒤로 단추를 표시하거나 숨깁니다.Shows or hides the back button on the toolbar.
찾기 컨트롤 표시Show find controls 도구 모음에 찾기 컨트롤을 표시하거나 숨깁니다.Shows or hides the find controls on the toolbar. 찾기 컨트롤을 사용하여 렌더링된 보고서에서 텍스트를 검색할 수 있습니다.The find controls allow a user to search for text in the rendered report. 이 옵션은 모든 찾기 컨트롤의 표시 여부를 변경합니다.This option changes the visibility of all the find controls.
확대/축소 컨트롤 표시Show zoom control 도구 모음에 확대/축소 컨트롤을 표시하거나 숨깁니다.Shows or hides the zoom control on the toolbar.
ATOM 피드 단추 표시Show ATOM feed button 도구 모음에 ATOM 피드 단추를 표시하거나 숨깁니다.Shows or hides the ATOM feed button on the toolbar.

htmlviewer_datafeedhtmlviewer_datafeed
도구 모음 위치ToolBar location 보고서 뷰어에서 도구 모음의 위치를 결정합니다.Determines the location of the toolbar within the report viewer. 유효한 값은 TopBottom이고Valid values include Top and Bottom.
프롬프트 영역Prompt area 유효한 값은 Displayed, CollapsedHidden입니다.Valid values include Displayed, Collapsed, and Hidden. Displayed 를 선택하면 매개 변수가 있는 값이 포함되어 있고 사용자 입력이 있어야 실행되는 보고서에 대해 매개 변수 영역이 표시됩니다.Displayed displays the Parameters area for reports that include parameterized values and that require user input before the report will run. 모든 보고서 매개 변수가 지정되어 있어 사용자에게 매개 변수 영역을 표시하지 않아도 되는 경우 Hidden 을 사용합니다.Use Hidden if all of the report parameters are specified and you do not want the parameters area to be visible to users.
매개 변수 영역 너비Parameters Area Width 단위와 값을 선택할 수 있습니다.You can choose the measurement and value. 기본값은 200픽셀입니다.The default is 200 pixels. 이 속성의 유일한 요구 사항은 0보다 커야 한다는 것입니다.The only requirement for this property is that it is greater than zero.
문서 구조Document Map 보고서에 정의되어 있으며 한 번 클릭하여 보고서의 특정 섹션에 액세스할 수 있도록 하는 보고서 탐색 컨트롤입니다.A report navigation control that is defined in the report and used to provide one-click access to specific sections of a report. 문서 구조는 HTML 보고서에서 사용할 수 있으며It is available in HTML reports. 보고서 보기 영역 옆의 축소 가능한 영역에 표시됩니다.The document map is displayed in a collapsible area next to the report viewing area. 유효한 값은 Displayed, CollapsedHidden입니다.Valid values include Displayed, Collapsed, and Hidden. 문서 구조는 보고서에 대해 정의 된 경우 영역 웹 파트 속성에서 숨김 또는 축소로 표시 하지 않는 한 기본적으로 확장 됩니다.If a document map is defined for a report, the area is expanded by default unless marked as hidden or collapsed in the web part properties. 문서 구조가 축소된 경우 화살표를 클릭하여 확장할 수 있습니다.If the document map is collapsed, you can click the arrow to expand it.
문서 구조 영역 너비Document Map Area Width 단위와 값을 선택할 수 있습니다.You can choose the measurement and value. 기본값은 200픽셀입니다.The default is 200 pixels. 이 속성의 유일한 요구 사항은 0보다 커야 한다는 것입니다.The only requirement for this property is that it is greater than zero.
매개 변수 로드Load Parameters 보고서의 매개 변수 속성을 검색합니다.Retrieve parameter properties for the report. 모든 보고서에 매개 변수가 있는 것은 아닙니다.Not all reports have parameters. 보고서에 매개 변수가 없으면 값이 반환되지 않습니다.If the report does not have parameters, no values will be returned. 방금 업로드한 보고서의 속성을 설정하는 경우 데이터 원본 연결이 삭제되었음을 나타내는 오류가 표시될 수 있습니다.If you are setting properties for a report that you just uploaded, you might get an error indicating that the data source connection has been deleted. 이 경우 연결을 다시 설정하고 연결이 지정된 다음 매개 변수 속성을 설정합니다.If this occurs, reset the connection and then finish setting parameter properties after the connection is specified. 연결을 설정 하는 방법에 대 한 자세한 내용은 참조 만들기 및 공유 데이터 원본 관리 ( 모드 ) 통합 SharePoint의 reporting Services .For more information about how to set the connection, see Create and Manage Shared Data Sources (Reporting Services in SharePoint Integrated Mode).

최상의 결과를 얻으려면 매개 변수 로드를 클릭하기 전에 적용 을 클릭합니다.For best results, click Apply before clicking Load Parameters.

매개 변수 속성을 로드한 다음에는 보고서의 매개 변수 속성 페이지에서와 같은 방식으로 매개 변수 속성을 설정할 수 있습니다.After you load parameter properties, you can set them the same way you would in the parameter property pages of the report. 매개 변수를 설정 하는 방법에 대 한 자세한 내용은 참조 하세요. 게시 된 보고서 ( 매개 변수 설정 모드 ) 통합 SharePoint의 reporting Services .For more information about how to set parameters, see Set Parameters on a Published Report (Reporting Services in SharePoint Integrated Mode).

도구 모음 사용자 지정Customizing the toolbar

도구 모음은 제목 아래에 나타나며 보고서 위쪽에 가로로 분포되어 있습니다.The toolbar appears beneath the title and extends across the top of the report. 도구 모음은 동작 메뉴, 페이지가 매겨진 보고서를 위한 페이지 탐색 기능, 새로 고침 기능 및 확대/축소 기능을 제공하며The toolbar provides an Actions menu, page navigation for paginated reports, refresh, and zoom. 문서 구조가 있는 보고서에 대한 문서 구조 컨트롤을 포함합니다.It includes a document map control for reports that have a document map. 동작 메뉴에는 보고서 내보내기 명령, 보고서 내의 텍스트 또는 숫자 검색 명령, 보고서 인쇄 명령 및 보고서 작성기에서 보고서를 여는 명령이 포함되어 있습니다.The Actions menu includes commands for exporting the report, searching for text or numbers within a report, printing the report, and, opening the report in Report Builder.

새 명령을 동작 메뉴에 추가할 수는 없지만 사용자에게 표시할 옵션을 변경하여 동작 메뉴를 사용자 지정할 수 있습니다.You cannot add new commands to the Actions menu but you can customize it by changing the options that are visible to users. 도구 모음 단추 및 컨트롤의 표시 여부를 변경 하려면 다음에서 옵션 변경의 도구 모음 항목 표시 유형 웹 파트의 섹션입니다.To change the visibility of toolbar buttons and controls, you change options in the ToolBar Items Visibility section of the web part. 보고서 서버에서 특정 기능을 사용할 수 없도록 만들어 인쇄 명령이나 특정 내보내기 형식을 제거할 수도 있습니다.You can also remove the Print command or specific export formats by making these features unavailable on the report server. 페이지 탐색 컨트롤은 페이지 나누기가 있는 보고서에 사용할 수 있습니다. 페이지 나누기가 없는 경우 해당 보고서는 길이가 가변적인 단일 페이지입니다.Page navigation controls are available for reports that have page breaks; otherwise, the report is a single page of variable length. 새로 고침 은 보고서의 현재 매개 변수를 사용하여 보고서를 다시 처리합니다.Refresh re-processes the report using the parameters that are current for the report. 한 줄에 있는 모든 컨트롤을 표시 하려면 웹 파트의 전체 너비를 400 픽셀 이상으로 설정 합니다.To display all the controls on one line, set the overall width of the web part to at least 400 pixels.

보기 영역 사용자 지정Customizing the viewing area

보기 영역은 보고서를 표시하는 데 사용됩니다.The view area is used to display reports. 보고서 보기 영역은 매개 변수 및 자격 증명 영역(사용되는 경우)과 공유됩니다.The report view area is shared with the Parameters and Credentials area, if they are used. 자격 증명이 필요한 경우 빈 보고서 보기 영역 옆에 자격 증명 영역이 표시됩니다.If credentials are required, the Credentials area is displayed next to an empty report view area. 자격 증명 영역은 사용자가 자격 증명을 제공하고 보고서를 실행하면 닫힙니다.The Credentials area closes after the user provides credentials and runs the report. 사용자에게 자격 증명 설정을 요청하는 텍스트를 사용자 지정하려면 데이터 원본 연결 속성을 수정합니다.To customize the text that prompts users to set credentials, modify the data source connection properties. 자세한 내용은 참조 만들기 및 공유 데이터 원본 관리 ( 모드 ) 통합 SharePoint의 reporting Services .For more information, see Create and Manage Shared Data Sources (Reporting Services in SharePoint Integrated Mode).

매개 변수 영역은 보고서를 실행하기 전에 값을 입력하는 필드를 제공합니다.The Parameters area provides fields for entering values before running the report. 이 영역은 보고서 정의에 매개 변수가 포함되어 있는 경우에만 사용됩니다.It is only used when a report definition includes parameters. 매개 변수 또는 자격 증명 영역이 표시 되는 보고서 보기가 웹 파트의 나머지 너비를 사용 하도록 조정 됩니다.When either the Parameters or Credentials areas are displayed, the report view is adjusted to use the remaining width of the web part. 매개 변수의 너비를 사용자 지정 하는 웹 파트에 속성을 설정할 수 있습니다.You can set properties on the web part to customize the width of Parameters. 페이지의 개별 매개 변수 옆에 나타나는 레이블을 정의할 수도 있습니다.You can also define the labels that appear next to individual parameters on the page. 매개 변수 레이블을 수정 하는 방법에 대 한 자세한 내용은 참조 하세요. 게시 된 보고서 ( 매개 변수 설정 모드 ) 통합 SharePoint의 reporting Services .For more information about how to modify parameter labels, see Set Parameters on a Published Report (Reporting Services in SharePoint Integrated Mode).

참고 항목See also

SharePoint 사이트에서 보고서 뷰어 웹 파트 Report Viewer web part on a SharePoint Site
웹 페이지에 보고서 뷰어 웹 파트 추가Add the Report Viewer web part to a web page

추가 질문이 있으신가요?More questions? Reporting Services 포럼에서 질문하기Try asking the Reporting Services forum