#変数

#はじめに

変数は、現在のコンテキストにおける特定の値を識別するために使用される一連のトークンです。ブロックのデータ範囲、フィールドのデフォルト値、連動ルール、ワークフローなどの設定で利用できます。

#現在サポートされている変数

#現在のユーザー

現在ログインしているユーザーのデータを表します。

#現在のロール

現在ログインしているユーザーのロール識別子（ロール名）を表します。

#現在のフォーム

現在のフォームの値を表し、フォームブロックでのみ使用されます。主な利用シーンは以下の通りです。

• 現在のフォームの連動ルール
• フォームフィールドのデフォルト値（新規データ追加時のみ有効）
• 関連フィールドのデータ範囲設定
• 送信アクションにおけるフィールド値の割り当て設定

#現在のフォームの連動ルール

#フォームフィールドのデフォルト値（新規フォームのみ）

#関連フィールドのデータ範囲設定

上位フィールドに基づいて下位フィールドの選択肢を動的にフィルタリングし、正確なデータ入力を保証するために使用されます。

例：

1. ユーザーが Owner フィールドの値を選択します。
2. システムは、選択された Owner の userName に基づいて、Account フィールドの選択肢を自動的にフィルタリングします。

#現在のレコード

レコードとは、データテーブルの行のことで、各行が1つのレコードを表します。表示系のブロックにおける行アクションの連動ルールでは、「現在のレコード」変数が利用できます。

例：「支払い済み」の伝票では、削除ボタンを無効にします。

#現在のポップアップレコード

ポップアップアクションは、NocoBaseのインターフェース設定において非常に重要な役割を果たします。

• 行アクションのポップアップ：各ポップアップには「現在のポップアップレコード」変数があり、現在の行レコードを表します。
• 関連フィールドのポップアップ：各ポップアップには「現在のポップアップレコード」変数があり、現在クリックされた関連レコードを表します。

ポップアップ内のブロックでは、「現在のポップアップレコード」変数を使用できます。関連する利用シーンは以下の通りです。

• ブロックのデータ範囲を設定する
• 関連フィールドのデータ範囲を設定する
• フィールドのデフォルト値を設定する（新規データ追加用のフォーム）
• アクションの連動ルールを設定する

#URLクエリパラメータ

この変数は、現在のページURLに含まれるクエリパラメータを表します。ページURLにクエリ文字列が存在する場合にのみ、この変数は利用可能です。リンクアクションと組み合わせて使用すると、より便利です。

#APIトークン

この変数の値は文字列で、NocoBase APIにアクセスするための認証情報です。ユーザーの身元を確認するために使用できます。

#現在のデバイスタイプ

例：PC以外のデバイスでは「テンプレート印刷」アクションを表示しない。