• 아티클

매개 변수가 있는 보고서 실행

매개 변수가 있는 보고서는 입력 값을 사용하여 보고서 처리를 완료하는 보고서입니다. 매개 변수가 있는 보고서로는 지역 값, 제품 범주 또는 ID를 기반으로 필터링하는 보고서를 예로 들 수 있습니다. 매개 변수는 일반적으로 보고서에 필요한 데이터를 선택하는 쿼리를 완성하는 데 사용됩니다. 매개 변수가 있는 보고서를 관리하거나 실행할 경우 선택한 매개 변수가 작업 중인 보고서에 미치는 영향을 잘 알고 있어야 합니다.

[!참고]

보고서에 사용되는 매개 변수는 보고서를 만든 사람이 정의합니다. 보고서가 게시된 후 일부 매개 변수 속성을 수정하여 사용되는 값과 값을 가져오는 방법을 변경할 수 있습니다. 매개 변수 생성에 대한 자세한 내용은 매개 변수(보고서 작성기 3.0 및 SSRS)을 참조하십시오. 매개 변수 관리에 대한 자세한 내용은 게시된 보고서의 매개 변수 속성 설정을 참조하십시오.

매개 변수 값 저장 및 확인

실행할 때 매개 변수 값을 가져오는 경우 보고서에 기본값을 저장하거나 사용자가 값을 입력하거나 선택하게 할 수 있습니다. 보고서가 항상 특정 값으로 처리되게 하려면 보고서에 매개 변수 값을 저장하는 것이 좋습니다. 예를 들어 지역 사무소에 전용 웹 사이트가 있으면 항상 특정 지역 코드를 사용하는 지역 판매 보고서를 해당 웹 사이트에 호스트할 수 있습니다.

사용자가 보고서를 열 때 값을 입력하거나 선택하도록 표시할 수도 있습니다. 매개 변수 값을 입력하도록 보고서를 구성하면 사용자가 특정 값을 입력할 수 있는 입력 필드가 제공됩니다. 값을 입력한 후 보고서 보기를 클릭하면 보고서가 실행됩니다. 값이 유효하면 보고서가 표시되고 값이 유효하지 않으면 오류 메시지가 나타나거나 빈 보고서가 표시됩니다. 저장된 매개 변수 값을 사용하면 입력 필드 또는 보고서 보기 단추가 표시되지 않고 보고서가 열립니다. 보고서를 실행하는 모든 사용자는 동일한 매개 변수 값을 사용합니다.

보고서에 쿼리 기반 매개 변수가 포함되어 있고 데이터 원본을 사용하기 위해 각 사용자가 로그온해야 하는 경우 매개 변수 입력 필드가 페이지에 표시되기 전에 자격 증명을 입력해야 합니다. 이 경우 매개 변수 값을 검색하려면 자격 증명을 제공해야 합니다.

매개 변수가 있는 보고서를 실행하려면 일반적으로 입력할 값을 알고 있어야 합니다. 유효한 값을 선택할 수 있는 드롭다운 목록이 보고서에 포함되어 있을 수 있습니다.

게시된 보고서에 매개 변수 속성(기본값 포함)을 설정하려면 보고서 관리자를 사용하십시오. 자세한 내용은 매개 변수(보고서 작성기 3.0 및 SSRS) 및 구독에 매개 변수 설정를 참조하십시오.

보고서 URL에 관한 매개 변수 설정

매개 변수가 있는 보고서를 실행하는 다른 방법은 URL을 사용하는 것입니다. 인코딩된 이름-값 쌍으로 된 하나 이상의 매개 변수를 앰퍼샌드 문자(&)로 구분하여 지정할 수 있습니다.

Null 매개 변수는 특수 구문을 사용하므로 Null 값에 대해 isnull을 지정해야 합니다. 매개 변수에 대해 Null 값을 지정하면 동일한 매개 변수에 대해 지정된 다른 값은 모두 무시됩니다. 다음은 Null 및 상수 값에 대한 여러 매개 변수를 설명하는 예입니다.

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder&region=west&sales:isnull=true

여러 값을 갖는 매개 변수는 매개 변수 이름을 반복하여 지정합니다. 예를 들면 다음과 같습니다.

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&region=east&region=west

Boolean 매개 변수는 0 또는 1의 값으로 지정됩니다.

Float 매개 변수는 서버 로캘의 소수 구분 기호를 포함해야 합니다.

DateTime 매개 변수는 YYYY-MM-DDTHH:MM:SS 형식으로 지정해야 하며 ISO(International Organization for Standardization) 8601 표준을 기반으로 합니다. URL에 대한 매개 변수를 설정하는 방법은 URL 액세스 매개 변수 사용를 참조하십시오.