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) == -1)?false:true;