getVar

LucyStudioデザイナーでアプリ単位に事前定義されたApp Varの現在値を読み取ります。

Parameters

• appVarName (string): LucyStudioアプリ設定で事前定義された変数名

Returns

any — 変数の現在値。定義されていない変数名の場合はnullを返します

Description

$app.getVarはLucyStudioデザイナーでアプリ単位に事前定義された変数の値を読み取ります。内部ではLucyVarMngr.getVarValue(appVarMap, appVarName)を呼び出します。

アプリ全体で共有されるため、どのフォームやページからでも同じ変数名で読み取れます。

⚠️ 変数名は必ずLucyStudioデザイナーで事前定義されている必要があります。定義されていない変数名はnullを返します。

$app vs $form vs $pageの比較

区分	$app.getVar	$form.getVar
スコープ	アプリ全体で共有	現在のフォームインスタンス
事前定義の場所	LucyStudioアプリ設定	LucyStudioフォーム設定
ライフサイクル	アプリ実行中は保持	フォームが閉じると破棄
他のフォームからのアクセス	✅ 可能	❌ 不可

Example

// App Varの読み取り
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 Varの設定
• $app.clearVar(appVarName) — App Varを初期値にリセット
• $form.getVar(localVarName) — フォーム単位の変数の読み取り（そのフォーム内でのみ有効）
• $app.getSharedData(key) — 任意のキーでインメモリデータを読み取り（事前定義は不要）