概要： ◀ ▼
您可以使用 CSV 文件批量导入或更新多个组织，与单独添加相比可以节省时间。CSV 必须遵循特定的格式规则和大小限制，并且只有管理员才能执行导入。该流程支持核心组织数据和自定义字段，但有一些限制，例如不能保证导入顺序，一个文件中不能有重复条目。导入历史记录日志跟踪进度。
您可以通过导入 CSV（用逗号分隔的值）文件批量添加多个组织，而不是一次添加一个组织。您可以使用批量导入来添加组织或更新组织。您必须是管理员才能批量导入组织。您还可以一次添加或更新多个用户和多个自定义对象记录。
批量导入组织操作不可撤消。在导入包含您所有组织信息的 CSV 文件之前，用单个组织记录测试同一个 CSV 文件，以确保上传正常。
使用数据导入工具批量导入的限制
您可以导入关于用户和组织的核心数据集。要导入下表中未列出的数据，您必须改用 Zendesk REST API。请参阅使用 Zendesk API 导入用户。
- 使用数据导入工具时，导入的 CSV 文件大小不得超过 1 GB。我们建议最多 500,000 行，即 1 个标题行和最多 499,999 行数据。此外，每行大小不得超过 128 KB。
- 导入的 CSV 文件最多可包含 200 列。
- 导入的 CSV 文件无法保证行的导入顺序。
- 请勿在一个 CSV 文件中包含多个相同的用户或组织，以免导入失败。
- 无法保证记录以其在 CSV 文件中显示的顺序创建或更新。
- 每次只能导入一个 CSV 文件。因此，如果您的数据多于 CSV 文件支持的最大行数，则必须为每个批次单独创建文件，并逐个导入。如果您不使用数据导入工具，则最多允许两个批次在后台排队运行。如果您想导入两个以上的批次，则需等到第一批导入完成后再添加更多批次。
- 无法使用批量导入从终端用户 Facebook 或 X（原 Twitter）帐户导入联系人信息。请使用 Zendesk REST API。使用 Zendesk API 导入用户
创建 CSV 组织数据文件
要批量导入组织，请使用 CSV 组织数据文件。本节说明如何设置 CSV 数据文件。
- 文件必须是格式正确的 CSV，并使用 UTF-8 字符编码保存。
- CSV 文件的第一行是标题行。
- 标题行必须包含下表中的所有必填字段，以及您要包含在下表中的所有其他字段。
- 在标题行中，使用 domain_names 或 default，具体取决于您的导入方法。它们不能一起使用。
- 如果您不打算为某个字段导入数据，请不要将其列在标题行中。
- 文件中的空白数据列将覆盖该组织的任何现有数据。
- 按 ALT + ENTER (Windows) 或 CTRL + OPTION + RETURN (macOS) 可在注释或多行自定义字段中添加换行符。
| 字段 | 描述 |
|---|---|
| 名称 | 必填。组织名称。 |
| external_id | 选填，但建议填写；如果您打算以后使用数据导入工具更新这些记录，则为必填。唯一标识值，例如外部系统中的员工或客户标识号。 |
| 注释 | 关于组织的注释。注释仅对专员可见，不会对终端用户可见。 |
| details | 关于该组织的详细信息，例如地址。此信息仅对专员可见，不会对终端用户可见。使用数据导入工具时，使用此字段代替默认标头。 |
| domain_names | 用于用户映射的组织域名。如果您要为一个组织添加多个域名，请用竖线字符 (|) 分隔。 |
| group_id | 输入组织的默认组。请参阅映射组到组织 |
| tags | 当 Zendesk Support 启用用户和组织标签时，您可以为组织设置标签。每个标签以竖线字符 (|) 分隔。 当批量导入组织时，您的 CSV 文件中的标签将替换现有的组织标签。要避免这种情况，请使用标签 API 来更新标签。 |
| organization_fields.<字段键值> | 执行批量组织导入时，您可以通过指定 organization_fields. 前缀和字段键值导入自定义组织字段。 例如，对于字段键值 subscription_date，使用以下内容设置此字段的导入值。 organization_fields.subscription_date 要查找组织字段的字段键，请参阅查找自定义字段的字段键或字段 ID。 如果字段值格式不正确，导入将失败，您将在导入历史记录日志中看到错误详情。对于自定义日期字段，使用 YY/MM/DD 或 YYYY-MM-DD 格式。对于复选框字段，使用 True 或 False。要设置下拉字段的值，使用您在创建下拉列表时添加的标签。
注意：在数据导入工具页面上导入组织时，不支持“查找关系”字段。
请参阅为组织添加自定义字段。 |
使用数据导入工具导入组织
您可以使用数据导入工具导入 CSV 文件，该文件可创建新组织或更新现有组织，并通过数据导入工具页面捕获所有尝试导入的日志。
当导入过程完成后，您的导入将被添加到队列中，而组织将被添加到 Zendesk Support。每个文件大约需要一个小时才能完成，但这取决于文件大小和队列大小。
- 在管理中心，单击侧栏中的对象和规则 (
)，然后选择工具 > 数据导入工具。 - 单击导入。
- 在目标下，选择组织。
- 在导入选项下，选择以下选项之一：
- 仅创建记录：仅创建新组织。CSV 文件中与现有组织相关的所有数据都将被忽略。
- 仅更新记录：替换 CSV 文件中列出的现有组织的数据。更新组织时，external_id 必填。与新组织相关的所有数据都将被忽略。
- 创建和更新记录：创建新组织，并更新 CSV 文件中现有组织的数据。
- 在文件上传下，拖放您的文件，或单击以上传并从文件浏览器中选择您的 CSV 文件。
要更改所选文件，请单击文件名称旁边的删除图标 (
)。 - 单击下一步。
- 查看字段映射列表。
- 如果字段映射正确，单击下一步。
- 如果字段映射不正确，单击上一步。编辑您的 CSV 文件，使其符合格式要求，然后重新上传文件。
- 在确认对话框中查看导入详情概要，然后单击开始导入。
导入开始后，无法撤消已导入的更改。要了解导入状态，请查看导入历史记录。
翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性
如对翻译准确性有任何疑问，请以文章的英语版本为准。