字段依赖关系允许您为特定的文档字段配置行为,其中该行为依赖于文档生命周期(加上状态和用户的生命周期角色)、文档类型或其他文档字段中的值。
注意:不能为必填文档字段设置字段依赖关系。
访问字段依赖关系规则
管理员可以从管理 > 配置 > 字段依赖关系管理字段依赖关系规则。此页列出了为 Vault 定义的所有依赖关系规则。条件列显示控制字段、文档类型或生命周期,操作列显示相关的依赖字段。
在此页面中,您可以单击导出为 Excel,以导出所有字段依赖关系并离线整理详细信息。
由文档生命周期控制
基于文档生命周期的字段依赖关系,能让您根据文档的生命周期状态和活动用户的文档生命周期角色来进一步细化特定文档字段的访问控制。
用例:由文档生命周期控制
VeePharm 可能希望通常锁定处于已批准状态的文档的所有字段,但允许审批者角色的用户编辑几个字段。为此,组织将在已批准状态配置安全设置,以移除除审批者之外的所有角色的编辑字段权限。此时,审批者对处于已批准状态的文档的所有字段拥有编辑访问权限,但 VeePharm 希望仅授予对文档批准评论字段和预算批准评论字段的编辑访问权限。
为了进一步限制编辑,管理员可以基于文档生命周期配置字段依赖关系。该字段依赖关系表明,对于常规生命周期,已批准文档状态、审批者角色、文档批准评论和预算批准评论字段均为可见。此配置不会自动阻止对其他文档字段的编辑。为了设置这些字段的行为,管理员可以选中没有生命周期依赖关系规则的每个字段复选框,并选择只读行为。
如何创建基于文档生命周期的依赖关系
创建新的依赖关系规则,其中字段行为由文档生命周期状态和用户的文档生命周期角色控制:
- 单击创建按钮。
- 选择由文档生命周期控制选项。
- 选择文档生命周期。
- 单击确定以打开详细信息页面。
- 在条件下方,选择生命周期状态和生命周期角色。
- 在依赖关系规则下,设置依赖字段操作:
- 单击字段标签以选择操作。
- 如果控制字段有多个依赖字段,单击 + 图标可添加更多行。
- 完成后,单击保存。
重新分类时的已知问题
重新分类将把文档更改为新的文档类型、子类型和类别。如果新的文档类型使用不同的生命周期,则重新分类也可以更改文档的生命周期。在这些情况下,Vault 不会基于新的生命周期强制执行字段依赖关系,直到重新分类的用户单击保存,从而允许用户查看和编辑可能受新生命周期上的字段依赖关系限制的字段。
Veeva Vault 将在未来版本中修复此问题(问题编号 DEV-210708)。
由文档字段控制
控制字段依赖关系允许您根据一个字段选择的值来设置另一个字段的行为。
用例:由文档字段控制
字段准备日期仅适用于字段使用字段设置为是的情况。否则,Vault 应隐藏该字段。要进行此配置,管理员将使用由文档字段控制设置来创建字段依赖关系。管理员将选择文档类型,因为字段是在类别级别定义的,因此还将选择子类型和类别。然后,用户可以选择控制字段字段使用。
在创建字段依赖关系页面,管理员定义字段使用的条件后,将选择字段准备日期并应用特定行为。当配置由文档字段控制的依赖关系时,如果不满足定义的条件,Vault 将自动应用相反行为。在此示例中,当字段使用设置为否时,Vault 将隐藏字段准备日期。
如何创建基于文档字段的依赖关系
要创建新的依赖关系规则,其中字段行为由其他文档字段控制:
- 单击创建按钮。
- 选择由文档字段控制选项。
- 进行文档类型选择。只有可用于所选文档类型的字段才能作为控制或依赖字段。可以设置为基础文档,以创建适用于所有文档的规则。
- 从字段选项列表中选择控制字段。
- 单击确定以打开详细信息页面。
- 在条件下方,设置会引起依赖字段操作的字段值。例如,布尔字段的是或否。
- 在依赖关系规则下,设置依赖字段操作:
- 选择字段或选项列表,以指示依赖字段的类型。
- 选择字段标签,然后选择操作。
- 如果控制字段有多个依赖字段,单击 + 图标可添加更多行。
- 完成后,单击保存。
由文档类型控制
基于文档类型、子类型和类别的字段依赖关系有助于组织细化适用于特定文档类型的字段。当 Vault 具有在基础文档级别定义的字段,但有些字段要么不相关,要么对于文档类型的子集是必需项时,这一点特别有用。
用例:由文档类型控制
例如,VeePharm 管理员在基础文档级别应用评论字段,这意味着此字段适用于所有文档类型。在大多数情况下,此字段为可选项,但组织希望确保文档类型为跟进请求的文档填写此字段。要进行此配置,管理员将使用由文档类型控制选项来创建字段依赖关系。然后,管理员定义依赖关系规则,以便当文档类型为跟进请求时,评论具有必需行为。
如何创建基于文档类型的依赖关系
要创建由文档类型控制的新的依赖关系规则:
- 单击创建按钮。
- 选择由文档类型控制选项。
- 选择在依赖关系规则中要使用的文档类型。此选择还决定哪些文档字段可作为依赖字段使用。
- 单击确定以打开详细信息页面。
- 在依赖关系规则下,设置依赖字段操作:
- 选择字段或选项列表,以指示依赖字段的类型。
- 选择字段标签,然后选择操作。
- 如果控制字段有多个依赖字段,单击 + 图标可添加更多行。
- 完成后,单击保存。
依赖字段行为
当设置字段依赖关系时,您需要利用以下行为之一来设置依赖字段的行为:
- 只读:依赖字段在满足控制条件时可见且只读。
- 可见:依赖字段在满足控制条件时可见且可编辑。
- 必需:依赖字段在满足控制条件时可见、可编辑且必需。
- 隐藏:依赖字段在满足控制条件时不可见。
相反行为
当不满足控制条件时,使用由文档字段控制设置的字段依赖关系将自动应用相反行为。例如,当字段使用设置为是时,让字段准备日期可见的依赖关系将在字段使用设置为否或留空时,自动让字段准备日期隐藏。
这种相反行为控制不适用于使用由文档生命周期控制或由文档类型控制设置的字段依赖关系。
用户权限和字段行为
通过字段依赖关系定义的行为只能进一步限制用户通过许可证类型、安全配置文件和文档生命周期角色已经拥有的访问权限。例如,让字段可见并不意味着,对文档没有编辑字段权限的用户可以对其进行编辑。
限制
Vault 对使用由文档类型控制或由文档字段控制设置的依赖关系进行了一些限制:
- 在由文档字段控制的依赖关系中,控制字段必须是布尔值(是/否)、选项列表或对象引用字段。
- 依赖字段不能由任何其他字段或文档类型控制。此规则不适用于受文档生命周期控制的依赖关系。单个字段可以由多个文档生命周期依赖关系控制,但只限基于文档字段或文档类型的单个依赖关系。
- 在文档类型层次结构中,依赖字段不能被定义为必需项。
- 依赖字段不能是标准 Vault 字段。(文档标题字段除外。对于标准或自定义文档类型,可以将文档标题设置为必需项。)
特殊注意事项
关于依赖字段,有几个需要注意的事项:
- 受控字段行为只适用于 UI 级别。API 和 VQL 不使用依赖字段规则。
隐藏操作通常与基于文档类型的规则一起使用,以便隐藏在文档类型为该文档类型的子类型的子集定义的字段。在这些情况下,可以使用共享字段而非依赖关系规则。
如何创建基于文档类型的依赖关系
要创建新的规则,其中控制字段为文档类型:
- 单击创建按钮。
- 选择由文档类型控制选项。
- 选择在依赖关系规则中要作为控制字段的文档类型。此选择还决定哪些文档字段可作为依赖字段使用。
- 单击确定以打开字段依赖关系详细信息页面。
- 在依赖关系规则下,设置依赖字段操作:
- 选择字段或选项列表,以指示依赖字段的类型。
- 选择字段标签,然后选择操作。
- 如果控制字段有多个依赖字段,单击 + 图标可添加更多行。
- 完成后,单击保存。
如何创建基于文档字段的依赖关系
要创建新的规则,其中控制字段为文档字段:
- 单击创建按钮。
- 选择由文档字段控制选项。
- 进行文档类型选择。只有可用于所选文档类型的字段才能作为控制或依赖字段。可以设置为基础文档,以创建适用于所有文档的规则。
- 从字段选项列表中选择控制字段。
- 单击确定以打开字段依赖关系详细信息页面。
- 在条件下方,设置会引起依赖字段操作的字段值。例如,布尔字段的是或否。
- 在依赖关系规则下,设置依赖字段操作:
- 选择字段或选项列表,以指示依赖字段的类型。
- 选择字段标签,然后选择操作。
- 如果控制字段有多个依赖字段,单击 + 图标可添加更多行。
- 完成后,单击保存。
特殊注意事项
关于依赖字段,有几个需要注意的事项:
- 必需操作只适用于 UI 级别。API 不使用依赖字段规则。通过文档类型层次结构定义的必需字段适用于 UI 级别和 API。
- 当不满足条件时,字段依赖关系规则也会影响依赖字段的行为。
- 隐藏操作通常与基于文档类型的规则一起使用,以便隐藏在文档类型为该文档类型的子类型的子集定义的字段。在这些情况下,可以使用共享字段而非依赖关系规则。
更新依赖关系规则
为字段依赖关系规则定义的一些选项仅在初始创建过程中可用。当编辑现有规则时,只能修改控制条件和依赖字段。不能修改文档类型选择。
请注意,所有规则更新在保存后立即生效。
查看使用规则的位置
除了在字段依赖关系页面查看定义的规则之外,您还可以从文档字段详细信息页面查看控制或依赖字段的规则。