一般値の置換の構文

Info*Engine の置換定義式は必ず $( と ) で区切られています。この区切り記号内で、置換を行うグループおよび属性を以下のように指定します。

VDB 内のグループに名前を付けます。このグループには、@FORM のようなコンテキストグループか、またはタスクの実行によって作成されたデータグループを指定できます。

選択したグループ内の要素 (行) を識別します。セレクタを以下に示します。

◦ 整数。インデックスによって要素を識別します。最初の要素のインデックスは 0 です。したがって、グループに 10 個の要素がある場合、インデックスの範囲は 0 ～ 9 となります。

◦ 文字 N。グループの最後の要素を選択します。

◦ 空。要素をすべて選択して、セパレータを使用せずに 1 つの文字列に連結します。空セレクタは通常、要素が 1 つだけの場合に使用されます。

◦ META。要素を選択するのではなく、グループからメタデータを選択します。

◦ アスタリスク (*)。要素をすべて選択し、1 つの文字列に連結します。セミコロンで文字列の要素を区切ります。

◦ attribute=value として指定された属性と値のペア。Info*Engine は、指定した属性の指定値があることが判明した最初の要素を選択します。たとえば、grp1 グループに name および phone 属性が含まれているとします。Doyle という名前の従業員の電話番号を検索するには、以下の置換定義式を使用します。

META が element_selector に指定されている場合は、以下のいずれかの属性を attribute_name について指定できます。

◦ COUNT はグループ内の要素の数です。

◦ STATUS はグループに現在関連付けられているステータス値です。ステータス 0 は成功を意味します。0 以外のステータスは失敗を意味します。

◦ NAME はグループの名前です。

◦ TYPE はグループのタイプです。グループの作成者は、TYPE 属性のメタ値を設定できますが、これは必須ではありません。有効なグループのタイプを以下に示します。

▪ Status -- リクエストの成功または失敗が含まれているグループ。

▪ Exception -- 例外発生時に生成されるエラー情報が含まれているグループ。

▪ Unknown -- グループの作成者が、その TYPE 情報を設定しなかったグループ。

◦ MESSAGE はグループに関連付けられている現在のメッセージです。グループに関連付けられたメッセージがない場合、置換は空の文字列となります。MESSAGE メタデータから複数のメッセージを読み込むことができます。たとえば、Grp123 と関連付けられているメッセージをすべて取得する場合は、以下の置換定義式を使用できます。

さらに、attribute_name についてグループで定義されていれば、どのメタデータ属性でも指定できます。

◦ 整数。インデックスによって値を識別します。最初の要素のインデックスは 0 です。したがって、グループに 5 個の要素がある場合、インデックスの範囲は 0 ～ 4 となります。

◦ 文字 N。属性の最後の値を選択します。

◦ 空。値をすべて選択して、セパレータを使用せずに 1 つの文字列に連結します。空セレクタは通常、値が 1 つだけの場合に使用されます。

◦ アスタリスク (*)。値をすべて選択し、1 つの文字列に連結します。コンマで文字列の値を区切ります。

以下の置換定義式では、@FORM グループの要素からすべての XYZ 値を選択して文字列に連結し、コンマを使用して値を区切ります。

以下の置換定義式によって、USERS グループの要素から最初の NAME 属性値を選択します。

以下の置換定義式によって、OUTGRP グループのメタデータから COUNT 値を選択します。

置換定義式の評価によって値が返されない可能性があります。これを防ぐには、定義式のデフォルトを組み込むようにしてください。以下の default 属性を param タグに組み込むことによってデフォルトを指定します。

たとえば、以下の param タグでは、ATTRIBUTE パラメータのデフォルトを文字列 "*" に設定します。