主题对象

“主题对象”提供对未直接收集到表单中的主题信息和其他数据的访问权限，因此您可以将其包括在规则的处理中或作为返回值。

有时，规则的逻辑可能需要引用未在表单中收集的数据，例如主题编号和状态，或与站点相关的信息。“主题对象”对于未包括在任何表单中的数据具有不同的属性。您可以使用“主题对象”及其属性进行规则处理，也可以作为计算值的结果。

提示：

最后一个方案可用于运行“显示访问”、“显示表单”和“显示问题”预定义规则，或者用作包括访问分支的表单问题。

所有这些属性将始终返回当前值。这意味着，如果对主题有任何更改，将覆盖旧数据并返回新数据。此外，对“主题对象”返回的值所做的更改不会触发规则运行或重新运行。由于规则在数据提交时运行，因此必须引用表单项变量，以在规则发生更改时触发规则运行以符合指定标准。

使用提示

• 使用点表示法访问对象属性时，最好检查属性是否已定义，以避免在 null 时出现代码故障。例如：

  if(Subject.SubjectNumber){
      var subnumber = Number(Subject.SubjectNumber.substring(10));
  }

• 预测文本功能在您键入时可用，其中包含这些属性的说明以及所有可用的规则帮助程序函数。请参阅使用预测文本编写规则。

主题对象属性

注意：

其中一些属性允许访问潜在的非盲信息。请谨慎使用它们以及分配的查询和数据分类（如果适用）来限制对此信息的访问。

属性	说明
SubjectNumber	指明分配给受试者的编号。
SubjectStatus	指明受试者的当前状态。可以显示以下状态： 新建 Screening_Initiated Screen_Failed（当站点用户手动将主题标记为筛选失败时） Auto_Screen_Failed（当受试者在系统中自动筛选失败时） 已入组 活动 已撤回 完成
ScreeningDate	指明筛选受试者的日期。默认情况下，所有日期都以标准 00:00 GMT 时间返回。
ScreenFailureDate	指明受试者筛查失败的日期，无论是人工还是自动进行筛查失败。默认情况下，所有日期都以标准 00:00 GMT 时间返回。 注： 如果手动输入屏幕故障的日期与系统日期不同，则会返回手动输入的值。 在 24.1 发行版之前自动筛选的主题不会返回 ScreenFailureDate 的日期。
CompletionDate	指明受试者完成研究中的所有访视的日期。默认情况下，所有日期都以 GMT 时间返回。
WithdrawalDate	指明受试者从研究中撤消的日期。默认情况下，所有日期都以标准 00:00 GMT 时间返回。
RandomizationDate	指明以下任何事件的日期： 当受试者随机化时，随机化编号是否随后更改。 当受试者重新随机化时。 默认情况下，所有日期都以标准 00:00 GMT 时间返回。 注： 如果 Oracle Clinical One Platform 外部出现手动随机化，则返回 Oracle Clinical One Platform 中受试者随机化的日期，而不是 Oracle Clinical One Platform 外部发生手动随机化的日期。
TreatmentArm	指明受试者的治疗组 ID（也称为简称）。 注意： 可能会失明。 注： 在其 ID 上包含反斜杠 ("\") 的处理组不能作为规则中的文本引用。可以使用 logMsg() 语句验证检索到的字符串，请参见 Debug a rule 。
CohortName	指明受试者所属的同届的名称（如果适用）。
SiteNumber	指示将主题分配到的站点 ID，如机构 ID 字段中创建组织：机构对话框中所指定。
SiteName	指示将主题分配到的站点名称，如“机构名称”字段中的“创建组织：机构”对话框中所指定。
Country	指明为主题分配到的地点指定的国家（地区）的 ISO 代码。 此值在“库”页上的“地理位置”系统代码列表中定义。
Region	指明将主题分配给的地点所在国家（地区）的主要区域。 在研究的“研究设置”选项卡上定义国家/地区的区域。