URL 액세스 매개 변수 사용
보고서의 모양을 구성하는 URL의 일부로 다음 매개 변수를 사용할 수 있습니다. 이 섹션에는 가장 일반적인 매개 변수가 나열됩니다. 매개 변수는 대/소문자를 구분하지 않으며, 매개 변수 접두사는 보고서 서버로 전달되는 경우 rs:로 시작하고 HTML 뷰어로 전달되는 경우 rc:로 시작합니다. 장치 또는 렌더링 확장 프로그램에 특정하는 매개 변수를 지정할 수도 있습니다. 장치별 매개 변수에 대한 자세한 내용은 URL에 장치 정보 설정 지정을 참조하십시오.
HTML 뷰어 명령
다음 표에서는 접두사 rc:로 시작하고 HTML 뷰어를 타겟팅하는 데 사용되는 URL 액세스 매개 변수에 대해 설명합니다.
매개 변수 |
동작 |
|---|---|
Toolbar |
도구 모음을 표시하거나 숨깁니다. 이 매개 변수 값이 false이면 모든 나머지 옵션이 무시됩니다. 이 매개 변수를 생략하면 도구 모음이 지원하는 렌더링 형식에 맞게 자동으로 표시됩니다. 이 매개 변수의 기본값은 true입니다. |
Parameters |
도구 모음의 매개 변수 영역을 표시하거나 숨깁니다. 이 매개 변수를 true로 설정하면 도구 모음의 매개 변수 영역이 표시됩니다. 이 매개 변수를 false로 설정하면 매개 변수 영역이 표시되지 않고 사용자가 영역을 표시할 수 없습니다. 이 매개 변수를 Collapsed 값으로 설정하면 매개 변수 영역이 표시되지 않지만 최종 사용자가 영역을 토글할 수 있습니다. 이 매개 변수의 기본값은 true입니다. |
Zoom |
보고서 확대/축소 값을 정수 백분율 또는 문자열 상수로 설정합니다. 표준 문자열 값에는 Page Width 및 Whole Page가 포함됩니다. Microsoft Internet Explorer 5.0 이전 버전과 모든 비 Microsoft 브라우저에서는 이 매개 변수가 무시됩니다. 이 매개 변수의 기본값은 100입니다. |
Section |
보고서에 표시할 페이지를 설정합니다. 보고서의 페이지 수보다 큰 값을 입력하면 마지막 페이지가 표시됩니다. 0보다 작은 값을 입력하면 보고서의 1페이지가 표시됩니다. 이 매개 변수의 기본값은 1입니다. |
StartFind |
검색할 마지막 섹션을 지정합니다. 이 매개 변수의 기본값은 보고서의 마지막 페이지입니다. |
EndFind |
검색에 사용할 마지막 페이지 번호를 설정합니다. 예를 들어, 값 5는 검색할 마지막 페이지가 보고서의 5페이지임을 나타냅니다. 기본값은 현재 페이지 번호입니다. 이 매개 변수는 StartFind 매개 변수와 함께 사용하십시오. |
FallbackPage |
검색 또는 문서 구조 선택을 실패할 때 표시할 페이지 번호를 설정합니다. 기본값은 현재 페이지 번호입니다. |
GetImage |
HTML 뷰어 사용자 인터페이스에 대한 특정 아이콘을 가져옵니다. |
Icon |
특정 렌더링 확장 프로그램의 아이콘을 가져옵니다. |
Stylesheet |
HTML 뷰어에 적용할 스타일시트를 지정합니다. |
HTML 렌더링에 대한 출력을 가리키는 URL에 추가 매개 변수를 전달할 수 있습니다. 자세한 내용은 HTML 장치 정보 설정을 참조하십시오.
보고서 서버 명령
다음 표에서는 접두사 rs:로 시작하고 보고서 서버를 타겟팅하는 데 사용되는 URL 액세스 매개 변수에 대해 설명합니다.
매개 변수 |
동작 |
|---|---|
Command |
검색할 마지막 섹션을 지정합니다. 이 매개 변수의 기본값은 보고서의 마지막 페이지입니다. |
Format |
보고서를 렌더링할 형식을 지정합니다. 일반적인 값은 HTML3.2, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML 및 NULL입니다. 자세한 내용은 URL에서 렌더링 형식 지정을 참조하십시오. |
ParameterLanguage |
브라우저 언어와 독립적으로 URL에 전달되는 매개 변수의 언어를 제공합니다. 기본값은 브라우저 언어입니다. en-us 또는 de-de와 같은 문화권 값일 수 있습니다. |
Snapshot |
보고서 기록 스냅숏을 기반으로 보고서를 렌더링합니다. 자세한 내용은 URL 액세스를 사용하여 보고서 기록 스냅숏 렌더링을 참조하십시오. |
PersistStream |
하나의 지속 스트림으로 보고서를 렌더링합니다. 이 매개 변수는 이미지 렌더러에서 렌더링된 보고서를 한 번에 한 청크씩 전송하는 데 사용됩니다. URL 액세스 문자열에 이 매개 변수를 사용한 후 PersistStream 매개 변수만 GetNextStream 매개 변수로 바꾸고 동일한 URL 액세스 문자열을 사용하여 지속 스트림의 다음 청크를 받을 수 있습니다. 이 URL 명령은 최종적으로 0바이트 스트림을 반환하여 지속 스트림의 끝을 나타냅니다. 기본값은 false입니다. |
GetNextStream |
PersistStream 매개 변수를 사용하여 액세스되는 지속 스트림의 다음 데이터 청크를 받습니다. 자세한 내용은 PersistStream에 대한 설명을 참조하십시오. 기본값은 false입니다. |
보고서 뷰어 웹 파트 명령
다음 표에서는 Reporting Services가 Windows SharePoint Services(WSS) 3.0 또는 MicrosoftOffice SharePoint Server (MOSS) 2007과 통합될 때 보고서 뷰어 웹 파트를 타겟팅하는 데 사용되는 SQL Server 2008의 새로운 예약된 보고서 매개 변수 이름에 대해 설명합니다. 이러한 매개 변수 이름은 접두사 rv:로 시작합니다. 보고서 뷰어 웹 파트에는 rs:ParameterLanguage 매개 변수도 사용할 수 있습니다.
매개 변수 |
동작 |
|---|---|
Toolbar |
보고서 뷰어 웹 파트에 대한 도구 모음 표시를 제어합니다. 기본값은 Full입니다. 다음 값을 사용할 수 있습니다.
|
HeaderArea |
보고서 뷰어 웹 파트에 대한 머리글 표시를 제어합니다. 기본값은 Full입니다. 다음 값을 사용할 수 있습니다.
|
DocMapAreaWidth |
보고서 뷰어 웹 파트에서 매개 변수 영역의 표시 너비(픽셀 단위)를 제어합니다. 기본값은 보고서 뷰어 웹 파트 기본값과 같습니다. 값은 음의 정수가 아니어야 합니다. |
AsyncRender |
보고서가 비동기적으로 렌더링되는지 여부를 제어합니다. 기본값 true는 보고서가 비동기적으로 렌더링됨을 지정합니다. 부울 값 true 또는 false여야 합니다. |
예
다음 예제는 rc:Toolbar 매개 변수 값을 false로 설정하여 HTML 뷰어 도구 모음을 숨깁니다.
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false
다음 예제는 하드 코딩된 매개 변수를 전달하고 사용자가 제공하는 매개 변수의 입력 필드를 숨깁니다.
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002
다음 예제는 rc:Zoom 매개 변수를 사용하여 보고서의 확대/축소 속성을 Page Width로 설정합니다.
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width
다음 예제는 보고서의 섹션 13을 토글합니다.
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13