Vault 加载程序支持以 CSV 格式导出文档、文档关系、对象记录、用户和组的字段、值和文件。许多用户在创建、更新或“更新和插入”Vault 数据时,利用这些导出为 CSV 输入文件创建模板。您还可以将提取数据用于在另一个应用程序中进行详细的数据分析和处理,或者将数据迁移到另一个 Vault 中。
如何提取
要从 Vault 中提取元数据和文件:
- 使用加载程序标签页的左侧面板,导航到提取页面。
- 选择对象类型。
- 可选:如果是提取文档元数据,请使用文档类型选项列表,将导出数据筛选为特定的文档类型、子类型或类别。
- 可选:选中包括不可编辑字段复选框。
- 可选:选中仅提取列标题复选框。
- 可选:选中包括源文件复选框。此选项仅在提取文档和文档版本时可用。
- 可选:选中包括格式副本复选框。此选项仅在提取文档和文档版本时可用。
- 可选:选中覆盖默认列选择复选框。
- 可选:在 Where 子句字段中,输入要筛选的字段,单击验证按钮以检查是否有语法错误。
- 单击提取。
请注意,对于对象类型为组的提取,Vault 不支持筛选,且 Where 子句字段被禁用。对于对象类型为用户的提取,Vault 允许 WHERE 子句筛选,但不支持验证。
在单击提取以开始对象或文档元数据提取之后,Vault 将开始处理请求。完成后,您会收到 Vault 通知以及包含请求详细信息和 CSV 输出文件的电子邮件。了解更多信息。
提取类型和限制
提取类型 | 输出 | 限制 |
文档/文档版本元数据 | CSV 输出 | 1,000,000 |
文档/文档版本源文件 | CSV 输出(带有指向 FTP 服务器的链接) | 2,000 |
文档/文档版本格式副本 | CSV 输出(带有指向 FTP 服务器的链接) | 2,000 |
文档/文档关系 | CSV 输出 | 1,000,000 |
对象记录元数据 | CSV 输出 | 1,000,000 |
对象关系 | CSV 输出 | 10 |
用户 | CSV 输出 | 1,000,000 |
组 | CSV 输出 | 1,000,000 |
Vault 加载程序还可以达到查询规模的上限(最多 50,000 个字符)。如果发现此错误,请更新您的提取设置,以包括更少的字段,例如不包括不可编辑字段,或选择包括特定字段。
包括不可编辑字段
选择此选项以提取可编辑和不可编辑字段。不可编辑字段包括创建日期和修改日期等数据。提取所有字段和值能为您提供更完整的 Vault 数据记录,这对于在其他应用程序中进行数据分析很有用。请注意,这些提取仅包括必需的不可编辑字段。
当提取元数据用于后续编辑和重新加载时,请勿包括不可编辑字段。除 ID 之外,输入中不允许有不可编辑字段。
仅提取列标题
选择此选项以仅提取字段名称。这种提取为您提供了一个输入文件模板,您可以向该模板添加值来创建新记录。
注意:使用此选项时,Vault 会排除 ID 字段。如果更新现有记录,则需要向 CSV 输入文件添加 ID 字段。
覆盖默认列选择
要选择提取中要包括的特定列,可以选中覆盖默认列选择复选框。此时将打开列选择窗格。您可以在可用列方框与所选列方框之间移动字段,方法是选择向左和向右箭头按钮,或者双击所需列。在选定列框中,使用上下箭头按钮可重新排列列的顺序。
覆盖默认列选择复选框不适用于对象类型为用户的提取。
您可以向可用列应用以下筛选器:
- 显示可编辑字段:仅显示用户可以编辑的字段。
- 显示必填字段:仅显示标记为必填的字段。
- 显示出站关系:仅显示对象或文档引用的字段。
要将所有设置重置为默认值,请单击还原默认值。
列筛选不适用于对象类型为用户的提取。
包括源文件和包括格式副本
选择这些选项来提取与文档或文档版本相关的源文件和/或格式副本。Vault 将文件导出到 Vault 的文件暂存服务器。当导出包含具有多种格式副本类型的文档或文档版本,且您选中包含格式副本复选框时,CSV 输出将为每种格式副本类型提供单独的行。
使用 Where 子句字段
使用 Where 子句字段,您可以对提取进行筛选。例如,使用对象记录 ID 从文档中提取元数据:
country__c = '00C000000000102' AND product__v = '00P000000000119'
请注意,WHERE 子句筛选不适用于对象类型为组的提取。
您可以对所选对象类型上配置的任何字段进行筛选。如果按文档类型筛选文档提取,还需要确保您的字段存在于该文档类型上。
提取文档关系时,可以按关系类型进行筛选。例如,要查找所有文档附件:
relationship_type__v = 'attachments__v'
您也可以使用 name__v
值进行筛选。对于单选字段,请在 WHERE
子句中使用关系名称。对于多值字段,请使用子选择语句。在本例中,国家/地区是单选字段,产品是多选字段:
document_country__cr.name__v = 'United States' AND product__v in (select id from document_product__vr WHERE name__v = 'Cholecap')
您可以单击 Where 子句字段,然后访问令牌 {…} 图标以搜索字段。单击验证按钮以检查是否有语法错误。WHERE 子句验证不适用于对象类型为用户的提取。
Where 子句字段支持所有可用的 Vault 查询语言 (VQL) 参数。您可以使用 AND
、OR
等运算符来进行更精确的提取。如需详细了解 VQL,包括子选择语法和查找文档关系,请参阅 Vault 开发人员门户。
重建索引
Vault 为元数据编制索引,以方便快速搜索和有效地应用访问控制。Vault 的提取取决于已编制索引的元数据。当值发生更改或用户创建新文档或对象记录时,Vault 必须更新索引。当重建索引时,新创建的文档或对象记录可能不包括在提取中。在大多数情况下,重建索引只需不到一 (1) 分钟的时间。
ID 值
所有提取的记录都包括其系统管理的 ID 值。当执行更新或更新和插入操作时,ID 是标识输入文件中现有记录的主要方法。尽管 ID 值不可编辑,但它们始终包括在输出的第一列中。
对象引用字段
除了内部 id 字段外,文档和对象提取还使用 external_id__v 和 name__v 字段来标识对象引用。
例如,市场营销活动对象记录提取可能如下所示:
id | name__v | product__c | product__c.name__v | product__c.external_id__v |
OBE000000000303 | Cap Your Cholesterol | 00P000000000202 | CholeCap | CC |
OBE000000000304 | Ever Wonder | 00P000000000101 | WonderDrug | WD |