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