setVar

LucyStudio 디자이너에 앱 단위로 사전 정의된 앱 변수(App Var)에 값을 설정합니다. 설정한 값은 앱 전역에서 공유됩니다.

Parameters

• appVarName (string): LucyStudio 앱 설정에서 사전 정의된 변수명
• data (any): 설정할 값 (문자열, 숫자, 불리언, 객체 등)

Returns

없음 (void)

Description

$app.setVar는 LucyStudio 디자이너의 앱(App) 단위로 사전 정의된 변수에 값을 저장합니다. 내부적으로 LucyVarMngr.setVarValue(appVarMap, appVarName, data)를 호출합니다.

값은 앱 전체에서 공유되므로, 어느 폼이나 페이지에서든 동일한 변수명으로 읽고 쓸 수 있습니다. 앱이 실행되는 동안 유지됩니다.

⚠️ 변수명은 반드시 LucyStudio 디자이너에서 사전 정의되어 있어야 합니다. 정의되지 않은 변수명을 사용하면 동작하지 않습니다. setSharedData / setStoreData와 달리 자유로운 키를 사용할 수 없습니다.

⚠️ 여기에 LucyStudio Variables 설정화면 추가 또는 링크 연결

$app vs $form vs $page 비교

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

폼 내부에서만 사용하는 변수라면 $form.setVar를 사용하세요.

Example

// LucyStudio 앱 설정에서 "loginUserId", "theme" 변수가 사전 정의된 경우
$app.setVar("loginUserId", "user_001");
$app.setVar("theme", "dark");
$app.setVar("cartItems", [{ id: 1, qty: 2 }, { id: 3, qty: 1 }]);

// 다른 폼/페이지에서 읽기
var userId = $app.getVar("loginUserId");
$log.i("로그인 사용자:", userId);

Related

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