URL 액세스(SSRS)

  • 아티클

SSRS(SQL Server Reporting Services)에서 보고서 서버의 URL 액세스를 사용하면 URL 요청을 통해 보고서 서버에 명령을 보낼 수 있습니다. 이 기능을 사용하면 기본 모드 보고서 서버에서나 SharePoint 라이브러리에서 보고서를 렌더링하는 방법을 사용자 지정할 수 있습니다. 예를 들어, 보고서를 특정 보고서 매개 변수 값 세트를 사용해 볼 수도 있고, 아니면 보고서의 특정 관심 페이지를 볼 수도 있습니다. URL에서 이러한 매개 변수를 정의하려면 미리 정의된 URL 액세스 매개 변수를 사용하면 됩니다.

보고서 서버가 보고서를 처리하는 방식을 사용자 지정하려면 렌더링 형식에 매개 변수를 포함하거나, 보고서 뷰어의 디자인을 지정하면 됩니다. 그런 다음 이 URL을 다른 사용자에게 보내면 해당 인물도 브라우저에서 보고서에 같은 방식으로 액세스할 수 있습니다.

URL 액세스를 통해 수행할 수 있는 다른 작업의 예:

URL 액세스 개념

보고서 서버는 보고서 서버에 대한 URL 요청에 포함된 매개 변수를 처리합니다. 보고서 서버가 URL 요청을 처리하는 방법은 매개 변수, 매개 변수 접두사, URL에 포함된 항목 유형에 따라 다릅니다. 보고서 서버 URL은 공동 World Wide Web 컨소시엄 W3C/IETF 드래프트 표준에서 제안한 URL 서식 지정 지침을 준수합니다. Reporting Services URL 기능은 표준 URL 주소 지정을 지원하는 대부분의 인터넷 브라우저나 애플리케이션에서 호환됩니다.

URL 액세스 구문

URL 요청에는 임의의 순서로 나열된 여러 매개 변수가 포함될 수 있습니다. 매개 변수는 앰퍼샌드(&)를 사용해서, 이름/값 쌍은 등호(=)를 사용해서 구분합니다.

URL 액세스 문자열의 다양한 구성 요소를 잘 알아야 SSRS 보고서 서버에 효과적으로 명령을 보낼 수 있습니다. URL 액세스 문자열에 포함되는 내용:

  • https://[rswebserviceurl]: 보고서 서버의 웹 서비스 URL입니다.
  • ?: 매개 변수를 포함하는 쿼리 문자열의 시작을 나타냅니다.
  • [pathinfo]: 서버에서 보고서나 항목으로 이동하는 경로입니다.
  • [&prefix:param=value]: 보고서 렌더링이나 동작을 사용자 지정하는 옵션 접두사를 포함한 하나 이상의 매개 변수입니다.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

구문 설명

다음 섹션에 URL 액세스 문자열에 사용되는 몇몇 매개 변수를 상세하게 설명했습니다. 전체 목록은 URL 액세스 매개 변수 참고자료를 참조하세요.

rswebserviceurl

보고서 서버의 웹 서비스 URL입니다.

  • 기본 모드의 경우, 이것은 Reporting Services 구성 관리자에 구성된 웹 서비스 보고서 서버 인스턴스 웹 서비스 URL입니다. 자세한 내용은 보고서 서버 URL 구성(보고서 서버 구성 관리자)을 참조하세요.

    예시:

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

  • SharePoint 통합 모드의 경우 Reporting Services와 통합된 SharePoint 사이트의 Reporting Services 프록시 URL입니다.

    예시:

    https://myspsite/subsite/_vti_bin/reportserver

    팁

    URL에 _vti_bin 프록시 구문이 포함되어 있어야 요청이 SharePoint 및 Reporting Services HTTP 프록시를 통해 라우팅됩니다. 프록시는 HTTP 요청에 몇몇 컨텍스트를 추가합니다. SharePoint 모드 보고서 서버에 대하여 보고서의 적절한 실행을 보장하는 데 필요한 컨텍스트입니다.

pathinfo

기본 모드 보고서 서버 데이터베이스에 있는 항목의 상대 경로 이름 또는 SharePoint 카탈로그에 있는 항목의 정규화된 URL입니다.

카탈로그 항목의 경로입니다. 기본 모드의 경우 슬래시(/)로 시작하는 보고서 서버 데이터베이스에 있는 항목의 상대 경로입니다. 예시:

/AdventureWorks2022/Employee_Sales_Summary_2022

SharePoint 통합 모드의 경우 SharePoint 라이브러리 항목의 정규화된 URL(항목 확장명 포함)입니다. 예시:

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&prefix:param=value

URL 액세스 문자열에 매개 변수와 그에 상응하는 값을 추가하여 보고서 렌더링이나 동작을 사용자 지정합니다. 이름/값 쌍의 매개 변수는 구문 param=value를 사용해 구성하며, 앰퍼샌드(&)로 구분합니다.

옵션 접두사인 rs: 또는 rc:를 사용해 보고서 서버 내 특정 프로세스를 대상으로 설정합니다.

참고 사항

URL 액세스 매개 변수에 접두사가 포함되지 않으면, 해당 매개 변수는 보고서 서버가 보고서 매개 변수로 처리합니다. 보고서 매개 변수는 매개 변수 접두사를 사용하지 않고 대/소문자를 구분합니다.

다음 예제에 이 문서에서 설명한 URL 전체를 표시했습니다.

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

관련 콘텐츠