URL 액세스 매개 변수 참조

  • 아티클

매개 변수를 URL의 일부로 사용하여 SQL Server 2016(13.x) 이상(SSRS) 보고서의 디자인을 구성할 수 있습니다. 이 문서에서는 가장 일반적으로 사용되는 매개 변수에 대해 설명합니다.

매개 변수는 대/소문자를 구분하지 않습니다. 접두사는 다음과 같습니다.

  • rs:: 보고서 서버를 대상으로 합니다.
  • rc:: HTML 뷰어를 대상으로 합니다.
  • rv:: 보고서 뷰어 웹 파트를 대상으로 합니다.

디바이스 또는 렌더링 확장 프로그램에 특정하는 매개 변수를 지정할 수도 있습니다. 디바이스별 매개 변수에 대한 자세한 내용은 URL에서 디바이스 정보 설정 지정을 참조하세요.

중요

SharePoint 모드 보고서 서버의 경우 URL에는 SharePoint를 통해 요청을 라우팅하는 _vti_bin 프록시 구문과 Reporting Services HTTP 프록시를 포함하는 것이 중요합니다. 프록시는 컨텍스트를 HTTP 요청에 추가하며 SharePoint 모드 보고서 서버에 대한 보고서의 올바른 실행을 보장하는 데 필요합니다. 예시를 보려면 URL 액세스를 사용하여 보고서 서버 항목 액세스를 참조하세요.

SQL Server 2016 이후부터 SharePoint와의 Reporting Services 통합을 사용할 수 없습니다.

HTML 뷰어 명령(rc:)

접두사 rc:을(를) 사용하여 HTML 뷰어를 대상으로 합니다.

명령 매개 변수 설명
Toolbar True 툴바를 표시합니다. 기본값은 true입니다.

참고 사항: 이 매개 변수를 생략하면 해당 매개 변수를 지원하는 렌더링 형식에 대한 툴바가 자동으로 표시됩니다.
Toolbar False 툴바를 숨깁니다. 이 매개 변수가 false이면 나머지 옵션은 모두 무시됩니다.
Toolbar Navigation 툴바에 페이지 매김만 표시합니다.
Parameters True 툴바의 매개 변수 영역을 표시합니다. 기본값은 true입니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Parameters False 매개 변수 영역을 숨기고 사용자가 표시할 수 없습니다.
Parameters Collapsed 매개 변수 영역을 숨기지만, 사용자가 표시하도록 토글할 수 있습니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width 페이지 너비에 맞게 보고서 확대/축소를 설정합니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width
Zoom Whole Page 전체 페이지에 맞게 보고서 확대/축소를 설정합니다.
Zoom <integer percentage> 보고서 확대/축소를 특정 백분율로 설정합니다. 기본값은 100입니다.
Section <page number> 보고서에서 표시할 페이지를 설정합니다. 보고서의 페이지 수보다 큰 값은 마지막 페이지를 표시합니다. 0 보다 작은 값을 입력하면 보고서의 1페이지가 표시됩니다. 기본값은 1입니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales&rc:Section=2

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2
FindString <text> 보고서에서 특정 텍스트 집합을 검색하고 해당 텍스트를 강조 표시합니다. 참고 사항: URL 액세스 문자열에 rc:FindString을(를) 포함하지 않으면 rc:Toolbar=false이(가) 작동하지 않습니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400
StartFind <start page> 검색할 첫 번째 섹션을 지정합니다. 기본값은 보고서의 첫 번째 페이지입니다.

예시:

기본 모드: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
EndFind <end page> 검색에 사용할 마지막 페이지 번호를 설정합니다. 기본값은 현재 페이지 번호입니다. 이 매개 변수를 StartFind 매개 변수와 함께 사용합니다.

예시: StartFind 예시를 참조하세요.
FallbackPage <page number> 검색 또는 문서 맵 선택 실패 시 표시할 페이지 수를 설정합니다. 기본값은 현재 페이지 번호입니다.
GetImage <icon name> HTML 뷰어 사용자 인터페이스에 대한 특정 이미지를 가져옵니다.
Icon <icon name> 특정 렌더링 확장 프로그램의 아이콘을 가져옵니다.
Stylesheet <stylesheet file name> HTML 뷰어에 적용할 스타일시트를 지정합니다.
디바이스 정보 설정 rc:tag=value 형식으로 디바이스 정보 설정을 지정합니다. 여기서 tag은(는) 렌더링 확장 프로그램에 특정한 디바이스 정보 설정의 이름입니다. 자세한 내용은 Format 명령 설명을 참조하세요.

이미지 렌더링 확장에 대한 OutputFormat 디바이스 정보 설정을 사용하여 URL 액세스 문자열에 다음 ...&rs:Format=IMAGE&rc:OutputFormat=JPEG 매개 변수를 사용하여 보고서를 JPEG 이미지로 렌더링할 수 있습니다. 모든 확장 프로그램별 디바이스 정보 설정에 대한 자세한 내용은 렌더링 확장 프로그램에 대한 디바이스 정보 설정(Reporting Services)을 참조하세요.

보고서 서버 명령(rs:)

rs: 접두사를 사용하여 보고서 서버를 대상으로 지정합니다.

명령 매개 변수 설명
Command ListChildren 및 GetChildren 폴더의 콘텐츠를 표시합니다. 폴더 항목은 일반 항목 탐색 페이지 내에 표시됩니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales&rs:Command=GetChildren

기본 모드의 명명된 인스턴스: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

SharePoint 모드:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren
Command Render 보고서는 볼 수 있도록 브라우저에서 렌더링됩니다.

예시:

기본 모드:https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint 모드:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
Command GetSharedDatasetDefinition 공유 데이터 세트와 연결되는 XML 정의를 표시합니다. 공유 데이터 세트 속성은 정의에 저장됩니다. 이러한 속성에는 쿼리, 데이터 세트 매개 변수, 기본값, 데이터 세트 필터, 데이터 정렬 및 대소문자 구분과 같은 데이터 옵션이 포함됩니다. 이 값을 사용하려면 공유 데이터 세트에 대한 보고서 정의 읽기 권한이 있어야 합니다.

예시:

기본 모드: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
Command GetDataSourceContents 지정된 공유 데이터 원본의 속성을 XML로 표시합니다. 브라우저에서 XML을 지원하고 데이터 원본에 대한 콘텐츠 읽기 권한이 있는 인증된 사용자의 경우 데이터 원본 정의가 표시됩니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command GetResourceContents 리소스를 렌더링하고 리소스가 브라우저와 호환되면 이를 HTML 페이지에 표시합니다. 그렇지 않으면 파일 또는 리소스를 열거나 디스크에 저장하도록 선택할 수 있습니다.

예시:

기본 모드: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
Command GetComponentDefinition 게시된 보고서 항목과 연결된 XML 정의를 표시합니다. 이 값을 사용하려면 게시된 보고서 항목에 대한 콘텐츠 읽기 권한이 있어야 합니다.
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL(.xls의 경우)
EXCELOPENXML(.xlsx의 경우)
WORD(.doc의 경우)
WORDOPENXML(.docx의 경우)
CSV
PDF
XML		 보고서를 렌더링하고 확인할 형식을 지정합니다. 기본값은 HTML5입니다. 자세한 내용은 URL 액세스를 사용하여 보고서 내보내기를 참조하세요. 전체 목록은 보고서 서버 \<Render> 파일의 rsreportserver.config 확장자 섹션을 참조하세요. 자세한 내용은 RsReportServer.config 구성 파일을 참조하세요.

예시:

기본 모드: https://myrshost/ReportServer?/myreport&rs:Format=PDF

SharePoint 모드: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage en-us, de-DE 등 브라우저 언어와 독립적으로 URL에 전달되는 매개 변수의 언어를 제공합니다. 기본값은 브라우저 언어입니다.

예시:

기본 모드: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Snapshot 보고서 기록 스냅샷을 기반으로 보고서를 렌더링합니다. 자세한 내용은 URL 액세스를 사용하여 보고서 기록 스냅샷 렌더링을 참조하세요.

예시:

기본 모드: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams true
false		 보고서를 단일 지속형 스트림에서 렌더링합니다. 이미지 렌더러는 이 매개 변수를 사용하여 렌더링된 보고서를 한 번에 한 청크씩 전송합니다. URL 액세스 문자열에 이 매개 변수를 사용한 후에는 GetNextStream 매개 변수 대신 PersistStreams 매개 변수와 함께 동일한 URL 액세스 문자열을 사용하여 영구 스트림의 다음 청크를 가져옵니다. 이 URL 명령은 결국 0바이트 스트림을 반환하여 지속된 스트림의 끝을 나타냅니다. 기본값은 false입니다.
GetNextStream true
false		 PersistStreams 매개 변수를 사용하여 액세스한 지속된 스트림에서 다음 데이터 청크를 가져옵니다. 자세한 내용은 PersistStreams 명령 설명을 참조하세요. 기본값은 false입니다.
SessionID 클라이언트 애플리케이션과 보고서 서버 간에 설정된 활성 보고서 세션을 지정합니다. 이 매개 변수의 값은 세션 식별자로 설정됩니다.

세션 ID를 쿠키로 지정하거나 URL의 일부로 지정할 수 있습니다. 세션 쿠키를 사용하지 않도록 보고서 서버를 구성하는 경우 지정된 세션 ID가 없는 첫 번째 요청은 세션 ID로 리디렉션됩니다. 보고서 서버 세션에 대한 자세한 내용은 실행 상태 식별을 참조하세요.
ClearSession true
false		 보고서 세션에서 인증된 사용자와 연결된 모든 보고서 인스턴스를 제거합니다. 보고서 인스턴스는 다양한 보고서 매개 변수 값을 사용하여 여러 번 실행되는 동일한 보고서로 정의됩니다. 기본값은 false입니다. 유효한 값은 true 및 false입니다.
ResetSession true
false		 보고서 세션과 모든 보고서 스냅샷의 연결을 제거하여 보고서 세션을 재설정합니다. 기본값은 false입니다. 유효한 값은 true 및 false입니다.
ShowHideToggle <positive integer> 보고서의 섹션의 표시/숨기기 상태를 토글합니다. 토글할 섹션을 나타내는 양의 정수를 지정합니다.

보고서 뷰어 웹 파트 명령(rv:)

rv: 접두사를 사용하여 SharePoint와 통합되는 보고서 뷰어 웹 파트를 대상으로 지정합니다. 보고서 뷰어 웹 파트에는 rs:ParameterLanguage 매개 변수도 사용할 수 있습니다.

명령 매개 변수 설명
Toolbar Full 전체 도구 모음을 표시합니다. 기본값은 Full입니다.
Toolbar Navigation 툴바에 페이지 매김만 표시합니다.

예시:

SharePoint 모드: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
Toolbar None 도구 모음을 표시하지 않습니다.
HeaderArea Full 전체 헤더를 표시합니다. 기본값은 Full입니다.
HeaderArea BreadCrumbsOnly 헤더에 이동 경로 탐색만 표시하여 사용자에게 애플리케이션의 현재 위치를 알립니다.

예시:

SharePoint 모드: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
HeaderArea None 헤더를 숨깁니다.
DocMapAreaWidth 보고서 뷰어 웹 파트에서 매개 변수 영역의 표시 너비(픽셀)를 제어합니다. 기본값은 보고서 뷰어 웹 파트 기본값과 같습니다. 값은 음의 정수가 아니어야 합니다.
AsyncRender true
false		 보고서가 비동기적으로 렌더링되는지 여부를 제어합니다. 기본값은 true이며, 이는 보고서가 비동기적으로 렌더링되도록 지정합니다. 값은 true 또는 false의 부울 값이어야 합니다.
ParamMode Full 매개 변수 프롬프트 영역을 표시합니다. 기본값은 Full입니다.
Collapsed 매개 변수 프롬프트 영역을 축소합니다.

예시:

SharePoint 모드: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
ParamMode Hidden 매개 변수 프롬프트 영역을 숨깁니다.
DocMapMode Full 문서 맵 영역을 표시합니다. 기본값은 Full입니다.
DocMapMode Collapsed 문서 맵 영역을 축소합니다.
DocMapMode Hidden 문서 맵 영역을 숨깁니다.
DockToolBar Top 툴바를 상단에 도킹합니다. 기본값은 상단입니다.
DockToolBar Bottom 툴바의 하단에 도킹합니다.

예시:

SharePoint 모드: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode 1 (0x1) 뒤로 단추
ToolBarItemsDisplayMode 2(0x2) 텍스트 검색 컨트롤
ToolBarItemsDisplayMode 4(0x4) 페이지 이동 컨트롤
ToolBarItemsDisplayMode 8 (0x8) 새로 고침 버튼
ToolBarItemsDisplayMode 16 (0x10) 확대/축소 목록 상자
ToolBarItemsDisplayMode 32(0x20) Atom 피드 버튼
ToolBarItemsDisplayMode 64(0x40) 작업의 인쇄 메뉴 옵션
ToolBarItemsDisplayMode 128(0x80) 작업의 내보내기 하위 메뉴
ToolBarItemsDisplayMode 256(0x100) 작업의 Report Builder로 열기 메뉴 옵션
ToolBarItemsDisplayMode 512(0x200) 작업의 구독 메뉴 옵션
ToolBarItemsDisplayMode 1024 (0x400) 작업의 새 데이터 경고 메뉴 옵션
ToolBarItemsDisplayMode 다중 값 표시할 툴바 항목을 제어합니다. 이 값은 비트 단위 열거형 값입니다. 툴바 항목을 포함하려면 항목의 값을 총 값에 추가합니다. 예를 들어, 작업 메뉴가 없는 경우 1+2+4+8+16+32인 rv:ToolBarItemsDisplayMode=63(또는 0x3F)을(를) 사용합니다. 작업 메뉴 항목에 대해서만 rv:ToolBarItemsDisplayMode=960(또는 0x3C0)을(를) 사용합니다. 기본값은 -1이며, 모든 툴바 항목이 포함됩니다. 유효한 값은 다음과 같습니다.

예시:

SharePoint 모드: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

관련 콘텐츠