URL에 보고서 매개 변수 전달Pass a Report Parameter Within a URL

보고서 매개 변수를 보고서 URL에 포함시켜 보고서에 전달할 수 있습니다.You can pass report parameters to a report by including them in a report URL. 이러한 URL 매개 변수는 보고서 처리 엔진에 직접 전달되기 때문에 접두사가 붙지 않습니다.These URL parameters are not prefixed because they are passed directly to the report processing engine.

중요

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.

프록시 구문을 포함하지 않으면 접두사 rp:로 매개 변수를 시작해야 합니다.If you don’t include the proxy syntax, then you need to prefix the parameter with rp:.

모든 쿼리 매개 변수에는 해당하는 보고서 매개 변수가 있을 수 있습니다.All query parameters can have corresponding report parameters. 해당 보고서 매개 변수를 전달하여 보고서에 쿼리 매개 변수를 전달할 수 있습니다.You pass a query parameter to a report by passing the corresponding report parameter. 자세한 내용은 관계형 쿼리 디자이너에서 쿼리 작성(보고서 작성기 및 SSRS)을 참조하세요.For more information, see Build a Query in the Relational Query Designer (Report Builder and SSRS).

중요

보고서 매개 변수는 대/소문자를 구분합니다.Report parameters are case-sensitive.

참고

보고서 매개 변수는 대/소문자를 구분하고 다음과 같은 특수 문자를 사용합니다.Report parameters are case-sensitive and utilize the following special characters:

  • URL 문자열에서 공백 문자는 URL 인코딩 표준에 따라 "%20" 문자로 바뀝니다.Any space characters in the URL string are replaced with the characters "%20," according to URL encoding standards.
    • URL의 매개 변수 부분에서 공백 문자는 더하기 문자(+)로 대체됩니다.A space character in the parameter portion of the URL is replaced with a plus character (+).
    • 문자열의 모든 부분에서 세미콜론은 "%3A" 문자로 바뀝니다.A semicolon in any portion of the string is replaced with the characters "%3A."
    • 브라우저에서 적절한 URL 인코딩을 자동으로 수행하며Browsers should automatically perform the proper URL encoding. 문자를 수동으로 인코딩할 필요는 없습니다.You do not have to encode any of the characters manually.

URL에 보고서 매개 변수를 설정하려면 다음 구문을 사용 합니다.To set a report parameter within a URL, use the following syntax:


parameter=value  

예를 들어 보고서에 정의된 두 개의 매개 변수 “ReportMonth” 및 “ReportYear”를 지정하려면 기본 모드 보고서 서버에 다음 URL을 사용합니다.For example, to specify two parameters, “ReportMonth” and “ReportYear”, defined in a report, use the following URL for a native mode report server:

http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008  

예를 들어 보고서에 정의된 두 개의 같은 매개 변수를 지정하려면 SharePoint 통합 모드 보고서 서버에 다음 URL을 사용합니다.For example, to specify the same two parameters defined in a report, use the following URL for a SharePoint integrated mode report server. /_vti_bin을 참고하세요.Note the /_vti_bin:

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008  

매개 변수에 대해 null 값을 전달하려면 다음 구문을 사용합니다.To pass a null value for a parameter, use the following syntax:


parameter  
:isnull=true  

예:For example,

SalesOrderNumber:isnull=true  

Boolean 값을 전달하려면 False에 0을 사용하고 True에 1을 사용합니다.To pass a Boolean value, use 0 for false and 1 for true. Float 값을 전달하려면 서버 로캘의 소수 구분 기호를 포함합니다.To pass a Float value, include the decimal separator of the server locale

참고

보고서에 기본값을 가진 보고서 매개 변수가 포함되어 있고 Prompt 속성의 값이 false 이면(즉, 보고서 관리자에서 사용자에게 확인 속성이 선택되지 않음) URL 내에서 해당 보고서 매개 변수에 대한 값을 전달할 수 없습니다.If your report contains a report parameter that has a default value and the value of the Prompt property is false (that is, the Prompt User property is not selected in Report Manager), then you cannot pass a value for that report parameter within a URL. 이러한 기능을 통해 관리자는 최종 사용자가 특정 보고서 매개 변수의 값을 추가하거나 수정하지 못하도록 설정할 수 있습니다.This provides administrators an option for preventing end users from adding or modifying the values of certain report parameters.

추가 예 Additional Examples

다음 URL 예제에는 공백 및 여러 매개 변수가 포함됩니다.The following URL example includes spaces and multiple parameters

  • “SQL Server 사용자 교육 팀” 폴더 이름에는 공백이 포함되므로 “+”가 공백을 각각 대체합니다.Folder name of “SQL Server User Education Team” includes spaces and therefore the “+” replaces each space.

  • “팀 프로젝트 보고서” 보고서 이름에는 공백이 포함되므로 “+”가 공백을 각각 대체합니다.Report name of “team project report” includes spaces and therefore the “+” replaces each space.

  • 두 개의 매개 변수 “teamgrouping2” 및 “teamgrouping1”에 값 “xgroup” 및 “ygroup”을 전달합니다.Passes two parameters of “teamgrouping2” with a value of “xgroup” and “teamgrouping1” with a value of “ygroup”.

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

다음 URL 예제에는 다중 값 매개 변수 ”OrderID”를 포함합니다.The following URL example includes a multi-value parameter ”OrderID. 다중 값 매개 변수의 형식은 각 값에 대해 매개 변수 이름을 반복합니다.The format for a Multi-Value parameter is to repeat the parameter name for each value.

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 의 단일 매개 변수를 전달합니다.The following URL example passes a single parameter of SellStartDate with a value of “7/1/2005”, for a native mode report server.

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

관련 항목:See Also

URL 액세스 ( Ssrs) URL Access (SSRS)
URL 액세스 매개 변수 참조URL Access Parameter Reference