注意:在 19R2 中,我们升级了 Vault FTP 基础设施,通过更好地利用 AWS™ 来使其更可靠、更具可扩展性并面向未来。作为此更改的一部分,您不再能够重命名或移动 FTP 服务器上的文件夹。您可以在开发人员门户中详细了解可扩展 FTP。从 20R3 开始,您可以使用 Vault REST API 管理 Vault 暂存服务器上的文件。您可以在开发人员门户中详细了解文件暂存 API。
您域中的每个 Vault 有其自己的文件暂存服务器,该服务器支持各种功能,包括 Vault 加载程序和未分类文档创建。文件暂存服务器是用于您要上传到 Vault 或从中提取的文件的临时存储区域。例如,使用 Vault 加载程序新建文档时,您会在加载 CSV 前将源文件上传到文件暂存服务器。CSV 随后引用文件暂存服务器上的源文件位置。
请注意,如果刷新 Vault,所有文件将从文件暂存服务器中移除。
服务器 URL
每个暂存服务器的 URL 与相应 Vault 的 URL 相同,例如,veepharm.veevavault.com。
如何访问文件暂存服务器
您可以使用您喜欢的 FTP 客户端、Vault REST API 或通过命令行访问您的暂存服务器。请在开发人员门户中详细了解文件暂存 API。
注意:如果在通过 FTP 上传大型文件时遇到问题,请将 FTP 客户端超时设置增加到 180 秒。如果您在代理或防火墙中启用了远程验证,从网络中的计算机到 Veeva 文件暂存服务器的 FTP 流量可能会被拒绝。如果可能,请与 IT 部门一起禁用远程验证。如果无法禁用,请联系 Veeva 支持人员。
将以下设置用于 FTP 客户端:
- 协议:FTP(文件传输协议)
- 加密:需要显式 FTP over TLS (FTPS)。这是安全要求。您的网络基础设施必须支持 FTPS 流量。
- 端口:通常无需添加,并会默认使用端口 21。
- 主机:{DNS}.veevavault.com。例如:“veepharm”是 veepharm.veevavault.com 中的 DNS。
- 超时:如果上传大型文件,则为 180 秒。
- 用户:{DNS}.veevavault.com+{USERNAME}。使用您用于登录的用户名。例如:
veepharm.veevavault.com+tchung@veepharm.com
。 - 密码:您在此 Vault 中的登录密码。使用您用于标准登录的密码。您还可以使用有效会话 ID。
- 登录类型:正常
- 传输文件类型:传输文件为二进制文件
FTP 限制
以下限制影响通过 FTP 进行的文件上传:
- 文件名长度不能超过 218 个字节,包括文件扩展名。请注意,一 (1) 个字符并非始终等于一 (1) 个字节。例如,字符“菌”是三 (3) 个字节。
- 完整文件夹路径不能超过 955 个字节。
暂存服务器权限
要从暂存服务器下载文件,您必须拥有标准 Vault 所有者或系统管理员安全配置文件,或拥有包括文件暂存:访问和 API:访问 API 权限的自定义安全配置文件。
暂存服务器不支持 SAML SSO 身份验证。
要将文件上传到暂存服务器上的根文件夹,您必须拥有标准 Vault 所有者或系统管理员安全配置文件。拥有文件暂存:访问权限的用户可以将文件上传到个人文件夹。
引用暂存服务器上用户个人文件夹中的文件时,您必须在文件路径中包括用户目录。例如,Clara 不是 Vault 所有者或系统管理员。她只能直接将文件上传到 Vault1234/u5678,其中 1234 是她的 Vault ID,5678 是她的用户 ID。请注意,Clara 仍然可以在其用户目录中生成新目录,例如 /u5678/uploads。
Vault 加载程序详细信息
您可以使用 Vault 加载程序命令行工具查看和管理 Vault 文件暂存服务器上的文件及文件夹。如需了解更多信息,请参阅 Vault 加载程序文件暂存命令行工具参考指南。
要将暂存服务器上的文件用于 Vault 加载程序,用户无需拥有对暂存服务器的访问权限。例如,一个拥有文件暂存服务器访问权限的用户可以上传文件,而另一个没有访问权限的用户则可以通过 Vault 加载程序创建引用暂存服务器上的文件的文档。
收件箱详细信息
注意:从 20R3 开始,在没有源文件的情况下,Vault 不再自动为 FTP 收件箱目录中的大型资产格式副本创建 dummy.txt 文件。有关详细信息,请参阅上传格式副本和创建文档。
您可以通过将文件上传到 Vault 文件暂存服务器上的收件箱目录来创建暂存文档。暂存是文档类型、生命周期和生命周期状态的名称。暂存文档未分类。您和其他拥有相关权限的用户可以将这些文档像任何其他未分类文档那样进行分类。但是,暂存文档不使用未分类生命周期,可能会拥有不同的角色和访问控制设置。
文件暂存服务器的收件箱自动对所有 Vault 可用。在使用此功能之前,管理员应当:
- 为暂存文档生命周期内的编辑者角色添加默认用户。
- 修改暂存文档生命周期内的编辑者角色,以在文档创建过程中分配默认用户(使用添加默认用户时间设置)。
- 可选:编辑此功能使用的通知消息模板。
消息模板
- 无法将 LSA 上传到活页夹或占位符 (
ftp_inbox_attach_to_unsupported_document__v
):当格式副本的目标文档是活页夹或占位符时,Vault 使用此错误消息。 - 大型资产已附加 (
ftp_inbox_lsa_uploaded_to_exsting_doc__v
):此通知发送给向现有文档上传了大型资产格式副本的用户。 - 无法将可视格式副本附加到视频 (
ftp_inbox_attach_viewable_rendition_to_video__v
):当已上传可视格式副本文件的目标文档是视频时,Vault 使用此错误消息。 - 超过最大文件大小 (
ftp_upload_too_large__v
):当文件超过大小限制时,Vault 使用此错误消息。它不是文件暂存服务器收件箱特有的功能。 - 缺少格式副本类型 (
ftp_inbox_missing_rendition_type__v
):当上传用户未指定格式副本类型或指定了无效的格式副本类型时,Vault 使用此错误消息。 - 没有适当的权限 (
ftp_inbox_no_appropriate_rendition_permission__v
):当上传用户尝试更新他们没有必需权限的文档时,Vault 使用此错误消息。 - 找不到目标文档 (
ftp_inbox_target_document_notFound__v
):当文件名的目标是不存在的文档 ID 时,将会出现此错误消息。在有些情况中,ID 有效,但是上传用户没有目标文档的查看文档访问权限。
临床 FTP 加载程序(仅限 Clinical Operations)
在 Clinical Operations Vault 中,您可以使用 Vault 的 FTP 服务器将对象记录数据加载到 Vault 中。有关详细信息,请参阅通过 FTP 创建和上传记录。