Vault 加载程序：创建、更新和删除对象目录

Vault 加载程序 让您能够对 Vault 中的对象记录执行批量创建、更新和删除操作。加载程序还提供更新和插入操作，让您能够使用单一 CSV 输入新建记录及更新现有记录。您还可以使用 用户 和 人员 对象创建和更新用户。要了解如何使用 用户 对象管理用户，请参阅 管理用户和人员对象 。了解有关如何 管理对象记录附件 的更多信息。

加载对象记录

在加载对象记录前，准备包含对象记录字段名称和值的 CSV 输入文件 。

要加载对象记录，请执行以下操作：

1. 在 加载程序 标签页的左侧面板中，单击 加载 。
2. 对于 CSV 文件 ，单击 选择 并选择 CSV 输入文件。
3. 在 对象类型 下拉菜单中，选择要对其执行批量操作的对象。
4. 在 操作类型 下拉菜单中，选择 创建 、 更新 、 更新和插入 或 删除 。
5. 在 关键字段 下拉菜单中，从指定对象选择任何唯一字段。仅 删除 、 更新和插入 以及 更新 操作需要此选项。
6. 可选：选中 记录迁移模式 复选框，以允许创建处于任何生命周期状态或状态类型的对象记录。此外，在迁移模式下创建记录时，Vault 会绕过 验证规则 和 引用约束 。
7. 可选：选中 在输出日志中包括更新的字段值用于验证 复选框，以在输出日志中包括受支持的 VQL 字段。VQL 查询验证将影响性能。
8. 可选：单击 映射字段 以访问字段映射网格。您还可以通过单击 映射字段 下拉按钮并选择 加载保存的映射 来加载之前保存的映射。
9. 单击 开始加载 。

在处理请求前，Vault 会 验证所选的 CSV 文件 。如果文件有效，Vault 会开始处理请求。完成后，您会收到 Vault 通知以及包含请求详细信息和 CSV 输出文件的电子邮件 。

字段映射

借助字段映射，您可以选择将想要加载的选定对象类型的特定字段映射到 CSV 输入文件中的列。从字段名称可能与目标 Vault 中的字段名称不完全匹配的另一个 Vault 导入记录时，或者从 Vault 之外的源导入数据时，这很有用。例如，假设您要将具有现有批次 ID 的批次数据从旧系统迁移到 Vault。创建 批次 对象记录时，您可以将 external_id__v 字段映射到 CSV 中名为“旧批次 ID”的列。

字段映射网格包含以下列：

• 字段名称 ：目标 Vault 中对象字段的名称。查找字段在其关联对象引用字段下方显示，并使用箭头图标指定。
• 字段标签 ：在目标 Vault UI 中为对象记录中的字段显示的标签。
• 类型 ：目标 Vault 中的字段类型。
• CSV 列 ：CSV 列标题中的值。如果使用 Vault Loader Extract 生成 CSV，这些值将与源 Vault 中的字段名称匹配。

搜索和筛选列

您可以通过选中 筛选器 节段中的一个或多个复选框，来选择仅在字段映射网格中显示某些类型的字段。您可以在字段映射网格上方输入页面编号以跳转到特定页面，也可以使用导航箭头。使用 搜索 框搜索特定字段。

设置 CSV 列

Vault 会自动将 CSV 列标题映射到类似字段名称。要更改这些映射，请从适用的 CSV 列 下拉列表中选择一个列标题，以将该列映射到所需对象字段。选择 （无映射） 以删除映射，并使字段在新创建或更新的记录中为空。单击 清除字段 以删除所有映射，或单击 保存映射 以保存当前字段映射供未来使用。

映射对象引用字段

Vault 使用引用对象中的查找字段映射对象引用字段。在上述示例中， 产品 ( product__c ) 字段通过将 product__c.generic_name__c 字段映射到 通用名称 CSV 列进行填充。您只能每个对象引用字段映射一个查找字段。如果某个对象引用字段的所有查找字段均设置为 （无映射） ，则它将在新创建或更新的记录中为空，或者，如果对象引用字段为必填，则加载将失败。

自动设置格式

由于 Vault 要求某些字段使用特定格式，在完成加载前，加载程序会使用自动设置格式来将字段值转换为 Vault 的标准格式。加载程序为以下字段类型使用自动设置格式：

• 布尔值：在加载前，加载程序会确保所有布尔字段值为 True 或 False
• 选项列表：将数据映射到选项列表时，加载程序在加载前将选项列表名称（公钥）用于查找。如果不为选项列表提供公钥，加载程序还可以将选项列表标签用于查找。

其他详细信息

• Vault 使用黄色高亮显示所需的 CSV 列。
• CSV 列中的下拉列表针对 CSV 的可用列显示 （无映射） 。
• 已经映射的字段在字段映射网格中不可用。

如何删除对象记录

要使用 Vault 加载程序进行删除，您将上传列出想要删除的记录的 CSV 输入文件。用于删除操作的 CSV 仅需要 ID 字段。流程的其余部分按 加载对象记录 所述进行。您无法删除 用户 对象记录，但您可以通过将用户的 Vault 成员身份设为 false 来在一个或多个单独的 Vault 中将用户帐户设为非活动状态。了解有关 Vault 成员身份 分配的更多信息。

级联删除

删除特定对象的记录时，Vault 可以 级联删除相关记录的整个层次结构 。删除使用级联删除设置的对象的记录时，您仅可在一次加载中删除一条记录（及其相关记录）。这意味着您无法在多个对象记录上使用级联删除设置。

批量删除记录时，您无法使用级联删除选项。

创建处于特定生命周期状态的记录

Vault 加载程序允许您在创建对象记录时指定生命周期状态。准备 CSV 文件时，您可以指定生命周期状态 ( state__v ) 或状态类型 ( state_label ) 字段值，以使用 创建 导入处于指定状态的记录。创建处于特定状态的记录时，Vault 不会执行入口条件。

要创建处于特定生命周期状态的记录，请在加载 CSV 前选中 记录迁移模式 复选框。您必须拥有 Vault 所有者操作：记录迁移 权限才能导入处于特定状态的记录。

准备 CSV 输入文件

字段因对象而异。以下列表包括始终或通常需要的字段，以及涵盖不同字段类型的多个示例字段。我们建议使用加载程序提取列标题并让 CSV 输入以该文件为基础。

列标题	字段	示例值	备注
id	ID	00P000000000101	更新或删除记录时需要。在更新和删除操作中，这是所有行都需要的。在更新和插入操作中，可以为新记录将此留空，但必须为现有记录进行填充。
name__v	名称	WonderDrug	除非对象使用自动命名，否则创建记录时需要。
object_type__v	对象类型	00P000000000304	使用对象字段名称（作为列标题）和记录的 ID 值设置对象类型；如果留空，则对象记录将使用“基本”类型，例如， 基本产品 。
object_type__vr.api_name__v	对象类型 > 名称	pharmaceutical__v	使用关系名称 ( object_type__vr ) 和对象字段名称 ( api_name__v )（作为列标题）以及对象类型名称值（非标签）设置对象类型；如果留空，则对象记录将使用“基本”类型，例如， 基本产品 。
campaign__c	市场活动	00P000000000101	使用对象字段名称 ( campaign__c )（作为列标题）和记录的 ID 值引用对象记录。了解有关如何 加载对象引用字段 的更多信息。
campaign__c.name__v	市场活动 > 名称	已超过	使用要更新的对象上的字段 ( campaign__c ) 和相关对象上的名称字段 ( name__v ) 作为列标题来引用相关对象记录。使用 Vault 加载程序创建对象记录时，您无法在动态引用约束下引用相关对象字段值来创建使用查找类型字段的字段的值。相反，您必须使用引用对象字段名称作为列标题，并提供记录 ID 作为值，如以上针对 camapign__c 的示例中所示。
doc_reference__c	文档引用字段（已控制版本）	1457_0_1	引用 文档特定版本 中的字段。
doc_reference_unbound__c	文档引用字段（未控制版本）	1457	引用文档 最新版本 中的字段。了解有关如何 取消绑定文档字段 的更多信息。
family__c	产品系列（选项列表）	Wonder	使用选项列表值名称或标签引用选项列表选项。
generic_avail__c	通用名称可用	false	在“是/否”类型字段中指示“否”。
date_approved__c	批准日期	2017-01-29	日期格式必须为 YYYY-MM-DD。
datetime_approved__c	批准日期时间	2017-08-04T19:53:00.000Z	日期时间值格式必须为 {YYYY-MM-DD}T{HH:MM:SS.SSS}Z 并使用 24 小时制。时间必须为 UTC 时间，而不是您所在时区的时间。日期时间必须以 .000Z UTC 表达式结尾；零可以是任何数字。
rich_text__c	富文本字段	Veeva 网站	富文本字段最多支持 32,000 个明文字符，另外为 HTML 标记保留了 32,000 个字符。在 Vault UI 中，用户只能通过富文本编辑器中的按钮输入 HTML 标记，但是 Vault 加载程序 CSV 输入文件支持手动 HTML。
state__v	生命周期状态	draft_state__c	指定记录的生命周期状态。仅对启用 记录迁移模式 的 创建 操作可用。您还可以为 state__v 列提供对象生命周期状态标签，加载程序将在状态标签唯一的情况下查找公钥名称。
state_label	生命周期状态类型	base:object_lifecycle:initial_state_type	指定记录的生命周期状态。同时提供状态和状态类型时， state_label 值必须映射到提供的 state__v 值。例如，如果 state__v 值设为 draft_state__c ，则 state_label 值必须已在目标 Vault 中设为草稿。仅对启用 记录迁移模式 的 创建 操作可用。

请参阅示例输入：

• 创建记录
• 更新记录
• 更新和插入记录

如何加载对象引用字段

您可以使用任何对象字段（值必须唯一）引用对象记录。对于每个对象引用，不要包括超过一个列标题，或者使用 字段映射 选择一列。如果 CSV 为某个对象引用字段包含空白值，则该字段将在新创建或更新的记录中为空，或者，如果对象引用字段为必填，则加载记录将失败。

如何加载用户记录

您可以使用 Vault 加载程序 创建和更新 包含 user__sys 对象的用户 记录 。这让您能够更新 用户 记录中的自定义字段，以及 管理者 等标准字段。因为 Vault 将 用户 记录与旧用户帐户同步，所以 Vault 会在您创建或更新 用户 记录时自动更新旧用户帐户。例如，如果更新 John Smith 的 用户 记录中的 language__sys 字段，Vault 还会更新 John Smith 的旧用户帐户中的相同字段。

要创建、更新或更新并插入用户，请执行以下操作：

1. 在 加载程序 标签页的左侧面板中，单击 加载 。
2. 对于 CSV 文件 ，单击 选择 并选择 CSV 输入文件。
3. 在 对象类型 下拉菜单中，从 对象 节段选择 用户 。
4. 在 操作类型 下拉菜单中，选择 创建 、 更新 或 更新和插入 。
5. 单击 开始加载 。

新建 用户 记录时，以下字段在所有 Vault 中均为必填字段：

名称	字段	示例值	备注
email__sys	电子邮件	[email protected]	用户的电子邮件地址。
first_name__sys	名字	Elaine	用户的名字。
last_name__sys	姓氏	Woodhouse	用户的姓氏。
username__sys	用户名	[email protected]	用户的 Vault 用户名（登录凭据）。例如，[email protected]。
language__sys	语言	0LU000000000101	用户的首选语言。
locale__sys	区域设置	0LO000000000104	用户所在的位置。
timezone__sys	时区	america_los_angeles__sys	用户所在的时区。
license_type__sys	许可证类型	full__v	可选：用户的许可证类型。如果省略，默认值为 full__v 。
security_profile__sys	安全配置文件	0SP000000000106	用户的安全配置文件。例如，Vault 所有者。
status__v	状态	active__v	用户的状态。

限制

对于 user_sys ，Vault 加载程序不支持以下操作：

• 创建跨域用户
• 重置密码
• 在域级别激活或停用用户
• 管理 Vault 成员身份

要执行上述操作，请参阅 Vault 加载程序：创建和更新旧版用户 。

文件验证

在开始 Vault 加载程序作业以创建、更新或删除对象记录前，Vault 会检查并确保所选 CSV 文件满足特定条件：

• 如果要创建对象记录，则 Vault 中的记录总数以及 CSV 新建的记录不会超过 Vault 的限制
• 如果要创建对象记录，请包括至少一条记录
• 不为空
• 不包含空列
• 包括有效标题行（无效标题行指没有与要加载的记录的元数据匹配的列。）
• 如果使用 删除 、 更新和插入 或 更新 操作，则必须映射指定为 关键字段 的列。

如果文件无效，Vault 会显示通知、停止流程并允许选择新的 CSV 文件。如果某些列标题与 Vault 的元数据不匹配，通知将允许您停止加载或忽略这些列并继续。