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

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

加载对象记录

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

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

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

在处理请求前，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 的旧用户帐户中的相同字段。

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

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

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

名称	字段	示例值	备注
`email__sys`	电子邮件	ewoodhouse@email.com	用户的电子邮件地址。
`first_name__sys`	名字	Elaine	用户的名字。
`last_name__sys`	姓氏	Woodhouse	用户的姓氏。
`username__sys`	用户名	ewoodhouse@veepharm.com	用户的 Vault 用户名（登录凭据）。例如，ewoodhouse@veepharm.com。
`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 的元数据不匹配，通知将允许您停止加载或忽略这些列并继续。