파라미터 컨트롤러
파라미터 컨트롤러는 뷰어가 워크시트 내용을 조정할 수 있게 해 주는 컴포넌트입니다. 하나의 파라미터 컨트롤러를 기반으로 여러 개의 파라미터 code를 만들 수 있고, 하나의 파라미터 code는 여러 워크시트에서 사용할 수 있으며, 실제 조회 시 파라미터 컨트롤러의 값에 따라 해당 파라미터 code가 채워집니다.
각 파라미터 컨트롤러에는 고유한 이름과 기본값이 있습니다. 워크시트 디버깅 결과는 기본값의 영향을 받으며, 편집 모드에서는 기본값을 조정할 수 없습니다.
파라미터 컨트롤러 유형
현재 BI 대시보드는 날짜 구간 컨트롤러와 드롭다운 컨트롤러의 두 가지 파라미터 컨트롤러를 지원합니다.
날짜 구간 컨트롤러에서는 날짜 범위를 설정할 수 있습니다. 선택할 수 있는 범위는 대시보드 및 분석 모델과 비슷하며, 고정 기간, 동적 기간, 또는 시작은 고정이고 종료는 동적인 기간을 포함합니다.
파라미터 컨트롤러를 추가한 후에는 다음을 포함한 파라미터 code도 설정해야 합니다.
- 파라미터 code: 워크시트에서 사용할 이름
- 가져올 내용: 시작 날짜 또는 종료 날짜 중에서 선택
- 날짜 format 형식: 실제 데이터 상황에 맞는 format 형식을 선택
- 오프셋 단위 & 오프셋: 시작 날짜 또는 종료 날짜를 기준으로 오프셋을 적용하여 최종 결과를 얻음
예를 들어 날짜 구간 컨트롤러의 날짜 범위가 2026-02-01～2026-02-28이라고 가정하면, 파라미터 code 설정 조건에 따라 최종 결과가 달라집니다.
| 가져올 내용 | 날짜 format 형식 | 오프셋 단위 | 오프셋 | 최종 결과 |
|---|---|---|---|---|
| 시작 날짜 | yyyy-MM-dd | / | 0 | 2026-02-01 |
| 시작 날짜 | yyyyMMdd | 일 | -1 | 20260131 |
| 종료 날짜 | yyyyMM | 주 | 1 | 202603 |
| 종료 날짜 | yyyy | 년 | -2 | 2024 |
날짜 구간 컨트롤러의 파라미터 code는 날짜로 치환될 때 따옴표가 자동으로 붙으므로, 워크시트에서는 ${파라미터 code}로 바로 쓰면 되며 따옴표를 더 추가하지 마십시오. '${파라미터 code}'로 쓰면 디버깅 시 오류가 발생합니다.
드롭다운 컨트롤러에서는 단일 선택 옵션을 설정할 수 있으며, 각 옵션에는 옵션 이름과 내용이 있습니다.
마찬가지로 파라미터 컨트롤러를 추가한 후에는 다음을 포함한 파라미터 code도 설정해야 합니다.
- 파라미터 code: 워크시트에서 사용할 이름
- 값 타입: 원시 또는 텍스트
값 타입이 원시이면 시스템이 내용을 그대로 사용하여 채웁니다. 값 타입이 텍스트이면 시스템이 바깥쪽을 작은따옴표('')로 감싼 후 추가합니다.
워크시트에서 파라미터 code 사용
설정이 완료되면 워크시트 아래쪽에 설정된 파라미터 컨트롤러와 관련 파라미터 code가 표시됩니다. 마우스를 hover하면 해당 파라미터 code에 채워질 내용을 미리 볼 수 있고, 복사 버튼을 클릭하면 파라미터 code를 빠르게 복사할 수 있습니다.
워크시트의 해당 위치에서 ${파라미터 code}를 사용하면 디버깅 및 실제 조회 시 해당 값으로 치환됩니다.
설정하지 않은 파라미터 code를 사용하면 안내 메시지가 표시됩니다.
페이지에서 파라미터 컨트롤러 조정
페이지에서 파라미터 컨트롤 추가를 클릭한 후 같은 유형의 파라미터 컨트롤러를 선택할 수 있습니다. 설정 후에는 BI 대시보드를 미리 보거나 볼 때 조정할 수 있습니다.
페이지에 추가되지 않은 파라미터 컨트롤러의 파라미터 code는 기본값으로만 조회됩니다. 페이지에 추가된 파라미터 컨트롤러의 파라미터 code 값은 뷰어의 조정에 따라 바뀝니다.