您可以通过导入 CSV(逗号分隔的值)文件批量添加多个组织,而不是一次添加一个组织。您可以使用批量导入来添加组织或更新组织。您必须是管理员才能批量导入组织。您还可以一次添加或更新多个用户和多个自定义对象记录。
批量导入组织操作不可撤消。在导入包含您所有组织信息的 CSV 文件之前,用单个组织记录测试同一个 CSV 文件,以确保上传正常。
批量导入用户和组织的限制
您可以导入关于用户和组织的核心数据集。例如,使用批量导入,您可导入下表中的数据;但是,您无法导入时区、照片、语言首选设置等。要导入下表中未列出的数据,您需要改用 Zendesk REST API。请参阅使用 Zendesk API 导入用户或使用 Zendesk API 导入组织。
- 最大行数取决于导入方法。
- 在使用批量操作页面导入新增和现有用户和组织数据时,导入的 CSV 数据文件最多可包含 2,000 行。即 1 个标题行和最多 1,999 行数据。
- 使用数据导入工具(beta 版)导入新增和现有用户和组织数据时,导入的 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 | 选填,但建议填写;如果您打算以后使用数据导入工具更新这些记录,则为必填。唯一标识值,例如外部系统中的员工或客户标识号。 |
注释 | 关于组织的注释。注释仅对专员可见,不会对终端用户可见。 |
domain_names (仅限数据导入工具) |
关于该组织的详细信息,例如地址。此信息仅对专员可见,不会对终端用户可见。使用数据导入工具时使用,取代默认标头。 |
默认 (非数据导入工具) |
这用于将用户映射到组织。输入一个或多个电邮域名,以空格分隔(例如 organization1.com organization2.com)。不使用数据导入器时使用,取代 domain_names 标头。 |
已分享 | True 或 False。将组织设置为共享组织。 请参阅为终端用户设置共享组织 |
shared_comments | True 或 False。允许此组织内的所有用户互相评论工单。共享字段也必须设置为 true。 请参阅为终端用户设置共享组织 |
组 | 输入组织的默认组。请参阅映射组到组织 |
标签 | 当 Zendesk Support 启用用户和组织标签时(请参阅添加标签和用户到组织),您可以为组织设置标签。用空格分隔每个标签。 当批量导入组织时,您的 CSV 文件中的标签将替换现有的组织标签。要避免这种情况,请使用标签 API 来更新标签。 |
organization_fields.<字段键值> (仅限数据导入工具) |
执行批量组织导入时,您可以通过指定 organization_fields. 前缀和字段键值导入自定义组织字段。 例如,对于字段键值 subscription_date,使用以下内容设置此字段的导入值。 organization_fields.subscription_date 要查找自定义组织字段的键值,单击管理员图标 () 并选择组织字段,然后单击自定义字段的名称。字段键值将显示在右侧的属性面板中。 如果字段值格式不正确,导入将失败,您将在导入历史记录日志中看到错误详情。对于自定义日期字段,使用 YY/MM/DD 或 YYYY-MM-DD 格式。对于复选框字段,使用 True 或 False。要设置下拉字段的值,使用您在创建下拉列表时添加的标签。
注意:在数据导入工具页面上导入组织时,不支持“查找关系”字段。
请参阅为组织添加自定义字段。 |
custom_fields.<字段键值> (非数据导入工具) |
执行批量组织导入时,您可以通过指定 custom_fields 前缀和字段键值导入自定义组织字段。 例如,对于字段键值 subscription_date,使用以下内容设置此字段的导入值。 custom_fields.subscription_date 要查找自定义组织字段的键值,单击管理员图标 () 并选择组织字段,然后单击自定义字段的名称。字段键值将显示在右侧的属性面板中。 如果字段值的格式不正确,导入将失败,您将收到一条错误报告,说明哪些记录保存失败。对于自定义日期字段,使用 YY/MM/DD 或 YYYY-MM-DD 格式。对于复选框字段,使用 True 或 False。要设置下拉列表选项的值,使用您在创建下拉列表时添加的标签。
注意:如果要导入的自定义组织字段是查找关系字段,请输入相关对象的 ID 作为该字段的值。例如,对于组织,输入组织的 ID;对于用户,输入用户的 ID;对于自定义对象记录,输入自定义对象记录的 ID。要查找组织、用户或自定义对象记录 ID,您可以从帐户导出数据,或使用组织 API、用户 API 或自定义对象 API。
在数据导入工具页面上导入组织时,不支持“查找关系”字段。 请参阅为组织添加自定义字段。 |
导入 CSV 组织数据文件
您可以使用批量导入来创建新组织或更新现有组织的信息。
当导入过程完成后,您的导入将被添加到队列中,而组织将被添加到 Zendesk Support。每个文件大约需要一个小时才能完成,但这取决于文件大小和队列大小。请参阅批量导入用户和组织的限制。
使用数据导入工具导入组织数据
您可以使用数据导入工具导入 CSV 文件,该文件可创建新组织或更新现有组织,并通过数据导入工具页面捕获所有尝试导入的日志。
- 在管理中心,单击侧栏中的对象和规则 (),然后选择工具 > 数据导入工具。
- 单击导入。
- 在目标下,选择组织。
- 在导入类型下,选择以下任一选项:
- 仅创建:仅创建新组织。CSV 文件中与现有组织相关的所有数据都将被忽略。
- 仅更新:替换 CSV 文件中列出的现有组织的数据。更新组织时,external_id 必填。与新组织相关的所有数据都将被忽略。
- 创建和更新:创建新组织,并更新 CSV 文件中现有组织的数据。
- 在文件上传下,拖放您的文件,或单击以上传并从文件浏览器中选择您的 CSV 文件。
要更改所选文件,请单击文件名称旁边的删除图标 ()。
- 单击下一步。
- 查看字段映射列表。
- 如果字段映射正确,单击下一步。
- 如果字段映射不正确,单击上一步。编辑您的 CSV 文件,使其符合格式要求,然后重新上传文件。
- 在确认对话框中查看导入详情概要,然后单击开始导入。
导入开始后,无法撤消已导入的更改。要了解导入状态,请查看导入历史记录。
使用批量操作导入以导入组织数据
建议使用数据导入工具,但您仍可以使用批量操作页面导入新增和更新的组织数据。从此页面导入完成时,您将收到一封电邮。
- 在管理中心,单击侧栏中的人员图标 (),然后选择批量操作 > 导入组织。
- 选择您要执行的导入类型:
-
创建新组织
-
更新现有的组织:使用此类型的导入以替换 CSV 文件中列出的组织现有数据。
组织的 external_id 或名称必须包含在 CSV 中,以便识别。除了组织标识符字段之外,您只需在文件中包含您要更新的字段。如果组织的行有空白字段,它将覆盖该组织的现有数据。
-
- 单击选择文件或粘贴数据链接。
- 单击导入。
导入开始后,无法撤消已导入的更改。
- (可选)在管理中心 > 对象和规则 > 工具 > 数据导入工具页面查看正在进行的导入状态。导入完成后,可在该页面上的“导入历史记录”日志中找到。