getVar

LucyStudio 디자이너에 앱 단위로 사전 정의된 앱 변수(App Var)의 현재 값을 읽어옵니다.

Parameters

• appVarName (string): LucyStudio 앱 설정에서 사전 정의된 변수명

Returns

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

Description

$app.getVar는 LucyStudio 디자이너의 앱(App) 단위로 사전 정의된 변수의 값을 읽어옵니다. 내부적으로 LucyVarMngr.getVarValue(appVarMap, appVarName)를 호출합니다.

앱 전역에서 공유되므로, 어느 폼이나 페이지에서든 동일한 변수명으로 읽을 수 있습니다.

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

$app vs $form vs $page 비교

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

Example

// 앱 변수 읽기
var userId = $app.getVar("loginUserId");
$log.i("로그인 사용자:", userId);

var theme = $app.getVar("theme");
if (theme === "dark") {
  // 다크 모드 처리
  $log.i("다크 모드 활성화");
}

// 미정의 변수는 null 반환
var unknown = $app.getVar("notDefined");
$log.i("미정의 변수:", unknown); // null

Related

• $app.setVar(appVarName, data) — 앱 변수 설정
• $app.clearVar(appVarName) — 앱 변수를 초기값으로 초기화
• $form.getVar(localVarName) — 폼 단위 변수 읽기 (해당 폼에서만 유효)
• $app.getSharedData(key) — 자유로운 키로 인메모리 데이터 읽기 (사전 정의 불필요)