URL 액세스(SSRS)URL Access (SSRS)

SQL Server Reporting Services(SSRS)에서 보고서 서버의 URL 액세스를 사용하면 URL 요청을 통해 보고서 서버에 명령을 보낼 수 있습니다.URL access of the report server in SQL Server Reporting Services (SSRS) enables you to send commands to a report server through a URL request. 예를 들어 기본 모드 보고서 서버 또는 SharePoint 라이브러리에서 보고서 렌더링을 사용자 지정할 수 있습니다.For example, you can customize the rendering of a report on a native mode report server or in a SharePoint library. 특정 보고서 매개 변수 값 집합을 사용하여 보고서를 보거나 보고서의 관심 있는 특정 페이지를 본 경우You may have viewed the report using a specific set of report parameter values, or you may have been viewing a particular page of interest in the report. 미리 정의된 URL 액세스 매개 변수를 사용하여 이 정보를 URL에 캡슐화할 수 있습니다.You can encapsulate this information in the URL using predefined URL access parameters. 또한 렌더링 형식 및 보고서 뷰어의 디자인에 대한 매개 변수를 포함하여 보고서 서버에서 보고서를 처리하는 방식을 사용자 지정할 수 있습니다.You can further customize how the report server processes the report by embedding parameters for rendering formats or for the look and feel of the report viewer. 그런 다음 이 URL을 전자 메일이나 웹 페이지에 직접 붙여넣어 다른 사용자가 브라우저에서 같은 방식으로 보고서에 액세스하도록 할 수 있습니다.You can then paste this URL directly into an email or Web page to let others to access your report in the same manner in the browser.

URL 액세스를 통해 수행할 수 있는 다음 동작의 예를 들면 다음과 같습니다.Other actions you can perform through URL access are:

  • HTML 뷰어에 명령(예: 디자인 조정) 보내기Send commands to the HTML viewer, such as adjusting its look and feel

  • 카탈로그 폴더의 자식 나열List the children of a catalog folder

  • 카탈로그 항목의 XML 정의 검색Retrieve the XML definition of a catalog item

  • 특정 보고서 기록 스냅숏 렌더링Render a specific report history snapshot

  • 보고서 세션 관리Manage report sessions

    URL 액세스를 통해 사용할 수 있는 설정 및 명령의 전체 목록은 URL 액세스 매개 변수 참조를 참조하세요.For the complete list of commands and settings available through URL access, see URL Access Parameter Reference.

URL 액세스 개념URL Access Concepts

보고서 서버에 대한 URL 요청에는 보고서 서버에서 처리하는 매개 변수가 포함됩니다.URL requests to the report server contain parameters that are processed by the report server. 보고서 서버에서 URL 요청을 처리하는 방법은 매개 변수, 매개 변수 접두사, URL에 포함된 항목의 종류 등에 따라 다릅니다.The way in which the report server handles URL requests depends on the parameters, parameter prefixes, and types of items that are included in the URL. 보고서 서버 URL은 W3C(World Wide Web 컨소시엄)와 IETF의 공동 초안 표준에서 제안한 대로 URL 형식 지정 지침을 따릅니다.Report server URLs adhere to the URL formatting guidelines as proposed by the joint World Wide Web Consortium W3C/IETF draft standard. Reporting ServicesReporting Services URL 기능은 표준 URL 주소 지정을 지원하는 대부분의 인터넷 브라우저나 응용 프로그램에서 호환됩니다. URL functionality is compatible with most Internet browsers or applications that support standard URL addressing.

URL 액세스 구문URL Access Syntax

URL 요청에는 임의의 순서로 나열된 여러 매개 변수가 포함될 수 있습니다.URL requests can contain multiple parameters that are listed in any order. 매개 변수는 앰퍼샌드(&)로 구분되고 이름/값 쌍은 등호(=)로 구분됩니다.Parameters are separated by an ampersand (&) and name/value pairs are separated by an equal sign (=).


rswebserviceurl  
?  
reportpath  
      [&prefix:param=value]...n]  

구문 설명Syntax Description

rswebserviceurlrswebserviceurl
보고서 서버의 웹 서비스 URL입니다.The Web service URL of the report server. 기본 모드의 경우 Reporting Services 구성 관리자에 구성된 보고서 서버 인스턴스의 웹 서비스 URL입니다(보고서 서버 URL 구성(SSRS Configuration Manager) 참조).For native mode, it is the Web service URL of the report server instance configured in Reporting Services Configuration Manager (see Configure Report Server URLs (SSRS Configuration Manager)). 예를 들어For example:

http://myrshost/reportserver  
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE  

SharePoint 통합 모드의 경우 Reporting ServicesReporting Services 와 통합된 SharePoint 사이트의 Reporting ServicesReporting Services프록시 URL입니다.For SharePoint integrated mode, it is the URL of the Reporting ServicesReporting Services proxy at a SharePoint site integrated with Reporting ServicesReporting Services. 예를 들어For example:

http://myspsite/subsite/_vti_bin/reportserver  

URL에는 SharePoint를 통해 요청을 라우팅하는 _vti_bin 프록시 구문과 Reporting ServicesReporting Services HTTP 프록시를 포함하는 것이 중요합니다.It is important the URL include the _vti_bin proxy syntax to route the request through SharePoint and the Reporting ServicesReporting Services HTTP proxy. 프록시는 몇 가지 컨텍스트를 HTTP 요청에 추가하며 이 컨텍스트는 SharePoint 모드 보고서 서버에 대한 보고서의 올바른 실행을 보장하는 데 필요합니다.The proxy adds some context to the HTTP request, context that is required to ensure proper execution of the report for SharePoint mode report servers.

pathinfopathinfo
기본 모드 보고서 서버 데이터베이스 항목의 상대 경로 이름 또는 SharePoint 카탈로그 항목의 정규화된 URL입니다.The relative path name of the item in the native mode report server database, or the fully qualified URL of the item in a SharePoint catalog.

카탈로그 항목의 경로입니다.The path of the catalog item. 기본 모드의 경우 보고서 서버 데이터베이스 항목의 상대 경로(슬래시(/로 시작)입니다.For native mode, it is the relative path of the item in the report server database, beginning with a slash (/). 예를 들어For example:

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2  

SharePoint 통합 모드의 경우 SharePoint 라이브러리 항목의 정규화된 URL(항목 확장명 포함)입니다.For SharePoint integrated mode, it is the fully qualified URL of the item in the SharePoint library, including the item extension. 예를 들어For example:

http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl  

&
URL 액세스 매개 변수의 이름/값 쌍을 구분하는 데 사용됩니다.Used to separate name and value pairs of URL access parameters.

prefixprefix
(선택 사항)Optional. 보고서 서버 내에서 실행 중인 특정 프로세스에 액세스하는 URL 액세스 매개 변수의 접두사(예: rs: 또는 rc:)입니다.A prefix for the URL access parameter (for example, rs: or rc:) that accesses a specific process running within the report server.

참고

URL 액세스 매개 변수의 접두사가 포함되지 않은 경우 매개 변수는 보고서 서버에서 보고서 매개 변수로 처리됩니다.If a prefix for a URL access parameter is not included, the parameter is processed by the report server as a report parameter. 보고서 매개 변수는 매개 변수 접두사를 사용하지 않으며 대/소문자를 구분합니다.Report parameters do not use a parameter prefix and are case-sensitive.

paramparam
매개 변수 이름입니다.The parameter name.

valuevalue
사용 중인 매개 변수의 값에 해당하는 URL 텍스트입니다.URL text corresponding to the value of the parameter being used.

참고: 사용 가능한 URL 액세스 매개 변수의 목록은 URL Access Parameter Reference을(를) 참조하십시오.Note: For a list of the available URL access parameters, see URL Access Parameter Reference. URL에 보고서 매개 변수를 전달하는 예제는 Pass a Report Parameter Within a URL을 참조하십시오.For examples passing report parameters on the URL, see Pass a Report Parameter Within a URL.

태스크 설명Task Descriptions 링크Links
보고서, 공유 데이터 원본 및 리소스와 같은 보고서 서버 항목 액세스Access report server items, such as reports, shared data sources, and resources. URL 액세스를 사용하여 보고서 서버 항목 액세스Access Report Server Items Using URL Access
보고서 매개 변수를 보고서로 전달Pass report parameters to a report. Pass a Report Parameter Within a URLPass a Report Parameter Within a URL
URL 액세스 문자열에서 날짜, 통화 등의 로캘별 해석을 정의하는 보고서 매개 변수의 로캘 설정Set the locale of the report parameters in the URL access string, which defines the locale-specific interpretations of dates, currencies, and so on. URL에 보고서 매개 변수 언어 설정Set the Language for Report Parameters in a URL
보고서 렌더링 방식을 사용자 지정하는 렌더링 확장자별 설정 보내기Send rendering extension specific settings that customize how the report is rendered. URL에 장치 정보 설정 지정Specify Device Information Settings in a URL
보고서를 브라우저에서 보지 않고 파일 형식으로 직접 내보내기Export a report directly to a file format without viewing it in the browser. URL 액세스를 사용하여 보고서 내보내기Export a Report Using URL Access
보고서를 열고 문자열 위치로 직접 이동Open a report and navigate directly to the location of a string. URL 액세스를 사용하여 보고서 검색Search a Report Using URL Access
특정 보고서 기록 스냅숏 렌더링Render a specific report history snapshot. URL 액세스를 사용하여 보고서 기록 스냅숏 렌더링Render a Report History Snapshot Using URL Access

관련 항목:See Also

Pass a Report Parameter Within a URL Pass a Report Parameter Within a URL
URL 액세스 매개 변수 참조 URL Access Parameter Reference
URL 액세스를 사용하여 Reporting Services 통합 Integrating Reporting Services Using URL Access
보고서 찾기, 보기 및 관리(보고서 작성기 및 SSRS)Finding, Viewing, and Managing Reports (Report Builder and SSRS )