了解个人联系人

使用Control Hub将最终用户的 Jabber 自定义联系人或任何第三方自定义联系人源迁移到 Webex 个人联系人。 将联系人迁移至云是一次性导入操作，您可以像 Jabber 一样搜索、查找、呼叫、发送消息或邀请联系人。

最终用户在 Webex 应用程序中定义 Webex 个人联系人。

Jabber 自定义联系人是指组织外部的非目录联系人以及存储在 Cisco Unified Communications Manager - 即时消息和在线状态服务数据库中的联系人。

第三方联系人是指组织外部的联系人，可能会导出并稍后导入 Webex。

必要条件

开始迁移个人联系人之前，请确保您满足以下要求：

  • 熟悉 Control Hub。

    Webex Control Hub 是 Webex 平台的管理界面。 有关更多信息，请参阅 Webex Control Hub 入门。

  • 使用完全管理员权限访问 Control Hub。

    如果拥有完全管理员权限，您可以将一个或多个角色分配给组织中的任何用户。 确保分配具有管理员权限的用户，以便您可以迁移其余 Jabber 自定义联系人。 有关更多信息，请参阅在 Webex Control Hub 中分配组织帐户角色。

  • 确保您计划迁移个人联系人的本地部署应用程序（例如 Cisco Unified Communications Manager （Unified CM）、Unified CM - 即时消息和在线状态服务）为 11.5 版本或更高版本，以使用 Control Hub 迁移向导。

  • 如果要迁移最终用户的 Jabber 自定义联系人，请使用批量管理从Cisco Unified Communications Manager (Unified CM) 下载最终用户文件，并从Unified CM - 即时消息和在线状态下载联系人文件。

    使用 Cisco Unified Communications Manager 应用程序中的“导入/导出”菜单导入用户。 请参阅使用 Unified CM 批量管理导出用户获取详细信息。

  • 如果从第三方来源导入自定义联系人，请使用中所述的程序从第三方来源导入个人联系人。

  • 确保迁移任务符合每个用户最多 500 个联系人以及单个文件中最多 10000 个联系人的要求。 我们建议在一个文件中列出相同类型的联系人。

使用 Unified CM 批量管理导出用户

使用 Unified CM 应用程序中的“批量管理”来导出用户并稍后导入 Control Hub。

如果即时消息地址方案是 User@Default Domain，则使用此过程从 Cisco Unified Communications Manager 即时消息和在线状态服务获取最终用户文件。

  1. 选择批量管理 > 导入/导出 > 导出以从当前主集群导出迁移用户的最终用户列表。 将显示“导出数据”窗口。

    当您上传新文件或再次上传相同文件时，该工具仅检测但无法避免创建重复的个人联系人。

  2. 在“导出数据”窗口的用户数据部分下选择最终用户。

  3. 为导出的列表数据选择文件名。 在作业描述字段中，输入要为作业提供的描述。 导出配置是缺省描述。

  4. 单击立即运行或安排作业稍后运行。 单击提交。

  5. 监控导出作业的状态。 如果作业被安排稍后运行，请使用批量管理主菜单中的作业安排程序选项激活作业。

    从 Unified CM 应用程序导出 tar 文件后，请勿修改或更新该文件。

完成以下步骤，以从 Cisco Unified CM 应用程序中导入用户：

1

下载导出文件并存储，以在用户迁移完成后使用。 选择 Cisco Unified CM Administration > 批量管理 > 上传/下载文件。

在“上传/下载”窗口中选择 tar 文件，然后单击下载选中项。
2

将 .tar 文件解压至计算机上的任何位置（使用 tar -xvf 命令）。 将 enduser.csv 文件解压至指定位置。 有关详细信息，请参阅即时消息和在线状态服务的配置和管理。

任务流程

使用“将个人联系人迁移至 Webex”卡，以将用户联系人从本地部署同步到 Webex Control Hub。

1

从 Webex Control Hub 中的客户视图，转至更新和迁移。
2

在将个人联系人迁移至 Webex 卡上单击开始。 将显示“联系人同步”页面。

从内建应用程序导入个人联系人

使用此过程从本地部署应用程序导入联系人列表。 您可以删除导入的文件、任何暂挂的迁移任务或失败的报告。

1

要导入数据，单击选择要导入的联系人类型下拉列表，然后选择域地址类型。

IM and Presence Server 支持以下两种 IM 寻址方案：

  • 目录 URI IM 地址方案 - 支持多个域，与用户的电子邮件地址一致，以及与 Microsoft SIP URI一致。

  • User@默认域方案 - 这是安装 IM and Presence Server 时的默认 IM 地址方案。

要了解内部IM&Presence 服务器使用的方案，请参阅 IM&Presence 服务器设置。 有关寻址方案的更多详细信息，请参阅配置即时消息程序寻址方案
2

根据所选的 IM 寻址方案，将联系人.csv文件 或最终用户.csv文件。

  • 对于目录 URI IM 地址方案，选择UCM IM&P 个人联系人 - 目录 URI IM 地址方案从下拉列表。 然后将联系人.csv文件以导入 Unified IM&Presence 服务器的联系人列表。

  • 对于 User@默认域方案方案，选择UCM IM&P 个人联系人 - 用户 @默认域从下拉列表。 然后将最终用户.csv从Unified CM应用程序和联系人.csv文件。


 

确保将最终用户.csv文件从 。从Unified CM应用程序导出的tar 文件。
3

单击查看文件下载详细信息以了解有关导入文件的详细说明。

导入 contacts.csv 文件时，将显示导出 Unified CM 即时消息和在线状态联系人数据窗口。 请按以下步骤从 IM&Presence 服务器导出和下载个人联系人。

自定义联系人

  1. 登录Cisco Unified CM IM and Presence 管理应用程序。

  2. 导航至批量管理 > 非在线联系人列表 > 导出非在线联系人列表下载联系人 csv IM&Presence 服务器上的文件。

常规联系人

  1. 登录到 Cisco Unified CM 即时消息和在线状态管理应用程序。

  2. 导航至批量管理 > 联系人列表 > 导出联系人列表下载联系人 csv IM&Presence 服务器上的文件。


 

此功能不支持使用CSV 文件从Cisco IM&Presence 服务器迁移Active Directory组。 此外，Webex 不支持 Active Directory (AD) 群组。 您可以手动编辑CSV 文件以添加 AD 组。 迁移完成后，这些组将在 上显示为个人组Webex ，

导入 enduser.csv 文件时，将显示导出 Unified CM 用户数据窗口。 要从 Unified CM 导出并下载用户数据，请执行以下步骤：

  1. 在批量管理下选择导入/导出，然后选择导出。

  2. 从导出的文件列表中，选择最终用户.csv 。

  3. 在作业信息下提供文件名，并选择要运行任务的日程表。 单击提交。

  4. 文件准备就绪后，在批量管理中的上传/下载文件下列出。

  5. 下载CSV 文件。 在迁移完成前请勿修改文件。


 
实施自动删除策略后，系统将删除已上传或存储的 90 天以上的数据。
4

在成功完成上传后，Control Hub 会验证 csv 文件中的联系人。


 

根据缺省方案在验证期间，您可以在审阅文件中看到这些更改。

  • 如果即时消息地址方案是 User@DefaultDomain - 用户电子邮件和联系人电子邮件由最终用户文件中的 MAIL ID 或 DIRECTORY URI 字段替换。

  • 对于自定义联系人 - 用户电子邮件由最终用户文件中的 MAIL ID 或 DIRECTORY URI 字段替换。

您可以查看审查文件中“用户电子邮件”或“联系人电子邮件”字段下的替换值。 Control Hub 使用此电子邮件地址检查 Common Identity(CI) 中是否存在用户或联系人。

屏幕上显示以下详细信息：

身份

描述

导入的联系人总数

使用 BAT 文件从 Unified CM 即时消息和在线状态服务器导入的联系人总数。

Webex 中的用户联系人

已与用户关联并迁移至 Webex 的联系人总数。

要迁移的联系人

准备迁移至用户联系人列表的联系人总数。

迁移的联系人

已成功迁移至用户联系人列表的联系人总数。

 

  • 您可以选择单击取消导入以取消导入。 如果您上传了错误的文件或想要更新联系人详细信息，可以删除导入的文件。

  • 如果在上传 csv 文件后遇到警告消息，说明： 在输入 csv 文件的额外列中找到数据，意味着输入文件中的记录值是以逗号分隔的。 这些值现在被拆分，在 csv 文件中显示为两个独立的列。 您必须从输入 csv从Cisco Unified IM& Presence 服务器下载的文件。 如果不更正文件并继续进行验证，则可能会迁移不正确的数据。

（可选）

  1. 单击更多选项查看或删除导入的文件。

  2. 选中这些选项以启用删除按钮。 确保您知晓您的操作的后果。 此操作无法撤消。

  • 我同意删除所有导入数据。

  • 我同意删除所有未同步的记录。
5

在验证 csv 文件时，已启用审查同步按钮。 通过“审查同步”页面，您可以查看符合条件的联系人以及有错误的联系人列表。
6

单击批量编辑以修复标记的错误。 单击下载 XLS 文件以下载错误报告。 导航至报告中的失败原因列，然后采取相应的操作来解决错误并上传最新文件。 请参阅迁移的联系人了解详细信息。 单击选择文件上传文件并再次验证文件。
7

处理完成后，将显示准备迁移至 Webex App 的有效联系人总数。 单击迁移联系人开始迁移。
8

要开始迁移，输入任务名称并单击确认和迁移。
9

已创建一项任务，您可以查看跟踪迁移进度来了解迁移状态。 完成任务后，请参阅跟踪迁移进度下的成功 KPI，了解成功迁移的联系人数量。

仅迁移有效记录，不迁移无效记录。
10

单击“跟踪迁移”部分中错误旁的向下箭头可下载摘要报告。

新迁移的联系人现在在 Webex 应用程序中列出。

从第三方来源导入个人联系人

此功能提供了一种通用机制，可将任何用户的联系人导入 Webex个人联系人（联系人服务）数据库。 这是通用的，因为联系源可能来自内部部署、竞争对手云联系人系统，甚至是Webex Calling MT 部署。 它开辟了迁移场景，以支持任何个人联系人导入案例，而不仅仅是Unified CM。

  • 使用新的通用文件中提供的新详细信息替换旧的联系人详细信息联系人 UUID 。

  • 该工具将填充联系人 UUID字段。 迁移联系人后，对应的联系人 UUID信息可在迁移摘要.csv文件。

  • 请勿修改联系人 UUID模板文件或 Migration Summary.csv 文件中的字段。 另外，不能重复联系人 UUID s 在模板文件中。 因此，请勿复制记录以在文件中创建另一行。

  • 如果您要更新与联系人相关的任何信息，除了在新文件中添加联系人的所有详细信息外，您还必须联系人 UUID 。 使用联系人 UUID从最晚迁移摘要.csv文件。

以下程序用于导入第三方来源中用户的个人联系人。

1

要导入数据，单击选择要导入的联系人类型下拉列表，然后选择一般个人联系人。
2

单击下载示例模板。
3

在模板文件中填充所有个人联系人的数据后，将其拖放到导入个人联系人部分。 或者，单击浏览文件并导航到填充的示例模板文件所在的文件夹位置并上传。


 

  • 支持的格式照片类型字段为 JPEG、PNG、BMP 和 GIF。

  • 该照片编码方案必须为 Base64，以便处理数据。

  • 模板文件中的以下字段为必填字段：

    • 用户电子邮件

    • 显示名称

    • 联系人电子邮件或电话号码

      - 必须填写以下任一字段。

    如果模板中的任何必填字段未填写，则与该个人联系人对应的记录在验证过程中将被标记为无效。
4

上传成功后， Control Hub验证CSV 文件中的联系人。


 

验证过程完成后，标签自定义会显示在联系人旁边。

有关 KPI 的详细信息，请参阅从内建应用程序导入个人联系人部分。
5

执行步骤 5–10 中的从内建应用程序导入个人联系人部分。

迁移的联系人

此页面列出了所选联系人的错误和警告消息。 它还为您提供所需的建议和解决方案来解决这些问题。 请解决错误，然后继续。 但是，您可以忽略警告。

注： 您还可以删除有错误的联系人，然后继续操作。

1

您可以查看这些值的计数：

  • 无效联系人

  • 无效用户

  • 有效用户

  • 可迁移的联系人。
2

单击批量编辑以修复标记的错误。 单击下载 XLS 文件以下载错误报告。 导航至报告中的失败原因列，然后采取相应的操作来解决错误并上传最新文件。 单击选择文件上传文件并再次验证文件。
3

单击迁移联系人。

将显示迁移联系人进度条，在迁移完成前无法执行任何操作。
4

从跟踪迁移状态页面查看迁移状态。 此页面显示已成功迁移的联系人以及迁移失败的联系人的计数。

准备 CSV 文件以迁移个人联系人

使用此表可查看必填字段或可选字段，以及批量迁移个人联系人时需要确定的内容。

列

描述

支持的值
用户电子邮件 用户域标识。 最多可包含 128 个字符。 值为用户电子邮件地址的域部分。

 

bjones@example .com 其中 bjones 是用户 ID ，example.com 是域
联系人电子邮件 联系人域标识。 最多可包含 128 个字符。 值为联系人电子邮件地址的域部分。

 

bjones@example .com 其中 bjones 为联系人 ID，example.com 为域
组名 要添加联系人列表条目的组的名称。 如果用户的联系人未分类，缺省组名称在组名字段中指定。
显示名称 输入显示名称。 例如： 测试

 

仅支持 UTF-8 字符。
字符长度： 1-30 个
名 输入名字以显示联系人姓名。 例如： 泰德

 

仅支持 UTF-8 字符。
字符长度： 1-30 个
姓 输入姓氏以显示联系人姓名。 例如： 罗斯

 

仅支持 UTF-8 字符。
字符长度： 1-30 个
公司 输入公司名称。 例如： ABC 字符长度： 1-30 个
职位 输入标题。 例如： 标题字符长度： 1-30 个
地址 输入地址。 例如： 纽约，NY 字符长度： 1-30 个
电话号码 请输入电话号码。 必须提供电话号码或分机号。

CSV 导入只允许使用 E.164 号码。

例如： +12815550100


 

电话号码必须在 Control Hub 中的号码标签页上。
电话号码类型 输入电话号码类型。

是，否


 

如果电话号码类型未设置，则无法呼叫。

照片编码

输入照片编码方案。

编码方案为 Base64

照片类型

照片的类型。

照片类型为 JPEG、PNG、BMP 和 GIF

照片内容

照片内容。

有效的 Base64 值

联系人 UUID

输入联系人 UUID。

例如： AFS123CX

字符长度： 36 个字符的字母数字组合。