# 매개변수 보기

## Content

# 일반

매개 변수를 생성할 때 `데이터 형식`은 매개 변수가 포함할 수 있는 값의 유형을 지정합니다. 숨기지 않은 매개 변수의 값은 보고서 구독자가 보고서 뷰어 컴포넌트의 매개 변수 패널을 통해 조정할 수 있습니다. 각 데이터 형식마다 기본 편집기가 있습니다.

* `부울` 매개 변수는 라디오 버튼을 사용합니다.
* `날짜` 및 `날짜/시간` 매개 변수는 달력 컨트롤을 사용합니다.
* `정수`, `문자열`, `Float` 매개 변수는 텍스트 상자를 사용합니다.

# 사용자 정의 매개 변수 보기

사용자 정의 매개 변수 보기를 구성할 수 있습니다. 이는 보고서 뷰어의 매개 변수 패널에 표시되며 보고서 디자이너의 `매개 변수` 탭을 통해 관리됩니다.
![image.a13bdf](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/5782ed59-7caa-432e-b8fb-3d0b076233da/image.a13bdf.67bf2b.png)
보고서에 매개 변수가 있으면 도구 모음의 `보기 생성` 버튼을 클릭하여 매개 변수 보기 생성을 시작할 수 있습니다. 아니면 프롬프트에서 `생성` 버튼을 사용할 수도 있습니다.
![image.103d64](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/5782ed59-7caa-432e-b8fb-3d0b076233da/image.103d64.33a8e2.png)
이 액션을 실행하면 보고서 매개 변수에 대한 기본 편집기가 `미리 보기` 버튼과 함께 열립니다. 여기서 이 자동 생성된 컨트롤을 구성하거나 사이드바에서 항목을 클릭하거나 끌어 놓아서 새 컨트롤로 대체할 수 있습니다.
![image.bd0495](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/5782ed59-7caa-432e-b8fb-3d0b076233da/image.bd0495.870a08.png)
이러한 컨트롤이 매개 변수 보기에 통합되면 디자이너 오른쪽의 속성 패널로 속성을 조정할 수 있습니다.
![image.617478](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/5782ed59-7caa-432e-b8fb-3d0b076233da/image.617478.7d35ae.png)
각 컨트롤에는 `위치 및 크기` 속성이 있습니다. 마우스 또는 키보드로 컨트롤을 수동 조정하거나 속성 패널에 `왼쪽`, `상단`, `너비`, `높이` 값을 직접 입력하여 이 속성을 변경할 수 있습니다.

# 매개 변수 보기 레이아웃

컨트롤을 사용하여 구성할 수 있는 레이아웃에는 두 가지 유형이 있습니다.

1. **자유 형식 레이아웃**: 이 레이아웃에서는 수동으로 각 컨트롤의 위치 및 크기를 설정할 수 있습니다.
2. **세로 스택 레이아웃**: 컨트롤이 상단부터 하단까지 자동으로 배열되고 크기 조절됩니다. 설정 가능한 유일한 변수는 항목의 순서입니다.

매개 변수 보기 도구 모음의 `세로 레이아웃` 버튼을 클릭하여 세로 스택 레이아웃을 위한 컨트롤 순서를 설정할 수 있습니다.
레이아웃 유형 선택은 보고서 뷰어 컴포넌트의 [매개 변수 패널 위치](/activereportsjs/docs/v6.1/#configuring-the-parameters-panel-location)에 따라 정해집니다.

* 위치가 `상단` 또는 `하단`으로 설정되면 **자유 형식 레이아웃**이 적용됩니다.
* 위치가 `기본` 또는 `자동`으로 설정되면 **세로 스택 레이아웃**이 적용됩니다.

# 매개 변수 보기 컨트롤

사용 가능한 컨트롤은 다음 두 가지 그룹으로 분류됩니다.

* `편집기`는 매개 변수와 연결되며 매개 변수 값 설정에 활용됩니다. 모든 편집기에는 `레이블/텍스트`와 `레이블/표시` 속성이 있으며, 이는 편집기와 함께 표시되는 프롬프트의 위치와 콘텐츠를 결정합니다. `바운드 매개 변수` 값의 속성에서는 바운드 매개 변수에 대한 `기본값`, `null화 가능`, `빈 칸 허용(문자열 매개 변수 전용)` 및 `여러 줄(문자열 매개 변수 전용)` 속성을 설정할 수 있습니다. 아래에서는 사용 가능한 편집기 및 속성에 대한 상세 설명을 볼 수 있습니다.
* `보조`는 `헤딩`, `일반 텍스트`, `버튼`을 제어하며 이는 추가 정보를 표시하고 작업을 수행합니다.

## 단순 값 편집기

단순 값 편집기는 사전 설정된 `사용 가능 값`이 없는 매개 변수 값의 수정을 지원합니다. 이를 통해 사용자는 원하는 값을 입력할 수 있습니다.

### 텍스트 편집기

`텍스트 편집기`는 보통 `문자열` 유형의 매개 변수에 사용되는 입력 상자를 제공합니다. 그러나 `바인딩` 속성을 활용하면 모든 유형의 매개변수와 연결할 수 있으며 숫자, 부울 값, 데이터 값 등을 모두 수동 입력할 수 있습니다. 입력 상자가 비어 있으면 프롬프트를 표시하기 위해 `자리 표시자` 속성이 사용됩니다.

### 숫자 편집기

`숫자 편집기`는 `정수` 및 `Float` 형식의 매개 변수에 바인딩될 수 있습니다. `유형` 속성은 에디터 유형을 정의하며, `위-아래 편집기`(기본) 또는 `슬라이더` 간에 선택할 수 있습니다. `최소`, `최대`, `스텝` 속성을 두 에디터 유형에 대해 설정하여 최솟값, 최댓값, 위/아래 버튼 클릭 또는 슬라이더 이동 시 값 증감량 등을 설정할 수 있습니다. `위-아래` 편집기는 수동 값 입력도 지원하며, `자리표시자` 속성은 입력 상자가 비어 있을 때 안에 프롬프트를 표시하도록 정의될 수 있습니다. `단계적으로 입력 반올림` 플래그가 설정되어 있으면 수동 입력 값이 단계 값의 가장 가까운 배수로 반올림됩니다.

### 부울 편집기

`부울 편집기`는 `부울` 유형 매개 변수로 바인드될 수 있습니다. `유형` 속성은 `토글`, `체크박스`, `라디오` 등의 옵션으로 에디터 유형을 결정합니다. `체크박스`에서는 체크마크 옆에 표시될 `텍스트`를 정의합니다. `토글` 및 `라디오`에서는 `True` 및 `False` 값을 설정할 수 있습니다. 또한 `라디오` 편집기의 `레이아웃`은 `가로` 또는 `세로`로 설정 가능합니다.

### 다중 값 편집기

`다중 값` 편집기는 모든 유형의 다중 값 매개 변수를 위한 수동 값 입력을 지원합니다. 이 편집기는 특히 `사용 가능한 값`이 구성되지 않은 매개 변수에 적용 가능합니다.

### 날짜/시간 편집기

`날짜/시간 편집기`는 `날짜` 및 `날짜/시간` 유형 파라미터와 연결될 수 있습니다. 이러한 유형에 사용 가능한 유일한 편집기는 달력입니다.

## 범위 편집기

범위 편집기는 사용자가 두 구분되는 매개 변수에 대해 값을 정의하도록 지원합니다. 이 두 값은 범위의 상한과 하한을 나타냅니다.

### 숫자 범위

`숫자 범위` 편집기는 핸들이 두 개인 슬라이더 형태입니다. `정수` 및 `Float` 매개 변수와 연결 가능한 `시작` 및 `대상` 바인딩 속성을 포함합니다. `최소`, `최대`, `스텝` 속성을 통해 최솟값, 최댓값, 슬라이더 조절 시 값 증감량을 지정할 수 있습니다.

### 날짜 범위

`날짜 범위` 편집기는 `시작 날짜` 및 `끝 날짜` 선택을 지원하는 달력 기능입니다. `From` 및 `To` 속성을 사용하여 해당 매개 변수에 바인딩될 수 있습니다. 또한 `최대 범위` 속성은 범위의 최대 기간을 명시하며 `보기 모드` 속성은 범위 선택 스케일을 일(기본), 월 또는 연도로 설정합니다.

## 선택 편집기

선택 편집기는 보고서 구독자에게 옵션 목록을 제공하는 요소입니다. 구독자는 바운드 매개 변수의 `다중 값` 플래그에 따라 하나 또는 다수의 값을 선택할 수 있습니다. 이 에디터들은 매개 변수에서 `사용 가능한 값`이 구성됐을 때만 적용된다는 점에 유의하십시오.

### 목록 편집기

`목록` 편집기는 `사용 가능한 값`을 목록으로 조직하며, 이를 가로 또는 세로로 배열할 수 있습니다. `레이아웃` 속성에서 가로 및 세로 방향 중에 선택할 수 있습니다. 가로 목록의 경우 추가 속성인 `열`로 값이 분할될 열의 수를 결정할 수 있습니다.

### 드롭다운 편집기

`드롭다운` 편집기는 `사용 가능한 값`의 드롭다운 스타일 표현을 제공합니다.

## 보조 컨트롤

보조 컨트롤에는 `헤딩`, `일반 텍스트`, `버튼`이 있습니다.
`헤딩` 및 `일반 텍스트` 컨트롤은 정적 텍스트 표시에 사용됩니다. 이러한 컨트롤에서는 네 가지 색상 스타일을 선택할 수 있습니다. `액센트`, `오류`, `경고`, `기본`입니다. 또한 `헤딩` 컨트롤은 취소선을 포함할 수 있으며 `일반 텍스트` 컨트롤은 여러 줄을 표시하도록 구성될 수 있습니다.
`버튼` 컨트롤은 다양한 작업을 촉진하는 역할을 합니다. `미리 보기`는 현재 설정된 매개 변수로 보고서를 실행합니다. `초기화`는 매개 변수를 기본값으로 되돌립니다. `지우기`는 입력 컨트롤에서 모든 값을 제거합니다.