URL 액세스 매개 변수 참조

  • 아티클

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

Important

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

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

HTML 뷰어 명령(rc:)

  • HTML 뷰어 명령은 HTML 뷰어를 대상으로 하는 데 사용되며 접두사에는 rc::

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

    Important

    rc:Toolbar=false는 SharePoint 사이트에서 호스트되는 보고서를 대상으로 지정하기 위해 할 일기본 이름 대신 IP 주소를 사용하는 URL 액세스 문자열에서 작동하지 않습니다.

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

    기본 모드의 예제:

    https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

    예를 들어 SharePoint 모드에서는 다음을 수행합니다.

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed

  • 확대/축소: 보고서 확대/축소 값을 정수 백분율 또는 문자열 상수로 설정합니다. 표준 문자열 값에는 페이지 너비 및 전체 페이지가 포함됩니다. Internet Explorer 5.0 이전 버전의 Internet Explorer 및 모든 타사 브라우저는 이 매개 변수를 무시합니다. 이 매개 변수의 기본값은 100입니다.

    기본 모드의 예제:

    https://myrshost/reportserver?/Sales&rc:Zoom=Page Width

    예를 들어 SharePoint 모드에서는 다음을 수행합니다.

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page Width

  • 섹션: 보고서에서 표시할 페이지를 설정합니다. 보고서의 페이지 수보다 큰 값은 마지막 페이지를 표시합니다. 0보다 작은 값은 보고서의 페이지 1을 표시합니다. 이 매개 변수의 기본값은 1입니다.

    기본 모드의 예제의 경우 보고서의 2페이지를 표시합니다.

    https://myrshost/reportserver?/Sales&rc:Section=2

    SharePoint 모드의 예제에서는 보고서의 2페이지를 표시합니다.

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2

  • FindString: 보고서에서 특정 텍스트 집합을 검색하고 텍스트를 강조 표시합니다.

    Important

    URL 액세스 문자열에 rc:Toolbar=false를 포함하지 않으면 rc:FindString은 작동하지 않습니다.

    기본 모드의 예제:

    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: 검색할 마지막 섹션을 지정합니다. 이 매개 변수의 기본값은 보고서의 마지막 페이지입니다.

    제품 카탈로그 샘플 보고서에서 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 매개 변수와 함께 이 매개 변수를 사용합니다. 이전 예제를 참조하세요.

  • FallbackPage: 검색 또는 문서 맵 선택 실패 시 표시할 페이지 수를 설정합니다. 기본값은 현재 페이지의 수입니다.

  • GetImage: HTML 뷰어 사용자 인터페이스에 대한 특정 아이콘을 가져옵니다.

  • 아이콘: 특정 렌더링 확장 프로그램의 아이콘을 가져옵니다.

  • 스타일시트: HTML 뷰어에 적용할 스타일시트를 지정합니다.

  • 디바이스 정보 설정: 디바이스 정보 설정을 형식 rc:tag=value으로 지정합니다. 여기서 태그 는 현재 사용되는 렌더링 확장 프로그램에 특정한 디바이스 정보 설정의 이름입니다. (자세한 내용은 에 대한 설명을 참조하세요.형식 매개 변수입니다.) 예를 들어 IMAGE 렌더링 확장 프로그램에 대한 OutputFormat 디바이스 정보 설정을 사용하여 URL 액세스 문자열 ...&rs:Format=IMAGE&rc:OutputFormat=JPEG에서 다음 매개 변수를 사용하여 보고서를 JPEG 이미지로 렌더링할 수 있습니다. 모든 확장 프로그램별 디바이스 정보 설정에 대한 자세한 내용은 렌더링 확장 프로그램에 대한 디바이스 정보 설정(Reporting Services)을 참조하세요.

보고서 서버 명령(rs:)

보고서 서버 명령은 접두사로 rs: 보고서 서버를 대상으로 하는 데 사용됩니다.

  • Command: 해당 항목 유형에 따라 카탈로그 항목에 동작을 수행합니다. 기본값은 URL 액세스 문자열에 참조된 카탈로그 항목의 유형에 의해 결정됩니다. 유효한 값은 다음과 같습니다.

    • 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

    • 렌더링: 보고서를 볼 수 있도록 브라우저에서 보고서가 렌더링됩니다.

      기본 모드의 예제:

      https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

      예를 들어 SharePoint 모드에서는 다음을 수행합니다.

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render

    • GetSharedDatasetDefinition: 공유 데이터 세트와 연결된 XML 정의를 표시합니다. 쿼리, 데이터 세트 매개 변수, 기본값, 데이터 세트 필터 및 데이터 정렬 및 대/소문자 구분과 같은 데이터 옵션을 포함한 공유 데이터 세트 속성이 정의에 저장됩니다. 이 값을 사용하려면 공유 데이터 세트에 대한 보고서 정의 읽기 권한이 있어야 합니다.

      기본 모드의 예제:

      https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition

    • 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

    • 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

    • GetComponentDefinition: 게시된 보고서 항목과 연결된 XML 정의를 표시합니다. 이 값을 사용하려면 게시된 보고서 항목에 대한 읽기 콘텐츠 권한이 있어야 합니다.

  • 형식: 보고서를 렌더링하고 볼 형식을 지정합니다. 일반적인 값은 다음과 같습니다.

    • HTML5

    • Pptx

    • 원자

    • HTML4.0

    • Mhtml

    • 이미지

    • EXCEL (.xls)

    • EXCELOPENXML (.xlsx)

    • WORD (.doc)

    • WORDOPENXML(.docx)

    • CSV

    • PDF

    • XML

    기본값은 HTML5입니다. 자세한 내용은 URL 액세스를 사용하여 보고서 내보내기를 참조 하세요.

    전체 목록은 보고서 서버 rsreportserver.config 파일의 <Render> 확장 섹션을 참조하세요. 파일을 찾을 수 있는 위치에 대한 자세한 내용은 RsReportServer.config 구성 파일을 참조하세요.

    예를 들어 기본 모드 보고서 서버에서 직접 보고서 PDF 복사본을 가져오는 경우 다음을 사용합니다.

    https://myrshost/ReportServer?/myreport&rs:Format=PDF

    예를 들어 SharePoint 모드 보고서 서버에서 직접 보고서의 PDF 복사본을 얻으려면 다음을 수행합니다.

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF

  • ParameterLanguage: 브라우저 언어와 독립적인 URL에 전달된 매개 변수에 대한 언어를 제공합니다. 기본값은 브라우저 언어입니다. 값은 en-us 또는 de-de와 같은 문화권 값일 수 있습니다.

    예를 들어 기본 모드에서 브라우저 언어를 재정의하고 de-DE의 문화권 값을 지정합니다.

    https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE

  • 스냅샷: 보고서 기록 스냅샷 기반으로 보고서를 렌더링합니다. 자세한 내용은 URL 액세스를 사용하여 보고서 기록 스냅샷 렌더링을 참조하세요.

    예를 들어 기본 모드에서는 타임스탬프를 13:40:02로 사용하여 2003-04-07년 스냅샷 보고서 기록을 검색합니다.

    https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02

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

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

  • SessionID: 클라이언트 애플리케이션과 보고서 서버 간에 설정된 활성 보고서 세션을 지정합니다. 이 매개 변수의 값은 세션 식별자로 설정됩니다.

    세션 ID를 쿠키로 지정하거나 URL의 일부로 지정할 수 있습니다. 보고서 서버가 세션 쿠키를 사용하지 않도록 구성된 경우 지정된 세션 ID가 없는 첫 번째 요청은 세션 ID로 리디렉션됩니다. 보고서 서버 세션에 대한 자세한 내용은 실행 상태 식별을 참조하세요.

  • ClearSession: true 값은 보고서 서버가 보고서 세션에서 보고서를 제거하도록 합니다. 인증된 사용자와 연결된 모든 보고서 인스턴스는 보고서 세션에서 제거됩니다. (보고서 인스턴스는 다른 보고서 매개 변수 값으로 여러 번 실행되는 동일한 보고서로 정의됩니다.) 기본값은 false입니다.

  • ResetSession: true 값은 보고서 서버가 보고서 세션의 모든 보고서 스냅샷 연결을 제거하여 보고서 세션을 다시 설정하도록 지시합니다. 기본값은 false입니다.

  • ShowHideToggle: 보고서의 섹션의 표시/숨기기 상태를 토글합니다. 토글할 섹션을 나타내는 양의 정수를 지정합니다.

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

다음 SQL Server 예약된 보고서 매개 변수 이름은 SharePoint와 통합된 보고서 뷰어 웹 파트를 대상 지정하는 데 사용됩니다. 이러한 매개 변수 이름 앞에는 rv:가 접두사로 지정됩니다. 보고서 뷰어 웹 파트에는 rs:ParameterLanguage 매개 변수도 사용할 수 있습니다.

  • 도구 모음: 보고서 뷰어 웹 파트의 도구 모음 표시를 제어합니다. 기본값은 Full입니다. 값은 다음과 같습니다.

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

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

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

    예를 들어 SharePoint 모드에서는 도구 모음에 페이지 매김만 표시합니다.

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation

  • HeaderArea: 보고서 뷰어 웹 파트의 헤더 표시를 제어합니다. 기본값은 Full입니다. 값은 다음과 같습니다.

    • 전체: 전체 헤더를 표시합니다.

    • BreadCrumbsOnly: 사용자에게 애플리케이션의 위치를 알리기 위해 헤더에 이동 경로 탐색만 표시합니다.

    • 없음: 헤더를 표시하지 않습니다.

    예를 들어 SharePoint 모드에서는 머리글에 이동 경로 탐색만 표시합니다.

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly

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

  • AsyncRender: 보고서가 비동기적으로 렌더링되는지 여부를 제어합니다. 기본값은 true로, 보고서가 비동기적으로 렌더링되도록 지정합니다. 값은 true 또는 false의 부울 값이어야 합니다.

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

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

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

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

    예를 들어 SharePoint 모드에서 매개 변수 프롬프트 영역을 축소하려면 다음을 수행합니다.

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed

  • DocMapMode: 보고서 뷰어 웹 파트의 문서 맵 영역이 전체 페이지 보기에 표시되는 방식을 제어합니다. 기본값은 Full입니다. 유효한 값은 다음과 같습니다.

    • 전체: 문서 맵 영역을 표시합니다.

    • 축소됨: 문서 맵 영역을 축소합니다.

    • 숨김: 문서 맵 영역을 숨깁니다.

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

    예를 들어 SharePoint 모드에서는 도구 모음을 아래쪽에 고정합니다.

    https://myspsite/_vti_bin/reportserver?https://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 모드에서는 뒤로 단추, 텍스트 검색 컨트롤, 페이지 탐색 컨트롤 및 새로 고침 단추만 표시합니다.

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

관련 콘텐츠