概述：批量添加
利用“导入用户（批量上载）”功能，您可以凭借企业管理员的身份创建一个包含若干用户标识的文件，并且可以将该文件提交至企业客户管理员用户管理页面，以进行处理。文件中的每个条目代表一位用户，经过处理后，会为每位用户创建一个帐户。由于可能涉及成千上万个帐户，因此我们会向您显示处理的状态及进度，您可以随时取消文件的处理。
如果客户购买了 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 类型必须是有效的。 |
| 电子邮件 |
最多 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 个帐户，则需要两小时零五分钟。
