get2SValues( )

根据 tableInstance 参数，以两节形式检索为表提供的双节形式或变量的变量值。

如果要从两部分表单实例中提取单个值，请考虑 getQuestionValue( )。

语法

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

参数

注：

允许在规则表达式的其他位置重复使用传递给此函数的变量，但是必须使用单引号将变量添加为参数。

参数	必选/可选	说明
formInstance	必需	您从中检索值的表单的实例编号。此参数可以是 JavaScript 变量，也可以是数字。
tableRowInstance	可选	要从中检索值的两部分表单表的实例编号。如果要从两部分表单的平面部分检索值，则此参数应为 null 。此参数可以是 JavaScript 变量或数字。
isNullConsidered	可选	使用单引号传入的项变量名称，用于检索值。

返回值

返回包含变量（与在 param2 中传递的名称相同）的 JSON 对象，其中包含以下值：

• 如果变量是部分日期，则返回的变量值为 C1Date 对象；如果变量是完整日期，则返回的变量值为日期对象。您可以使用 isPartialDate( ) 函数进行检查。

• 如果变量是选项控件（复选框、单选或下拉列表），则返回的变量值采用 JSON 格式：("[{\"value\":\"3\",\"label\":\"TestLabel\"}]")。可以使用 JSON.parse 或辅助函数 parseChoice( ) 对此进行语法分析。

  • parseChoice(rfData.v4_chk4))
  • JSON.parse(rfData.v4_chk4))
• 返回对象具有名为 exists 的属性，如果传入的任一变量具有以两节形式传递的实例编号的值，则返回 true。

示例

示例 3-78 获取 AE 表单实例 #1 中三个项变量的值，并将其放入文本项

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