Vault 加载程序让您能够从上传的源文件、文档模板以及内容占位符批量新建文档。您还可以更新 Vault 中现有文档的信息。
如何加载文档
在加载文档前:
- 如果要从源文件创建文档,请将文件上传到暂存服务器(通过 FTP 或使用 Vault REST API 创建文件夹或文件(不到 50MB 的文件)或可恢复上传会话(超过 50MB 的文件)终结点)。
- 准备 CSV 输入文件,其中包含文档字段值。
要加载文档,请执行以下操作:
- 在加载程序标签页的左侧面板中,单击加载。
- 对于 CSV 文件,单击选择并选择 CSV 输入文件。
- 在对象类型选项列表中,选择文档。
- 在操作类型选项列表中,选择创建或更新。
- 可选:选中文档迁移模式复选框以允许创建任何状态或状态类型的文档、文档版本、文档格式副本或文档、版本、角色。这还让您能够在 CSV 输入文件中设置名称、文档编号和版本号。
- 可选:选中在输出日志中包括更新的字段值用于验证复选框,以在输出日志中包括受支持的 VQL 字段。VQL 查询验证将影响性能。归档文档时,Vault 不支持此选项。
- 可选:单击映射字段以访问字段映射网格。
- 单击开始加载。
Vault 开始处理请求。完成后,您会收到 Vault 通知以及包含请求详细信息和 CSV 输出文件的电子邮件。
注意:因为 Vault 会异步重建文档索引,所以如果在使用 Vault 加载程序创建和更新文档时使用在输出日志中包括更新的字段值用于验证,则可能不会在输出日志中包括更新的字段值。
字段映射
借助字段映射,您可以选择将想要加载的选定对象类型的特定字段映射到 CSV 输入文件中的列。例如,创建产品对象记录时,您可以将 therapeutic_area__v
字段名称映射到治疗领域 CSV 列。
要映射字段,请执行以下操作:
- 选择 CSV 文件后,从对象下拉列表中选择文档。
- 在操作类型下拉菜单中,选择创建、更新、更新和插入或删除。
- 在关键字段下拉菜单中,从所选对象选择任何唯一字段。仅删除、更新和插入以及更新操作需要此选项。
- 单击映射字段按钮以访问字段映射网格。您还可以通过单击映射字段下拉按钮并选择加载保存的映射来加载之前保存的映射。
- 可选:应用任何其他列筛选器。
- 可选:单击清除字段以清除所有现有列映射。
- 可选:单击自动映射以使 Vault 能够根据匹配对象标签或名称自动将 CSV 列映射到对象列。
- 可选:使用搜索框搜索特定对象列。
- 在 CSV 列中,从适用下拉列表中选中一个列名以映射到所需的对象字段或标签。您可以在字段映射网格上方输入页面编号以跳转到特定页面,也可以使用导航箭头。
- 单击保存映射,以保存当前列映射。
- 单击开始加载。
自动设置格式
由于 Vault 要求某些字段使用特定格式,在完成加载前,加载程序会使用自动设置格式来将字段值转换为 Vault 的标准格式。加载程序为以下字段类型使用自动设置格式:
- 布尔值
- 在加载前,加载程序会确保所有布尔字段值为 True 或 False。
- 选项列表
- 将数据映射到选项列表时,加载程序在加载前将选项列表名称(例如,
family__c
)用于查找。如果不为选项列表提供名称,加载程序还可以将选项列表标签(例如,系列)用于查找。
其他详细信息
- Vault 使用黄色高亮显示所需的 CSV 列
- CSV 列中的下拉列表针对 CSV 的可用列显示(无映射)
- 选择(无映射)以取消映射之前映射的列
- 在取消映射前,已经映射的字段在 CSV 列下拉列表中不可用
准备 CSV 输入文件
文档字段因 Vault 和文档类型而异。以下列表包括需要的字段,以及涵盖不同字段类型的多个示例字段。创建未分类文档时,其中一些字段不会应用。我们建议使用加载程序提取列标题并让 CSV 输入以该文件为基础。您只能通过多值关系字段使用 ID 值,或根据唯一字段通过查找来添加关系。name__v
不是唯一字段。使用多值字段上传文档时,以逗号分隔列表的形式输入值,值之间不空格。
注意:您必须在 CSV 文件中使用 UTF-8 编码才能通过 Vault 加载程序创建或更新文档。
注意:您可以在输入文件中使用文档外部 ID 来为源文档和目标文档创建关系。要使用文档外部 ID 作为查找,您只能提供外部 ID 并且必须排除 source_doc_id__v
和 target_doc_id__v
字段。
列标题 | 字段 | 示例值 | 备注 |
---|---|---|---|
id | ID | 486 | 更新操作所必需的。这是文档的内部 ID 编号。您可以通过使用 Vault 加载程序提取现有文档来查找 ID 值。 |
name__v | 文档名称 | 2017 年春季宣传单页 | 除非文档类型使用自动命名,否则是必需的;在这种情况下,提供值会覆盖默认值。 |
type__v | 文档类型 | 材料 | 必填. |
subtype__v | 子类型 | 促销 | 如果所选文档类型拥有子类型,则是必需的。 |
classification__v | 分类 | 患者教育 | 如果所选子类型拥有类别,则是必需的。 |
lifecycle__v | 文档生命周期 | 材料审查 | 必填. |
major_version_number__v | 主要版本号 | 1 | 如果要创建多个文档版本,则是必需的;在“v1.3”中将为“1”。您不能使用此选项来更新文档的过去版本。仅文档的最新版本可通过 Vault 加载程序进行编辑。 |
minor_version_number__v | 次要版本号 | 3 | 如果要创建文档版本,则是必需的;在“v1.3”中将为“3”。您不能使用此选项来更新文档的过去版本。仅文档的最新版本可通过 Vault 加载程序进行编辑。 |
file | 源文件 | 2017-flyer.pdf | 引用 FTP 服务器上的文件。在这种情况下,文件在根目录中,但您还可以创建子目录并将文件置于此处。文件引用必需包括文件扩展名,例如,“2017-flyer.pdf”。 |
product__v | 产品 | 00P000000000101 | 使用文档字段名称 (product__v )(作为列标题)和记录的 ID 值引用对象记录。您可以使用任何对象字段(值必须唯一)引用对象记录,如示例输入所示。 |
campaign__c.name__v | 市场活动 > 名称 | 已超过 | 使用文档字段名称 (campaign__c ) 以及对象字段名称 (name__v ) 作为列标题来引用对象记录。 |
country__v.external_id__c | 国家/地区 > 外部 ID | US120 | 使用文档字段名称 (country__v ) 以及对象字段名称 (external_id__c ) 作为列标题来引用对象记录。 |
audience__c | 受众(选项列表) | 患者,药剂师 | 使用 UI 标签引用选项列表选项。 |
clm_content__v | CLM 内容 | false | 在“是/否”类型字段中指示“否”。 |
publish_date__c | 发布日期(日期) | 2017-12-03 | 填充日期字段。日期必须使用 YYYY-MM-DD 格式。 |
用于创建文档的示例输入
您可以创建以下类型的文档:
相关权限
除标准 Vault 加载程序权限外,您的安全配置文件还必须包括应用程序:所有文档:所有文档操作权限才能使用 Vault 加载程序创建文档。