URL 액세스 매개 변수 참조
보고서의 모양과 느낌을 구성하는 URL의 일부로 다음 매개 변수를 사용할 수 있습니다. 이 섹션에는 가장 일반적인 매개 변수가 나열됩니다. 매개 변수는 대/소문자를 구분하지 않으며, 매개 변수 접두사는 보고서 서버로 전달되는 경우 rs: 로 시작하고 HTML 뷰어로 전달되는 경우 rc: 로 시작합니다. 디바이스 또는 렌더링 확장 프로그램에 특정하는 매개 변수를 지정할 수도 있습니다. 디바이스별 매개 변수에 대한 자세한 내용은 URL에서 디바이스 정보 설정 지정을 참조하세요.
Important
URL에 _vti_bin 프록시 구문이 포함되어 있어야 요청이 SharePoint 및 Reporting Services HTTP 프록시를 통해 라우팅됩니다. 프록시는 몇 가지 컨텍스트를 HTTP 요청에 추가하며 이 컨텍스트는 SharePoint 모드 보고서 서버에 대한 보고서의 올바른 실행을 보장하는 데 필요합니다. 예제는 URL 액세스를 사용하여 보고서 서버 항목에 액세스하는 것을 참조 하세요.
URL에 보고서 매개 변수 및 예제를 포함하는 방법에 대한 자세한 내용은 URL 내에서 보고서 매개 변수 전달을 참조하세요.
HTML 뷰어 명령(rc:)
다음 표에서는 rc 접두사로 사용되며 HTML 뷰어를 대상으로 하는 데 사용되는 URL 액세스 매개 변수에 대해 설명합니다.
| 매개 변수 | 설명 | 값 |
|---|---|---|
| 도구 모음 | 도구 모음을 표시하거나 숨깁니다. ** 중요 ** rc:도구 모음 false=은 SharePoint 사이트에서 호스트되는 보고서를 대상으로 지정하기 위해 도메인 이름 대신 IP 주소를 사용하는 URL 액세스 문자열에서 작동하지 않습니다. |
이 매개 변수의 값이 false면 나머지 옵션은 모두 무시됩니다. 이 매개 변수를 생략하면 도구 모음을 지원하는 렌더링 형식에 대한 도구 모음이 자동으로 표시됩니다. 이 매개 변수의 기본값은 .입니다 true.true false |
| 매개 변수 | 도구 모음의 매개 변수 영역을 표시하거나 숨깁니다.Native 모드 예제:http://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed |
이 매개 변수를 true로 설정하면 도구 모음의 매개 변수 영역이 표시됩니다. 이 매개 변수를 false로 설정하면 매개 변수 영역이 표시되지 않고 사용자가 영역을 표시할 수 없습니다. 이 매개 변수를 값 Collapsed으로 설정하면 매개 변수 영역이 표시되지 않지만 최종 사용자가 전환할 수 있습니다. 이 매개 변수의 기본값은 true입니다. 유효한 값은 다음과 같습니다.true false Collapsed |
| 확대/축소 | 보고서 확대/축소 값을 정수 백분율 또는 문자열 상수로 설정합니다.Native 모드 예제:http://myrshost/reportserver?/Sales&rc:Zoom=Page WidthSharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width |
표준 문자열 값에는 포함 Page Width 및 Whole Page. Internet Explorer 5.0 이전 버전과 모든 비 Microsoft 브라우저에서는 이 매개 변수가 무시됩니다. 이 매개 변수의 기본값은 100입니다. |
| 섹션 | 보고서에서 표시할 페이지를 설정합니다.Native 모드 예제는 보고서의 페이지 2를 표시합니다.http://myrshost/reportserver?/Sales&rc:Section=2SharePoint 모드 예제는 보고서의 페이지 2를 표시합니다.http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2 |
보고서의 페이지 수보다 큰 값은 마지막 페이지를 표시합니다. 보고서의 페이지 1을 표시하는 값보다 0 작은 값입니다. 이 매개 변수의 기본값은 1입니다. |
| FindString | 보고서에서 특정 텍스트 집합을 검색합니다.Native 모드 예제:http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400SharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400 |
|
| StartFind | 검색할 마지막 섹션을 지정합니다.Native 제품 카탈로그 샘플 보고서에서 1페이지부터 5페이지로 끝나는 텍스트 "Mountain-400"의 첫 번째 항목을 검색하는 모드 예제입니다.https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
이 매개 변수의 기본값은 보고서의 마지막 페이지입니다. |
| EndFind | 검색에 사용할 마지막 페이지의 수를 설정합니다. 예를 들어, 값 5는 검색할 마지막 페이지가 보고서의 5페이지임을 나타냅니다. StartFind 매개 변수와 함께 이 매개 변수를 사용합니다. StartFind에 대한 위의 예제를 참조하세요. |
기본값은 현재 페이지 번호입니다. |
| FallbackPage | 검색 또는 문서 맵 선택이 실패할 경우 표시할 페이지 수를 설정합니다. | 기본값은 현재 페이지 번호입니다. |
| GetImage | HTML 뷰어 사용자 인터페이스에 대한 특정 아이콘을 가져옵니다. | |
| Icon | 특정 렌더링 확장 프로그램의 아이콘을 가져옵니다. | |
| 스타일시트 | HTML 뷰어에 적용할 스타일시트를 지정합니다. | |
| 디바이스 정보 설정 | 태그가 현재 사용되는 렌더링 확장 프로그램에 특정한 디바이스 정보 설정의 이름인 디바이스 정보 설정을 형식 rc:tag=value 으로 지정합니다(Format 매개 변수에 대한 설명 참조). 예를 들어 이미지 렌더링 확장 프로그램에서 URL 액세스 문자열에 다음 매개 변수를 사용하는 JPEG 이미지에 보고서를 렌더링할 수 있도록 OutputFormat 디바이스 정보 설정을 사용할 수 있습니다. ...&rs:Format=IMAGE&rc:OutputFormat=JPEG 모든 확장 관련 디바이스 정보 설정 에 대한 자세한 내용은 렌더링 확장 프로그램에 대한 디바이스 정보 설정(Reporting Services)을 참조하세요. |
보고서 서버 명령(rs:)
다음 표에서는 rs 접두 사로 사용되며 보고서 서버를 대상으로 하는 데 사용되는 URL 액세스 매개 변수에 대해 설명합니다 .
| 매개 변수 | 설명 |
|---|---|
| Command | 항목 유형에 따라 카탈로그 항목에 대한 작업을 수행합니다. 기본값은 URL 액세스 문자열에 참조된 카탈로그 항목의 유형에 의해 결정됩니다. 유효한 값은 다음과 같습니다.ListChildren 폴더 GetChildren 의 내용을 표시합니다. 폴더 항목은 일반 항목 탐색 페이지 내에 표시됩니다.Native 모드 예제:http://myrshost/reportserver?/Sales&rs:Command=GetChildrenSharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren |
Render 지정된 보고서를 렌더링합니다.Native 모드 예제:http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
|
GetSharedDatasetDefinition 공유 데이터 세트와 연결된 XML 정의를 표시합니다. 쿼리, 데이터 세트 매개 변수, 기본값, 데이터 세트 필터 및 데이터 정렬 및 대/소문자 구분과 같은 데이터 옵션을 포함한 공유 데이터 세트 속성이 정의에 저장됩니다. 이 값을 사용하려면 공유 데이터 세트에 대한 보고서 정의 읽기 권한이 있어야 합니다.Native 모드 예제:https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
|
GetDataSourceContents 지정된 공유 데이터 원본의 속성을 XML로 표시합니다. 브라우저에서 XML을 지원하고 데이터 원본에 대한 권한이 있는 Read Contents 인증된 사용자인 경우 데이터 원본 정의가 표시됩니다.Native 모드 예제:http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContentsSharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents |
|
GetResourceContents 리소스가 브라우저와 호환되는 경우 리소스를 렌더링하고 HTML 페이지에 표시합니다. 그렇지 않으면 파일 또는 리소스를 열거나 디스크에 저장하라는 메시지가 나타납니다.Native 모드 예제:http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint 모드 예제:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
|
GetComponentDefinition 게시된 보고서 항목과 연결된 XML 정의를 표시합니다. 이 값을 사용하려면 게시된 보고서 항목에 대한 권한이 있어야 합니다 Read Contents . |
|
| 형식 | 보고서를 렌더링할 형식을 지정합니다. 일반적인 값은 ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML입니다. 기본값은 HTML4.0입니다. 자세한 내용은 Export a Report Using URL Access를 참조하세요.예를 들어 Native 모드 보고서 서버에서 직접 보고서 PDF 복사본을 가져오는 경우 다음을 사용합니다.http://myrshost/ReportServer?/myreport&rs:Format=PDF예를 들어 모드입니다 SharePoint .http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
| ParameterLanguage | 브라우저 언어와 독립적으로 URL에 전달되는 매개 변수의 언어를 제공합니다. 기본값은 브라우저 언어입니다. 값은 문화권 값(예:en-usde-de.예를 들어 모드에서는 Native 브라우저 언어를 재정의하고 de-DE의 문화권 값을 지정합니다.http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
| 스냅샷 | 보고서 기록 스냅샷을 기반으로 보고서를 렌더링합니다. 자세한 내용은 URL 액세스를 사용하여 보고서 기록 스냅샷 렌더링을 참조 하세요. 예를 들어 모드에서는 Native 타임스탬프가 13:40:02인 2003-04-07년도의 보고서 기록 스냅샷을 검색합니다.http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
| PersistStreams | 보고서를 단일 지속형 스트림에서 렌더링합니다. 이 매개 변수는 이미지 렌더러에서 렌더링된 보고서를 한 번에 한 청크씩 전송하는 데 사용됩니다. URL 액세스 문자열에서 이 매개 변수를 사용한 후 PersistStreams 매개 변수 대신 GetNextStream 매개 변수와 동일한 URL 액세스 문자열을 사용하여 지속형 스트림에서 다음 청크를 가져옵니다. 이 URL 명령은 결국 0 바이트 스트림을 반환하여 지속형 스트림의 끝을 나타냅니다. 기본값은 false입니다. |
| GetNextStream | PersistStreams 매개 변수를 사용하여 액세스되는 지속형 스트림의 다음 데이터 청크를 가져옵니다 . 자세한 내용은 PersistStreams에 대한 설명을 참조하십시오. 기본값은 false입니다. |
| SessionID | 클라이언트 애플리케이션과 보고서 서버 간에 설정된 활성 보고서 세션을 지정합니다. 이 매개 변수의 값은 세션 식별자로 설정됩니다. 세션 ID를 쿠키로 지정하거나 URL의 일부로 지정할 수 있습니다. 보고서 서버가 세션 쿠키를 사용하지 않도록 구성된 경우 지정된 세션 ID가 없는 첫 번째 요청은 세션 ID로 리디렉션됩니다. 보고서 서버 세션에 대한 자세한 내용은 실행 상태 식별을 참조하세요. |
| ClearSession | true 값은 보고서 서버가 보고서 세션에서 보고서를 제거하도록 합니다. 인증된 사용자와 연결된 모든 보고서 인스턴스는 보고서 세션에서 제거됩니다. (보고서 인스턴스는 다른 보고서 매개 변수 값으로 여러 번 실행되는 동일한 보고서로 정의됩니다.) 기본값은 .입니다 false. |
| ResetSession | true 값은 보고서 서버가 보고서 세션과 모든 보고서 스냅샷의 연결을 제거하여 보고서 세션을 다시 설정하도록 합니다. 기본값은 false입니다. |
| ShowHideToggle | 보고서의 섹션의 표시/숨기기 상태를 토글합니다. 토글할 섹션을 나타내는 양의 정수를 지정합니다. |
보고서 뷰어 웹 파트 명령(rv:)
다음 표에서는 SharePoint와 통합된 보고서 뷰어 웹 파트를 대상으로 하는 데 사용되는 SQL Server 예약 보고서 매개 변수 이름을 설명합니다. 이러한 매개 변수 이름 앞에는 rv:가 접두사로 지정됩니다. 보고서 뷰어 웹 파트는 rs:ParameterLanguage 매개 변수도 허용합니다.
| 매개 변수 | 작업 |
|---|---|
| 도구 모음 | 보고서 뷰어 웹 파트의 도구 모음 표시를 제어합니다. 기본값은 Full입니다. 가능한 값:Full: 전체 도구 모음을 표시합니다.Navigation: 도구 모음에 페이지 매김만 표시합니다.None: 도구 모음을 표시하지 않습니다.예를 들어 모드에서는 SharePoint 도구 모음에 페이지 매김만 표시합니다.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
| HeaderArea | 보고서 뷰어 웹 파트의 머리글 표시를 제어합니다. 기본값은 Full입니다. 가능한 값:Full: 전체 헤더를 표시합니다.BreadCrumbsOnly: 헤더에 이동-부스러기 탐색만 표시하여 애플리케이션에 있는 위치를 사용자에게 알릴 수 있습니다.None: 머리글을 표시하지 않습니다.예를 들어 모드에서는 SharePoint 머리글에 이동-부스러기 탐색만 표시합니다.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
| DocMapAreaWidth | 보고서 뷰어 웹 파트에서 매개 변수 영역의 표시 너비(픽셀)를 제어합니다. 기본값은 보고서 뷰어 웹 파트 기본값과 같습니다. 값은 음의 정수가 아니어야 합니다. |
| AsyncRender | 보고서가 비동기적으로 렌더링되는지 여부를 제어합니다. 기본값은 true보고서가 비동기적으로 렌더링되도록 지정하는 값입니다. 부울 값 true 또는 false여야 합니다. |
| ParamMode | 보고서 뷰어 웹 파트의 매개 변수 프롬프트 영역이 전체 페이지 보기에 표시되는 방식을 제어합니다. 기본값은 Full입니다. 유효한 값은 다음과 같습니다.Full: 매개 변수 프롬프트 영역을 표시합니다.Collapsed: 매개 변수 프롬프트 영역을 축소합니다.Hidden: 매개 변수 프롬프트 영역을 숨깁니다.예를 들어 SharePoint 모드에서는 매개 변수 프롬프트 영역을 축소합니다.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
| DocMapMode | 보고서 뷰어 웹 파트의 문서 구조 영역이 전체 페이지 뷰에서 표시되는 방식을 제어합니다. 기본값은 Full입니다. 유효한 값은 다음과 같습니다.Full: 문서 맵 영역을 표시합니다.Collapsed: 문서 맵 영역을 축소합니다.Hidden: 문서 맵 영역을 숨깁니다. |
| DockToolBar | 보고서 뷰어 웹 파트의 도구 모음이 위쪽 또는 아래쪽에 도킹되는지 여부를 제어합니다. 유효한 값은 Top 및 Bottom입니다. 기본값은 Top입니다.예를 들어 모드에서는 SharePoint 도구 모음을 아래쪽에 도킹합니다.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
| ToolBarItemsDisplayMode | 도구 모음 항목 표시 여부를 제어합니다. 비트 열거 값입니다. 툴바 항목을 포함하려면 항목의 값을 총 값에 추가합니다. 예를 들어 작업 메뉴가 없으므로 rv:ToolBarItemsDisplayMode=63(또는 0x3F)을 사용합니다. 즉, 1+2+4+8+16+32입니다. 작업 메뉴 항목에 대해서만 rv:ToolBarItemsDisplayMode=960(또는 0x3C0)을 사용합니다. 기본값은 -1모든 도구 모음 항목을 포함하는 것입니다. 유효한 값은 다음과 같습니다.1(0x1): 뒤로 단추 2(0x2): 텍스트 검색 컨트롤 4(0x4): 페이지 탐색 컨트롤 8(0x8): 새로 고침 단추 16(0x10): 확대/축소 목록 상자 32(0x20): 아톰 피드 단추 64(0x40): 동작 의 인쇄메뉴 옵션 128(0x80): 작업의 내보내기 하위 메뉴 256(0x100: 작업의 보고서 작성기 메뉴 옵션으로 열기 512(0x200: 동작 의 구독메뉴 옵션 1024(0x400: 작업의 새 데이터 경고 메뉴 옵션 예를 들어 모드에서는 SharePoint 뒤로 단추, 텍스트 검색 컨트롤, 페이지 탐색 컨트롤 및 새로 고침 단추만 표시합니다.http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |