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

概述

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

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

文件要求

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

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

文件格式和标题

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

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

在某些区域设置中,操作系统使用分号(“;”)作为字段分隔符。这样导致 Microsoft Excel 保存文件时用分号作为分隔符,从而导致处理失败。您可以临时更新区域设置以解决此问题。或者,在 Excel 中保存文件时,选择“另存为”,然后通过选择 UTF-8 作为编码类型而将文件另存为 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 客户关怀部门。

文件处理

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

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

身份类型

操作

例外

Business ID

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

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

注意:

为了提供企业存储和其他企业级功能等优势,我们将所有现有的 Adobe ID 迁移到 Business ID。所有新的企业客户都将为其团队成员使用 Business ID。

当为您的组织安排此升级时,您将预先收到通知。有关更多信息,请参阅 Business ID 和新存储功能简介。在您的组织迁移之前,您将继续使用 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 值”消息。

国家/地区代码错误

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

如果您的组织已更新为新的 Business ID,并且您已输入 Adobe ID 作为 CSV 中的身份类型,则您将遇到此错误。

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

如果您的组织尚未更新为新的 Business ID,并且您已输入 Business ID 作为 CSV 中的身份类型,则您将遇到此错误。

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

如果您遇到此错误,则表示您的组织已更新为 Adobe 的新 Business ID,并且您已输入 Adobe ID 作为 CSV 中的身份类型。

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

如果您遇到此错误,则表示您的组织已更新为 Adobe 的新 Business ID,并且您正在将 Adobe ID 添加到用户组。

您必须从 Business ID、Enterprise ID 或 Federated ID 类型用户中进行选择以添加到用户组。

如果您尝试编辑 Business ID 用户的名字、姓氏和国家/地区,则您将遇到此错误。不允许对 Business ID 类型用户执行此操作。

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

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

Adobe 徽标

登录到您的帐户