보고서 URL에 보고서 매개 변수를 포함하여 보고서에 보고서 매개 변수를 전달할 수 있습니다. 이러한 URL 매개 변수는 보고서 처리 엔진에 직접 전달되기 때문에 접두사가 붙지 않습니다.
중요합니다
URL에는 SharePoint 및 Reporting Services HTTP 프록시를 통해 요청을 라우팅하는 프록시 구문을 포함하는 _vti_bin 것이 중요합니다. 프록시는 SHAREPoint 모드 보고서 서버에 대한 보고서를 적절하게 실행하는 데 필요한 컨텍스트인 HTTP 요청에 일부 컨텍스트를 추가합니다.
프록시 구문을 포함하지 않는 경우 매개 변수 접두사를 rp:로 접두사로 지정해야 합니다.
모든 쿼리 매개 변수에는 해당하는 보고서 매개 변수가 있을 수 있습니다. 해당 보고서 매개 변수를 전달하여 쿼리 매개 변수를 보고서에 전달합니다. 자세한 내용은 관계형 쿼리 디자이너(보고서 작성기 및 SSRS)에서 쿼리 빌드를 참조하세요.
중요합니다
보고서 매개 변수는 대/소문자를 구분합니다.
비고
보고서 매개 변수는 대/소문자를 구분하며 다음 특수 문자를 사용합니다.
- URL 문자열에서 공백 문자는 URL 인코딩 표준에 따라 "%20" 문자로 바뀝니다.
- URL의 매개 변수 부분에서 공백 문자는 더하기 문자(+)로 대체됩니다.
- 문자열의 모든 부분에서 세미콜론은 문자로 "%3A"로 대체됩니다.
- 브라우저에서 적절한 URL 인코딩이 자동으로 수행됩니다. 문자를 수동으로 인코딩할 필요가 없습니다.
URL에 보고서 매개 변수를 설정하려면 다음 구문을 사용 합니다.
parameter=value
예를 들어 보고서에 정의된 두 개의 매개 변수인 "ReportMonth" 및 "ReportYear"를 지정하려면 기본 모드 보고서 서버에 다음 URL을 사용합니다.
http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008
예를 들어 보고서에 정의된 동일한 두 매개 변수를 지정하려면 SharePoint 통합 모드 보고서 서버에 대해 다음 URL을 사용합니다. 다음 사항에 유의하세요./_vti_bin
http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008
매개 변수에 대해 null 값을 전달하려면 다음 구문을 사용합니다.
parameter
:isnull=true
예를 들면 다음과 같습니다.
SalesOrderNumber:isnull=true
값을 전달하려면 false에 Boolean 0, true에 1을 사용합니다. 값을 전달 Float 하려면 서버 로캘의 소수 구분 기호를 포함합니다.
비고
보고서에 기본값이 있는 보고서 매개 변수가 포함되어 있고 속성 값 Prompt 이 false 보고서 관리자에서 프롬프트 사용자 속성이 선택되지 않은 경우 URL 내에서 해당 보고서 매개 변수의 값을 전달할 수 없습니다. 이러한 기능을 통해 관리자는 최종 사용자가 특정 보고서 매개 변수의 값을 추가하거나 수정하지 못하도록 설정할 수 있습니다.
추가 예제
다음 URL 예제에는 공백 및 여러 매개 변수가 포함됩니다.
"SQL Server 사용자 교육 팀"의 폴더 이름에는 공백이 포함되므로 "+"는 각 공간을 대체합니다.
"팀 프로젝트 보고서"의 보고서 이름에는 공백이 포함되므로 "+"는 각 공간을 대체합니다.
"값이 각각 "xgroup" 과 "ygroup" 인 "teamgrouping2"와 "teamgrouping1"의 두 매개 변수를 전달합니다."
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 의 단일 매개 변수를 전달합니다.
http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005