매개 변수 컬렉션 참조(보고서 작성기 및 SSRS)
보고서 매개 변수는 식에서 참조할 수 있는 기본 제공 컬렉션 중 하나입니다. 식에 매개 변수를 포함하면 사용자의 선택에 따라 보고서 데이터와 모양을 사용자 지정할 수 있습니다. 식은 (Fx) 또는 <식> 옵션을 제공하는 모든 보고서 항목 속성 또는 입력란 속성에 사용할 수 있습니다. 식은 보고서의 내용과 모양을 다른 방법으로 제어하는 데도 사용됩니다. 자세한 내용은 식 예(보고서 작성기 및 SSRS)를 참조하십시오.
런타임에 매개 변수 값을 데이터 집합 필드 값과 비교할 때는 비교하는 두 항목의 데이터 형식이 같아야 합니다. 보고서 매개 변수는 다음 유형 중 하나일 수 있습니다. Boolean, DateTime, Integer, Float 또는 Text(기본 데이터 형식인 String을 나타냄). 필요한 경우에는 데이터 집합 값과 일치하도록 매개 변수 값의 데이터 형식을 변환해야 할 수 있습니다. 자세한 내용은 식의 데이터 형식(보고서 작성기 및 SSRS)을 참조하십시오.
식에 매개 변수 참조를 포함하려면 매개 변수가 단일 값인지 다중값 매개 변수인지에 따라 달라지는 매개 변수 참조의 올바른 구문을 지정하는 방법을 이해해야 합니다.
[!참고]
SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 보고서 작성기에서 보고서 디자인(SSRS)을 참조하십시오.
식에서 단일 값 매개 변수 사용
다음 표에서는 식에서 임의 데이터 형식의 단일 값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.
예 |
설명 |
|---|---|
=Parameters!<ParameterName>.IsMultiValue |
False를 반환합니다. 매개 변수가 다중값인지 확인합니다. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다. False일 경우 매개 변수는 단일 값이며 단일 개체입니다. |
=Parameters!<ParameterName>.Count |
정수 값 1을 반환합니다. 단일 값 매개 변수의 경우 개수는 항상 1입니다. |
=Parameters!<ParameterName>.Label |
사용 가능한 값의 드롭다운 목록에서 표시 이름으로 자주 사용되는 매개 변수 레이블을 반환합니다. |
=Parameters!<ParameterName>.Value |
매개 변수 값을 반환합니다. Label 속성이 설정되지 않은 경우 이 값은 사용 가능한 값 드롭다운 목록에 표시됩니다. |
=CStr(Parameters! <ParameterName>.Value) |
매개 변수 값을 문자열로 반환합니다. |
=Fields(Parameters!<ParameterName>.Value).Value |
매개 변수와 동일한 이름을 갖고 있는 필드에 대해 값을 반환합니다. |
필터에 매개 변수를 사용하는 방법은 데이터 집합 필터, 데이터 영역 필터 및 그룹 필터 추가(보고서 작성기 및 SSRS)을 참조하십시오.
식에서 다중값 매개 변수 사용
다음 표에서는 식에서 임의 데이터 형식의 다중값 매개 변수에 대한 참조를 포함할 때 사용할 구문의 예를 보여 줍니다.
예 |
설명 |
|---|---|
=Parameters!<MultivalueParameterName>.IsMultiValue |
True 또는 False를 반환합니다. 매개 변수가 다중값인지 확인합니다. True일 경우 매개 변수는 다중값이며 개체 컬렉션입니다. False일 경우 매개 변수는 단일 값이며 단일 개체입니다. |
=Parameters!<MultivalueParameterName>.Count |
정수 값을 반환합니다. 값 개수를 나타냅니다. 단일 값 매개 변수의 경우 개수는 항상 1입니다. 다중값 매개 변수의 경우 개수는 0개 이상입니다. |
=Parameters!<MultivalueParameterName>.Value(0) |
다중값 매개 변수의 첫 번째 값을 반환합니다. |
=Parameters!<MultivalueParameterName>.Value(Parameters!<MultivalueParameterName>.Count-1) |
다중값 매개 변수의 마지막 값을 반환합니다. |
=Split("Value1,Value2,Value3",",") |
값 배열을 반환합니다. 다중값 String 매개 변수에 대한 값 배열을 만듭니다. 분할할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다. 다중값 매개 변수에 대한 기본값을 설정하거나, 하위 보고서 또는 드릴스루 보고서에 전송할 다중값 매개 변수를 만드는 데 이 식을 사용할 수 있습니다. |
=Join(Parameters!<MultivalueParameterName>.Value,", ") |
다중값 매개 변수에서 쉼표로 구분된 선택한 값 목록으로 구성된 String을 반환합니다. 조인할 두 번째 매개 변수에서 임의의 구분 기호를 사용할 수 있습니다. |
=”Report for: “ & JOIN(Parameters!<MultivalueParameterName>.Value," & “ ) |
다중값 매개 변수에서 선택한 값 목록으로 구성된 String을 반환하며 값 목록을 표시하는 텍스트 문자열이 앞에 옵니다. |
필터에 매개 변수를 사용하는 방법은 보고서 매개 변수(보고서 작성기 및 SSRS)를 참조하십시오.
참고 항목
태스크
보고서 매개 변수 추가, 변경 또는 삭제(보고서 작성기 및 SSRS)