为归档导入准备数据和 AWS S3 环境

导入 ContentVersion 文件

1. 在 S3 存储桶中，创建名为 ContentDocuments 的目录。
2. 将所有物理文件（例如 PDF 和 PNG）放在 ContentDocuments 目录中。
   

   备注 每个文件名与首次上载到 Salesforce 的原始文件名相匹配至关重要。如果您有两个名称相同的不同文件，此过程将失败。

   

   备注 如果相同文件与 Salesforce 中的多个记录关联，则仅在 ContentDocuments 目录中插入该文件的一个副本。归档应用程序将该单个文件附加到引用它的所有记录。
3. 提供这些 CSV 文件。您可以一起导入这些文件，因此不需要导入订单。
   • ContentDocument.csv：该文件创建父 ContentDocument 记录，这些记录充当文件版本的容器。这些 CSV 字段是必填字段。
     • Id:文件的唯一 18 个字符的 ContentDocument ID。
     • 来自 ContentDocument 模式的所有标准字段（例如 Description）和所有自定义字段（例如 My_Custom__c）。
   • ContentVersion.csv:此文件将文件版本链接到根 ContentDocument 记录。这些 CSV 字段是必填字段。
     • Id:文件的唯一 18 个字符的 ContentVersion ID。
       

       备注 确保 ID 与 S3 存储桶中的文件名匹配。
     • ContentDocumentId:ContentDocument.csv 中的 ID。此 ID 将版本链接到容器。
     • PathOnClient:ContentDocuments 目录中相应物理文件的确切原始文件名。
     • VersionData:此字段需要为空。
     • ContentVersion 方案中的所有标准和自定义字段。
   • ContentDocumentLink.csv：此文件将 ContentDocument 记录及其所有版本链接到关联的根 Salesforce 记录，例如客户和个案。这些 CSV 字段是必填字段。
     • Id:文件的唯一 18 个字符的 ContentDocumentLink ID。
     • ContentDocumentId:ContentDocument.csv 的 ID。此 ID 将文件版本链接到容器。
     • LinkedEntityId:与文件关联的记录的 Salesforce ID。
     • ContentDocumentLink 方案中的所有标准和自定义字段。

导入附件记录

1. 在 S3 存储桶中，创建名为附件的目录。
2. 将所有附件文件放入附件目录。
   

   备注 每个文件都需要与上传到 Salesforce 的原始文件名相匹配。如果您有两个名称相同的不同文件，此过程将失败。
3. 创建名为 Attachment.csv 的 CSV 文件。该文件包含目录中每个附件文件的元数据和根记录链接。这些 CSV 字段是必填字段。
   • Id:附件的唯一 18 个字符的附件 ID。
   • ParentId:与此附件关联的记录的 Salesforce ID。
   • Name:此字段需要包含“附件”目录中相应物理文件的精确原始文件名。
   • 附件方案中的所有标准和自定义字段。

   

   备注 如果您有大量附件，您可以将元数据拆分为多个索引文件，例如 Attachment_1.csv 和 Attachment_2.csv。
   

   备注 所有 CSV 文件需要保留在根文件夹中。请勿将其放在 ContentDocuments 或 Attachments 子目录中。

解决文件名冲突

1. 将 S3 存储桶中的物理文件从原始名称重命名为其唯一的 18 个字符的 Salesforce ID，后跟文件后缀。例如：
   • 附件记录 invoice.pdf 会变为 00P5g000002aBCDEFGA.pdf
   • ContentVersion 文件 report.pdf 会变为 ⁇ g000001ABCDEFE.pdf
2. 将此新的基于 ID 的文件名添加到适当的 CSV 字段中，以便归档应用程序可以找到它。

   对于 ContentVersion 文件，更新PathOnClient字段。

   对于附件记录，更新Name字段。

验证并启动数据加载

1. 转到归档中的“活动”选项卡。
2. 在开始归档之前，您可以下载活动日志来验证所有 CSV 和文件是否加载成功。
   此日志显示了记录的数量，例如个案和附件，以及准备导入的物理文件的列表。在提交归档之前，您可以使用此日志来识别失败，例如缺少文件。

启动数据加载

警告 为防止错误，请确保您的 S3 源文件夹仅包含您计划导入的 CSV 文件。在开始前，删除任何测试文件、备份或无关的报表。

1. 从归档主页中，单击导入数据图标。
2. 输入 S3 存储桶的这些连接详细信息。
   • AWS 访问密钥 ID
   • AWS 密码访问密钥
   • S3 存储桶路径

     示例：//my-example-bucket/path/to/folder

   • S3 区域

     示例：us-east-2

3. 要开始进程，请单击导入。

监控数据加载过程

系统首先验证 S3 连接和文件格式。如果出现错误，进程将停止，并显示错误消息描述问题。

要查看导入数据加载活动的状态，请转到“活动”选项卡。进度由处理的文件数量来衡量。

备注 “导入数据加载”操作仅在“活动”选项卡上可见，不会显示在主页的“最近活动”部分。

运行和监控导入策略

1. 要开始最终归档过程，请单击导入策略上的立即运行。
2. 在“活动”选项卡中跟踪状态。
   使用操作类型 Import-data-archive 记录进程。

备注 每个归档进程最多分配 100 万个根记录。如果您计划导入超过 100 万条根记录，归档流程将根据需要分为尽可能多的单独流程，每个流程都有自己的活动，直到导入策略完成。

在开始新的导入之前，系统需要完成当前数据集的完整导入-数据加载和导入-数据归档周期。导入数据归档活动完成后，您的数据将被安全地存储，您可以开始新的导入周期。

保留策略