ListRFInstances( )

繰返しフォームのすべてのインスタンス番号をリストします。ルール式でこのヘルパー関数を使用して、繰返しフォームの特定の質問値のインスタンスをチェックできます。

これは集計関数です。ターゲットが繰返しフォームにある場合は、各フォーム インスタンスに対してルールが実行されます。

構文

ListRFInstances('variable',includeDeleted)

パラメータ

注意:

この関数に渡された変数は、ルール式内の他の場所でも再使用できますが、一重引用符を使用して変数をパラメータとして追加する必要があります。

パラメータ	必須/オプション	説明
variable	必須	検索する品目変数。一重引用符を使用して渡されます。
includeDeleted	オプション	削除されたレコードが出力に含まれるかどうかを示します。 0 - 削除された繰返しインスタンスをリターン配列に含めません。これは、値が指定されない場合のデフォルトです。 1 - 削除された繰返しインスタンスを配列数に含めます。

戻り値

繰返しフォーム・インスタンス番号の配列。

例)

例3-55 AEフォーム・インスタンス#3が存在しない場合の問合せの呼出し

// Raise a query if AE form instance #3 does not exist
var arrAE = ListRFInstances('onDate', 0);
return (arrAE.indexOf(2) == -1)?false:true;

注意:

この例では、配列が位置0から始まるため、.indexOf(2)は3番目のフォーム・インスタンスと等しくなります。

例3-56指定されたフォーム・インスタンス番号が存在しない場合、変数を使用して問合せを呼び出します

// Raise a query if current form instance number does not exist
var curInst = GetCurrentRFInstance();
var arrAE = ListRFInstances('onDate', 0);
return (arrAE.indexOf(curInst.intValue()) == -1)?false:true;

注意:

ListRFInstances()でJavaScript indexOf()メソッドを使用するときに渡される変数は、検索が正しく機能するように、intValue()を使用して整数に変換する必要があります。