기본 제공 컬렉션-기본 제공 Globals 및 Users 참조 (보고서 작성기)Built-in Collections - Built-in Globals and Users References (Report Builder)

GlobalsUser 컬렉션을 모두 포함하는 기본 제공 필드 컬렉션은 보고서를 처리할 때 Reporting Services에서 제공하는 전역 값을 나타냅니다.The Built-in fields collection, which includes both the Globals and the User collections, represent global values provided by Reporting Services when a report is processed. Globals 컬렉션은 보고서의 이름, 보고서 처리가 시작된 시간, 보고서 머리글 또는 바닥글의 현재 페이지 번호와 같은 값을 제공합니다.The Globals collection provides values such as the name of the report, the time when report processing began, and current page numbers for the report header or footer. User 컬렉션은 사용자 식별자 및 언어 설정을 제공합니다.The User collection provides the user identifier and language settings. 이러한 값을 식에 사용하여 보고서의 결과를 필터링할 수 있습니다.These values can be used in expressions to filter results 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.

전역 컬렉션 사용Using the Globals Collection

Globals 컬렉션에는 보고서의 전역 변수가 포함됩니다.The Globals collection contains the global variables for the report. 디자인 화면에서 이러한 변수 접두사가 붙은 상태로 표시는 & (앰퍼샌드), 예를 들어 [&ReportName]합니다.On the design surface, these variables appear prefixed by an & (ampersand), for example, [&ReportName]. 다음 표에서는 Globals 컬렉션의 멤버를 설명합니다.The following table describes the members of the Globals collection.

멤버Member 형식Type DescriptionDescription
ExecutionTimeExecutionTime DateTimeDateTime 보고서가 실행되기 시작한 날짜와 시간입니다.The date and time that the report began to run.
PageNumberPageNumber 정수Integer 페이지 번호를 다시 설정하는 페이지 나누기를 기준으로 한 현재 페이지 번호입니다.The current page number relative to page breaks that reset the page number. 보고서 처리를 시작할 때 초기 값은 -1로 설정됩니다.At the beginning of report processing, the initial value is set to 1. 페이지 번호는 각 렌더링된 페이지에 대해 증가합니다.The page number increments for each rendered page.

사각형, 데이터 영역, 데이터 영역 그룹 또는 지도에 대해 페이지 나누기 내에서 페이지 번호를 매기려면 PageBreak 속성에 대해 ResetPageNumber 속성을 True로 설정합니다.To number pages within page breaks for a rectangle, a data region, a data region group, or a map, on the PageBreak property, set the ResetPageNumber property to True. 테이블릭스 열 계층 구조 그룹에는 지원되지 않습니다.Not supported on tablix column hierarchy groups.

PageNumber는 페이지 머리글 또는 페이지 바닥글의 식에만 사용할 수 있습니다.PageNumber can only be used in an expression in a page header or page footer.
ReportFolderReportFolder 문자열String 보고서를 포함하는 폴더의 전체 경로입니다.The full path to the folder containing the report. 여기에는 보고서 서버 URL이 포함되지 않습니다.This does not include the report server URL.
ReportNameReportName 문자열String 보고서 서버 데이터베이스에 저장되어 있는 보고서의 이름입니다.The name of the report as it is stored in the report server database.
ReportServerUrlReportServerUrl 문자열String 보고서가 실행 중인 보고서 서버의 URL입니다.The URL of the report server on which the report is being run.
TotalPagesTotalPages 정수Integer PageNumber를 다시 설정하는 페이지 나누기를 기준으로 한 총 페이지 수입니다.The total number of pages relative to page breaks that reset PageNumber. 페이지 나누기가 설정되어 있지 않으면 이 값은 OverallTotalPages와 같습니다.If no page breaks are set, this value is the same as OverallTotalPages.

TotalPages는 페이지 머리글 또는 페이지 바닥글의 식에만 사용할 수 있습니다.TotalPages can only be used in an expression in a page header or page footer.
PageNamePageName 문자열String 페이지의 이름입니다.The name of the page. 보고서 처리를 시작할 때 초기 값은 InitialPageName(보고서 속성)에서 설정됩니다.At the beginning of report processing, the initial value is set from InitialPageName, a report property. 각 보고서 항목을 처리하면 이 값은 사각형, 데이터 영역, 데이터 영역 그룹 또는 지도의 해당 PageName 값으로 바뀝니다.As each report item is processed, this value is replaced by the corresponding value of PageName from a rectangle, a data region, a data region group, or a map. 테이블릭스 열 계층 구조 그룹에는 지원되지 않습니다.Not supported on tablix column hierarchy groups.

PageName은 페이지 머리글 또는 페이지 바닥글의 식에만 사용할 수 있습니다.PageName can only be used in an expression in a page header or page footer.
OverallPageNumberOverallPageNumber 정수Integer 전체 보고서에서 현재 페이지의 페이지 번호입니다.The page number of the current page for the entire report. 이 값은 ResetPageNumber의 영향을 받지 않습니다.This value is not affected by ResetPageNumber.

OverallPageNumber는 페이지 머리글 또는 페이지 바닥글의 식에만 사용할 수 있습니다.OverallPageNumber can only be used in an expression in a page header or page footer.
OverallTotalPagesOverallTotalPages 정수Integer 전체 보고서의 총 페이지 수입니다.The total number pages for the entire report. 이 값은 ResetPageNumber의 영향을 받지 않습니다.This value is not affected by ResetPageNumber.

OverallTotalPages는 페이지 머리글 또는 페이지 바닥글의 식에만 사용할 수 있습니다.OverallTotalPages can only be used in an expression in a page header or page footer.
RenderFormatRenderFormat RenderFormatRenderFormat 현재 렌더링 요청에 대한 정보입니다.Information about the current rendering request.

자세한 내용은 다음 섹션의 "RenderFormat"을 참조하십시오.For more information, see "RenderFormat" in the next section.

Globals 컬렉션 멤버는 variant를 반환합니다.Members of the Globals collection return a variant. 특정 데이터 형식이 필요한 식에서 이 컬렉션의 멤버를 사용하려면 먼저 변수를 캐스팅해야 합니다.If you want to use a member of this collection in an expression that requires a specific data type, you must first cast the variable. 예를 들어 실행 시간 variant를 날짜 형식으로 변환하려면 =CDate(Globals!ExecutionTime)를 사용합니다.For example, to convert the execution time variant into a Date format, use =CDate(Globals!ExecutionTime). 자세한 내용은 식의 데이터 형식(보고서 작성기 및 SSRS)).For more information, see Data Types in Expressions (Report Builder and SSRS).

RenderFormatRenderFormat

다음 표에서는 RenderFormat의 멤버에 대해 설명합니다.The following table describes the members for RenderFormat.

멤버Member 형식Type DescriptionDescription
이름Name 문자열String RSReportServer 구성 파일에 등록된 렌더러 이름입니다.The name of the renderer as registered in the RSReportServer configuration file.

보고서 처리/렌더링 주기의 특정 부분에서 사용 가능합니다.Available during specific parts of the report processing/rendering cycle.
IsInteractiveIsInteractive BooleanBoolean 현재 렌더링 요청이 대화형 렌더링 형식을 사용하는지 여부입니다.Whether the current rendering request uses an interactive rendering format.
DeviceInfoDeviceInfo 읽기 전용 이름/값 컬렉션Read-only name/value collection 현재 렌더링 요청에 대한 deviceinfo 매개 변수의 키/값 쌍입니다.Key/value pairs for deviceinfo parameters for the current rendering request.

컬렉션에 키나 인덱스를 사용해 문자열 값을 지정할 수 있습니다.String values can be specified by using either the key or an index into the collection.

Examples

다음 예에서는 식에서 Globals 컬렉션에 대한 참조를 사용하는 방법을 보여 줍니다.The following examples show how to use a reference to the Globals collection in an expression:

  • 이 식을 보고서 바닥글의 입력란에 배치하면 보고서의 페이지 번호와 총 페이지 수가 제공됩니다.This expression, placed in a text box in the footer of a report, provides the page number and total pages in the report:

    =Globals.PageNumber & " of " & Globals.TotalPages

  • 이 식은 보고서 이름과 보고서가 실행된 시간을 제공합니다.This expression provides the name of the report and the time it was run. 시간 형식은 MicrosoftMicrosoft .NET Framework.NET Framework 형식 문자열(간단한 날짜)로 지정됩니다.The time is formatted with the MicrosoftMicrosoft .NET Framework.NET Framework formatting string for short date:

    =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")

  • 보고서를 Excel로 내보낼 때 선택한 열에 대해 열 표시 유형 대화 상자에 배치된 식은 열을 표시합니다.This expression, placed in the Column Visibility dialog box for a selected column, displays the column only when the report is exported to Excel. 그렇지 않은 경우 이 열은 숨겨집니다.Otherwise, the column is hidden.

    EXCELOPENXML 은 Office 2007에 포함된 Excel 형식을 나타냅니다.EXCELOPENXML refers to the format of Excel that is included in Office 2007. EXCEL 은 Office 2003에 포함된 Excel 형식을 나타냅니다.EXCEL refers to the format of Excel that is included in Office 2003.

    =IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)

User 컬렉션 사용Using the User Collection

User 컬렉션에는 보고서를 실행하는 사용자에 대한 데이터가 포함됩니다.The User collection contains data about the user who is running the report. 예를 들어 이 컬렉션을 사용하여 보고서에 나타나는 데이터를 필터링함으로써 현재 사용자의 데이터만 표시하거나 보고서 제목 등에 UserID를 표시할 수 있습니다.You can use this collection to filter the data that appears in a report, for example, showing only the data of the current user, or to display the UserID, for example, in a report title. 디자인 화면에서 이러한 변수 접두사가 붙은 상태로 표시는 & (앰퍼샌드), 예를 들어 [&UserID]합니다.On the design surface, these variables appear prefixed by an & (ampersand), for example, [&UserID].

다음 표에서는 User 컬렉션의 멤버를 설명합니다.The following table describes the members of the User collection.

멤버Member 형식Type DescriptionDescription
언어Language 문자열String 보고서를 실행하는 사용자의The language of the user running the report. en-US)을 입력합니다.For example, en-US.
UserIDUserID 문자열String 보고서를 실행하는 사용자의 ID입니다.The ID of the user running the report. Windows 인증을 사용하는 경우 이 값은 현재 사용자의 도메인 계정입니다.If you are using Windows Authentication, this value is the domain account of the current user. 값은 Reporting ServicesReporting Services 보안 확장 프로그램에 의해 결정되며 이 프로그램은 Windows 인증 또는 사용자 지정 인증을 사용할 수 있습니다.The value is determined by the Reporting ServicesReporting Services security extension, which can use Windows Authentication or custom authentication.

보고서에서 여러 언어를 지원하는 방법에 대한 자세한 내용은 Reporting ServicesReporting Services SQL Server 온라인 설명서 설명서에서 "다국어 배포 또는 글로벌 배포를 위한 솔루션 디자인 고려 사항"을 참조하세요.For more information about supporting multiple languages in a report, see "Solution Design Considerations for Multi-Lingual or Global Deployments" in the Reporting ServicesReporting Services documentation in SQL Server Books Online.

로캘 설정 사용Using Locale Settings

식을 사용하여 User.Language 값을 통해 클라이언트 컴퓨터의 로캘 설정을 참조하여 보고서가 사용자에게 표시되는 방식을 결정할 수 있습니다.You can use expressions to refer to the locale settings on a client computer through the User.Language value to determine how a report appears to the user. 예를 들어 로캘 값에 따라 다른 쿼리 식을 사용하는 보고서를 만들 수 있습니다.For example, you can create a report that uses a different query expression based on the locale value. 반환되는 언어에 따라 다양한 열에서 지역화된 정보를 검색하기 위해 쿼리가 변경될 수 있습니다.The query may change to retrieve localized information from a different column depending on the language returned. 또한 이 변수를 기반으로 하는 보고서나 보고서 항목의 언어 설정에 식을 사용할 수 있습니다.You can also use an expression in the language settings of the report or report items based on this variable.

참고

보고서의 언어 설정을 변경할 수 있지만 이로 인한 표시 문제에 유의해야 합니다.While you can change the language settings of a report, you must be careful about any display issues this may cause. 예를 들어 보고서의 로캘 설정을 변경하면 보고서의 날짜 형식을 변경할 수 있지만 통화 형식도 변경될 수 있습니다.For example, changing the locale setting of the report can change the date format in the report, but it can also change the currency format. 통화가 적절하게 변환되지 않으면 잘못된 통화 기호가 보고서에 표시될 수 있습니다.Unless there is a conversion process for the currency, this may cause the incorrect currency symbol to be displayed in the report. 이를 방지하려면 변경할 개별 항목에 대한 언어 정보를 설정하거나 통화 데이터가 있는 항목을 특정 언어로 설정합니다.To avoid this, set the language information about the individual items that you want to change, or set the item with the currency data to a specific language.

스냅숏 또는 기록 보고서에 대한 UserID 식별Identifying UserID for Snapshot or History Reports

User!UserID 변수를 포함하는 보고서에서는 보고서를 보고 있는 현재 사용자와 관련된 보고서 데이터가 표시되지 않는 경우도 있습니다.In some cases, reports that include the User!UserID variable will fail to show report data that is specific to the current user who is viewing the report.

관련 항목:See Also

식(보고서 작성기 및 SSRS) Expressions (Report Builder and SSRS)
식 대화 상자 ( 보고서 작성기 ) Expression Dialog Box (Report Builder)
식 (의 데이터 형식 보고서 작성기 및 SSRS ) Data Types in Expressions (Report Builder and SSRS)
숫자 및 날짜 서식 지정(보고서 작성기 및 SSRS) Formatting Numbers and Dates (Report Builder and SSRS)
식 예 ( 보고서 작성기 및 SSRS )Expression Examples (Report Builder and SSRS)