配置预定义的验证规则以引发查询

现在,您可以配置在表单设计中添加的预定义验证规则,以验证答案、提出查询或同时验证两者。

关于此新功能

研究设计者通常将预定义的规则添加到表单设计中,以验证答案、确保满足给定标准或触发特定操作(例如显示动态问题或表单或发送通知)。使用定制 JavaScript 规则可以涵盖其他方案,这些规则由规则设计者进行编程和测试。

此增强功能专为添加到表单设计的预定义验证规则启用查询功能。因此,当未满足验证标准时,您的团队不再需要创建定制规则来提出查询。这样可以减少应用此类规则所需的潜在编程错误和时间。此外,验证功能现在是可选的,还有添加的查询功能。这意味着您现在可以在表单上创建规则,其作用如下:
  • Validation(验证),该操作会引发错误并阻止站点用户执行随机化和试验供应管理 (RTSM) 操作,直到错误得到解决。
  • 作为查询引发的验证,这也会阻止 RTSM 操作。但是,在这种情况下,您可以关闭相关查询以允许受影响的 RTSM 操作继续,而无需先解决验证错误。
  • 简单查询,用于标识不符合给定的数据审核者标准但不影响 RTSM 操作的答案。这些引发的查询将遵循正常的查询工作流。
可以受验证规则影响的 RTSM 操作包括筛选、随机化和分配。特定 RTSM 操作是否受到影响取决于问题设置以及这些事件是否需要该操作。此发行版中还引入了一项新功能,它能够根据需要确定特定 RTSM 操作的特定问题。请参阅改进数据收集和随机化以及试用供应管理 (RTSM) 的数据录入工作流

研究设计者的详细信息

如果您是研究设计者,使用预定义的验证规则,以下是您的新增功能:
  • 在表单设计中添加或更新验证规则时,您现在可以使用两个配置切换:验证创建查询
  • 您必须为验证规则激活至少一个切换,或者可以同时激活这两个切换。根据规则配置,结果可能不同:
    配置 结果
    验证

    不符合规则标准的答案将变为无效,并且可能会影响 RTSM 操作。

    无效答案包括红色大纲和错误消息,错误消息由研究设计者在规则配置中定义。

    创建一个查询

    对于无法满足规则标准的答案,会引发查询,但它们不是无效的,并且不会影响 RTSM 操作。

    仅在保存和提交数据后才会显示查询。但是,在输入数据时,答案周围会出现一个红色大纲,并显示一条错误消息(如验证中),以告知站点用户失败的标准,并让他们有机会在保存答案之前更正答案(如果适用)。如果提交了数据并引发了查询,则失败的验证指示器将消失。

    验证创建查询

    如果答案不符合规则标准,则该答案将变为无效,并在其上引发查询。RTSM 操作可能也会受到影响。

    如果输入的数据不符合验证标准,则在输入数据时将显示红色大纲和错误消息。然后,将引发查询,但仅提交一次数据。由于答案无效,失败的验证指示器将保留。

  • 您仍可以向同一问题添加多个验证规则,这些问题将使用逻辑运算符 ANDOR 进行求值。可以在单个问题中组合以不同方式配置的规则(仅验证、仅查询或两者),但不能组合逻辑运算符。

在升级发行评估环境 (RAE) 之后,您可以在研究设计器用户指南中找到有关此功能的更多信息。

站点和其他赞助商用户的详细信息

无论您是处理所收集数据的验证错误的站点用户,还是审查数据和管理查询的申办者用户,以下是您的工作流可能受到此新功能的影响:
  • 如果在数据收集过程中触发了其中的任何规则,站点用户可以选择更正输入的数据并解析这些规则。对于引发的查询,站点用户还可以为其提供答案,例如,当它不适用于更新输入的数据时。之后,如果申办者用户关闭查询,将解析验证。
    有权关闭编程和手动查询的任何用户也将能够关闭这些类型的查询。

    注:

    如果一个问题存在多个查询,则可能有些是验证,有些不是。
  • 将多个验证规则添加到问题时,处理这些条件的方式以及错误消息的显示方式存在差异:
    • 对于 OR 条件之后的多个规则,验证规则将全部求值,直到满足一个验证或全部求值并失败为止。由于 OR 条件仅在所有验证失败时才会失败,因此在这种情况下将显示所有关联的错误消息或查询。然后,如果至少解决了一个错误或查询,则会满足 OR 条件,所有错误都将消失并关闭触发的查询。
    • 对于 AND 条件之后的多个验证,系统将评估所有规则。如果任何条件失败,则整个条件将失败,并且会为每个失败的验证显示一条错误消息或查询。在解决所有错误或查询之前,问题将保持失败状态。
  • 如果手动关闭查询,则不会重新评估查询,除非更新数据,即使更新规则并使用高级研究版本控制 (ASV) 应用更改也是如此。更新数据时,将始终重新评估预定义的验证规则。
  • 与任何其他查询一样,预定义验证规则产生的这些查询是可见的,可以从查询侧窗格、访视中以及从查询列表页面管理,以进行研究级别的查询管理。这些查询也包含在“查询”报告中,它们以自动计算作为发出用户随处显示。
  • 日期/时间问题的将来日期验证不完全是设计器验证规则。但是,它们现在也作为查询触发。有关详细信息,请参阅将来日期现在在不允许的情况下提出查询

对报告的影响

预定义的验证规则现在包含在规则报表中,但与自定义规则不同。为了支持此功能,规则报告现在以 XLSX 格式(而不是 CSV 格式)提供,该格式将所有验证规则包含在称为设计器验证规则的单独选项卡中。在 PDF 和 HTML 格式的输出中,表单设计中添加的所有这些预定义验证规则都具有相同名称的新部分。有关更多信息,请参见 Rules report is now available in XLSX format

此外,还会对其他报告进行其他更改,以支持此增强功能。引入了以下报告更改:
报告 更改类型 说明
研究设计报表 修改后的列数据

在表单的验证规则列中,对于在表单设计中添加的验证规则,类型(验证验证和查询查询)将附加到现有信息的正面。

例如: Validation and Query:Exactly 1

带注释的 CRF 报告 修改后的列数据

Validations(验证)列中,对于在表单设计中添加的验证规则,类型( Validation(验证)Validation and Query(验证和查询)Query(查询))将附加到现有信息前面。

例如:规则 1:验证和查询:完全 1

规则报表 新部分和列

预定义的验证规则包括在此报表中、新的设计器验证规则部分或选项卡中(取决于格式)。

有关添加到本节的列的详细信息,请参阅规则报告文档。

查询报告 新建列

添加新的类型列以指示其是否具有验证功能(验证和查询)、由自定义规则(自动查询)生成,还是手动查询(手动)。

已经在现场学习了?

发布此新功能时,现有验证规则将仅配置 Validation(验证)切换为活动状态,以保留现有功能。只要此发行版可用,您就可以创建新的验证规则,以创建查询或随时更新查询,从而将查询功能添加到现有规则。

您可以使用高级研究版本控制 (ASV) 将这些更新或任何更新应用于预定义的验证规则。在 RAE 升级后的关于高级研究版本控制中,查找有关将此新功能与 ASV 一起使用的影响的更多信息。