为 CSV 批量上传用户排除故障 | Adobe Admin Console

概述

通过可在“用户”页面上找到的“通过 CSV 添加用户”功能,管理员可使用 CSV 文件在 Admin Console 中创建多个用户。在“批量操作结果”页面上显示创建用户帐户过程的状态和进度。随时可取消创建用户帐户的过程。

注意:

本文所述过程中使用的 CSV 文件可能使用逗号 (,) 或分号 (;) 作为分隔符。

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

文件要求

管理员在上传文件之前必须满足的处理要求如下:

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

文件格式和标题

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

解决方法

注意:

如下所述的更改可能会影响其他应用程序和电子表格。因此,请在 CSV 中作出必要的更改,随即撤消这些设置。 

Windows 10

  1. 转到 Windows 的“设置”

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

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

Windows 7

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

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

数据或行要求

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

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

如果您是 Teams 客户,请将“产品配置”列标题改为“团队产品”。此外,对于此列中的数据,请输入“产品”名称(而非“产品配置文件”名称)。

  • 选项(如果存在)有效。
注意:

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

文件大小要求

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

如果需要上传大于 25,000 个用户,我们推荐采用以下方法之一:

  1. 将 CSV 拆分为多个(最大)25,000 行的文件。为获得最佳性能,请使用 5,000 行或更少。
  2. 使用 Adobe 的用户同步工具。这是一个命令行工具,它将用户和组信息从组织的企业目录系统(如 Active Directory 或其他 LDAP 系统)转移到组织在 Adobe Admin Console 中的目录。
  3. 使用 Adobe 的用户管理 REST API。可将此 API 集成到组织的管理应用程序和流程中。
  4. 如果已用 Microsoft Azure 或 Google 联合身份验证在 Admin Console 上设置了 Federated ID,请使用其 Admin Console 连接器。请参阅设置 Google 联合身份验证以用于 SSO 登录 Adobe用 Azure AD 连接器设置 SSO
  5. 如果使用任何上述方法都无法批量上传用户,请登录到 Admin Console,导航到“支持”,然后联系 Adobe 客户关怀部门。

文件处理

在处理文件时,将根据具体的域单独处理每个条目,如下表中所述。

完成所有处理后,通过电子邮件将摘要发送到发起处理的管理员。如果取消导入操作,则停止处理。但是,并不回滚已处理的行。

注意:

我们正在将组织(团队或企业)更新到企业存储模型,以便为 Adobe ID 用户启用企业存储和其他企业级功能。

当为您的组织安排此更新时,您将收到通知。更新后,Adobe ID 用户将移至企业存储,并且组织将直接管理其企业资料

身份类型

操作

例外

Federated ID

  • 使用指定的用户名创建用户记录。
  • 将帐户添加到指定的产品配置文件。
  • 除了用于确定域之外,不使用电子邮件地址。
  • 如果启用了产品配置文件通知设置,则将一封电子邮件发给用户。

  • 用户名存在
  • 对于某个国家/地区(如果存在)不开放 Adobe 业务*
  • 根据组织或合同的类型,如果通过指定的产品配置文件找不到足够的许可证,则发生以下情况之一:
    • Teams:发生“没有足够的许可证”错误
    • VIP:将帐户添加到指定的产品配置文件。但是,由于超出许可证配额,因此产品对用户不可用
    • ETLA:将帐户添加到指定的产品配置文件。用户获得指定产品的访问权限。续订时向您收取补足款

Enterprise ID

  • 使用给定的电子邮件地址创建帐户。
  • 将帐户添加到指定的产品配置。
  • 将一封欢迎电子邮件发给用户。

  • 已有正在进行的邀请或存在具有给定电子邮件的帐户
  • 对于某个国家/地区(如果存在)不开放 Adobe 业务*
  • 根据组织或合同的类型,如果通过指定的产品配置文件找不到足够的许可证,则发生以下情况之一:
    • Teams:发生“没有足够的许可证”错误
    • VIP:将帐户添加到指定的产品配置文件。但是,由于超出许可证配额,因此产品对用户不可用
    • ETLA:将帐户添加到指定的产品配置文件。用户获得指定产品的访问权限。续订时向您收取补足款

Adobe ID

  • 使用给定的电子邮件地址创建帐户。
  • 帐户被添加到指定的产品配置。
  • 如果您在编辑产品配置文件中启用了通过电子邮件通知用户选项,则会向用户发送欢迎电子邮件。

 

  • 已有正在进行的邀请或存在具有给定电子邮件的帐户.
  • 对于某个国家/地区(如果存在)不开放 Adobe 业务*
  • 根据组织或合同的类型,如果通过指定的产品配置文件找不到足够的许可证,则发生以下情况之一:
    • Teams:发生“没有足够的许可证”错误
    • VIP:将帐户添加到指定的产品配置文件。但是,由于超出许可证配额,因此产品对用户不可用
    • ETLA:将帐户添加到指定的产品配置文件。用户获得指定产品的访问权限。续订时向您收取补足款

 

警告:

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

注意:

“导入用户”功能不支持具有特殊字符(如逗号 (,) 或分号 (;))的用户昵称。

性能详细信息

为避免过载,处理过程中须遵守 66.6% 占空比的规则。如果处理条目的时间与滚动平均值相差 10% 以上,则调整节流机制,以使处理请求仅占用 2/3 的真实时间。

此外,受运营团队管理的节流控制也限制处理速率。如果明确设置了节流控制,则禁用占空比控制。有一个 API 调用可以切换回基于占空比的节流。

它向您显示每秒处理的请求数,以提供有关性能的反馈。

创建 1,000 个帐户并将每个帐户添加到 2 个产品配置的目标速率为 1 个帐户/秒,不计入 66.6% 的占空比,因此表观处理速率可达到 0.66 个帐户/秒,即 40 个帐户/分钟。在此速率下创建 1,000 个帐户耗时 25 分钟。在此速率下创建 5,000 个帐户耗时两小时五分钟。

故障排除

“故障排除”部分帮助您排除在使用 Adobe Admin Console 的批量导入功能时可能出现的错误状况或其他问题。

上传错误

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

在以下情况下显示该错误消息:

  • 文件并非 CSV 格式。
  • 所需的列标题(例如“电子邮件”)无效或缺少它。
  • 缺少所需的列。

执行以下操作:

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

有关必备或可选字段和文件格式的详细信息,请参阅“管理用户”中的 CSV 文件格式表。

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

  1. Microsoft Excel 中打开 CSV 文件。

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

  3. 转到“数据”选项卡并单击“分列”

  4. 在随后显示的对话框中反复单击“下一步”,直到禁用了“下一步”按钮并启用了“完成”按钮。

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

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

在以下情况下显示该错误消息:

  • 当存在所需的列标题(例如“电子邮件”),但缺少相应的行值时。

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

处理错误

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

原因

INTERNAL_SERVER_ERROR 错误由网关超时引起。它在错误结果屏幕上的“状态”列中显示 INTERNAL_SERVER_ERROR

解决方法

您可稍后重试。

原因

如果不作任何更改即再次上传现有用户,则它在错误结果屏幕上的“状态”列中显示“已添加用户”

已添加用户

解决方法

务必不要再次上传现有用户。删除包含现有用户详细信息的行。

原因

此错误发生在与 Azure SyncGoogle Sync 关联的目录中。在身份提供方一侧管理用户。

解决方法

我们建议您编辑和管理身份提供方门户中的同步数据,并允许通过同步传播更改。除非绝对必要,否则不要在 Admin Console 中手动更改数据。

原因

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

Error parsing

解决方法

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

原因

如果域不满足以下条件,则对于 Enterprise IDFederated ID 用户发生该错误:

  • 列中的域名有效
  • 电子邮件 ID 的域名有效
  • 用户名的域名有效

在结果屏幕上的状态列中显示在您的组织中未发现域消息。

注意:

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

解决方法

执行以下操作:

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

原因

如果您的组织没有拥有您要将用户添加到的域,则会出现此错误。

解决方法

要将用户添加到域,可以执行下列操作之一:

原因

如果缺少国家/地区代码标题和/或数据值,则对于 Enterprise IDFederated ID 用户发生该错误。

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

国家/地区代码错误

解决方法

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

原因

当您的组织已更新为企业存储模型,并且您已输入 Adobe ID 作为 CSV 中的身份类型时,将出现此错误。

解决方法

您必须从 Enterprise ID 或 Federated ID 类型用户中进行选择。

原因

通常,当 CSV 文件中的用户名未对应于组织的 Admin Console 中的任何用户时,会出现此错误。它是在 Adobe Admin Console 中的现有可用用户的操作期间触发的。

用户不在组织中

解决方法

管理员应验证 CSV 字段中提供的用户名值是否包含在 Adobe Admin Console 中可用的用户信息中。

原因

此错误仅在切换用户身份期间出现。在 CSV 文件中,给定的用户名匹配,但电子邮件与 Admin Console 上的目录中的电子邮件不匹配。

电子邮件必须匹配

解决方法

确保电子邮件与为 Admin Console 上的目录定义的域匹配。

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

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

 Adobe

更快、更轻松地获得帮助

新用户?

Adobe MAX 2024

Adobe MAX
创意大会

10 月 14 日至 16 日迈阿密海滩及线上

Adobe MAX

创意大会

10 月 14 日至 16 日迈阿密海滩及线上

Adobe MAX 2024

Adobe MAX
创意大会

10 月 14 日至 16 日迈阿密海滩及线上

Adobe MAX

创意大会

10 月 14 日至 16 日迈阿密海滩及线上