get2SValues( )

2セクション形式の指定された変数、またはtableInstanceパラメータに基づいて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を返します。

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

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