기본 제공 컬렉션-보고서 및 그룹 변수 참조 (보고서 작성기)Built-in Collections - Report and Group Variables References (Report Builder)

보고서의 식에서 두 번 이상 사용되는 복잡한 계산이 있는 경우 변수를 만들어 사용할 수 있습니다.When you have a complex calculation that is used more than once in expressions in a report, you might want to create a variable. 보고서 변수 또는 그룹 변수를 만들 수 있습니다.You can create a report variable or a group variable. 변수 이름은 보고서에서 고유해야 합니다.Variable names must be unique in a report.

참고

SQL Server Data Tools의 보고서 작성기 및 보고서 디자이너에서 페이지를 매긴 보고서 정의(.rdl) 파일을 만들고 수정할 수 있습니다.You can create and modify paginated report definition (.rdl) files in Report Builder and in Report Designer in SQL Server Data Tools. 각 제작 환경에서는 보고서 및 관련 항목을 만들고, 열고, 저장할 수 있는 여러 방법을 제공합니다.Each authoring environment provides different ways to create, open, and save reports and related items.

보고서 변수Report Variables

보고서 변수를 사용하여 환율이나 타임스탬프와 같이 시간에 종속되는 계산 또는 여러 번 참조되는 복잡한 계산에 대한 값을 저장할 수 있습니다.Use a report variable to hold a value for time-dependent calculations, such as currency rates or time stamps, or for a complex calculation that is referenced multiple times. 기본적으로 보고서 변수는 한 번 계산한 후 보고서 전체의 식에 사용할 수 있습니다.By default, a report variable is calculated once and can be used in expressions throughout a report. 보고서 변수는 기본적으로 읽기 전용입니다.Report variables are read-only by default. 기본값을 변경하여 보고서 변수를 읽기/쓰기 가능하도록 설정할 수 있습니다.You can change the default to enable a report variable as read-write. 보고서 변수의 값은 보고서를 다시 처리할 때까지 세션 전체에서 보존됩니다.The value in a report variable is preserved throughout a session, until the report is processed again.

보고서 변수를 추가하려면 보고서 속성 대화 상자를 열고 변수를 클릭한 후 이름과 값을 입력합니다.To add a report variable, open the ReportProperties dialog box, click Variables, and provide a name and a value. 이름은 문자로 시작하고 공백을 포함하지 않는 대/소문자를 구분하는 문자열입니다.Names are case-sensitive strings that begin with a letter and have no spaces. 이름에는 문자, 숫자 또는 밑줄()을 포함할 수 있습니다.A name can include letters, numbers, or underscores ().

식에서 변수를 참조하려면 전역 컬렉션 구문을 사용합니다(예: =Variables!CustomTimeStamp.Value).To refer to the variable in an expression, use the global collection syntax, for example, =Variables!CustomTimeStamp.Value. 디자인 화면에서 값은 입력란에 <<Expr>>로 표시됩니다.On the design surface, the value appears in a text box as <<Expr>>.

다음 방법으로 보고서 변수를 사용할 수 있습니다.You can use report variables in the following ways:

  • 읽기 전용으로 사용 값을 한 번 설정하여 보고서 세션에 대해 상수를 만듭니다(예: 타임스탬프 만들기).Read-only use Set a value once to create a constant for the report session, for example, to create a time stamp.

    입력란의 식은 보고서를 읽는 사용자의 요청에 따라 계산되므로 동적 값(예: 현재 시간을 반환하는 함수인 Now() 를 포함하는 식)은 사용자가 뒤로 단추를 사용하여 앞뒤 페이지로 이동하는 경우 다른 값을 반환할 수 있습니다.Because expressions in text boxes are evaluated on-demand as a user pages through a report, dynamic values (for example, an expression that includes the Now() function, which returns the time of day) can return different values if you page forward and backward by using the Back button. 보고서 변수의 값을 =Now()식으로 설정하고 변수를 식에 추가하면 보고서를 처리하는 동안 내내 동일한 값이 사용되도록 할 수 있습니다.By setting a the value of a report variable to the expression =Now(), and then adding the variable to your expression, you ensure the same value is used throughout report processing.

  • 읽기/쓰기로 사용 값을 한 번 설정하고 보고서 세션 내에서 값을 직렬화합니다.Read-write use Set a value once and serialize the value within a report session. 변수에 대해 읽기/쓰기 옵션을 사용하는 것이 보고서 정의의 코드 블록에서 정적 변수를 사용하는 것보다 효율적입니다.The read-write option for variables provides a better alternative than using a static variable in the Code block in the report definition.

    변수의 읽기 전용 옵션 선택을 취소하면 변수의 Writable 속성이 true로 설정됩니다.When you clear the Read-Only option for a variable, the Writable property for the variable is set to true. 식에서 값을 업데이트하려면 SetValue 메서드(예: =Variables!MyVariable.SetValue("123"))를 사용합니다.To update the value from an expression, use the SetValue method, for example, =Variables!MyVariable.SetValue("123").

    참고

    보고서 프로세서가 변수를 초기화하는 시기 또는 변수를 업데이트하는 식을 계산하는 시기는 제어할 수 없습니다.You cannot control when the report processor initializes a variable or evaluates an expression that updates a variable. 변수 초기화 실행 순서는 정의되어 있지 않습니다.The order of execution for variable initialization is undefined.

    세션에 대한 자세한 내용은 Previewing Reports in Report Builder를 참조하십시오.For more information about sessions, see Previewing Reports in Report Builder.

그룹 변수Group Variables

그룹 변수를 사용하여 복잡한 식을 그룹 범위에서 한 번에 계산할 수 있습니다.Use a group variable to calculate a complex expression once in the scope of a group. 그룹 변수는 그룹 및 해당 자식 그룹의 범위 내에서만 유효합니다.A group variable is valid only in the scope of the group and its child groups.

예를 들어 서로 다른 세금 범주에 속한 항목에 대한 재고 데이터를 표시하는 데이터 영역이 있고 각 범주에 대해 서로 다른 세율을 적용하려는 경우를 가정해 보겠습니다.For example, suppose a data region displays inventory data for items that are in different tax categories and you want to apply different tax rates for each category. Category에서 데이터를 그룹화하고 부모 그룹에서 Tax 변수를 정의합니다.You would group the data on Category and define a Tax variable on the parent group. 그런 다음 ItemTax 에 대한 그룹 변수를 각 세금 범주에 정의하고 서로 다른 각 Category 하위 그룹을 적절한 그룹 변수에 할당합니다.Then you would define a group variable for ItemTax for each tax category and assign each of the different Category subgroups to the correct group variable. 예를 들어For example:

  • [Category]기반의 부모 그룹에 대해 Tax 변수를 [Tax]값으로 정의합니다.For the parent group based on [Category], define the variable Tax with a value [Tax]. 범주 값은 Food와 Clothing이라고 가정하겠습니다.Assume the category values are Food and Clothing.

  • [Subcategory]기반의 자식 그룹에 대해 ItemsTax 변수를 =Variables!Tax.Value * Sum(Fields!Price.Value)으로 정의합니다.For the child group based on [Subcategory], define the variable ItemsTax as =Variables!Tax.Value * Sum(Fields!Price.Value). Food 범주의 하위 범주 값은 Beverages 및 Bread라고 가정하겠습니다.Assume the subcategory values for the category Food are Beverages and Bread. Clothing의 하위 범주 값은 Shirts 및 Hats라고 가정하겠습니다.Assume the subcategory values for Clothing are Shirts and Hats.

  • 자식 그룹의 행에 있는 입력란에 대해 =Variables!ItemsTax.Value식을 추가합니다.For a text box in a row in the child group, add the expression =Variables!ItemsTax.Value.

    입력란에는 Beverages 및 Bread에 대해 Food 세금을 사용하고 Shirts 및 Hats에 대해 Clothing 세금을 사용한 총 세금이 표시됩니다.The text box displays the total tax for Beverages and Bread using the Food tax and for Shirts and Hats using the Clothing tax.

    그룹 변수를 추가하려면 테이블릭스 그룹 속성 대화 상자를 열고 변수를 클릭하고 이름과 값을 입력합니다.To add a group variable, open the Tablix Group Properties dialog box, click Variables, and provide a name and a value. 그룹 변수는 고유 그룹 값별로 한 번 계산됩니다.The group variable is calculated once per unique group value.

    식에서 변수를 참조하려면 전역 컬렉션 구문을 사용합니다(예: =Variables!GroupDescription.Value).To refer to the variable in an expression, use the global collection syntax, for example, =Variables!GroupDescription.Value. 디자인 화면에서 값은 입력란에 <<Expr>>로 표시됩니다.On the design surface, the value appears in a text box as <<Expr>>.

관련 항목:See Also

필터, 그룹 및 데이터 정렬 ( 보고서 작성기 및 SSRS ) Filter, Group, and Sort Data (Report Builder and SSRS)
식 (의 기본 제공 컬렉션 보고서 작성기 및 SSRS ) Built-in Collections in Expressions (Report Builder and SSRS)
식 예 ( 보고서 작성기 및 SSRS )Expression Examples (Report Builder and SSRS)