getCurrentVisitPropertyValue( )

控制不同访问时的规则行为。例如,如果对表单中的问题创建了规则,并且该表单与多个访问关联,则只能对研究中的某些访问(而不是所有访问)提出查询。

默认情况下,对包含表单的研究中的每个访问执行规则。声明变量时,访问字段:
  • 如果在访问字段中保留 -All Visits-,则将从运行规则的当前访问中的表单中检索变量数据。
  • 如果选择特定访问,例如“筛选访问”,则将从指定访问中的表单检索变量数据,在这种情况下,对于执行规则的每个访问,都会检索筛选访问。
您将此帮助程序函数用于仅针对特定访问应用和执行的规则。

语法

getCurrentVisitPropertyValue('propertyName')

参数

propertyName

propertyName 用单引号引起来。propertyName 可以是以下任意一项:

  • 标题
  • 访问 ID
  • 事件类型

根据访问设计时间,eventtype 值可以是以下值之一:ScreeningVisitScheduleAbleVisitSubjectWithdrawalVisitSubjectCompletionVisitUnScheduleAbleVisitEventAdverseEvent

返回值

返回当前访问属性。

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

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