概述

借助“用户”页面中提供的通过 CSV 添加用户功能,管理员可以使用 CSV 文件在 Admin Console 中创建多个用户帐户。在用户帐户创建过程中,相关的状态和进度信息将显示在批量操作结果页面。您可以随时取消“用户”帐户的创建过程。

通过 CSV 添加用户

有关在 Admin Console 中处理用户的更多详细信息,请参阅管理用户

文件要求

以下是管理员在上载文件之前必须遵守的处理要求:

  • 文件格式和标题
  • 文件数据或行要求

文件格式和标题

  • 文件采用逗号分隔值 (CSV) 格式,后缀为 .csv。每条记录单独位于一行,由换行符 (CRLF) 分隔。例如,aaa,bbb,ccc CRLF。更多详细信息,请参阅 RFC 4180(CSV 文件规范)
  • 列标题有效。标题行为必填项。有关必填或可选字段以及文件格式的更多信息,请参阅“管理用户”中的 CSV 文件格式表。

注意:

上载的 CSV 文件必须使用逗号(“,”)作为分隔字段的分隔符。

在某些区域设置中,操作系统使用分号(“;”)作为字段分隔符。这会导致 Microsoft Excel 保存使用分号作为分隔符的文件,从而造成处理失败。您可以临时更新区域设置以解决此问题。或者,在保存 Excel 格式的文件时,选择另存为,然后选择 UTF -8 作为编码类型,将文件另存为 CSV。

解决方法

注意:

下面描述的更改可能会影响其他应用程序和电子表格。因此,请在 CSV 中进行必要的更改,然后还原这些设置。

  1. 转到 Windows 设置

  2. 导航至时间和语言 > 区域和语言 > 其他日期、时间和区域设置 > 更改日期、时间和数字格式

  3. 格式下拉列表中,选择英语(英国)

  1. 导航至控制面板 > 所有控制面板项 > 区域和语言

  2. 格式下拉列表中,选择英语(英国)

数据或行要求

请确保每个数据行都满足以下要求:

  • 包含有效的电子邮件地址。
  • 产品配置文件(或配置)(如果存在)有效。

注意:

如果您是团队客户,请将产品配置列标题更改为团队产品。另外,关于此列中的数据,请输入产品名称(不是产品配置文件名称)。

  • 各种选项(如果存在)有效。

注意:

国家/地区代码必须为两个字母的 ISO 3166 (alpha-2) 代码。

文件大小要求

您的 CSV 文件最多可包含 25,000 行(包含 5,000 行可获得最佳性能)。如果文件超过 5000 行,则在 Admin Console 上处理文件时,您会遇到性能问题(请参阅下一节:文件处理)。但是,我们将拒绝任何超过 25,000 行的 CSV 文件。

如果您要求上载的用户超过 25,000,我们建议您执行下列操作之一:

  1. 将您的 CSV 拆分为多个文件(每个文件最多 25,000 行)。为获得最佳性能,请使用 5000 行或更少。
  2. 使用 Adobe 的用户同步工具。该工具是一个命令行工具,可将用户和组信息从组织的企业目录系统(例如 Active Directory 或其他 LDAP 系统)移动到 Adobe Admin Console 中的组织目录。
  3. 使用 Adobe 的用户管理 REST API。您可以将该 API 集成到组织的管理应用程序和流程中。
  4. 如果您已在 Admin Console 与 Microsoft Azure 或 Google 联盟中设置 Federated ID,请使用其 Admin Console 连接器。请参阅借助 Adobe 为 SSO 设置 Google 联盟使用 Azure AD 连接器设置 SSO
  5. 如果您无法使用以上任何方法批量上载用户,请登录 Admin Console,导航至“支持”,然后联系 Adobe 客户关怀团队。

文件处理

处理文件时,将基于特定的域名,单独处理每个条目,具体情况如下表所示。

完成所有处理后,相关摘要将会通过电子邮件发送给执行处理的管理员。如果取消导入操作,处理过程也将随之停止。但是,已处理的行将无法实现回退。

身份类型 操作 例外情况
Federated ID
  • 使用指定的用户名。
  • 帐户会添加到指定的产品配置文件。
  • 除非要确定域名,否则不使用电子邮件地址。
  • 如果启用了“产品配置文件”通知,则会向用户发送电子邮件。
  • 用户名存在
  • 国家/地区(如果存在)没有开展 Adobe 业务*
  • 如果通过指定的产品配置文件无法获取足够的许可证,则根据组织或合同的类型,会出现以下情况之一:
    • 团队:出现“没有足够的许可证”错误
    • VIP:帐户会添加到指定的产品配置文件。但是,由于超出许可证配额,用户无法使用产品
    • ETLA:帐户会添加到指定的产品配置文件。用户可以访问指定的产品。在续订时会按实际费用收费
Enterprise ID
  • 根据给定的电子邮件地址,创建帐户。
  • 将帐户添加到指定的产品配置。
  • 向用户发送欢迎电子邮件。
  • 已经在发送邀请,或者,具有给定电子邮件地址的帐户已存在
  • 国家/地区(如果存在)没有开展 Adobe 业务*
  • 如果通过指定的产品配置文件无法获取足够的许可证,则根据组织或合同的类型,会出现以下情况之一:
    • 团队:出现“没有足够的许可证”错误
    • VIP:帐户会添加到指定的产品配置文件。但是,由于超出许可证配额,用户无法使用产品
    • ETLA:帐户会添加到指定的产品配置文件。用户可以访问指定的产品。在续订时会按实际费用收费
Adobe ID
  • 根据给定的电子邮件地址,创建帐户。
  • 将邀请函与列出的产品配置文件相关联。
  • 如果帐户存在,则将其添加到产品配置文件中。
  • 向用户发送欢迎电子邮件。
  • 具有给定电子邮件地址的帐户已存在。
  • 国家/地区(如果存在)没有开展 Adobe 业务*
  • 如果通过指定的产品配置文件无法获取足够的许可证,则根据组织或合同的类型,会出现以下情况之一:
    • 团队:出现“没有足够的许可证”错误
    • VIP:帐户会添加到指定的产品配置文件。但是,由于超出许可证配额,用户无法使用产品
    • ETLA:帐户会添加到指定的产品配置文件。用户可以访问指定的产品。在续订时会按实际费用收费

* Adobe 服务和软件受美国出口法律的控制,这些法律限制某些地区(包括但不限于古巴、伊朗、朝鲜、苏丹、叙利亚和乌克兰的克里米亚地区)对 Adobe 服务和软件的出口和使用。

注意:

“导入用户”功能不支持包含特殊字符(如,逗号“,”和分号“;”)的用户别名。

性能详情

为了避免过载,处理期间应遵循 66.6% 的占空比规则。如果处理条目的时间与波动平均值之间的差异超过 10%,则需要调整节流阀,以便将处理要求的时间控制在只占用实际时间的 2/3。

此外,负责管理节流控件的运营团队也应当限制处理速率。如果已经明确设置了节流控件,则禁用占空比控件。可通过 API 调用,恢复为基于占空比的节流。

处理期间,会为您显示每秒处理的请求数量,以提供性能反馈。

如果创建 1000 个帐户(其中,每个帐户要添加到 2 个产品配置中)的目标速率为 1 个帐户/秒(不考虑 66.6% 的占空比),那么实际处理速率是 0.66 个帐户/秒(或者说,大约 40 个帐户/分钟)。以此速率来创建 1,000 个帐户,则需要 25 分钟。以此速率来创建 5,000 个帐户,则需要两小时零五分钟。

故障诊断

本部分可帮助您在使用 Adobe Admin Console 中的批量导入功能时,故障诊断可能出现的各种错误条件或其他问题。

上载错误

有时,如果不满足某些条件,文件上载将会失败。

出现下列情况时,将会显示错误消息:

  • 文件不是 CSV 格式。
  • 必需的列标题(例如,电子邮件)无效或缺失。
  • 缺少必需的列。
headers_are_missing

请执行以下操作:

  • 仅使用 .csv 文件格式。
  • 确保列标题有效。
  • 确保列值有效。

有关必填或可选字段以及文件格式的更多信息,请参阅“管理用户”中的 CSV 文件格式表。

要修复 CSV 文件中数据格式的问题,请执行以下操作:

  1. Microsoft Excel 中打开 CSV 文件。

  2. 选择(突出显示)工作表中包含据的任何列。

  3. 转到数据选项卡,然后单击文本到列

  4. 在显示的对话框中,持续单击下一步,直到下一步按钮被禁用且完成按钮被启用为止。

  5. 单击“完成”,然后保存并关闭该文件。

  6. 将更新后的 CSV 文件上传到 Admin Console。

出现下列情况时,将会显示错误消息:

  • 存在必需的列标题(例如,电子邮件),但是缺少相应的行值。
error_parsing

确保为每行输入相应的值。

处理错误

如果系统无法处理上载文件中的数据行,则会出现处理错误。要查看详细信息,请参阅批量操作结果

INTERNAL_SERVER_ERROR 错误是因为网关超时导致的。系统在错误结果屏幕的状态列中显示 INTERNAL_SERVER_ERROR 错误。

InternalServerError

您可以稍后重试。

如果在未进行任何更改的情况下再次上载现有用户,则系统会在错误结果屏幕中的状态列中显示用户已添加消息。

用户已添加

确保不要再次上载现有用户。删除包含现有用户详细信息的行。

如果存在必需的列标题(例如,电子邮件),但是缺少相应的行值,则系统会在结果屏幕的状态列中显示解析数据时出错的消息。

错误解析

确保为每行输入相应的值。

对于 Enterprise IDFederated ID 用户,如果域名不满足以下条件,则会出现此类错误:

  • 域名列中存在有效的域名
  • 电子邮件 ID 具备有效的域名
  • 用户名具备有效的域名

结果屏幕中的状态列中将显示在组织中找不到域名的消息。

domain_was_not_found-fileuploadedbutnotprocessed

注意:

使用无效域名时会发生此类错误,这表明您的组织尚未声明或信任该域名。

请执行以下操作:

  • 域名列中输入有效域名
  • 根据“身份类型”,输入有效的电子邮件 ID
  • 根据“身份类型”,输入有效的用户名

对于 Enterprise IDFederated ID 用户,如果缺少国家/地区代码标题或数据值,或者两者同时缺失,则会发生此类错误。

结果屏幕中的状态列中将显示国家/地区代码必须为双字符 ISO-3166 值的消息。

国家/地区代码错误

请确保输入国家/地区代码列标题和相应的有效行值。

如果您是一位“系统”或“支持”管理员,并且仍然面临批量上载用户的问题,请通过 Admin Console 支持选项卡创建案例、开始聊天或管理现有案例。

有关更多帮助,请参阅创建支持案例