getRFValues( )

繰返しフォーム・インスタンスの指定されたアイテムの現在の値を取得します。

構文

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

繰返しフォーム・インスタンスから単一の値のみをフェッチする場合は、getQuestionValue( )も考慮してください。

getRFValues(formInstance, ['var1', 'var2', 'varN'] )

パラメータ

ノート:

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

パラメータ	必須/オプション	説明
`formInstance`	必須	値の取得元のフォームのインスタンス番号。このパラメータは、JavaScript変数にすることも、数値にすることもできます。
`isNullConsidered`	オプション	値を取得するために一重引用符を使用して渡されるアイテム変数名。

戻り値

変数を含むJSONオブジェクト(2番目のパラメータで渡されたものと同じ名前)を値とともに返します。

変数が部分的な日付の場合、返される変数値はC1Dateオブジェクトになります。または、変数の完全な日付の場合、変数値はDateオブジェクトになります。これは、次に示すようにisPartialDate( )関数を使用してチェックできます。
変数が選択コントロール(チェックボックス、ラジオ・ボタンまたはドロップダウン)である場合、返される変数はJSON形式("[{\"value":\"3\",\"label\":\"TestLabel\"}]")になります。これは、JSON.parseまたはparseChoice( )を使用して解析できます。
- parseChoice(rfData.v4_chk4))
- JSON.parse(rfDate.v4_chk4))
リターン・オブジェクトにはプロパティ名'exists'があり、渡された変数のいずれかにリピート・フォーム・インスタンス番号で渡された値がある場合、trueを返します。

例)

例3-60 AEフォーム・インスタンス#1の3つのアイテム変数の値を取得し、テキスト・アイテムに配置

varrfData = getRFValues(1, ['aeTerm','aeDate','aeSerious'] );
if(rfData.exists){
    returnrfData.aeTerm + "  | "  + rfData.aeDate.getFullYear() + " | "+ JSON.parse(rfData.aeSerious)[0].label;
} else{
    return;
}   


// It is best practice to check if the variable has value before using it
varrfData = getRFValues(1, ["aeTerm","aeDate"] );
if(rfData.exists && rfData.aeTerm && rfData.aeDate){
    returnrfData.aeTerm + "  | "  + rfData.aeDate.getFullYear() ;
} else{
    return;
}

親トピック: 繰返しフォーム関数