getCurrentVisitPropertyValue( )

获取当前访视的给定属性名称的属性值。访问属性可以是其标题、ID 或事件类型。

您可以将此帮助程序功能用于仅针对特定访问应用和执行规则，从而控制不同访问上的规则行为。例如，如果对表单中的问题创建了规则，并且该表单与多次访问关联，则只能对研究中的某些访问（而不是所有访问）提出查询。

默认情况下，对包含表单的研究中的每个访问执行规则。声明变量时，访问字段：

• 如果在访问字段中保留 -All Visits-，则将从运行规则的当前访问中的表单中检索变量数据。
• 如果选择特定访问，例如“筛选访问”，则将从指定访问中的表单检索变量数据，在这种情况下，对于执行规则的每个访问，都会检索筛选访问。

有关详细信息，请参阅定义规则变量。

语法

getCurrentVisitPropertyValue('propertyName')

参数

参数	必选/可选	说明
propertyName	必需	要检索的访问属性的名称。可以是以下任何一项（包括引号是必需的）： 'title' 'visitid' 'eventtype'

返回值

返回当前访视的给定属性。

根据访视设计，事件类型属性值可以是以下值之一：

• ScreeningVisit
• ScheduleAbleVisit
• SubjectWithdrawalVisit
• SubjectCompletionVisit
• UnScheduleAbleVisit
• 事件
• AdverseEvent

示例

示例 3-81 获取当前访问的提供的属性的属性值

// Returns (short-name) the current visit property 'visitid':
return getCurrentVisitPropertyValue('visitid')
  
// Returns (name) the current visit property 'title':
return getCurrentVisitPropertyValue('title')
 
// Returns event-type of the visit - will be one of the following "ScreeningVisit","ScheduleAbleVisit","SubjectWithdrawalVisit","SubjectCompletionVisit","UnScheduleAbleVisit","Event","AdverseEvent"
return getCurrentVisitPropertyValue('eventtype')
 
 
// Example to demonstrate functionality based on current visit
if(getCurrentVisitPropertyValue ("visitid")==='visit1'){
    //add visit1 functionality here
}
else if(getCurrentVisitPropertyValue ("visitid")==='visit2'){
    //add visit2 functionality here
}
else{
    //else functionality
}