get2SValues( )

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

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

構文

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

パラメータ

注意:

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

パラメータ	必須/オプション	説明
`formInstance`	必須	値の取得元のフォームのインスタンス番号。このパラメータは、JavaScript変数にすることも、数値にすることもできます。
`tableRowInstance`	オプション	値を取得する2セクション・フォームの表のインスタンス番号。2セクション・フォームのフラット部分から値を取得する場合は、このパラメータをnullにする必要があります。このパラメータには、JavaScript変数または数値を指定できます。
`isNullConsidered`	オプション	値を取得するために一重引用符を使用して渡されるアイテム変数名。

戻り値

次の値を持つ変数(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-78 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;
}

親トピック: 2セクション・フォーム関数