Valence App Builderには、「アプリ変数」と呼ばれるValenceアプリケーション実行中に情報（データ）を保持/参照する為のいわゆる「変数」が定義できるようになっています。
アプリ変数の基本的な使用方法については、以前のTips記事「Valence アプリ変数の活用方法(第1回) 」にまとめていますので、そちらをご覧下さい。
その他、これまでにもアプリ変数の活用例をTips記事に多数アップしておりますので、Migaro. Tips (Valence) の画面右側にある「Tips内検索」より「アプリ変数」で検索してみてください。
アプリ変数は、もちろん目的にあわせて、独自の変数を追加して利用する事ができますが、それとは別に予め用意された「デフォルトアプリ変数」もございます。今回のトピックではこの「デフォルトアプリ変数」についてご紹介いたします。
アプリ変数宣言画面とデフォルトアプリ変数
App Builderのアプリ変数宣言画面は、アプリケーション編集画面のアプリ変数アイコンから呼び出せます。
表示されたアプリ変数宣言画面の一覧の中にある背景色がブルーの変数が「デフォルトアプリ変数」です。デフォルトアプリ変数は、それぞれ用途が決まっております。
デフォルトアプリ変数の使用例
デフォルトアプリ変数[nabPromptBeforeClose]は、アプリケーション終了時に表示される確認メッセージを登録する為のものです。例えば、[nabPromptBeforeClose]の値として、”このまま終了すると、未保存のデータは破棄されます”と設定すると、アプリケーション終了時に、確認メッセージが表示されるようになります。
デフォルトアプリ変数 一覧
アプリ変数宣言画面で設定可能なデフォルトアプリ変数
アプリ変数宣言画面の一覧に表示されているデフォルトアプリ変数は、次の通りです。
| 変数名 | 概要 | 備考 |
|---|---|---|
| nabAppMsg | アプリケーションメッセージを表示 | |
| nabAppMsgHide | アプリケーションメッセージを隠す | true：隠す |
| nabAppMsgUI | アプリケーションメッセージUI | info：情報、warning：警告、error：エラー |
| nabChangeAppName | アプリケーション名を変更 | ※PCのみ有効 |
| nabFireLocalEvent | 指定された名称のローカルイベントを実行 | |
| nabHideAppBar | アプリケーションタイトルバーを隠す | true：隠す |
| nabHideBreadcrumbs | パンくずリストを隠す | true：隠す |
| nabInfo | SnackBar メッセージを表示 | |
| nabMsg | ポップアップメッセージを表示 | |
| nabMsgTitle | ポップアップメッセージのタイトル | |
| nabPromptBeforeClose | アプリケーション終了時に表示するメッセージ |
読み取り専用のデフォルトアプリ変数
上記のデフォルトアプリ変数以外に、アプリケーション実行時に自動的に値がセットされ、実行中は値の参照のみ可能な「読み取り専用」のデフォルトアプリ変数もあります。主な読み取り専用のデフォルトアプリ変数は、次の通りです。
| 変数名 | 概要 | 備考 |
|---|---|---|
| nabActiveFormHelperCnt | Formヘルパープログラム(RPG)実行中カウント | FormHelperプログラム実行中は、1となる |
| nabCurrenctSection | 現在開いているセクション名 | |
| nabIbmI | IBMi接続ユーザー名 | ログインユーザー情報 |
| nabUserID | ValenceのユーザーID（数値4桁） | ログインユーザー情報 |
| nabUser | Valenceのユーザー名 | ログインユーザー情報 |
| nabUserEmail | Valenceユーザーの登録メールアドレス | ログインユーザー情報 |
| nabIsDesktop | PCブラウザでの実行かどうか | PCブラウザでの実行の場合、true |
| nabIsMobile | モバイルアプリでの実行かどうか | モバイルアプリでの実行の場合、true |
| nabIsPhone | スマートフォンからの実行かどうか | スマートフォンからの実行の場合、true |
| nabIsTablet | タブレットからの実行かどうか | タブレットからの実行の場合、true |
| nabNullDate | IBMi日付型のNULL値 | “0001-01-01”が格納 |
| nabNullTimeStamp | IBMiタイムスタンプ型のNULL値 | “0001-01-01-00.00.00.000000”が格納 |
| nabNullTimestampShort | IBMiタイムスタンプ型（秒迄）のNULL値 | ”0001-01-01-00.00.00“が格納 |