자습서: 보고서에 매개 변수 추가(보고서 작성기)Tutorial: Add a Parameter to Your Report (Report Builder)

이 자습서에서는 보고서를 읽는 사람이 하나 이상의 값에 대해 보고서 데이터를 필터링할 수 있도록 페이지가 매겨진 Reporting ServicesReporting Services 보고서에 매개 변수를 추가합니다.In this tutorial, you add a parameter to a Reporting ServicesReporting Services paginated report so report readers can filter report data for one or more values.

report-builder-parameter-tutorial

보고서 매개 변수는 데이터 집합 쿼리에 포함하는 각 쿼리 매개 변수에 대해 자동으로 만들어집니다.Report parameters are created automatically for each query parameter that you include in a dataset query. 매개 변수 데이터 형식에 따라 보고서 뷰 도구 모음에 매개 변수가 표시되는 방식이 결정됩니다.The parameter data type determines how it appears on the report view toolbar.

참고

이 자습서에서 마법사의 단계는 하나의 절차로 통합됩니다.In this tutorial, the steps for the wizard are consolidated into one procedure. 보고서 서버를 찾고 데이터 원본을 선택하고 데이터 집합을 만드는 방법에 대한 단계별 지침은 이 시리즈의 첫 번째 자습서인 자습서: 기본 테이블 보고서 만들기(보고서 작성기)를 참조하세요.For step-by-step instructions about how to browse to a report server, choose a data source, and create a dataset, see the first tutorial in this series: Tutorial: Creating a Basic Table Report (Report Builder).

이 자습서에 소요되는 예상 시간: 25분Estimated time to complete this tutorial: 25 minutes.

요구 사항Requirements

요구 사항에 대한 자세한 내용은 자습서의 필수 조건(보고서 작성기)을 참조하세요.For information about requirements, see Prerequisites for Tutorials (Report Builder).

1. 테이블 또는 행렬 마법사에서 행렬 보고서 및 데이터 집합 만들기1. Create a Matrix Report and Dataset in the Table or Matrix Wizard

행렬 보고서, 데이터 원본 및 데이터 집합을 만듭니다.Create a matrix report, a data source, and a dataset.

참고

이 자습서의 쿼리에는 데이터 값이 포함되어 있으므로 외부 데이터 원본이 필요하지 않습니다.In this tutorial, the query contains the data values, so that it does not need an external data source. 따라서 쿼리가 상당히 길어집니다.This makes the query quite long. 비즈니스 환경에서는 쿼리에 데이터가 포함되지 않을 것입니다.In a business environment, a query would not contain the data. 이 자습서의 쿼리는 학습용으로만 제공됩니다.This is for learning purposes only.

새 행렬 보고서를 만들려면To create a new matrix report

  1. 컴퓨터,웹 포털 또는 SharePoint 통합 모드에서 보고서 작성기를 시작 Reporting ServicesReporting Services 합니다.Start Report Builder either from your computer, the Reporting ServicesReporting Services web portal, or SharePoint integrated mode.

    새 보고서 또는 데이터 집합 대화 상자가 열립니다.The New Report or Dataset dialog box opens.

    새 보고서 또는 데이터 집합 대화 상자가 표시되지 않는 경우 파일 메뉴 > 새로 만들기를 클릭합니다.If you don't see the New Report or Dataset dialog box, on the File menu > New.

  2. 왼쪽 창에서 새 보고서가 선택되어 있는지 확인합니다.In the left pane, make sure New Report is selected.

  3. 오른쪽 창에서 테이블 또는 행렬 마법사를 클릭합니다.In the right pane, click Table or Matrix Wizard.

  4. 데이터 집합 선택 페이지에서 데이터 집합 만들기 > 다음을 클릭합니다.On the Choose a dataset page, click Create a dataset > Next.

  5. 데이터 원본에 대한 연결 선택 페이지의 목록에서 데이터 원본을 선택하거나 보고서 서버로 이동하여 데이터 원본을 선택합니다.On the Choose a connection to a data source page, select a data source from the list or browse to the report server to select one. SQL Server형식인 데이터 원본을 선택합니다.Select any data source that is type SQL Server.

  6. 다음을 클릭합니다.Click Next.

    자격 증명을 입력해야 할 수도 있습니다.You may need to enter your credentials.

  7. 쿼리 디자인 페이지에서 텍스트로 편집을 클릭합니다.On the Design a query page, click Edit as Text.

  8. 맨 위에 있는 빈 창에 다음 쿼리를 붙여넣습니다.Paste the following query into the empty pane at the top:

    ;WITH CTE (StoreID, Subcategory, Quantity)   
    AS (  
    SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity  
    UNION SELECT  200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity  
    UNION SELECT  200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity  
    UNION SELECT  199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity  
    UNION SELECT  306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity  
    UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity)  
    SELECT StoreID, Subcategory, Quantity  
    FROM CTE  
    

    이 쿼리는 공용 테이블 식에 있는 몇 가지 Transact-SQLTransact-SQL SELECT 문의 결과를 결합하여 Contoso 샘플 데이터베이스의 단순화된 카메라 매출 데이터를 기반으로 하는 값을 지정합니다.This query combines the results of several Transact-SQLTransact-SQL SELECT statements inside a common table expression to specify values that are based on simplified sales data for cameras from the Contoso sample database. 하위 범주는 디지털 카메라, 디지털 SLR(Single Lens Reflex) 카메라, 캠코더 및 액세서리입니다.The subcategories are digital cameras, digital single lens reflex (SLR) cameras, camcorders, and accessories.

  9. 쿼리 디자이너 도구 모음에서 실행 (!)을 클릭하여 데이터를 확인합니다.On the query designer toolbar, click Run (!) to see the data.

    결과 집합은 네 상점의 각 하위 범주에 대한 판매 항목의 수량을 StoreID, Subcategory, Quantity 열에 표시하는 11개 데이터 행으로 구성되어 있습니다. 상점 이름은 결과 집합에 포함되는 데이터가 아닙니다.The result set consists of 11 rows of data that show the quantity of items sold for each subcategory for four stores, in the following columns: StoreID, Subcategory, Quantity.The store name is not part of the result set. 이 자습서의 뒷부분에 나오는 별도의 데이터 집합에서 상점 식별자에 해당하는 상점 이름을 조회할 수 있습니다.Later in this tutorial, you will look up the name of the store that corresponds to the store identifier from a separate dataset.

    이 쿼리에는 쿼리 매개 변수가 포함되어 있지 않습니다.This query does not contain query parameters. 이 자습서의 뒷부분에서 쿼리 매개 변수를 추가합니다.You will add query parameters later in this tutorial.

  10. 다음을 클릭합니다.Click Next.

2. 마법사에서 데이터 구성 및 레이아웃 선택2. Organize Data and Choose Layout in the Wizard

마법사는 데이터를 표시하기 위한 시작 디자인을 제공합니다.The wizard provides a starting design for displaying data. 이 마법사의 미리 보기 창에서는 테이블 또는 행렬 디자인을 완료하기 전에 데이터 그룹화의 결과를 시각화할 수 있습니다.The preview pane in the wizard helps you to visualize the result of grouping data before you complete the table or matrix design.

데이터를 그룹으로 구성하려면To organize data into groups

  1. 필드 정렬 페이지에서 Subcategory를 행 그룹으로 끌어옵니다.On the Arrange fields page, drag Subcategory to Row groups.

  2. StoreID를 열 그룹으로 끌어옵니다.Drag StoreID to Column groups.

  3. Quantity를 으로 끌어옵니다.Drag Quantity to Values.

    각 상점에 하나의 열을 사용하여 하위 범주로 그룹화된 행에 판매 수량 값을 구성했습니다.You have organized the quantity sold values in rows grouped by subcategory, with one column for each store.

  4. 다음을 클릭합니다.Click Next.

  5. 레이아웃 선택 페이지의 옵션에서 부분합 및 총합계 표시 가 선택되어 있는지 확인합니다.On the Choose the Layout page, under Options, make sure Show subtotals and grand totals is selected.

    보고서를 실행하면 마지막 열에 모든 상점에 대한 각 하위 범주의 총 수량이 표시되고 마지막 행에 각 상점에 대한 모든 하위 범주의 총 수량이 표시됩니다.When you run the report, the last column will show the total quantity of each subcategory for all stores, and the last row will show the total quantity for all subcategories for each store.

  6. 다음을 클릭합니다.Click Next.

  7. 마침을 클릭합니다.Click Finish.

    디자인 화면에 행렬이 추가됩니다.The matrix is added to the design surface. 행렬에는 열 3개와 행 3개가 표시됩니다.The matrix displays three columns and three rows. 첫 번째 행의 셀 내용은 Subcategory, [StoreID] 및 Total입니다.The contents of the cells in the first row are Subcategory, [StoreID], and Total. 두 번째 행의 셀 내용에는 하위 범주, 각 상점의 판매 항목 수량 및 모든 상점에 대한 각 하위 범주의 총 수량을 나타내는 식이 포함됩니다.The contents of the cells in the second row contain expressions that represent the subcategory, the quantity of items sold for each store, and the total quantity for each subcategory for all stores. 마지막 행의 셀에는 각 상점의 총합계가 표시됩니다.The cells in the final row display the grand total for each store.

    ssRB_ParamTut_Design

  8. 행렬을 클릭하고 첫 번째 열의 가장자리로 마우스를 이동한 후 핸들을 잡고 열 너비를 확장합니다.Click in the matrix, hover over the edge of the first column, grab the handle, and expand the column width.

    ssRB_ParamTut_Drag

  9. 실행 을 클릭하여 보고서를 미리 봅니다.Click Run to preview the report.

보고서가 보고서 서버에서 실행되고 보고서 처리가 수행된 시간과 제목이 표시됩니다.The report runs on the report server and displays the title and the time the report processing occurred.

ssRB_ParamTut__Preview1

지금은 열 제목에 상점 이름이 아닌 상점 식별자가 표시됩니다.So far the column headings display the store identifier but not the store name. 나중에 상점 식별자/상점 이름 쌍이 포함된 데이터 집합에서 상점 이름을 조회하는 식을 추가합니다.Later, you will add an expression to look up the store name in a dataset that contains store identifier/store name pairs.

3. 쿼리 매개 변수를 추가하여 보고서 매개 변수 만들기3. Add a Query Parameter to Create a Report Parameter

쿼리 매개 변수를 쿼리에 추가하면 보고서 작성기가 이름, 프롬프트 및 데이터 형식에 대한 기본 속성을 사용하여 단일 값 보고서 매개 변수를 자동으로 만듭니다.When you add a query parameter to a query, Report Builder automatically creates a single-valued report parameter with default properties for name, prompt, and data type.

쿼리 매개 변수를 추가하려면To add a query parameter

  1. 디자인 을 클릭하여 디자인 뷰로 다시 전환합니다.Click Design to switch back to Design view.

  2. 보고서 데이터 창에서 데이터 집합 폴더를 확장하고 DataSet1을 마우스 오른쪽 단추로 클릭한 다음 쿼리를 클릭합니다.In the Report Data pane, expand the Datasets folder, right-click DataSet1, and then click Query.

  3. 다음 Transact-SQLTransact-SQL WHERE 절을 쿼리의 마지막 줄로 추가합니다.Add the following Transact-SQLTransact-SQL WHERE clause as the last line in the query:

    WHERE StoreID = (@StoreID)  
    

    여기서 쿼리 매개 변수로 지정 된 상점 식별자에 검색된 데이터를 제한 하는 절 @StoreID 합니다.The WHERE clause limits the retrieved data to the store identifier that is specified by the query parameter @StoreID.

  4. 쿼리 디자이너 도구 모음에서 실행 (!)을 클릭합니다.On the query designer toolbar, click Run (!). 쿼리 매개 변수 정의 대화 상자가 열리고 쿼리 매개 변수에 대해 값을 묻는 @StoreID 합니다.The Define Query Parameters dialog box opens and prompts for a value for the query parameter @StoreID.

  5. 매개 변수 값200을 입력합니다.In Parameter Value, type 200.

  6. 확인을 클릭합니다.Click OK.

    결과 집합에는 상점 식별자 200에 대한 Accessories, Camcorders 및 Digital SLR Cameras의 판매 수량이 표시됩니다.The result set displays the quantities sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

  7. 확인을 클릭합니다.Click OK.

  8. 보고서 데이터 창에서 매개 변수 폴더를 확장합니다.In the Report Data pane, expand the Parameters folder.

이제 @StoreID라는 보고서 매개 변수와 보고서 매개 변수를 레이아웃할 수 있는 매개 변수 창이 있습니다.Note there is now a report parameter named @StoreID, and a Parameters pane where you can lay out the report parameters.

ssRB_ParamPane

매개 변수 창이 표시되지 않는 경우Don't see a Parameters pane? 보기 메뉴에서 매개 변수를 선택합니다.On the View menu, select Parameters.

4. 보고서 매개 변수의 기본 데이터 형식 및 기타 속성 변경4. Change Default Data Type and Other Properties for a Report Parameter

보고서 매개 변수를 만든 후 속성의 기본값을 조정할 수 있습니다.After you create a report parameter, you can adjust the default values for properties.

보고서 매개 변수의 기본 데이터 형식을 변경하려면To change the default data type for a report parameter

기본적으로 만든 매개 변수의 데이터 형식은 Text입니다.By default, the parameter you created has the data type Text. 상점 식별자가 정수이므로 데이터 형식을 Integer로 변경할 수 있습니다.Because the store identifier is an integer, you can change the data type to Integer.

  1. 보고서 데이터 창의 매개 변수 노드에서 @StoreID를 마우스 오른쪽 단추로 클릭한 다음 매개 변수 속성를 참조하세요.In the Report Data pane under the Parameters node, right-click @StoreID, then click Parameter Properties.

  2. 프롬프트Store identifier?를 입력합니다.In Prompt, type Store identifier? 보고서를 실행할 때 이 텍스트가 보고서 뷰어 도구 모음에 표시됩니다.This text appears on the report viewer toolbar when you run the report.

  3. 데이터 형식의 드롭다운 목록에서 정수를 선택합니다.In Data type, from the drop-down list, select Integer.

  4. 대화 상자의 나머지 기본값을 적용합니다.Accept the remaining default values in the dialog box.

  5. 확인을 클릭합니다.Click OK.

  6. 실행 을 클릭하여 보고서를 미리 봅니다.Click Run to preview the report. 보고서 뷰어에 Store Identifier? 에 대한 @StoreID를 참조하세요.The report viewer displays the prompt Store Identifier? for @StoreID.

  7. 보고서 뷰어 도구 모음에서 Store ID 옆에 200을 입력한 다음 보고서 보기를 클릭합니다.On the report viewer toolbar, next to Store ID, type 200, and then click View Report.

SSRB_ParamTutStoreID

4a.4a. 사용 가능한 값과 표시 이름을 제공하는 데이터 집합 추가Add a Dataset to Provide Available Values and Display Names

보고서를 읽는 사람이 매개 변수에 대해 유효한 값만 입력하도록 선택할 값의 드롭다운 목록을 만들 수 있습니다.To make sure your report readers type only valid values for a parameter, you can create a drop-down list of values to choose from. 지정한 목록이나 데이터 집합의 값을 사용할 수 있습니다.The values can come from a dataset or from a list that you specify. 매개 변수에 대한 참조가 포함되지 않은 쿼리를 사용하여 데이터 집합에서 사용 가능한 값을 제공해야 합니다.Available values must be supplied from a dataset with a query that does not contain a reference to the parameter.

매개 변수에 대한 유효한 값의 데이터 집합을 만들려면To create a dataset for valid values for a parameter

  1. 디자인 을 클릭하여 디자인 뷰로 전환합니다.Click Design to switch to Design view.

  2. 보고서 데이터 창에서 데이터 집합 폴더를 마우스 오른쪽 단추로 클릭한 다음 데이터 집합 추가를 클릭합니다.In the Report Data pane, right-click the Datasets folder, and then click Add Dataset.

  3. 이름Stores를 입력합니다.In Name, type Stores.

  4. 내 보고서에 포함된 데이터 집합 사용을 선택합니다.Select Use a dataset embedded in my report.

  5. 데이터 원본의 드롭다운 목록에서, 첫 번째 절차에서 사용한 데이터 원본을 선택합니다.In Data source, from the drop-down list, choose the data source you used in the first procedure.

  6. 쿼리 유형에서 텍스트 가 선택되어 있는지 확인합니다.In Query type, verify that Text is selected.

  7. 쿼리에 다음 텍스트를 붙여넣습니다.In Query, paste the following text:

    SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName  
    UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName  
    UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName  
    UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName  
    
  8. 확인을 클릭합니다.Click OK.

    보고서 데이터 창의 Stores 데이터 집합 노드 아래에 StoreID 및 StoreName 필드가 표시됩니다.The Report Data pane displays the fields StoreID and StoreName under the Stores dataset node.

4b.4b. 목록에 표시할 사용 가능한 값 지정Specify Available Values to Show in a List

사용 가능한 값을 제공하는 데이터 집합을 만든 후 보고서 속성을 변경하여 보고서 뷰어 도구 모음의 유효한 값 드롭다운 목록을 채우는 데 사용할 데이터 집합과 필드를 지정합니다.After you create a dataset to provide available values, you change the report properties to specify which dataset and which field to use to populate the drop-down list of valid values on the Report Viewer toolbar.

데이터 집합의 매개 변수에 사용 가능한 값을 제공하려면To provide available values for a parameter from a dataset

  1. 보고서 데이터 창에서 @StoreID를 마우스 오른쪽 단추로 클릭한 다음 매개 변수 속성를 참조하세요.In the Report Data pane, right-click the parameter @StoreID, then click Parameter Properties.

  2. 사용 가능한 값을 클릭한 다음 쿼리에서 값 가져오기를 클릭합니다.Click Available Values, and then click Get values from a query.

  3. 데이터 집합의 드롭다운 목록에서 Stores를 클릭합니다.In Dataset, from the drop-down list, click Stores.

  4. 값 필드의 드롭다운 목록에서 StoreID를 클릭합니다.In Value field, from the drop-down list, click StoreID.

  5. 레이블 필드의 드롭다운 목록에서 StoreName을 클릭합니다.In Label field, from the drop-down list, click StoreName. 이 레이블 필드는 값의 표시 이름을 지정합니다.The label field specifies the display name for the value.

  6. 일반을 클릭합니다.Click General.

  7. 프롬프트에서 S를re Identifer?S를re name?으로 변경합니다.In Prompt, change Store Identifer? to Store name?

    이제 보고서를 읽는 사람이 상점 식별자 대신 상점 이름 목록에서 선택하게 됩니다.Report readers will now select from a list of store names instead of store identifiers. 매개 변수가 상점 이름이 아닌 상점 식별자를 기반으로 하기 때문에 매개 변수 데이터 형식은 Integer 로 유지됩니다.Note that the parameter data type remains Integer because the parameter is based on the store identifier, not the store name.

  8. 확인을 클릭합니다.Click OK.

  9. 보고서를 미리 봅니다.Preview the report.

    보고서 뷰어 도구 모음의 매개 변수 입력란은 이제 값 선택을 표시하는 드롭다운 목록입니다.In the report viewer toolbar, the parameter text box is now a drop-down list that displays Select a Value.

  10. 드롭다운 목록에서 Contoso Catalog Store를 선택한 다음 보고서 보기를 클릭합니다.From the drop-down list, select Contoso Catalog Store, then click View Report.

보고서에는 상점 식별자 200에 대한 Accessories, Camcorders 및 Digital SLR Cameras의 판매 수량이 표시됩니다.The report displays the quantity sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

4c.4c. 기본값 지정Specify a Default Value

보고서가 자동으로 실행되도록 각 매개 변수의 기본값을 지정할 수 있습니다.You can specify a default value for each parameter so the report runs automatically.

데이터 집합에서 기본값을 지정하려면To specify a default value from a dataset

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 보고서 데이터 창에서 @StoreID를 마우스 오른쪽 단추로 클릭한 다음 매개 변수 속성를 참조하세요.In the Report Data pane, right-click @StoreID, then click Parameter Properties.

  3. 기본값을 클릭한 다음 쿼리에서 값 가져오기를 클릭합니다.Click Default Values, then click Get values from a query.

  4. 데이터 집합의 드롭다운 목록에서 Stores를 클릭합니다.In Dataset, from the drop-down list, click Stores.

  5. 값 필드의 드롭다운 목록에서 StoreID를 클릭합니다.In Value field, from the drop-down list, click StoreID.

  6. 확인을 클릭합니다.Click OK.

  7. 보고서를 미리 봅니다.Preview the report.

For @StoreID의 경우 보고서 뷰어에 Stores를 참조하세요.For @StoreID, the report viewer displays the value "Contoso North America Online Store" because it's the first value from the result set for the dataset Stores. 보고서에는 상점 식별자 199에 대한 Digital Cameras의 판매 수량이 표시됩니다.The report displays the quantity sold for Digital Cameras for store identifier 199.

사용자 지정 기본값을 지정하려면To specify a custom default value

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 보고서 데이터 창에서 @StoreID을 마우스 오른쪽 단추로 클릭한 다음 매개 변수 속성를 참조하세요.In the Report Data pane, right-click @StoreID, and then click Parameter Properties.

  3. 기본값 > 값 지정 > 추가를 클릭합니다.Click Default Values > Specify values > Add. 새 값 행이 추가됩니다.A new value row is added.

  4. 200을 입력합니다.In Value, type 200.

  5. 확인을 클릭합니다.Click OK.

  6. 보고서를 미리 봅니다.Preview the report.

For @StoreID의 경우 보고서 뷰어에 상점 식별자 200를 참조하세요.For @StoreID, the report viewer displays "Contoso Catalog Store" because it's the display name for store identifier 200. 보고서에는 상점 식별자 200에 대한 Accessories, Camcorders 및 Digital SLR Cameras의 판매 수량이 표시됩니다.The report displays the quantity sold for Accessories, Camcorders, and Digital SLR Cameras for the store identifier 200.

4d.4d. 이름/값 쌍 조회Look up a Name/Value Pair

데이터 집합에는 식별자 및 해당 이름 필드가 포함되어 있을 수 있습니다.A dataset might contain both the identifier and the corresponding name field. 식별자만 있는 경우 이름/값 쌍이 포함된 만든 데이터 집합에서 해당 이름을 조회할 수 있습니다.When you only have an identifier, you can look up the corresponding name in a dataset that you created that includes name/value pairs.

데이터 집합에서 값을 조회하려면To look up a value from a dataset

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 디자인 화면에서 행렬에 있는 첫 번째 행의 열 머리글에서 [StoreID] 를 마우스 오른쪽 단추로 클릭한 다음 을 클릭합니다.On the design surface, in the matrix, in the first row column header, right-click [StoreID] and then click Expression.

  3. 식 창에서 시작 부분의 등호 (=)를 제외한 텍스트를 모두 삭제합니다.In the expression pane, delete all text except the beginning equals sign (=).

  4. 범주에서 일반 함수를 확장하고 기타를 클릭합니다.In Category, expand Common Functions, and click Miscellaneous. 항목 창에 함수 집합이 표시됩니다.The Item pane displays a set of functions.

  5. 항목에서 조회를 두 번 클릭합니다.In Item, double-click Lookup. 식 창에 =Lookup(이 표시됩니다.The expression pane displays =Lookup(. 예제 창에 Lookup 구문 예가 표시됩니다.The Example pane displays an example of Lookup syntax.

  6. 다음 식을 입력합니다.Type the following expression:

    =Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")      
    

    Lookup 함수가 StoreID의 값을 사용하여 "Stores" 데이터 집합에서 조회한 다음 StoreName 값을 반환합니다.The Lookup function takes the value for StoreID, looks it up in the "Stores" dataset, and returns the StoreName value.

  7. 확인을 클릭합니다.Click OK.

    상점 열 머리글에 복잡한 식의 표시 텍스트인 Expr이 포함됩니다.The store column header contains the display text for a complex expression: Expr.

  8. 보고서를 미리 봅니다.Preview the report.

각 열의 맨 위 열 머리글에 상점 식별자 대신 상점 이름이 표시됩니다.The column header at the top of each column displays the store name instead of the store identifier.

5. 보고서에 선택한 매개 변수 값 표시5. Display the Selected Parameter Value in the Report

보고서를 읽는 사람이 보고서에 대해 궁금한 사항이 있을 경우 선택한 매개 변수 값을 알면 도움이 됩니다.When your report readers have questions about a report, it helps to know which parameter values they chose. 각 매개 변수에 대해 사용자가 선택한 값을 보고서에 유지할 수 있습니다.You can preserve user-selected values for each parameter in the report. 입력란의 매개 변수를 페이지 바닥글에 표시하는 것이 한 가지 방법입니다.One way is to display the parameters in a text box in the page footer.

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 페이지 바닥글을 마우스 오른쪽 단추로 클릭하고 삽입 > 입력란을 선택합니다.Right-click the page footer > Insert > Text Box. 입력란을 타임스탬프가 있는 입력란 옆으로 끌어옵니다.Drag the text box next to the text box with the time stamp. 입력란의 측면 핸들을 잡고 너비를 확장합니다Grab the side handle of the text box and expand the width.

  3. 보고서 데이터 창에서 @StoreID 매개 변수를 입력란으로 끌어옵니다.From the Report Data pane, drag the parameter @StoreID to the text box. 입력란에 [@StoreID]가 표시됩니다.The text box displays [@StoreID].

  4. 매개 변수 레이블을 표시하려면 삽입 커서가 기존 식 뒤에 나타날 때까지 입력란을 클릭하고 공백을 입력한 다음 매개 변수의 또 다른 복사본을 보고서 데이터 창에서 입력란으로 끌어옵니다.To display the parameter label, click in the text box until the insert cursor appears after the existing expression, type a space, and then drag another copy of the parameter from the Report Data pane to the text box. 입력란에 [@StoreID] [@StoreID]가 표시됩니다.The text box displays [@StoreID] [@StoreID].

  5. 첫 번째 [@StoreID] 를 마우스 오른쪽 단추로 클릭하고 을 클릭합니다.Right-click the first [@StoreID] and click Expression. 대화 상자가 열립니다.The Expression dialog box opens. Value 텍스트를 Label로 바꿉니다.Replace the text Value with Label.

  6. 확인을 클릭합니다.Click OK.

    [@StoreID.Label] [@StoreID]텍스트가 표시됩니다.The text displays: [@StoreID.Label] [@StoreID].

  7. 보고서를 미리 봅니다.Preview the report.

6. 필터에서 보고서 매개 변수 사용6. Use the Report Parameter in a Filter

필터를 사용하면 외부 데이터 원본에서 검색된 데이터 중 보고서에 사용할 데이터를 제어할 수 있습니다.Filters help control which data to use in a report after it is retrieved from an external data source. 보고서를 읽는 사람이 표시할 데이터를 제어할 수 있도록 행렬에 대한 필터에 보고서 매개 변수를 포함할 수 있습니다.To let report readers control the data they want to see, you can include the report parameter in a filter for the matrix.

행렬 필터에서 매개 변수를 지정하려면To specify a parameter in a matrix filter

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 행렬에서 행 또는 열 머리글 핸들을 마우스 오른쪽 단추로 클릭한 다음 테이블릭스 속성을 클릭합니다.Right-click a row or column header handle on the matrix, and then click Tablix Properties.

  3. 필터를 클릭한 다음 추가를 클릭합니다.Click Filters, and then click Add. 새 필터 행이 나타납니다.A new filter row appears.

  4. 의 드롭다운 목록에서 데이터 집합 필드 StoreID를 선택합니다.In Expression, from the drop-down list, select the dataset field StoreID. 데이터 형식에 Integer가 표시됩니다.The data type displays Integer. 식 값이 데이터 집합 필드이면 데이터 형식이 자동으로 설정됩니다.When the expression value is a dataset field, the data type is set automatically.

  5. 연산자에서 등호 (=)가 선택되어 있는지 확인합니다.In Operator, verify that the equals sign (=) is selected.

  6. [@StoreID]를 입력합니다.In Value, type [@StoreID].

    [@StoreID]=Parameters!StoreID.Value를 나타내는 단순 식 구문입니다.[@StoreID] is the simple expression syntax that represents =Parameters!StoreID.Value.

  7. 확인을 클릭합니다.Click OK.

  8. 보고서를 미리 봅니다.Preview the report.

    행렬에 "Contoso Catalog Store"에 대한 데이터만 표시됩니다.The matrix displays data only for "Contoso Catalog Store".

  9. 보고서 뷰어 도구 모음에서 Store name?으로 Contoso Asia Online Store를 선택한 다음 보고서 보기를 클릭합니다.On the report viewer toolbar, for Store name?, select Contoso Asia Online Store, and then click View Report.

행렬에 선택한 상점에 해당하는 데이터가 표시됩니다.The matrix displays data that corresponds to the store that you selected.

7. 여러 값을 허용하도록 보고서 매개 변수 변경7. Change the Report Parameter to Accept Multiple Values

매개 변수를 단일 값 매개 변수에서 다중값 매개 변수로 변경하려면 필터를 비롯해 매개 변수에 대한 참조가 포함된 모든 식과 쿼리를 변경해야 합니다.To change a parameter from single to multivalued, you must change the query and all expressions that contain a reference to the parameter, including filters. 다중값 매개 변수는 값 배열입니다.A multivalued parameter is an array of values. 데이터 집합 쿼리에서 쿼리 구문을 통해 한 값의 값 집합 포함 여부를 테스트해야 합니다.In a dataset query, query syntax must test for inclusion of one value in a set of values. 보고서 식에서 식 구문은 개별 값이 아닌 값 배열에 액세스해야 합니다.In a report expression, expression syntax must access an array of values instead of an individual value.

매개 변수를 단일 값 매개 변수에서 다중값 매개 변수로 변경하려면To change a parameter from single to multivalued

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 보고서 데이터 창에서 @StoreID을 마우스 오른쪽 단추로 클릭한 다음 매개 변수 속성를 참조하세요.In the Report Data pane, right-click @StoreID, and then click Parameter Properties.

  3. 다중 값 허용을 선택합니다.Select Allow multiple values.

  4. 확인을 클릭합니다.Click OK.

  5. 보고서 데이터 창에서 데이터 집합 폴더를 확장하고 DataSet1을 마우스 오른쪽 단추로 클릭한 다음 쿼리를 클릭합니다.In the Report Data pane, expand the Datasets folder, right-click DataSet1, and then click Query.

  6. 쿼리의 마지막 줄에 있는 **** WHERE 절에서 다음과 같이 등호 Transact-SQLTransact-SQL WHERE clause 등호 last line 등호 query:Change the equals sign (=) to IN in the Transact-SQLTransact-SQL WHERE clause in the last line in the query:

    WHERE StoreID IN (@StoreID)  
    

    IN 연산자는 값의 값 집합 포함 여부를 테스트합니다.The IN operator tests a value for inclusion in a set of values.

  7. 확인을 클릭합니다.Click OK.

  8. 행렬에서 행 또는 열 머리글 핸들을 마우스 오른쪽 단추로 클릭한 다음 테이블릭스 속성을 클릭합니다.Right-click a row or column header handle on the matrix, and then click Tablix Properties.

  9. 필터를 클릭합니다.Click Filters.

  10. 연산자에서 In을 선택합니다.In Operator, select In.

  11. 확인을 클릭합니다.Click OK.

  12. 페이지 바닥글에 매개 변수가 표시되는 입력란에서 모든 텍스트를 삭제합니다.In the text box that displays the parameter in the page footer, delete all text.

  13. 입력란을 마우스 오른쪽 단추로 클릭한 다음 을 클릭합니다.Right-click the text box, and then click Expression. 다음 식을 입력합니다. =Join(Parameters!StoreID.Label, ", ")Type the following expression: =Join(Parameters!StoreID.Label, ", ")

    이 식은 사용자가 선택한 모든 상점 이름을 쉼표와 공백으로 구분하여 연결합니다.This expression concatenates all store names that the user selected, separated by a comma and a space.

  14. 확인을 클릭합니다.Click OK.

  15. 방금 만든 식 앞의 입력란을 클릭한 다음Click in the text box in front of the expression that you just created, and then type the following:

    Parameter Values Selected:를 입력합니다.Parameter Values Selected:

  16. 보고서를 미리 봅니다.Preview the report.

  17. Store Name? 옆의 드롭다운 목록을 클릭합니다.Click the drop-down list next to Store Name?

    각각의 유효한 값이 확인란 옆에 나타납니다.Each valid value appears next to a check box.

  18. 모두 선택을 클릭한 다음 보고서 보기를 클릭합니다.Click Select All, and then click View Report.

    보고서에 모든 상점에 대한 모든 하위 범주의 판매 수량이 표시됩니다.The report displays the quantity sold for all subcategories for all stores.

  19. 드롭다운 목록에서 모두 선택 을 클릭하여 목록을 지우고 "Contoso Catalog Store"와 "Contoso Asia Online Store"를 차례로 클릭한 다음 보고서 보기를 클릭합니다.From the drop-down list, click Select All to clear the list, click "Contoso Catalog Store" and "Contoso Asia Online Store", and then click View Report.

    report-builder-parameter-multiselect

8. 조건부 표시에 대한 부울 매개 변수 추가8. Add a Boolean Parameter for Conditional Visibility

부울 매개 변수를 추가하려면To add a Boolean parameter

  1. 디자인 화면의 보고서 데이터 창에서 매개 변수를 마우스 오른쪽 단추로 클릭한 다음 매개 변수 추가를 클릭합니다.On the design surface, in the Report Data pane, right-click Parameters, and click Add Parameter.

  2. 이름에 ShowSelections를 입력합니다.In Name, type ShowSelections.

  3. 프롬프트에 Show selections?를 입력합니다.In Prompt, type Show selections?

  4. 데이터 형식에서 Boolean을 클릭합니다.In Data type, click Boolean.

  5. 기본값을 클릭합니다.Click Default Values.

  6. 값 지정을 클릭한 다음 추가를 클릭합니다.Click Specify value, and then click Add.

  7. False를 입력합니다.In Value, type False.

  8. 확인을 클릭합니다.Click OK.

부울 매개 변수에 따라 표시 유형을 설정하려면To set visibility based on a Boolean parameter

  1. 디자인 화면에서 매개 변수 값이 표시되는 페이지 바닥글의 입력란을 마우스 오른쪽 단추로 클릭한 다음 입력란 속성을 클릭합니다.On the design surface, right-click the text box in the page footer that displays the parameter values, and then click Text Box Properties.

  2. 표시 유형을 클릭합니다.Click Visibility.

  3. 식에 따라 표시 또는 숨기기옵션을 선택한 다음 Fx식 단추를 클릭합니다.Select the option Show or hide based on an expression, and then click the expression button Fx.

  4. 다음 식을 입력합니다. =Not Parameters!ShowSelections.ValueType the following expression: =Not Parameters!ShowSelections.Value

    입력란의 표시 유형 옵션은 Hidden 속성을 사용하여 제어됩니다.The text box Visibility option is controlled by the property Hidden. 매개 변수를 선택할 경우 Hidden 속성이 False이고 입력란이 표시되도록 Not 연산자를 적용합니다.Apply the Not operator so that when the parameter is selected, the Hidden property is false, and the text box will be displayed.

  5. 확인을 클릭합니다.Click OK.

  6. 확인을 클릭합니다.Click OK.

  7. 보고서를 미리 봅니다.Preview the report.

    매개 변수 선택 항목을 바닥글에 표시하는 입력란이 나타나지 않습니다.The text box that displays the parameter choices in the footer does not appear.

  8. 보고서 뷰어 도구 모음의 Show selections옆에서 True > 보고서 보기를 클릭합니다.In the report viewer toolbar, next to Show selections, click True > View Report.

    선택한 모든 상점 이름을 표시하는 페이지 바닥글의 입력란이 나타납니다.The text box in the page footer appears, showing all the store names you selected.

9. 보고서 제목 추가9. Add a Report Title

보고서 제목을 추가하려면To add a report title

  1. 디자인 뷰로 전환합니다.Switch to Design view.

  2. 디자인 화면에서 제목을 추가하려면 클릭하십시오.를 클릭합니다.On the design surface, click Click to add title.

  3. Parameterized Product Sales를 입력한 다음 입력란 바깥쪽을 클릭합니다.Type Parameterized Product Sales, and then click outside the text box.

10. 보고서 저장10. Save the Report

보고서를 보고서 서버에 저장하려면To save the report on a report server

  1. 보고서 작성기 단추에서 다른 이름으로 저장을 클릭합니다.From the Report Builder button, click Save As.

  2. 최근에 사용한 사이트 및 서버를 클릭합니다.Click Recent Sites and Servers.

  3. 보고서를 저장할 수 있는 권한을 가진 보고서 서버의 이름을 선택하거나 입력합니다.Select or type the name of the report server where you have permission to save reports.

    보고서 서버에 연결하는 중이라는 메시지가 나타납니다.The message Connecting to report server appears. 연결되면 보고서 서버 관리자가 보고서의 기본 위치로 지정한 보고서 폴더의 내용이 표시됩니다.When the connection is complete, you see the contents of the report folder that the report server administrator specified as the default location for reports.

  4. 이름에서 기본 이름을 Parameterized Sales Report로 바꿉니다.In Name, replace the default name with Parameterized Sales Report.

  5. 저장을 클릭합니다.Click Save.

보고서가 보고서 서버에 저장됩니다.The report is saved to the report server. 연결된 보고서 서버는 창 아래쪽에 있는 상태 표시줄에 나타납니다.The report server that you are connected to appears in the status bar at the bottom of the window.

다음 단계Next Steps

보고서에 매개 변수를 추가하는 방법에 대한 연습을 완료했습니다.This concludes the walkthrough for how to add a parameter to your report. 매개 변수에 대한 자세한 내용은 보고서 매개 변수(보고서 작성기 및 보고서 디자이너)를 참조하세요.To learn more about parameters, see Report Parameters (Report Builder and Report Designer).

관련 항목:See Also