ListRFInstances( )

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

ノート:

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

構文

ListRFInstances('variable',includeDeleted)

パラメータ

variable

検索する訪問またはフォームに存在するアイテム。

ノート:

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

includeDeleted

• nullまたは 0 -削除された繰返しインスタンスは、戻り配列に含まれません。
• 1 -削除された繰返しインスタンスを配列カウントに含めます。

戻り値

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

例3-54 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-55指定されたフォーム・インスタンス番号が存在しない場合は、変数を使用して問合せを生成します。

// 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()を使用して整数に変換する必要があります。