事件操作是可配置的操作,当用户从文件上传创建文档、创建现有文档的新草稿、创建现有文档的副本或创建新的对象记录时会自动执行事件操作。例如,当用户创建新文档时,事件操作可以将审查到期日期设置为未来 15 天。
事件操作的定义与入口操作非常相似。它们:
- 存在于特定的生命周期内;它们并非特定于单个生命周期状态,而是特定于生命周期
- 有条件,可能基于文档或对象记录的字段值
- 使用“系统用户”执行,这意味着启动触发操作的用户不需要事件操作的特定权限
访问事件操作管理
您可以在相关生命周期内配置文档和对象记录事件操作:
- 对于文档,导航到管理 > 配置 > 文档生命周期 > [生命周期] > 事件操作。
- 对于对象记录,导航到管理 > 配置 > 对象生命周期 > [生命周期] > 事件操作。
文档操作类型
适用于文档的事件操作支持:
- 更新文档字段
- 这些操作基于配置的值或公式自动更新文档中的一个或多个字段。该操作可以更新文本、数字、选项列表、是/否、日期和日期时间字段类型。有关创建公式的详细信息,请参阅在 Vault 中创建公式。
- 设置格式副本配置文件
- 此操作根据您配置的条件选择特定的格式副本配置文件。
- eConsent 草稿
- 此操作仅在 Clinical Operations Vault 中可用。有关详细信息,请参阅配置 Veeva eConsent 创作 (Clinical Operations)。
文档的操作顺序
Vault 在文档创建过程结束时触发事件操作。由于此操作发生在应用了字段默认规则之后,因此事件操作是有条件的,可能基于用户设置的字段或基于使用默认规则设置的字段。
如何创建文档的事件操作
要添加新的事件操作规则:
- 从事件操作标签页中,单击特定事件。
- 在事件配置页面中,单击编辑。
- 单击创建事件操作。
- 可选:通过选择有条件地执行,将条件添加到事件操作规则。
- 在执行操作下方,选择操作的类型以及任何其他所需的值。其他值将取决于操作配置。
- 可选:通过单击添加操作在同一规则中创建多个操作。如果规则是有条件的,这些操作将具有相同的条件。
- 单击保存。配置的事件操作立即生效。
注意:Vault 不会对在文档迁移模式下通过 API 或 Vault 加载程序上传的文档执行事件操作。
对象记录操作类型
适用于对象记录的事件操作支持:
- 更新记录字段
- 这些操作基于配置的值或公式自动更新对象记录中的一个或多个字段。该操作可以更新文本、数字、选项列表、是/否、日期和日期时间字段类型。有关创建公式的详细信息,请参阅在 Vault 中创建公式。
- 启动工作流
- 这些操作会自动启动该对象记录的指定工作流。只有为自动启动配置的工作流可用。
对象记录的操作顺序
Vault 在对象记录的创建过程中如下所示触发事件操作:
- 在使用字段默认值之前执行更新记录字段操作。如果事件操作设置了字段值,Vault 会忽略为该字段配置的任何默认值,以免覆盖该值。了解有关对象字段默认值的运算顺序的更多信息。
- 在触发、使用字段默认值和更新记录字段操作后,执行启动工作流操作。
注意:如果这些事件操作因任何原因失败,将无法完成对象记录的创建。
如何创建对象记录的事件操作
要添加新的事件操作规则:
- 从事件操作节段中,单击创建记录事件。在 19R1 中,对于对象记录,事件操作仅支持此事件。
- 在事件配置页面中,单击编辑。
- 单击创建事件操作。
- 可选:通过选择有条件地执行,将条件添加到事件操作规则。
- 在执行操作下方,选择操作的类型以及任何其他所需的值。其他值将取决于操作配置。
- 可选:通过单击添加操作在同一规则中创建多个操作。如果规则是有条件的,这些操作将具有相同的条件。
- 单击保存。配置的事件操作立即生效。
如何定义条件
仅当文档或对象记录满足一组条件时才需要特定的事件操作。例如,您可以配置仅在需要批准字段设置为是时更新文档字段批准到期日期的操作。为此,您基于需要批准字段定义了一个条件。
要定义条件,请选择文档字段或对象字段、运算符和值。某些系统字段不可用。如有需要,可以单击添加条件来定义多个条件。
文档或对象记录必须满足规则中定义的所有条件,Vault 才能执行事件操作。如果条件使用不适用于该文档或对象记录的字段,Vault 会将该条件评估为“false”。当条件评估为“false”时,该事件(创建文档、创建对象记录等)继续进行,但不执行操作。
关于在条件和操作中引用缺失记录
当您在 Vault 配置期间克隆生命周期配置时,对于入口条件中对特定对象记录的引用,如果新环境中不存在这些记录,则该引用可能会失效。如果发生这种情况,则对缺失对象记录的引用在生命周期配置字段中显示为空。
尽管 Vault 允许在缺失这些记录的情况下保存配置,但如果您希望在新环境中使用这些条件,我们建议您使用 Vault 加载程序或通过 API 重新创建 ID 值相同的记录,以便解决这些缺失的引用。如果您只想更新其他配置并将其带回源环境,则可以按原样保留缺失的引用。
如何编辑或删除事件操作
要对事件操作规则进行更改,请单击编辑。如果您需要删除整个规则、规则中的条件或规则中的操作,请单击 X 图标。完成更改后,单击保存。
限制
对于每个生命周期和事件(例如,创建文档),您最多可以定义 25 条事件操作规则。在一条规则中,最多可以指定十 (10) 项事件操作。如果规则是有条件的,则最多可以有五 (5) 个条件。
相关权限
要定义文档事件操作,您必须拥有具有管理:文档生命周期权限的安全配置文件。
要定义对象记录事件操作,您必须拥有具有管理:对象生命周期权限的安全配置文件。