식의 기본 제공 컬렉션(보고서 작성기 및 SSRS)
보고서의 식에는 ReportItems, 매개 변수, 필드, 데이터 세트, 데이터 원본, 변수 및 보고서 이름과 같은 글로벌 정보에 대한 기본 제공 필드 등 기본 제공 컬렉션에 대한 참조가 포함될 수 있습니다. 식 대화 상자에 표시되지 않는 컬렉션도 있습니다. DataSets 및 DataSources 컬렉션은 보고서 서버의 게시된 보고서에 대해 런타임에만 사용할 수 있습니다. ReportItems 컬렉션은 페이지 또는 페이지 머리글의 입력란과 같이 보고서 영역에 있는 입력란의 컬렉션입니다.
자세한 내용은 식(보고서 작성기 및 SSRS)을 참조하세요.
참고
SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 보고서 정의(.rdl)를 만들고 수정할 수 있습니다. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다. 자세한 내용은 microsoft.com 웹에서 보고서 디자이너 및 Report Builder(SSRS)에서 보고서 디자인을 참조하세요.
기본 제공 컬렉션 이해
다음 표에서는 식을 작성할 때 사용할 수 있는 기본 제공 컬렉션을 보여 줍니다. 각 행에는 컬렉션에 대한 대/소문자 구분 프로그래밍 이름, 식 대화 상자를 사용하여 컬렉션에 대한 참조를 대화형으로 추가할 수 있는지 여부, 예, 그리고 컬렉션 값이 초기화되어 사용 가능해지는 시점을 포함한 설명이 포함됩니다.
| 기본 제공 컬렉션 | 식 대화 상자의 범주 | 예제 | Description |
|---|---|---|---|
Globals |
기본 제공 필드 | =Globals.ReportName- or -=Globals.PageNumber |
보고서 이름이나 페이지 번호를 비롯하여 보고서에 유용한 전역 변수를 나타냅니다. 항상 사용할 수 있습니다. 자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)를 참조하세요. |
User |
기본 제공 필드 | =User.UserID-또는- =User.Language |
언어 설정 또는 사용자 ID를 비롯하여 보고서를 실행하는 사용자에 대한 데이터 컬렉션을 나타냅니다. 항상 사용할 수 있습니다. 자세한 내용은 기본 제공 Globals 및 Users 참조(보고서 작성기 및 SSRS)를 참조하세요. |
Parameters |
매개 변수 | =Parameters("ReportMonth").Value-또는- =Parameters!ReportYear.Value |
각각 단일 값 또는 다중값일 수 있는 보고서 매개 변수 컬렉션을 나타냅니다. 초기화 처리가 완료된 다음에만 사용할 수 있습니다. 자세한 내용은 매개 변수 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요. |
Fields(<Dataset>) |
필드 | =Fields!Sales.Value |
보고서에 사용할 수 있는 데이터 세트의 필드 컬렉션을 나타냅니다. 데이터 원본에 있는 데이터를 검색하여 데이터 세트로 가져온 후에 사용할 수 있습니다. 자세한 내용은 데이터 세트 필드 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요. |
DataSets |
표시되지 않음 | =DataSets("TopEmployees").CommandText |
보고서 정의 본문에서 참조하는 데이터 세트 컬렉션을 나타냅니다. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다. 로컬 미리 보기에서는 사용할 수 없습니다. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요. |
DataSources |
표시되지 않음 | =DataSources("AdventureWorks2012").Type |
보고서 본문에서 참조하는 데이터 원본 컬렉션을 나타냅니다. 페이지 머리글이나 페이지 바닥글에만 사용되는 데이터 원본은 포함되지 않습니다. 로컬 미리 보기에서는 사용할 수 없습니다. 자세한 내용은 DataSources 및 DataSets 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요. |
Variables |
Variables |
=Variables!CustomTimeStamp.Value |
보고서 변수 및 그룹 변수의 컬렉션을 나타냅니다. 자세한 내용은 보고서 및 그룹 변수 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요. |
ReportItems |
표시되지 않음 | =ReportItems("Textbox1").Value |
보고서 항목에 대한 입력란의 컬렉션을 나타냅니다. 이 컬렉션은 페이지 머리글 또는 페이지 바닥글에 포함할 페이지 항목을 요약하는 데 사용할 수 있습니다. 자세한 내용은 ReportItems 컬렉션 참조(보고서 작성기 및 SSRS)를 참조하세요. |
식에서 컬렉션 구문 사용
식에서 컬렉션을 참조하려면 컬렉션의 항목에 대한 표준 Microsoft Visual Basic 구문을 사용합니다. 다음 표에서는 컬렉션 구문의 예를 보여 줍니다.
| 구문 | 예제 |
|---|---|
| Collection!ObjectName.Property | =Fields!Sales.Value |
| Collection!ObjectName("Property") | =Fields!Sales("Value") |
| Collection("ObjectName").Property | =Fields("Sales").Value |
| Collection("Member") | =User("Language") |
| Collection.Member | =User.Language |