변수 등록(지정)

지정한 변수값을 데이터의 검색 조건으로 지정하기 위해서는 변수를 선언해야 합니다.

변수를 사용하는 방법에는 스크립트를 통해 변수를 선언하는 방법과 변수편집기 메뉴를 통한 방법이 있습니다.

변수 유형에 따라 SQL 바인딩 규칙이 다르기 때문에 유형에 맞는 예약어로 변수명을 지정해야 합니다.

  • 문자형 변수 예약어 (:VS_)
    'VS_' 로 시작하는 변수는 SQL 바인딩 시 앞 뒤로 ''(Single Quotation)을 붙여 실행됩니다.
    예) AND USER_NAME = :VS_USER_NAME → AND USER_NAME = 'Tom'
  • 수치형 변수 예약어 (:VN_)
    'VN_'로 시작하는 변수는 SQL 바인딩 시 단순 치환됩니다.
    예) AND AGE = :VN_AGE → AND AGE = 28
  • 라인 삭제 옵션 (@)
    변수 예약어 앞에 '@' 기호를 붙이면 변수에 지정된 값이 없을 때 해당 조회조건 라인이 삭제됩니다.
    예) WHERE 1=1 AND USER_NAME = @:VS_USER_NAME → WHERE 1=1

컨트롤 활용

컨트롤의 Name을 변수명으로 설정합니다.

Variables Editor 활용

Variables Editor를 활용하여 변수를 등록하고, 값을 설정할 수 있습니다.

변수 편집기 창 사용 방법

변수 사용

DataSource에서 사용

SQL문에서 사용

i-META Viewer에서 사용

Client Script에서 사용

  • 컨트롤 불러오기
    Matrix.getObject(name)
  • 변수편집기 내 변수 불러오기
    Matrix.GetVariable(name)
  • 변수편집기 내 변수 값 설정
    Matrix.SetVariable(name, value)

변수 바인딩 결과 확인하기

Log Viewer를 통해 변수 바인딩 결과를 확인할 수 있습니다.