getQuestionValue( )

为提供的项目路径返回单个问题值。项路径应为整个路径，并且应当包含 visitId、formId 和 itemId 的值。此函数从重复表单和平面表单的问题中提取值。

所有访问不能在变量定义中使用。如果要从单个函数调用中的重复表单实例提取多个值，请使用 getRFValues( ) 函数。

注意：

此规则不支持访问开始日期项。
这是聚合函数，如果目标位于重复表单上，则为每个表单实例运行规则。

语法

getQuestionValue('ruleVariable', eventInstanceNumber, formInstanceNumber, repeatFormNumber)

参数

注意：

如果缺少可选参数，则从规则目标上下文获取事件实例编号和表单实例编号。

参数	必选/可选	说明
`ruleVariable`	必需	要检索的变量。必须是规则变量（在规则编辑器中全局添加）。
`eventInstanceNumber`	可选	事件实例编号/周期实例编号。要引用非重复访问，请传递空字符串。
`formInstanceNumber`	可选	表单实例号。要引用非重复表单，请传递空字符串。
`repeatFormNumber`	可选	重复表单编号以引用两个部分表单上的项。

返回值

相应数据类型中的问题值，如果没有值，则为空。

注意：

即使已删除实例也会返回该值。

问题类型	返回的数据类型详细信息。
日期	如果变量是部分日期，则返回的变量值将是一个 `C1Date` 对象，如果变量是完整日期，则将是一个 `Date` 对象。有关其他信息，请参阅在自定义规则中处理部分日期。注：使用日期项时，必须包含空值检查。有关更多信息，请参见示例。
选择控件：复选框单选按钮下拉列表	返回的变量值是 JSON 格式的字符串： `"[{\"value\":\"3\",\"label\":\"TestLabel\"}]"` 可以使用 `JSON.parse` 或辅助函数 `parseChoice` 对此进行语法分析。 `parseChoice(result))` `JSON.parse(result))`

示例

示例 3-96 在 2 部分表单中使用 getQuestionValue

要将 getQuestionValue 用于 2 部分表单的表行中的项，语法为：

getQuestionValue('ruleVariable', eventInstanceNumber, repeatNumber, formInstanceNumber)

// Get a value from an item in a flat form
return (getQuestionValue('text1');
 
 
// Get a value from an item in repeating form instance #1
// Pass an empty string to eventInstance
return (getQuestionValue('text1', '', 1);
 
 
// Get a value from a flat form in unscheduled visit instance #1
// Pass an empty string to eventInstance
return (getQuestionValue('text1', 1, '');
 
 
// Get a date value from a flat form
var res = getQuestionValue('dt1');
if(res !== null) {
  return res.getFullYear();
} else {
  // do nothing
  return;
}
 
 
//In a 2-section form, get a value from Form 2, Table Row 3:
return getQuestionValue('v2', '', 3, 2);

父主题：多个访问计划和周期访问功能