get2SValues( )
tableInstanceパラメータに基づいて、2セクション・フォームの指定された変数または2セクション・フォームの表の変数の値を取得します。
2セクション・フォーム・インスタンスから単一の値をフェッチする場合は、getQuestionValue( )を検討してください。
構文
get2SValues(formInstance, tableRowInstance, ['var1', 'var2', 'varN'])
パラメータ
戻り値
次の値を使用して、(param2で渡されたものと同じ名前の)変数を含むJSONオブジェクトを返します:
- 返される変数値は、変数が部分的な日付の場合はC1Dateオブジェクト、変数が完全な日付の場合はDateオブジェクトです。これを確認するには、isPartialDate( )関数を使用します。
-
変数が選択制御(チェックボックス、ラジオまたはドロップダウン)である場合、返される変数値はJSON形式(
"[{\"value\":\"3\",\"label\":\"TestLabel\"}]"
)です。これは、JSON.parse
またはヘルパー関数parseChoice( )を使用して解析できます。parseChoice(rfData.v4_chk4))
JSON.parse(rfData.v4_chk4))
- 戻りオブジェクトには
exists
という名前のプロパティがあり、渡された変数のいずれかに2セクション・フォーム・インスタンス番号で渡された値がある場合、trueを返します。
Example 3-77 Get values for three item variables in AE form instance #1, and put them to a text item
// Get values for 3 item variables in AE form instance #1, and put them to a text item
var rfData = get2SValues(1, null, ['aeTerm','aeDate','aeSerious'] );
if(rfData.exists){
return rfData.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
var rfData = get2SValues(1, 2, ['aeTerm','aeDate'] );
if(rfData.exists && rfData.aeTerm && rfData.aeDate){
return rfData.aeTerm + " | " + rfData.aeDate.getFullYear() ;
} else {
return;
}
親トピック: 2セクション・フォーム関数