[AEM Forms]{class="badge positive" title="AEM Formsに適用）。"}
インタラクティブ通信エディターのバインドされていない変数コンポーネント
1. はじめに
インタラクティブ通信（IC）エディターのバインドされていない変数 コンポーネントを使用すると、値が外部データモデルまたはスキーマノードに関連付けられていないフィールドを配置できます。 代わりに、値はスクリプト、ルールベースの計算、または静的なデフォルトを通じて提供されるため、バインドされたデータソースから直接取得されない計算された表示値または中間表示値が必要なときはいつでも、このコンポーネントが適切な選択肢になります。
バインドされていない変数はフォームデータモデルに接続されていないため、設計時および実行時に値を完全にオーサリング制御できます。 この関数を使用すると、計算合計、動的に生成された参照番号、中間数式結果、またはルールエンジンが生成するその他の値を表示できます。
コンポーネントは、4つのデータ型Text、Numeric、Date、および Date/Time をすべてサポートしており、アクティブなデータ型によって、どの表示パターン構文と図形節記号が適用されるかが決定されます。
2. 表示パターン
テキストボックス、数値フィールド、日付フィールド、日付/時刻フィールドコンポーネントで使用できる同じ表示パターンコントロールを使用して、プロパティ パネルから 表示パターン をバインドされていない変数フィールドに割り当てることができます。 これにより、カンバスプレビューおよび生成された出力で、計算された値または参照された値をフォーマットされた形式で表示できます。
設定されたパターンは、キャンバスのプレビューにすぐに反映され、保存と再読み込みのサイクルを通じて保持されます。
表示パターンの設定
- デザインキャンバスで「バインドされていない変数」コンポーネントを選択します。
- プロパティ パネルを開きます。
- 「パターンを表示」セクションで、定義済みのパターンを選択するか、カスタム画像句を入力します。
- カンバス上で書式設定された値をプレビューします。
適切なパターンの選択
連結されていない変数は任意のデータタイプを保持できるため、使用するpicture句の構文は、フィールドで設定されたデータタイプと一致する必要があります。
YYYY-MM-DDまたはYYYY-MM-DDTHH:MM）に準拠している必要があります。 この形式に従わない値は、表示パターンが適用されずに、そのまま表示されます。3. プロパティ
バインドされていない変数コンポーネントは、他のフィールドコンポーネントと共通のプロパティのセットを共有し、1つの重要な違いを持ちます。任意のデータソースまたはインタラクティブ通信フラグメントの外部データバインディングオプションをサポートします。
3.1基本フィールド
-
名前：変数の一意のID。 IC内のルール、スクリプト、式で参照するために使用します。
-
データタイプ：この変数が保持する値のタイプを指定しますText、Numeric、Date、またはDate/Time。 選択したデータタイプによって、どの表示パターン構文が適用され、値がどのように検証されるかが決まります。
-
キャプション： キャンバス上のフィールドの横に表示されるラベル（例：「計算合計」または「参照番号」）。
-
値： フィールドに表示されるデフォルト値または計算値。 ほとんどの場合、これは手動で入力するのではなく、ルールエディターまたはスクリプトを使用してプログラムで設定されます。
-
予約：計算された値が使用できない場合に表示されるフォールバック値。空白フィールドが許容できない印刷専用または読み取り専用の出力に便利です。
-
アピアランス： フィールドコンテナのビジュアルスタイルプリセット（なし、実線ボックス、または下線）。
3.2 タイポグラフィ
表示される値のスタイル設定を制御します。
-
フォントのバリエーション： フォントファミリー、太さ（標準、太字）、スタイル（斜体）を選択して、周囲のコンテンツに合わせます。
-
フォントサイズ：通常、デフォルトで10 ptに設定されます。通信の他の部分と視覚的な一貫性を維持するように調整してください。
3.3 ポジション
カンバス上でのコンポーネントの配置を定義します。
-
XおよびY座標：水平方向と垂直方向の位置を正確に設定します。
-
幅と高さ：隣接する要素と整列させる寸法をミリメートル単位で指定します。
3.4 マージン
コンポーネントの境界の周りの間隔を定義します。
-
上（上）
-
下（下）
-
左
-
右
3.5外観
フィールドコンテナのスタイルを設定します。
-
フィールドの 塗りつぶし： 背景色。
-
線： フィールドの周囲の境界線。次のオプションがあります。
-
幅：境界線の太さ。
-
スタイル：実線、破線、または点線。
-
Edge:角丸または鋭利な角。
-
3.6 プレゼンス
実行時の表示を制御：
-
表示可能： フィールドが表示され、レイアウト スペースを占有します。
-
非表示（空き領域を保持）: フィールドは非表示ですが、レイアウト領域は保持されます。ルールエディターを使用して表示を動的に切り替える場合に便利です。
4. 使用方法
表示する値が次の場合は、バインドされていない変数を使用します。
-
ルールまたはスクリプトによって計算されます。例えば、合計、税計算、他のフィールド値から派生した割引額などです。
-
プログラムで生成された — バックエンド ロジックによって実行時に割り当てられた参照番号またはトラッキングコードなど。
-
データモデルで使用できません。例えば、画面上では意味のある中間結果がスキーマフィールドとして存在しないなど。
-
条件付き表示 – 特定の条件が満たされた場合にのみ、計算されたメッセージまたは値を表示し、ルールエディターを使用して表示と値を一緒に設定します。
連結されていない変数は、サブフォーム、レイアウトコンテナ内、またはデザインキャンバス上に直接配置できます。 ルールエディターと組み合わせて、IC内の他のバウンドフィールドに基づいて値を計算する式を作成します。
5. ベストプラクティス
-
印刷出力と読み取り専用プレビューで、計算された値が使用できない場合に空白フィールドが表示されないように、意味のある予約値を設定します。
-
データ型を出力と一致させます。通貨金額を計算する場合は、データ型を数値に設定し、数値の表示パターンを適用します。日付を計算する場合は、日付に設定し、ISO 8601入力を確保します。
-
明確なキャプションを使用 – 値が計算され、ラベルから直接認識できないため、説明的なキャプション（例：「小計（計算済み）」）を使用すると、レビュー担当者とエンドユーザーの両方の混乱を防ぐことができます。
-
モデルに属するデータに対してバインドされていない変数を過剰に使用しない – 値をフォームデータモデルに合理的に追加できる場合は、標準フィールドをバインドすることを好みます。 実際に一時的または派生的な値に対して、非連結変数を予約します。
-
式を文書化する — ルールエディターにコメントを追加して、バインドされていない各変数が何を計算するかを記述します。これにより、ICが後で編集されるときにロジックが維持されます。
関連トピック
- テキストボックスコンポーネント — テキスト値の表示パターン構文
- 数値フィールドコンポーネント – 数値および通貨値のパターン構文を表示
- 日付フィールドコンポーネント – 日付の表示パターン構文
- 日付/時刻フィールドコンポーネント – 日付と時刻を組み合わせた値の表示パターン構文
- インタラクティブ通信エディターでルールエディターを使用 – 式を書き込んで値を計算し、バインドされていない変数に割り当てます
- インタラクティブ通信エディターでのデータバインディングの設定