getVar

폼 스크립트에서 LucyStudio 디자이너에 **사전 정의된 폼 변수(Form Var)**의 현재 값을 읽어옵니다.

파라미터

localVarName (string): LucyStudio 폼 설정에서 사전 정의된 변수명

반환: any — 변수의 현재 값. 정의되지 않은 변수명이면 null 반환

설명

$form.getVar는 LucyStudio 디자이너의 폼(Form) 단위로 사전 정의된 변수의 값을 읽어옵니다. 내부적으로 LucyVarMngr.getVarValue(_mapFormVar, localVarName)를 호출합니다.

변수는 현재 폼 인스턴스에만 유효하며, 다른 폼 인스턴스의 변수에는 접근할 수 없습니다.

경고

변수명은 반드시 LucyStudio 디자이너에서 사전 정의되어 있어야 합니다. 정의되지 않은 변수명은 null을 반환합니다.

$form vs $app vs $page 비교

구분	`$form.getVar`	`$app.getVar`	`$page.getVar`
스코프	현재 폼 인스턴스	앱 전역 공유	❌ 미지원
사전 정의 위치	LucyStudio 폼 설정	LucyStudio 앱 설정	—
생명주기	폼이 닫히면 소멸	앱 실행 중 유지	—
다른 폼에서 접근	❌ 불가	✅ 가능	—

Example

// 폼 변수 읽기
var count = $form.getVar("count");
$log.i("현재 카운트:", count);

var user = $form.getVar("selectedUser");
if (user !== null) {
  $log.i("선택된 사용자:", user.name);
} else {
  $log.i("선택된 사용자 없음");
}

getVar​

getVar