get2SValues( )

tableInstanceパラメータに基づいて、2セクション・フォームの指定された変数または2セクション・フォームの表の変数の値を取得します。

2セクション・フォーム・インスタンスから単一の値をフェッチする場合は、getQuestionValue( )を検討してください。

構文

get2SValues(formInstance, tableRowInstance, ['var1', 'var2', 'varN'])

パラメータ

formInstance

値を取得する2セクション・フォームのインスタンス番号。これは、JavaScript変数または数値です。

tableRowInstance

値を取得する2セクション・フォームの表のインスタンス番号。2セクション・フォームのフラット部分から値を取得する場合、このパラメータはnullです。このパラメータには、JavaScript変数または数値を指定できます。

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;
}