URL 내에서 보고서 매개 변수 전달

보고서 매개 변수를 보고서 URL에 포함시켜 보고서에 전달할 수 있습니다. 이러한 URL 매개 변수는 보고서 처리 엔진에 직접 전달되므로 접두사로 지정되지 않습니다.

참고 항목

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

Important

URL에는 SharePoint 및 Reporting Services HTTP 프록시를 통해 요청을 라우팅하는 프록시 구문을 포함하는 _vti_bin 것이 중요합니다. 프록시는 몇 가지 컨텍스트를 HTTP 요청에 추가하며 이 컨텍스트는 SharePoint 모드 보고서 서버에 대한 보고서의 올바른 실행을 보장하는 데 필요합니다.

프록시 구문을 포함하지 않는 경우 매개 변수 접두사를 rp:로 접두사지정해야 합니다.

모든 쿼리 매개 변수에는 해당하는 보고서 매개 변수가 있을 수 있습니다. 해당 보고서 매개 변수를 전달하여 쿼리 매개 변수를 보고서에 전달합니다. 자세한 내용은 관계형 쿼리 디자이너(보고서 작성기 및 SSRS)에서 쿼리 빌드를 참조하세요.

Important

보고서 매개 변수는 대/소문자를 구분합니다.

참고 항목

보고서 매개 변수는 대/소문자를 구분하며 다음 특수 문자를 사용합니다.

  • URL 문자열에서 공백 문자는 URL 인코딩 표준에 따라 "%20" 문자로 바뀝니다.
  • URL의 매개 변수 부분에서 공백 문자는 더하기 문자(+)로 대체됩니다.
  • 문자열의 모든 부분에서 세미콜론은 문자로 "%3A"로 대체됩니다.
  • 브라우저에서 적절한 URL 인코딩이 자동으로 수행됩니다. 문자를 수동으로 인코딩할 필요가 없습니다.

URL에 보고서 매개 변수를 설정하려면 다음 구문을 사용 합니다.

  
parameter=value  

예를 들어 보고서에 정의된 두 개의 매개 변수인 "ReportMonth" 및 "ReportYear"를 지정하려면 기본 모드 보고서 서버에 다음 URL을 사용합니다.

https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008  

예를 들어 보고서에 정의된 동일한 두 매개 변수를 지정하려면 SharePoint 통합 모드 보고서 서버에 대해 다음 URL을 사용합니다. 다음 사항에 유의하세요./_vti_bin

https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008  

매개 변수에 대해 null 값을 전달하려면 다음 구문을 사용합니다.

  
parameter  
:isnull=true  
  

예를 들면 다음과 같습니다.

SalesOrderNumber:isnull=true  

부울 값을 전달하려면 false에 대해 0, true에 대해 1을 사용합니다. Float 값을 전달하려면 서버 로캘의 소수 구분 기호를 포함합니다.

참고 항목

보고서에 기본값이 있는 보고서 매개 변수가 포함되어 있고 Prompt 속성이 false(즉 보고서 관리자에서 Prompt User 속성을 선택하지 않음)이면 URL 내에서 해당 보고서 매개 변수에 대한 값을 전달할 수 없습니다. 이러한 기능을 통해 관리자는 최종 사용자가 특정 보고서 매개 변수의 값을 추가하거나 수정하지 못하도록 설정할 수 있습니다.

추가 예

다음 URL 예제에는 공백 및 여러 매개 변수가 포함됩니다.

  • "SQL Server 사용자 교육 팀" 폴더 이름에는 공백이 포함되므로 "+"가 공백을 각각 대체합니다.

  • "팀 프로젝트 보고서"의 보고서 이름에는 공백이 포함되므로 "+"는 각 공간을 대체합니다.

  • 값이 "teamgrouping2"이고 값 xgroup 이 "teamgrouping1" ygroup인 두 매개 변수를 전달합니다.

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup  

다음 URL 예제에는 다중 값 매개 변수 "OrderID"를 포함합니다. 다중 값 매개 변수의 형식은 각 값에 대한 매개 변수 이름을 반복하는 것입니다.

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup&OrderID=747&OrderID=787&OrderID=12  

다음 URL 예제는 기본 모드 보고서 서버에 대해 값이 “7/1/2005”인 단일 매개 변수 SellStartDate를 전달합니다.

https://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005