| Easy Heading Macro | ||||||
|---|---|---|---|---|---|---|
|
작성자 : 김원정 / 검수자 : -
Release No. 7.0.500.20260122-11
변수 개요
변수는 변하는 데이터(값)을 저장할 수 있는 메모리 공간입니다.
변수에는 데이터가 한 개만 저장됩니다.
1. 데이터 유형별 예약어
시스템이 데이터(문자/숫자)를 올바르게 인식할 수 있도록, 반드시 데이터 유형에 맞는 예약어를 사용하여 변수명을 지정해야 합니다.
| 변수 유형 | 예약어 형식 | SQL 바인딩 규칙 | 쿼리 적용 예시 |
| 문자형 변수(Variable String) | VS_로 시작 | SQL 바인딩 시 앞뒤로 '(Single Quotation)이 붙여 선언 | :VS_USER_NAME → '홍길동' |
| 수치형 변수(Variable Numeric) | VN_로 시작 | 별도의 처리 없이 단순 치환으로 선언 | :VN_AGE → 28 |
| 참고사항 |
|---|
실제 데이터 조회 쿼리 예시
|
2. 변수명, 왜 데이터 타입에 맞춰 지정해야 하나요?
· 문자형(:VS_)은 SQL 문법상 문자열은 작은따옴표로 감싸야 하므로, 시스템에서 자동으로 이를 처리해 줍니다.
· 수치형(:VN_)은 숫자 값은 따옴표 없이 사용되므로 입력된 값이 그대로 쿼리에 반영됩니다.
3. 데이터 소스에 연결 시, 변수명 앞에 콜론(:)을 왜 붙이나요?
데이터소스에서 변수를 활용하려면 반드시 변수명 앞에 콜론(:)이 작성되어야 합니다.
· (X) 잘못된 예: WHERE NAME = VS_USER_NAME → 시스템은 VS_USER_NAME이라는 글자 자체를 이름으로 인식하여 데이터를 찾으려 합니다. (결과가 나오지 않음)
· (O) 올바른 예: WHERE NAME = :VS_USER_NAME → 시스템이 변수임을 인식합니다.
변수 활용하기
이 가이드는 사용자가 선택한 월(Month) 값에 따라 데이터가 자동으로 바뀌는 보고서를 만드는 과정을 안내합니다.
변수(조회조건) 컨트롤 생성 및 지정
- 컨트롤 생성:UI Bot→ Month 컨트롤을 배치합니다.
- 변수명 설정: 우측 속성 창의 Name 항목에 변수명 규칙을 적용하여 작성합니다.
예시:VS_YM(문자형 변수)
i-META 활용 데이터 연결
i-META 파일을 활용하여 데이터를 연결해 보겠습니다.
| 참고사항 |
|---|
데이터 컴포넌트 유형에 따라 연결하는 위치가 상이합니다. |
1. 데이터 컴포넌트 생성
데이터를 화면에 보여주기 위해 UI Bot에서 List-Grid를 생성합니다.
2. 데이터 연결
- 리스트 그리드를 마우스 우클릭 > [i-META]를 선택합니다.
- i-META목록에서 조회할 META 선택하고, 조회항목과 조회조건을 배치합니다.
조회조건 [년월]에 변수 이름(VS_YM)을 콜론(:)과 함께 작성합니다.
참고사항 변수명 앞에 콜론(:)이 빠지면 시스템이 변수로 인식하지 못합니다.
- 확인 버튼을 클릭합니다.
3. 데이터 확인
보고서를 열었을 때, List-Grid에 데이터가 바로 나오도록 리스트 그리드를 선택한 뒤 우측 Event 영역에서 [AutoRefresh]를 활성화 합니다.
보고서 상단의 [실행] 버튼을 클릭하여 데이터가 정상적으로 조회되는지 확인합니다.
SQL 활용 데이터 연결
SQL 쿼리를 작성하여 데이터를 연결해 보겠습니다.
| 참고사항 |
|---|
데이터 컴포넌트 유형에 따라 연결하는 위치가 상이합니다. |
1. 데이터 컴포넌트 생성
데이터를 화면에 보여주기 위해 UI Bot에서 List-Grid를 생성합니다.
2. 데이터 연결
- 리스트 그리드를 마우스 우클릭 > [SQL]을 선택합니다.
- 데이터소스 창에서 데이터소스를 추가합니다.
- 데이터베이스를 선택합니다.
SQL 쿼리를 작성합니다.
조회조건 ym 컬럼에 변수 이름(VS_YM)을 콜론(:)과 함께 작성합니다.코드 블럭 language sql title 사용한 SQL 쿼리 SELECT T3.ym AS 년월 , T2.store_region AS 매장지역 , SUM(T1.quantity) AS 매출수량 , SUM(T1.revenue_amt) AS 매출금액 FROM sales_performance T1 INNER JOIN sales_store T2 ON (T1.store_cd = T2.store_cd) INNER JOIN sales_std_date T3 ON (T1.std_date = T3.ymd) WHERE 1=1 AND T3.ym = :VS_YM GROUP BY T3.ym, T2.store_region참고사항 변수명 앞에 콜론(:)이 빠지면 시스템이 변수로 인식하지 못합니다.
확인 버튼을 클릭하여 데이터를 연결합니다.
3. 데이터 확인
보고서를 열었을 때, List-Grid에 데이터가 바로 나오도록 리스트 그리드를 선택한 뒤 우측 Event 영역에서 [AutoRefresh]를 활성화 합니다.
보고서 상단의 [실행] 버튼을 클릭하여 데이터가 정상적으로 조회되는지 확인합니다.