UI式言語
UI式言語を使用すると、基本要素UI項目の関連付けられたモデル・ノード属性に従って、基本UI要素のテキスト・パラメータの値を動的に作成できます。
構文
各式には、モデルのノードを参照する予約済キーワードが含まれます。 モデルのノード上の属性を参照する名前で修飾します。 たとえば:
The node named #{amn.name} has a maximum quantity of #{amn.maxQuantity}.
-
各式を
#{
(ポンド記号および左中カッコ)で開始し、}
(右中カッコ)で終了する必要があります。 -
amn
キーワードは、UI基本要素のモデルのノードへの参照を作成します。 -
各式では、
amn
キーワードを含め、大文字と小文字が区別されます。 -
amn
キーワードは、常にモデルのノードの属性への参照で修飾する必要があります:#{amn.referenceName}
-
有効な属性を参照する必要があります。 有効な属性は、コンフィギュレータ・モデル・ノード・プロパティのユーザー補助に列挙されます。 属性が無効な場合、式で使用しようとすると、コンフィギュレータはエラーを作成します。
-
UI式の属性参照は、属性名の先頭文字を小文字にすることで形成されます。 プレフィクス
Is
およびHas
は、式参照から省略されます。
次の表に、UI式言語の属性参照の概要を示します。
UI式言語リファレンス |
参照先 |
式の例 |
---|---|---|
|
関連付けられたモデル・ノードの名前。 |
|
|
関連付けられたモデル・ノードの説明。 |
|
|
関連付けられたモデル・ノードの数量。 |
|
|
IsBoundQuantityのような名前の属性 |
|
|
HasChildrenのような名前の属性 |
|
|
トランザクション属性の値(関連付けられたモデル・ノードがルート・モデル・ノードの下の属性である場合)。 |
|
|
名前付きサプリメンタル属性の値。 |
|
|
指定されたユーザー定義属性の値。 |
|
UI式言語の制限事項
UI式の言語式には、次の制限が適用されます。
-
式では大文字と小文字が区別されます。
-
式属性の参照は、関連付けられたモデル・ノードに対して有効な属性である必要があります。 この検証は、要素に関連付けられたモデル・ノードを変更した場合にも適用されます。
-
式言語は、すべてのモデル・ノード・システム、ユーザーおよび補足属性で使用できますが、基本UI要素のテキスト・パラメータに対してのみ使用できます。 基本的なUI要素は次のとおりです: テキスト、イメージ、スペーサおよびIFrame。 テキスト・パラメータは次のとおりです: テキスト、インライン・スタイル、スタイル・クラスおよびURL。
-
コレクションまたはリストの要素への参照が無効です。 無効な参照の例:
#{amn.children[0].name}
。 -
トランザクション品目属性への参照は、基本UI要素の関連モデル・ノードがモデルのルート・ノードの下にあるトランザクション属性である場合にのみ有効です。 有効な参照式:
#{amn.value}
。 -
関連付けられたモデル・ノードの属性値が実行時に使用できない場合、表示される値は空白です。 属性値が使用できないために、式を実行時に評価できない場合、表示される値は
N/A
です。
UI式言語の一般的な用途
通常は、UI式言語を使用して次のことを行います:
-
ユーザー・インタフェース・ページでテキスト基本UI要素を作成し、関連付けられたモデル・ノードの最小値と最大値を動的に表示します。 例:
Min: #{amn.minValue} Max: #{amn.maxValue}
-
問合せパラメータを提供するためにIFrameのURLが動的に拡張されるIFrame基本UI要素を作成します。 例:
https://www.mysite.com:1000/perform?taskID=#{amn.value}
-
カスケード・スタイル・シート(CSS)の中央セットをノードの補足属性に格納し、式言語を使用して、基本的なUI要素のインライン・スタイル属性からCSSを一般的に参照します。 例:
#{amn.suppAttr['InlineStyle']}