Release No. 7.0.500.20260122-11 

변수 개요

변수는 변하는 데이터(값)을 저장할 수 있는 메모리 공간입니다.

데이터 유형별 변수명 규칙

시스템이 데이터(문자/숫자)를 올바르게 인식할 수 있도록, 반드시 데이터 유형에 맞는 예약어를 사용하여 변수명을 지정해야 합니다.

변수명, 왜 데이터 타입에 맞춰 지정해야 하나요?

· 문자형(:VS_)은 SQL 문법상 문자열은 작은따옴표로 감싸야 하므로, 시스템에서 자동으로 이를 처리해 줍니다.

· 수치형(:VN_)은 숫자 값은 따옴표 없이 사용되므로 입력된 값이 그대로 쿼리에 반영됩니다.

데이터 소스에 연결 시, 변수명 앞에 콜론(:)을 왜 붙이나요?

데이터소스에서 변수를 활용하려면 반드시 변수명 앞에 콜론(:)이 작성되어야 합니다.

· (X) 잘못된 예: WHERE NAME = VS_USER_NAME → 시스템은 VS_USER_NAME이라는 글자 자체를 이름으로 인식하여 데이터를 찾으려 합니다. (결과가 나오지 않음)

· (O) 올바른 예: WHERE NAME = :VS_USER_NAME → 시스템이 변수임을 인식합니다.

변수 활용하기

이 가이드는 사용자가 선택한 월(Month) 값에 따라 데이터가 자동으로 바뀌는 보고서를 만드는 과정을 안내합니다.

변수(조회조건) 컨트롤 생성 및 지정

1. 컨트롤 생성: UI Bot→ Month 컨트롤을 배치합니다.
2. 변수명 설정: 우측 속성 창의 Name 항목에 변수명 규칙을 적용하여 작성합니다.
   예시: VS_YM (문자형 변수)
   

i-META 활용 데이터 연결

i-META 파일을 활용하여 데이터를 연결해 보겠습니다.

1. 데이터 컴포넌트 생성

데이터를 화면에 보여주기 위해 UI Bot에서 List-Grid를 생성합니다.

2. 데이터 연결

1. 리스트 그리드를 마우스 우클릭 > [i-META]를 선택합니다.
   
   
   
2. i-META목록에서 조회할 META 선택하고, 조회항목과 조회조건을 배치합니다.

3. 조회조건 [년월]에 변수 이름(VS_YM)을 콜론(:)과 함께 작성합니다.
   

   변수명 앞에 콜론(:)이 빠지면 시스템이 변수로 인식하지 못합니다.

4. 확인 버튼을 클릭합니다.
   

3. 데이터 확인

보고서를 열었을 때, List-Grid에 데이터가 바로 나오도록 리스트 그리드를 선택한 뒤 우측 Event 영역에서 [AutoRefresh]를 활성화 합니다.

보고서 상단의 [실행] 버튼을 클릭하여 데이터가 정상적으로 조회되는지 확인합니다.

SQL 활용 데이터 연결

SQL 쿼리를 작성하여 데이터를 연결해 보겠습니다.

1. 데이터 컴포넌트 생성

데이터를 화면에 보여주기 위해 UI Bot에서 List-Grid를 생성합니다.

2. 데이터 연결

1. 리스트 그리드를 마우스 우클릭 > [SQL]을 선택합니다.
   
   
   
2. 데이터소스 창에서 데이터소스를 추가합니다.
3. 데이터베이스를 선택합니다.

4. SQL 쿼리를 작성합니다.
   조회조건 ym 컬럼에 변수 이름(VS_YM)을 콜론(:)과 함께 작성합니다.

   사용한 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

   변수명 앞에 콜론(:)이 빠지면 시스템이 변수로 인식하지 못합니다.

5. 확인 버튼을 클릭하여 데이터를 연결합니다.

   

3. 데이터 확인

보고서를 열었을 때, List-Grid에 데이터가 바로 나오도록 리스트 그리드를 선택한 뒤 우측 Event 영역에서 [AutoRefresh]를 활성화 합니다.

보고서 상단의 [실행] 버튼을 클릭하여 데이터가 정상적으로 조회되는지 확인합니다.