主题对象

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

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

提示：

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

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

使用提示

使用点表示法访问对象属性时，最好检查属性是否已定义，以避免在 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`	指明受试者筛选失败的日期，无论是人工屏幕失败还是站点用户编辑受试者的屏幕失败日期 automatically.If，此属性的值也会更新。默认情况下，所有日期都以标准 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`	指明将主题分配给的地点所在国家（地区）的主要区域。在研究的“研究设置”选项卡上定义国家/地区的区域。

父主题：开始制定规则之前