您可以通过导入 CSV(逗号分隔的值)文件一次性添加和更新多条记录,而不是一次添加一条自定义对象记录。您必须是管理员才能批量导入自定义对象记录。
本文章包含以下主题:
要求和限制
批量导入存在以下限制:
- 导入的 CSV 文件大小不能超过 1 GB。我们建议最多 500,000 行,即 1 个标题行和最多 499,999 行数据。此外,每行大小不得超过 32 KB。
- 导入的 CSV 文件最多可包含 102 列。
- 请勿在一个 CSV 文件中多次包含相同的记录。这样做会导致导入失败。
- 无法保证记录以其在 CSV 文件中出现的顺序创建或更新。
- 每次只能导入一个 CSV 文件。因此,如果您的数据多于 CSV 文件支持的最大行数,则必须为每个批次单独创建文件,并逐个导入。
- 批量导入自定义对象记录不可撤消。在导入包含您当前所有记录信息的 CSV 文件之前,用单个记录测试同一个 CSV 文件,以确保上传正常。
创建自定义对象记录 CSV 文件
要批量导入自定义对象记录,您需要使用 CSV 文件。在创建文件时,请记住以下重要事项:
- 文件必须为正确的 CSV 格式,并使用 UTF-8 字符编码保存。
- CSV 文件的第一行是标题行。
- 标题行必须包含 名称 字段。(可选)如果您希望将来批量更新记录,还必须添加一个 external_id 字段。标题行中的所有其他字段名称应与自定义对象中的字段键精确匹配。
- 要导入下拉字段的值,请使用自定义下拉字段的 field_key 作为列标题,并指定选项 标签,而不是用户友好的值。
- 要导入查找关系字段的值,请使用自定义查找关系字段的 field_key 作为列标题,并提供记录的 id 或 外部 id。如果您使用记录的 ID,请提供该值。如果您使用 外部 ID,请使用 external_id:value格式,其中 value 将替换为相关记录的外部 ID 值。
- 如果您不打算为某个字段导入数据,请不要将其列在标题行中。
- 按 ALT + ENTER (Windows) 或 CTRL + OPTION + RETURN (macOS) 可在注释或多行自定义字段中添加换行符。
如果您要批量上传记录,以便为新自定义对象的现有数据做种,我们建议您查看 规划自定义对象工作流程。在此过程中,我们建议使用此数据为每个自定义对象创建电子表格。如果结构与 您在 Zendesk 中创建的自定义对象 和上述指南相一致,您可以将电子表格导出为 CSV 文件,并将其用于批量上传。在这种情况下,如果您以后想批量更新记录,请确保为 external_id 添加列,并为每条记录添加一个 ID。
导入自定义对象记录 CSV 文件
您可以使用数据导入工具导入 CSV 文件,该文件将创建新的自定义对象记录或更新现有记录,并捕获所有通过数据导入工具页面尝试导入的日志。
使用数据导入工具创建或更新自定义对象记录
- 您必须先 在 Zendesk 中创建自定义对象,然后才能批量上传自定义对象的记录。
- 在管理中心,单击侧栏中的对象和规则 (),然后选择工具 > 数据导入工具。
- 单击导入。
- 在导入类型下,选择以下任一选项:
- 仅创建:仅创建新的自定义对象记录。CSV 文件中与现有记录相关的所有数据都将被忽略。
- 仅更新:替换 CSV 文件中列出的现有自定义对象记录的数据。与新记录相关的所有数据都将被忽略。
- 创建和更新:创建新的自定义对象记录,并更新 CSV 文件中列出的现有自定义对象记录的数据。
- 在 目标下,选择自定义对象的名称。
- 在文件上传下,拖放您的文件,或单击以上传并从文件浏览器中选择您的 CSV 文件。
要更改所选文件,请单击文件名称旁边的删除图标 ()。
- 单击下一步。
- 查看字段映射列表。
- 如果字段映射正确,单击下一步。
- 如果字段映射不正确,单击上一步。编辑您的 CSV 文件,使其符合 格式要求,然后重新上传 文件。
- 在确认对话框中查看导入详情概要,然后单击开始导入。
导入开始后,无法撤消已导入的更改。要了解导入状态,请查看导入历史记录。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。