다음을 통해 공유


보고서 뷰어 웹 파트 사용자 지정

적용 대상: SQL Server Reporting Services 2016(13.x) 이상 Power BI Report Server SharePoint 2013 이상 ❌ SharePoint Online

이전 버전의 SSRS(SQL Server Reporting Services)와 관련된 콘텐츠는 SQL Server Reporting Services란?을 참조하세요.

보고서 뷰어 웹 파트를 사용하여 SharePoint 통합용으로 구성된 보고서 서버에서 실행되는 보고서를 볼 수 있습니다. 표시할 수 있는 보고서에는 보고서 정의 파일(.rdl)과 보고서 작성기 보고서가 있습니다. 보고서는 새 페이지의 보고서 뷰어 웹 파트에서 자동으로 열립니다. 또한 해당 페이지에서 특정 보고서가 항상 표시되기를 원하는 경우 기존 웹 페이지 또는 사이트에 보고서 뷰어 웹 파트를 추가할 수 있습니다.

참고

이름은 같지만 Reporting Services 추가 기능을 통해 설치된 보고서 뷰어 웹 파트는 RSWebParts.cab 파일에 포함된 보고서 뷰어 웹 파트와 다릅니다. 이 항목의 지침은 Reporting Services 추가 기능을 통해 설치되는 보고서 뷰어 웹 파트에만 해당됩니다.

다음과 같은 방법으로 보고서 뷰어 웹 파트를 사용자 지정할 수 있습니다.

  • 속성을 설정하여 웹 파트의 모양을 변경합니다.

  • 보고서 도구 모음에서 사용할 대화형 보고 기능을 선택합니다.

  • 사용할 보기 영역을 지정합니다. 보고서 뷰어 웹 파트에는 보고서 보기 영역, 매개 변수 영역 및 자격 증명 영역이 있습니다.

다른 파일 형식을 지원하도록 보고서 뷰어 웹 파트를 확장할 수 없으며 보고서 도구 모음을 사용자 지정 도구 모음으로 바꾸거나 기존 도구 모음에 새 기능을 추가할 수 없습니다. 표준 기능을 사용자 지정해야 하는 경우 사용자 지정 웹 파트를 만들어야 합니다.

웹 파트 속성 설정

웹 파트에는 특정 기능을 구성하는 데 사용되는 사용자 지정 속성과 모든 웹 파트의 표준이 되는 공통 속성이 있습니다.

기본 속성 변경

보고서 뷰어 웹 파트에는 요청 시 라이브러리나 폴더에서 보고서를 여는 데 적합한 기본 속성이 있습니다. 기본적으로 사용 가능한 모든 컨트롤이 도구 모음에 표시됩니다. 높이 및 너비는 웹 페이지의 모든 사용 가능한 공간을 사용하도록 설정됩니다. 기본 속성을 수정하려면 사이트 설정을 통해 웹 파트를 사용자 지정합니다.

  1. 사이트 동작 메뉴에서 사이트 설정을 선택합니다.

  2. 갤러리에서 웹 파트를 선택합니다.

  3. ReportViewer.dwp를 선택합니다.

  4. 도구 창을 열고 사용할 속성을 설정합니다.

웹 페이지에 포함된 보고서 뷰어 사용자 지정

속성을 설정하여 웹 페이지에 보고서 뷰어를 맞출 수 있습니다. 보고서 뷰어는 속해 있는 페이지와 동일한 스타일 및 색을 사용할 수 있습니다. 도구 모음, 문서 구조 및 매개 변수 영역의 전체 또는 일부를 숨겨 할당된 공간 내에서 보고서 보기 영역을 최대화할 수 있습니다. 보고서는 항상 만들 때 정의한 스타일을 사용합니다. SharePoint 라이브러리에 게시한 후에 보고서 모양을 사용자 지정할 수 없습니다.

웹 페이지에 보고서 뷰어 웹 파트를 포함하는 경우 보고서 URL 속성을 특정 보고서로 설정해야 합니다. 그렇게 하지 않으면 보고서 뷰어에 보고서 연결에 대한 지침이 표시됩니다. 지침을 사용자 지정하거나 제거할 수는 없습니다.

보고서 뷰어 웹 파트의 사용자 지정 속성

사용자 지정 속성을 설정할 때 일부 속성은 보고서 뷰어 웹 파트가 페이지에 포함된 경우에만 사용됩니다. 이러한 속성으로는 제목, 높이, 너비, 크롬 유형 및 영역을 들 수 있습니다. 도구 모음 설정 및 매개 변수 설정과 같은 기타 속성은 보고서 뷰어가 페이지 내에 나타나는지, 아니면 전체 페이지 모드로 보고서를 여는지에 관계없이 사용됩니다.

보고서 뷰어 웹 파트의 사용자 지정 속성은 다음 표에 나열되어 있습니다.

속성 설명
보고서 현재 SharePoint 사이트나 동일한 웹 애플리케이션 또는 팜 내의 사이트에 있는 보고서에 대한 정규화된 경로여야 합니다. 더 많은 속성을 설정할 때 최상의 결과를 얻으려면 보고서 URL을 지정한 다음 적용을 선택합니다.
하이퍼링크 대상 현재 문서 내에 연결된 내용을 표시할 대상 프레임을 지정하는 표준 HTML입니다. 외부 웹 사이트에 대한 하이퍼링크가 포함된 보고서의 경우 대상 문서로 현재 창 내의 기존 보고서를 대체할지, 아니면 해당 문서를 새 브라우저 창에서 열지를 지정할 수 있습니다. 유효한 값은 _Top, _Blank_Self입니다. _Top 은 현재 창을 사용하고, _Blank 는 새 브라우저 창에서 문서를 로드하며 _Self 는 현재 프레임 내에서 문서를 엽니다. _Parent도 HTML의 대상 특성에 대해 유효한 값이지만 페이지에 포함된 보고서 뷰어 웹 파트에는 사용하지 마세요.
웹 파트 제목 자동 생성 보고서 뷰어 웹 파트 이름과 보고서 이름을 대시로 구분하는 생성되는 제목입니다. 보고서에 제목이 없는 경우 보고서 파일 이름이 사용됩니다. 페이지에 웹 파트를 추가하면 제목이 표시됩니다. 이 확인란을 선택한 경우 페이지를 새로 고칠 때마다 제목이 생성됩니다.
웹 파트 제목 세부 정보 링크 자동 생성 웹 파트 위에 나타나는 생성된 하이퍼링크입니다. 이 링크를 선택하여 보고서를 전체 페이지 모드로 새 페이지에서 열 수 있습니다.
보고서 작성기 메뉴 항목 표시 보고서 작성기를 여는 동작 메뉴 옵션을 표시하거나 숨깁니다.
구독 메뉴 항목 표시 보고서에 대한 구독을 만드는 동작 메뉴 옵션을 표시하거나 숨깁니다.
인쇄 메뉴 항목 표시 보고서를 인쇄하는 동작 메뉴 옵션을 표시하거나 숨깁니다.
내보내기 메뉴 항목 표시 보고서를 내보내는 동작 메뉴 옵션을 표시하거나 숨깁니다.
새로 고침 단추 표시 도구 모음에 새로 고침 단추를 표시하거나 숨깁니다.
페이지 탐색 컨트롤 표시 도구 모음에 보고서 탐색 단추를 표시하거나 숨깁니다. 이 옵션은 모든 탐색 컨트롤의 표시 여부를 변경합니다.
뒤로 단추 표시 도구 모음에 뒤로 단추를 표시하거나 숨깁니다.
찾기 컨트롤 표시 도구 모음에 찾기 컨트롤을 표시하거나 숨깁니다. 찾기 컨트롤을 사용하여 렌더링된 보고서에서 텍스트를 검색할 수 있습니다. 이 옵션은 모든 찾기 컨트롤의 표시 여부를 변경합니다.
확대/축소 컨트롤 표시 도구 모음에 확대/축소 컨트롤을 표시하거나 숨깁니다.
ATOM 피드 단추 표시 도구 모음에 ATOM 피드 단추를 표시하거나 숨깁니다.

htmlviewer_datafeed
도구 모음 위치 보고서 뷰어에서 도구 모음의 위치를 결정합니다. 유효한 값은 TopBottom이고
프롬프트 영역 유효한 값은 Displayed, CollapsedHidden입니다. Displayed를 선택하면 매개 변수가 있는 값이 포함되어 있고 사용자 입력이 있어야 실행되는 보고서에 대해 매개 변수 영역이 표시됩니다. 모든 보고서 매개 변수가 지정되어 있어 사용자에게 매개 변수 영역을 표시하지 않아도 되는 경우 Hidden을 사용합니다.
매개 변수 영역 너비 단위와 값을 선택할 수 있습니다. 기본값은 200픽셀입니다. 이 속성의 유일한 요구 사항은 0보다 커야 한다는 것입니다.
문서 구조 보고서에 정의되어 있으며 한 번 클릭하여 보고서의 특정 섹션에 액세스할 수 있도록 하는 보고서 탐색 컨트롤입니다. 문서 구조는 HTML 보고서에서 사용할 수 있으며 보고서 보기 영역 옆의 축소 가능한 영역에 표시됩니다. 유효한 값은 Displayed, CollapsedHidden입니다. 보고서에 대해 문서 구조가 정의된 경우 웹 파트 속성에서 숨김 또는 축소로 표시되어 있지 않은 한 이 영역은 기본적으로 확장됩니다. 문서 구조가 축소된 경우 화살표를 선택하여 확장할 수 있습니다.
문서 구조 영역 너비 단위와 값을 선택할 수 있습니다. 기본값은 200픽셀입니다. 이 속성의 유일한 요구 사항은 0보다 커야 한다는 것입니다.
매개 변수 로드 보고서의 매개 변수 속성을 검색합니다. 모든 보고서에 매개 변수가 있는 것은 아닙니다. 보고서에 매개 변수가 없으면 값이 반환되지 않습니다. 업로드한 보고서의 속성을 설정하는 경우 데이터 원본 연결이 삭제되었음을 나타내는 오류가 표시될 수 있습니다. 이 오류가 발생하는 경우 연결을 다시 설정하고 연결이 지정된 다음 매개 변수 속성을 설정합니다. 연결을 설정하는 방법에 대한 자세한 내용은 공유 데이터 원본 만들기 및 관리(SharePoint 통합 모드의 Reporting Services)를 참조하세요.

최상의 결과를 얻으려면 매개 변수 로드를 클릭하기 전에 적용을 선택합니다.

매개 변수 속성을 로드한 다음에는 보고서의 매개 변수 속성 페이지에서와 같은 방식으로 매개 변수 속성을 설정할 수 있습니다. 매개 변수를 설정하는 방법에 대한 자세한 내용은 게시된 보고서에 매개 변수 설정(SharePoint 통합 모드의 Reporting Services)을 참조하세요.

도구 모음 사용자 지정

도구 모음은 제목 아래에 나타나며 보고서 위쪽에 가로로 분포되어 있습니다. 도구 모음은 동작 메뉴, 페이지가 매겨진 보고서를 위한 페이지 탐색 기능, 새로 고침 기능 및 확대/축소 기능을 제공하며 문서 구조가 있는 보고서에 대한 문서 구조 컨트롤을 포함합니다. 동작 메뉴에는 보고서 내보내기 명령, 보고서 내의 텍스트 또는 숫자 검색 명령, 보고서 인쇄 명령 및 보고서 작성기에서 보고서를 여는 명령이 포함되어 있습니다.

새 명령을 동작 메뉴에 추가할 수는 없지만 사용자에게 표시할 옵션을 변경하여 동작 메뉴를 사용자 지정할 수 있습니다. 도구 모음 단추 및 컨트롤의 표시 여부를 변경하려면 웹 파트의 도구 모음 항목 표시 유형 섹션에서 옵션을 변경합니다. 보고서 서버에서 특정 기능을 사용할 수 없도록 만들어 인쇄 명령이나 특정 내보내기 형식을 제거할 수도 있습니다. 페이지 탐색 컨트롤은 페이지 나누기가 있는 보고서에 사용할 수 있습니다. 페이지 나누기가 없는 경우 해당 보고서는 길이가 가변적인 단일 페이지입니다. 새로 고침은 보고서의 현재 매개 변수를 사용하여 보고서를 다시 처리합니다. 모든 컨트롤을 한 줄에 표시하려면 웹 파트의 전체 너비를 400픽셀 이상으로 설정합니다.

보기 영역 사용자 지정

보기 영역은 보고서를 표시하는 데 사용됩니다. 보고서 보기 영역은 매개 변수 및 자격 증명 영역(사용되는 경우)과 공유됩니다. 자격 증명이 필요한 경우 빈 보고서 보기 영역 옆에 자격 증명 영역이 표시됩니다. 자격 증명 영역은 사용자가 자격 증명을 제공하고 보고서를 실행하면 닫힙니다. 사용자에게 자격 증명 설정을 요청하는 텍스트를 사용자 지정하려면 데이터 원본 연결 속성을 수정합니다. 자세한 내용은 공유 데이터 원본 만들기 및 관리(SharePoint 통합 모드의 Reporting Services)를 참조하세요.

매개 변수 영역은 보고서를 실행하기 전에 값을 입력하는 필드를 제공합니다. 이 영역은 보고서 정의에 매개 변수가 포함되어 있는 경우에만 사용됩니다. 매개 변수 또는 자격 증명 영역이 표시되는 경우 보고서 보기가 웹 파트의 나머지 너비를 사용하도록 조정됩니다. 웹 파트의 속성을 설정하여 매개 변수의 너비를 사용자 지정할 수 있습니다. 페이지의 개별 매개 변수 옆에 나타나는 레이블을 정의할 수도 있습니다. 매개 변수 레이블을 수정하는 방법에 대한 자세한 내용은 게시된 보고서에 매개 변수 설정(SharePoint 통합 모드의 Reporting Services)을 참조하세요.