概述:批量添加

利用“导入用户(批量上载)”功能,您可以凭借企业管理员的身份创建一个包含若干用户标识的文件,并且可以将该文件提交至企业客户管理员用户管理页面,以进行处理。文件中的每个条目代表一位用户,经过处理后,会为每位用户创建一个帐户。由于可能涉及成千上万个帐户,因此我们会向您显示处理的状态及进度,您可以随时取消文件的处理。

如果客户购买了 Adobe 的许可协议(即,向客户授予特定数量的 Adobe 各种产品的许可证),我们会相应地为该客户创建企业帐户。购买交易结束后,Adobe 代理会为该组织创建一个帐户,并为这个帐户创建一个具有管理员功能的用户。这位管理员可以为组织中的成员创建并管理用户帐户。

注意:

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

功能

当选择了要处理的文件后,随后将会执行下面的预检查操作,如果检查失败,则提供相关的错误消息。

  • 文件为 CSV 格式
  • 标题合法(如果有)
  • 1-5000 个条目

对于每个条目:

  • 电子邮件地址应当合法
  • 零个或多个指定的产品配置
  • 国家/地区(如果有)是合法的,并且是 Adobe 开展业务的国家/地区
  • 各种选项(如果有)合法

每个导入操作的处理限度为每个文件至多含有 5000 个条目。

处理文件时,每个条目将按照以下方式进行单独处理:

电子邮件地址的域名

操作

例外情况

由组织声明并由 Adobe 管理 根据给定的电子邮件地址,创建 Adobe ID 帐户。发送欢迎电子邮件。

已经在进行邀请的发送,或者,具有给定电子邮件地址的帐户已存在。

国家/地区(如果有)没有向 Adobe 业务开放。

非法的产品配置或超出配额。

由组织声明并由企业管理 使用指定的用户名创建个人记录。添加到指定的产品配置中。除非要确定域名,否则不使用电子邮件地址。不发送电子邮件。

已存在用户名。

国家/地区(如果有)没有向 Adobe 业务开放。

非法的产品配置或超出配额。

组织并未声明

向用户电子邮件地址发送邀请电子邮件。不创建帐户。将邀请函与列出的产品配置相关联。

如果存在帐户,则添加到产品配置中。

已收到邀请,或者,已存在具有给定电子邮件地址的帐户。

国家/地区(如果有)没有向 Adobe 业务开放。

在完成所有文件条目的处理后,我们将会向那些新加入的用户发送一封电子邮件,通知他们处理结束并附上结果摘要。

如果取消导入操作,处理过程也将随之停止。已完成的处理将无法撤消(回退)。

用户界面

在管理控制台的“列表用户”面板中,有一个用于上载用户文件的图标。用户文件的类型必须是“csv”,而且要包含“.csv”后缀。关于它的格式,我们将会在下面进行介绍。

当选择导入用户文件时,会显示一个对话框,其中包含指导说明、下载示例文件的链接,以及一个可用来浏览和选择要上载并处理的文件的链接。

一旦选择了要处理的文件,则会对该文件执行预检查以确定其有效性,并且在检测到错误后予以报告。如果没有错误,系统就会将该文件保存在服务器上,并开始着手处理。对于给定的组织(无论拥有什么域)而言,系统每次只能处理一个导入操作,因此只有当第一个导入操作完成后,才能启动后续的导入操作。

当接受处理时,“列表用户”面板的“导入结果”选项卡上会显示一行内容。该条目具体包含以下内容:

  • 文件名
  • 上载及开始处理的日期/时间
  • 状态(“正在处理”/“已完成”/“已取消”)(会定期更新)
  • 创建的帐户数量(会定期更新)
  • 错误数量(会定期更新)
  • 处理速率(条/秒)(会定期更新)
  • 估计剩余时间(会定期更新)
  • 取消操作的控件(仅在处理过程中出现)
  • 指向报告的链接(当处理结束时)
  • 删除条目的控件(当处理结束时)

单击文件名会弹出一份报告,其中包含状态为“已完成”或“已取消”时的详细处理信息。显示摘要信息,其中包含成功条目及各种类型的失败的数量。仅显示非零值。

处理期间,“活动用户列表”(如果显示)开始展示所有已创建的用户,或者会显示更新的用户数量。

随着处理的进行,生成的用户邀请会显示在“待处理”的邀请列表中,或者会显示更新的邀请数量。

报告是在处理过程结束后形成的,其中显示了每个处理条目的结果。报告包含三栏:

  • 行号
  • 电子邮件地址
  • 状态和错误消息(如果有)

报告是按行号排序的,而行号对应于 csv 文件中的原始行号。

重要:“导入结果”页面可显示 90 天以内的报告。超过 90 天的报告将会自动删除,系统管理员无权干涉。

文件格式

列出用户的文件必须符合 RFC 4180(CSV 文件规范)。标题行(如果有)必须如下所示:

类型、电子邮件、产品配置、用户名、国家/地区代码、名字、姓氏、选项

注意:这些字段可能会定期更改,所以,请务必确保标题与 Admin Console 中的最新示例匹配。

这些字段的定义如下所示:

字段

语法

解释

类型 Adobe ID、Enterprise ID 或 Federated ID 值中的一种。 这些值可以控制那些分配给用户的 ID 类型。不区分大小写。对于域而言,ID 类型必须是有效的。
电子邮件

RFC 2822 sec 3.4.1

最多 60 个字符

包含用户名和域名。对于企业管理的域,仅使用域名。用户名决定帐户名。对于其他帐户类型,该字段是用于用户和帐户名的电子邮件地址。
产品配置 逗号分隔的产品配置昵称列表 这是您希望分配给用户的产品配置昵称。您可以一次性为用户分配多项产品配置,并用逗号分隔这些配置名称。例如,“受众管理:Audience Manager - 默认访问权限, 仅限自定计划 - 自定计划 - 设计”
用户名 任意字符串。必须是 ASCII 码。 仅用于企业管理的域中。它将作为这位用户的帐户名。必须是电子邮件地址,域名所有者可以强制用户们使用相同的电子邮件地址。最大长度为 255 个字符
国家/地区代码 ISO 3166-1 alpha-2 国家/地区代码这是一个由双字母组成的国家/地区代码(例如,美国的代码是“US”) 如果该字段存在,则必须进行检查以确保用户来自 Adobe 能够合法开展业务的国家/地区。对于企业管理的帐户,该字段必须存在。
名字 字符串 最大长度为 255 个字符
姓氏 字符串 最大长度为 255 个字符
选项

逗号分隔的名称列表。该字段可供未来使用

预期的未来值:

NoEmail:禁止向帐户发送欢迎电子邮件。

ResetPassword:标记要重置密码的帐户

下载

故障诊断批量上载的问题

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

“无效的配置名称”错误

如果您遇到“无效的配置名称”错误(“INVALID_ CONFIGURATIONS”),请检查 Admin Console 中的产品配置:

  • 如果产品配置为“默认配置”,那么这是一个作为示例而提供的虚拟配置。您必须编辑此配置,以将其转换为真实、有效的产品配置。
  • 如果您新建一个产品配置,那么“默认配置”将会消失。
  • 在编辑产品配置或新建产品配置后,请再次尝试批量导入。

验证 CSV 格式

验证您的 CSV 文件,具体方法是:将您的文件与功能板中的示例模板进行比较。重要的字段包括“名字”、“姓氏”、“用户 ID”、“电子邮件地址”和“国家/地区代码”。

如果用户存在,导入则不会失败。取而代之,您看到的会是一则指明用户存在于批量上载报告中的消息。

上载报告可列出与现有用户警告不同的其他错误。

导入错误

各种类型的用户 ID 的必填字段:

类型 电子邮件 产品配置 用户名 国家/地区代码 名字 姓氏 选项
Adobe ID 必填 可选 可选 可选 可选 可选 可选
Enterprise ID 必填 必填 可选 可选 可选 可选 可选
Federated ID 必填 必填 必填 必填 可选 可选 可选

已知问题

目前,在批量导入报告中,导入错误消息的右侧被截断。Admin Console 的未来版本将会校正此问题。

涉及导入错误的各种情况、消息和响应代码

 

情况

消息

注意事项

CSV 文件标题行无效

 

CSV 文件中的标题行无效。标题行必须是

类型、电子邮件、产品配置、用户名、国家/地区代码、名字、姓氏、选项

 

上载时无法导入,且无法运行批量导入。

缺少 CSV 文件标题行

 

CSV 文件中的标题行无效。标题行必须是

类型、电子邮件、产品配置、用户名、国家/地区代码、名字、姓氏、选项

 

上载时无法导入,且无法运行批量导入。

标题行的栏数不正确 第 2 行的文件格式无效。如需帮助,请参阅示例。csv 文件行存在错误的栏数 上载时无法导入,且无法运行批量导入。
数据行的栏数不正确

第 2 行的文件格式无效。如需帮助,请参阅示例。csv 文件行存在错误的栏数

上载时无法导入,且无法运行批量导入。
CSV 中无数据行;或者,有 1 个数据行,但缺少标题行 无效的文件。应当至少在文件中添加一位用户,然后重试。如需帮助,请参阅示例。  上载时无法导入,且无法运行批量导入。
“类型”值无效

第 2 行的文件格式无效:身份标识的类型必须是 Adobe ID、Enterprise ID 或 Federated ID 三者之一。(行号为 2。)

上载时无法导入,且无法运行批量导入
电子邮件地址无效

第 2 行的文件格式无效:需要有效的电子邮件地址。(行号为 2。)

上载时无法导入,且无法运行批量导入
电子邮件地址属于另一个域 请参阅下面的内容  
国家/地区代码无效:不是两个字母 第 2 行的文件格式无效:国家/地区代码必须符合 ISO 3166-1 alpha-2(双字符国家/地区代码)。(行号为 2。) 上载时无法导入,且无法运行批量导入。必须是合法的,并且是 Adobe 开展业务的国家/地区。
国家/地区代码遭到禁止(如 KP) 无效的国家/地区代码。 在报告和摘要中,显示为一则消息。
国家/地区代码是由两个字母组成,但不是有效的代码(如 AB) 无效的国家/地区代码。 在报告和摘要中,显示为一则消息。
“名字”、“姓氏”、“用户名”或“选项”太长(超过 255 个字符) 第 3 行的文件格式无效:字符串超过 255 个字符。(行号为 3。) 上载时无法导入,且无法运行批量导入。
用户名不是电子邮件地址 无效的用户名。

这取决于身份验证源是否需要此信息。

同时,它还会显示在摘要中。

用户名和电子邮件地址必须匹配 无效的用户名。该组织的用户名和电子邮件地址必须一致

这取决于身份验证源是否需要此信息。

无效的用户名。显示在摘要中

电子邮件地址不在正确的域中 并非拥有电子邮件域。这位用户是由另一个组织管理,或具有其他类型。 并非拥有电子邮件域。显示在摘要中。
“选项”字段包含非法值   目前没有检查手段或消息
内部错误 内部错误:<字符串>  
已邀请用户 已作为 Adobe ID 用户进行邀请。已发送邀请。 显示在摘要中的开始部分。
用户已在组织中 已与组织建立关联。用户 <xxx> 已与您的组织建立关联。 显示在摘要中的开始部分。
不受支持的编码   编码属于不受支持的类型。

下面是一些具体案例:

组织的域名及类型

先决条件

操作

预期

消息

组织已声明域名为 d3 且类型是 Type3 用户 u@d3 已存在,类型为 Type3 添加一个类型为 Type1 的用户 u@d3 错误 已与组织建立关联。该用户已存在
  任意 添加一个类型为 Type2 的用户 u@d3 错误 并非拥有电子邮件域。这位用户是由另一个组织管理,或具有其他类型。
  用户 u@d3 已存在,类型为 Type3 添加一个类型为 Type3 的用户 u@d3 错误 已与组织建立关联。用户 u@d3 已与您的组织建立关联。
  组织中已存在类型为 Type1 的用户 u@d3 添加一个类型为 Type1 的用户 u@d3 错误 已与组织建立关联。用户 u@d3 已与您的组织建立关联。
  组织中已存在类型为 Type1 的用户 u@d3 添加一个类型为 Type3 的用户 u@d3 错误 已与组织建立关联。用户 u@d3 已与您的组织建立关联。
 

已邀请类型为 Type1 的用户 u@d3

用户 u@d3 不存在

添加一个类型为 Type1 的用户 u@d3 错误 已作为 Adobe ID 用户进行邀请。已发送邀请。 
 

已邀请类型为 Type1 的用户 u@d3

用户 u@d3 不存在

添加一个类型为 Type3 的用户 u@d3 错误 已作为 Adobe ID 用户进行邀请。已发送邀请。 
 

已邀请类型为 Type1 的用户 u@d3

在发出邀请后,已创建类型为 Type1 的用户 u@d3

添加一个类型为 Type1 的用户 u@d3 错误 已作为 Adobe ID 用户进行邀请。已发送邀请。 
 

已邀请类型为 Type1 的用户 u@d3

在发出邀请后,已创建类型为 Type1 的用户 u@d3

添加一个类型为 Type3 的用户 u@d3 错误

已作为 Adobe ID 用户进行邀请。已发送邀请。 

 

 

已邀请类型为 Type1 的用户 u@d3

在发出邀请前,已创建类型为 Type1 的用户 u@d3

添加一个类型为 Type1 的用户 u@d3 错误 已作为 Adobe ID 用户进行邀请。已发送邀请。 
 

已邀请类型为 Type1 的用户 u@d3

在发出邀请前,已创建类型为 Type1 的用户 u@d3

添加一个类型为 Type3 的用户 u@d3 错误 已作为 Adobe ID 用户进行邀请。已发送邀请。 
  组织中不存在类型为 Type1 的用户 u@d3 添加一个类型为 Type3 的用户 u@d3 成功  
  该组织并未声明域名 d2

添加一个类型为 Type3 的用户 u@d2

错误 并非拥有电子邮件域。这位用户是由另一个组织管理,或具有其他类型。
         
组织已声明域名为 d2 且类型是 type2 已邀请类型为 Type2 的用户 x@y 加入域 d2 添加一个类型为 Type1 的用户 x@y 错误 已作为 Adobe ID 用户进行邀请,且已发送邀请。
  任意 添加一个类型为 Type2 的用户 u@d3 错误 并非拥有电子邮件域。这位用户是由另一个组织管理,或具有其他类型。
  任意 添加一个类型为 Type3 的用户 x@y 错误 并非拥有电子邮件域。这位用户是由另一个组织管理,或具有其他类型。
         

性能详情

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

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

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

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

本产品经 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 许可  Twitter™ 与 Facebook 中的内容不在 Creative Commons 的条款约束之下。

法律声明   |   在线隐私策略