다음을 통해 공유

  • 아티클

URL 액세스 매개 변수 사용

보고서의 모양과 느낌을 구성하는 URL의 일부로 다음 매개 변수를 사용할 수 있습니다. 이 섹션에는 가장 일반적인 매개 변수가 나열됩니다. 매개 변수는 대/소문자를 구분하지 않으며, 매개 변수 접두사는 보고서 서버로 전달되는 경우 rs:로 시작하고 HTML 뷰어로 전달되는 경우 rc:로 시작합니다. 장치 또는 렌더링 확장 프로그램에 특정하는 매개 변수를 지정할 수도 있습니다. 장치별 매개 변수에 대한 자세한 내용은 URL에 장치 정보 설정 지정을 참조하십시오.

HTML 뷰어 명령

다음 표에서는 접두사 rc:로 시작하고 HTML 뷰어를 타겟팅하는 데 사용되는 URL 액세스 매개 변수에 대해 설명합니다.

매개 변수

동작

Toolbar

도구 모음을 표시하거나 숨깁니다. 이 매개 변수 값이 false이면 모든 나머지 옵션이 무시됩니다. 이 매개 변수를 생략하면 도구 모음이 지원하는 렌더링 형식에 맞게 자동으로 표시됩니다. 이 매개 변수의 기본값은 true입니다.

중요 정보중요
rc:Toolbar=false는 도메인 이름 대신 IP 주소를 사용하여 SharePoint 사이트에서 호스팅되는 보고서를 대상으로 지정하는 URL 액세스 문자열에는 작동하지 않습니다.

Parameters

도구 모음의 매개 변수 영역을 표시하거나 숨깁니다. 이 매개 변수를 true로 설정하면 도구 모음의 매개 변수 영역이 표시됩니다. 이 매개 변수를 false로 설정하면 매개 변수 영역이 표시되지 않고 사용자가 영역을 표시할 수 없습니다. 이 매개 변수를 Collapsed 값으로 설정하면 매개 변수 영역이 표시되지 않지만 최종 사용자가 영역을 토글할 수 있습니다. 이 매개 변수의 기본값은 true입니다.

Zoom

보고서 확대/축소 값을 정수 백분율 또는 문자열 상수로 설정합니다. 표준 문자열 값에는 Page Width 및 Whole Page가 포함됩니다. 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 액세스를 사용하여 보고서 기록 스냅숏 렌더링을 참조하십시오.

PersistStreams

보고서를 단일 지속형 스트림에서 렌더링합니다. 이 매개 변수는 이미지 렌더러에서 렌더링된 보고서를 한 번에 한 청크씩 전송하는 데 사용됩니다. 이 매개변수를 URL 액세스 문자열에 사용한 후에는 PersistStreams 매개 변수 대신 GetNextStream 매개 변수를 사용하여 지속형 스트림의 다음 청크를 가져옵니다. 이 URL 명령은 결과적으로 지속형 스트림의 끝을 나타내는 0바이트 스트림을 반환합니다. 기본값은 false입니다.

GetNextStream

PersistStreams 매개 변수를 사용하여 액세스하는 지속형 스트림의 다음 데이터 청크를 가져옵니다. 자세한 내용은 PersistStreams에 대한 설명을 참조하십시오. 기본값은 false입니다.

보고서 뷰어 웹 파트 명령

다음 표에서는 Reporting Services가 Windows SharePoint Services(WSS) 3.0 이상 및 Microsoft Office SharePoint Server 2007 이상과 통합될 때 보고서 뷰어 웹 파트를 타겟팅하는 데 사용되는 SQL Server의 예약된 보고서 매개 변수 이름에 대해 설명합니다. 이러한 매개 변수 이름은 접두사 rv:로 시작합니다. 보고서 뷰어 웹 파트에는 rs:ParameterLanguage 매개 변수도 사용할 수 있습니다.

매개 변수

동작

Toolbar

보고서 뷰어 웹 파트에 대한 도구 모음 표시를 제어합니다. 기본값은 Full입니다. 다음 값을 사용할 수 있습니다.

  • Full: 전체 도구 모음을 표시합니다.

  • Navigation: 도구 모음에 페이지 매김만 표시합니다.

  • None: 도구 모음을 표시하지 않습니다.

HeaderArea

보고서 뷰어 웹 파트에 대한 머리글 표시를 제어합니다. 기본값은 Full입니다. 다음 값을 사용할 수 있습니다.

  • Full: 전체 머리글을 표시합니다.

  • BreadCrumbsOnly: 응용 프로그램 내 사용자의 위치를 알려주는 bread-crumb 탐색만 머리글에 표시합니다.

  • None: 머리글을 표시하지 않습니다.

DocMapAreaWidth

보고서 뷰어 웹 파트에서 매개 변수 영역의 표시 너비(픽셀 단위)를 제어합니다. 기본값은 보고서 뷰어 웹 파트 기본값과 같습니다. 값은 음의 정수가 아니어야 합니다.

AsyncRender

보고서가 비동기적으로 렌더링되는지 여부를 제어합니다. 기본값 true는 보고서가 비동기적으로 렌더링됨을 지정합니다. 부울 값 true 또는 false여야 합니다.

ParamMode

보고서 뷰어 웹 파트의 매개 변수 프롬프트 영역이 전체 페이지 뷰로 표시되는 방식을 제어합니다. 유효한 값은 다음과 같습니다.

  • Full: 매개 변수 프롬프트 영역을 표시합니다.

  • Collapsed: 매개 변수 프롬프트 영역을 축소합니다.

  • Hidden: 매개 변수 프롬프트 영역을 숨깁니다.

기본값은 Full입니다.

DocMapMode

보고서 뷰어 웹 파트의 문서 구조 영역이 전체 페이지 뷰로 표시되는 방식을 제어합니다. 유효한 값은 다음과 같습니다.

  • Full: 문서 구조 영역을 표시합니다.

  • Collapsed: 문서 구조 영역을 축소합니다.

  • Hidden: 문서 구조 영역을 숨깁니다.

기본값은 Full입니다.

DockToolBar

보고서 뷰어 웹 파트의 도구 모음이 위쪽에 도킹되는지 아래쪽에 도킹되는지를 제어합니다. 유효한 값은 Top 및 Bottom입니다. 기본값은 Top입니다.

ToolBarItemsDisplayMode

표시되는 도구 모음 항목을 제어합니다. 이는 비트 열거 값입니다. 도구 모음 항목을 포함하려면 해당 항목의 값을 전체 값에 추가합니다. 예를 들면 다음과 같습니다. 동작 없음 메뉴의 경우 rv:ToolBarItemsDisplayMode=63(1+2+4+8+16+32) 또는 0x3F를 사용하고 동작 메뉴 항목의 경우 rv:ToolBarItemsDisplayMode=960 또는 0x3C0을 사용합니다. 유효한 값은 다음과 같습니다.

  1. 1(0x1): 뒤로 단추입니다.

  2. 2(0x2): 텍스트 검색 컨트롤입니다.

  3. 4(0x4): 페이지 탐색 컨트롤입니다.

  4. 8(0x8): 새로 고침 단추입니다.

  5. 16(0x10): 확대/축소 목록 상자입니다.

  6. 32(0x20): ATOM 피드 단추입니다.

  7. 64(0x40): 동작의 인쇄 메뉴 옵션입니다.

  8. 128(0x80): 동작의 내보내기 하위 메뉴입니다.

  9. 256(0x100: 동작의 보고서 작성기로 열기 메뉴 옵션입니다.

  10. 512(0x200): 동작의 구독 메뉴 옵션입니다.

기본값은 -1로, 모든 도구 모음 항목을 포함합니다.

예

다음 예제는 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

참고 항목

참조

URL에서 매개 변수 접두사 사용

관련 자료

URL 액세스