Vault 提供各种 URL 格式,让您能够直接从外部系统将用户链接到特定文档。大多数组织都拥有各种保存或引用文档的系统,例如,学习管理系统 (LMS) 和企业门户。随着时间的推移,上传的文档会变得过时,您必须重新上传新版本。确保所有这些系统保持同步十分耗时。使用 Vault URL 可帮助您的组织维持单一事实来源 (Vault),而无需将文档上传到各种学习管理系统 (LMS) 和企业门户。

请注意,这些 URL 仅适用于拥有 Vault 访问权限的用户。如果用户尚未登录,Vault 将提示他们登录,然后再显示文档。Vault 绝不会显示用户没有查看权限的文档或文档版本。如果用户没有访问权限或没有找到文档,他们将看到“未找到文档”错误。

基本 URL

基本 URL 是 URL 中不会根据参数更改的部分:

https://{DNS}.veevavault.com/ui/#doc_info/{ID}

构造 URL 时,您会将上述 {DNS} 和 {ID} 项替换为实际信息:

  • 将 {DNS} 替换为 Vault 的域名,例如,“veepharm”是 https://veepharm.veevavault.com 中的 DNS
  • 将 {ID} 替换为文档的 ID。查找此信息的最简单方法是打开“文档信息”页并查看“doc_info/”之后的编号。例如,https://veepharm.veevavault.com/ui/#doc_info/3084/0/7 中的“3084”。

基本 URL 将用户发送到他们有权查看的文档最新版本的第一页。例如,如果 Gladys 在版本 1.0 上拥有查看文档权限,但在版本 1.1 上没有相应权限,她将看到版本 1.0。

如何指定版本

您可以将用户发送到文档的特定版本。要指定版本,请将以下参数添加到 URL:

/{MAJOR_VERSION}/{MINOR_VERSION}

变量 {MAJOR_VERSION}{MINOR_VERSION} 对应于 major_version_number__vminor_version_number__v 字段。

示例:https://veepharm.veevavault.com/ui/#doc_info/3084/1/0

与状态类型或状态配合使用

您可以将此设置与状态类型生命周期状态设置组合使用,以便仅当某个版本处于指定生命周期状态或状态类型时才将用户发送到该版本。

示例:https://veepharm.veevavault.com/ui/#doc_info/3084/1/0?status=approved_for_use__c

访问和重定向

如果用户没有访问指定版本的权限或指定版本不再存在,Vault 会重定向至他们可以访问的最新版本。如果需要,您可以选择阻止此重定向

如何指定页面编号

您可以将用户发送到文档的特定页面。要指定页面,请将以下参数添加到 URL:

?anQS=page{#}

变量 {#} 对应于文档的页面编号。

示例:https://veepharm.veevavault.com/ui/#doc_info/3084?anQS=page3

如何指定状态类型

您可以构造将用户发送到处于特定状态类型的最新版本的 URL,例如,最新稳定状态版本。要指定状态类型,请将以下参数添加到 URL:

?state_type={STATE_TYPE_NAME}

变量 {STATE_TYPE_NAME} 对应于状态类型的名称值(而不是标签)。

示例:https://veepharm.veevavault.com/ui/#doc_info/3084?state_type=steady_state__v

请注意,您无法在同一 URL 中同时指定状态类型和生命周期状态。

访问和重定向

如果用户没有处于指定状态类型的最新版本的访问权限,Vault 将重定向至他们可以访问并处于该状态类型的最新版本。Vault 绝不会重定向至不处于指定状态类型的版本。

支持的状态类型

Vault 支持以下状态类型作为 URL 参数:

  • 开始:starting_state__v
  • 稳定:steady_state__v
  • 作废:obsolete_state__v
  • 已替换:superseded_state__v

对于任何其他值,用户将看到“未找到文档”错误。

如何指定生命周期状态

您可以构造将用户发送到处于特定生命周期状态的最新版本的 URL,例如,处于已批准使用状态的最新版本。要指定生命周期状态,请将以下参数添加到 URL:

?status={STATE_NAME}

变量 {STATE_NAME} 对应于生命周期状态的名称值(而不是标签)。此值在管理 > 配置 > 文档生命周期 > [生命周期] > 状态 > [状态] 中可见。

示例:https://veepharm.veevavault.com/ui/#doc_info/3084?status=approved_for_use__c

请注意,您无法在同一 URL 中同时指定状态类型和生命周期状态。

访问和重定向

如果用户没有处于指定生命周期状态的最新版本的访问权限,Vault 将重定向至他们可以访问并处于该状态的最新版本。Vault 绝不会重定向至不处于指定生命周期状态的版本。

如何停止重定向

有时,您想要确保用户转到特定版本并在其没有该版本访问权限的情况下完全阻止链接生效。要执行此操作,请将以下参数添加到 URL:

?redirect=false

如果用户没有指定版本的访问权限,他们将看到“未找到文档”错误。

示例:https://veepharm.veevavault.com/ui/#doc_info/3084?redirect=false

您还可以使用 ?redirect=true,但此参数仅复制默认重定向行为,因此没有必要。