自定义规则的快速启动

创建新规则

1 先决条件

在开始使用规则之前，必须先在测试容器中有一个包含以下元素的研究版本：

表单
访问（包含表单）
主题
与放置在测试容器中的研究版本关联的站点

2 访问规则编辑器

在主页上，单击要处理的研究的“测试模式”按钮。
在顶部，确保选择了受试者。
如果您可以访问研究的多个试验机构，请从右上角的试验机构下拉列表中选择一个试验机构。
在表中，找到并单击要编辑的访问卡。
在访问窗口的左侧，单击要为其创建规则的表单。
选择应包含规则的问题。在右侧，展开规则窗格，然后单击添加规则。

3 添加规则

在规则编辑器中，填写以下字段，然后单击下一步：

规则名称：输入规则的名称。每个名称在研究中必须唯一。
说明：输入规则的简要说明。此字段不是必填字段，但可以帮助您区分每个规则及其在研究中的用途。这在要重用规则时很有用。
不阻止用户：如果要允许网站用户在规则运行时编辑和保存表单而未被阻止，请打开此开关。

为规则定义变量：

单击变量旁边的加号 (+) 以添加变量。
在第一个字段中，输入变量名称。
从每个下拉列表中选择访问、表单和项。
提示：对包含表单的研究中的每个访问执行规则。如果在访问字段中保留 -All Visits，则将从运行规则的当前访问中的表单中检索变量数据。如果选择特定访问，则将从执行规则的每个访问中指定访问中的表单检索变量数据。
对要创建的每个新变量重复步骤 a、b 和 c。

在表达式字段中，输入将求值结果为值的 JavaScript 表达式。
请参阅规则开发人员指南以概述可以编程的规则。
从操作下拉列表中，选择希望规则生成的响应类型：

选择创建查询可在每次规则表达式返回的值为假时自动生成查询。此外，输入查询消息供用户查看。
选择创建分配的查询可将查询分配给特定研究角色。单击文本框以选择一个或多个学习角色，然后在右侧输入查询消息。
注：“角色”下拉列表仅包含已在研究中创建的学习角色。不包括模板学习角色。
阅读逐步说明为自动查询创建规则。
如果希望系统自动计算值并使用结果填充只读项，请选择计算值。您还必须为计算的值选择目标类型（文本或数字）和格式。
阅读分步说明以为计算的值创建规则。
选择发送通知以向特定用户发送电子邮件通知。输入主题行、以分号分隔的电子邮件地址和要发送的消息。
阅读分步说明以创建规则以发送电子邮件通知。

单击保存。
注意：如果规则表达式包含语法错误，则规则编辑器会将其标记为要更正。在将其提升为 UAT 和批准之前，规则必须包含有效的表达式和至少一个操作。

4 调试规则

在规则编辑器中创建规则时，根据需要添加日志语句。
提示：要编辑现有规则，请单击菜单图标，然后选择“编辑”。
有关如何正确使用日志帮助程序函数的更多信息，请参见 logMsg() helper function 。
单击调试，这将自动保存对 JavaScript 表达式所做的更改。
查看右侧显示的日志窗口。
在 JavaScript 表达式按预期工作之前对其进行任何必要的更改。
单击保存。
阅读分步说明和详细信息以调试规则。

规则示例

比较两个值

在本例中，使用重要符号表单从主题收集重要符号信息。规则将用于通过比较代谢读数和代谢读数来计算主体的血压，如果代谢读数大于代谢压力，则生成查询。

使用其变量名称来评估尿素血压是否大于系统血压，并返回 False 以引发查询。然后选择创建查询作为操作并输入查询消息：


                    if(bpdia > bpsys)
    return false;

return true;

计算 BMI

在本例中，使用重要符号表单从主题收集重要符号信息。规则将用于通过从表单读取权重和高度来将 BMI 显示为只读值。

通过从表单添加变量来计算 BMI，并将 BMI 公式返回为只读项，然后选择计算值作为在表单上显示计算值的操作：


                    if((weight === 0) || (height === 0)){
    return 0;
} else {
    return weight / (height * height);
}

已知同意日期必须在某个日期范围内

对于此示例，筛选表单用于收集知情同意的日期。此规则用于计算日期是否在某个范围内，如果日期超出定义的参数，则创建查询通知。

使用 "isDateInRange()" 帮助函数评估通知同意日期是否在参数内。返回 False 以引发查询，然后选择创建查询作为操作并输入查询消息：


                    var dateFrom = new Date("March 1, 2020");
var dateEnd = new Date("March 30, 2020");

return isDateInRange(dateInformedConsent, dateFrom, 
dateEnd, "both");

注：请参阅规则开发人员指南中的其他规则示例。

测试和发布

1 测试和批准规则

您需要在将规则发布到“生产”之前测试并批准该规则。

在主页上，单击要参与的研究的“测试模式”按钮。在顶部，确保选择了受试者。
如果您可以访问研究的多个试验机构，请从右上角的试验机构下拉列表中选择一个试验机构。
在表中，找到并单击要编辑的访问卡。
在访问窗口的左侧，单击要测试和审批规则的表单。
输入包含规则的问题值。
单击保存。
重复步骤 6 和 7 以测试所有可能的方案。如果规则为所有方案生成预期结果：
1. 在规则窗格中，单击规则名称旁边的规则状态图标以显示状态滑块。
2. 将滑块从 UAT 移动到已批准。
  注：单击菜单图标（菜单图标），然后选择查看以查看只读模式中的规则详细信息。

2 发布一个或多个规则

可通过两种方式发布规则：一次发布一个规则或一次发布多个规则。

在主页上，单击要处理的研究的“测试模式”按钮。
在顶部，确保选择了受试者。
如果您可以访问研究的多个试验机构，请从右上角的试验机构下拉列表中选择一个试验机构。
在表中，找到并单击要编辑的访问卡。
在访问窗口的左侧，单击包含要发布的规则或规则的表单。
在“Rules（规则）”窗格顶部，单击“Form（表单）”切换“All Rules（所有规则）”。
在规则窗格中，单击“表单”切换按钮中的查看所有规则。
单击“发布所有已批准规则”。
注意：仅当研究已在“已批准”容器中时，才能按照步骤 6 和 7 在“生产”中发布规则。否则，需要将研究从“测试”移到“批准”以在“生产”中发布所有规则。

3 修改和重新发布已发布的规则

您可以修改已发布的规则并根据需要重新发布。如果在测试模式下修改已发布规则，则在将该规则的状态更新为已发布之前，更改不会在生产模式下显示。

在主页上，单击要处理的研究的“测试模式”按钮。
在顶部，确保选择了受试者。
如果您可以访问研究的多个试验机构，请从右上角的试验机构下拉列表中选择一个试验机构。
在表中，找到并单击要编辑的访问卡。
在访问窗口的左侧，单击要为其修改已发布规则的表单。
在规则窗格顶部，单击“表单”切换中的所有规则。
选择包含该规则的问题。
在右侧，展开规则窗格，单击菜单图标。
选择编辑。
在规则编辑器中，进行更改。单击保存。
注意：规则的状态将更新为拟定。当前在生产中发布的规则不受此更改的影响。如果要重新开始，则始终可以删除状态为拟定的规则。