联系人列表的批量管理

批量管理概述

使用 IM and Presence Service 批量管理工具，您可以对许多 IM and Presence Service 用户执行批量事务，包括：

  • 重命名用户联系人 ID 以在 Microsoft 迁移过程中使用。

  • 将属于特定节点或 Presence 冗余组的用户的联系人列表、非 Presence 联系人列表和位置详细信息导出到 CSV 数据文件。


    注

    非 Presence 联系人都没有 IM 地址，并且只能通过此程序导出。

  • 您可以导入已导出到不同群集中的另一个节点或 Presence 冗余组的用户联系人列表、非 Presence 联系人列表和用户位置迁移详细信息。 为新用户预填联系人列表或添加到现有联系人列表。

  • 这些功能简化了群集之间的用户迁移。

批量管理前提条件

在导入用户联系人列表之前：

  1. 在 Cisco Unified Communications Manager 上部署用户。

  2. 确保在 Cisco Unified Communications Manager 上为 IM and Presence Service 许可用户。


注

默认联系人列表导入速度取决于虚拟机部署硬件类型。 可以选择 Cisco Unified CM IM and Presence 管理 > 系统 > 服务参数 > Cisco 批量部署服务来更改联系人列表导入速度。 但是，如果您增大默认导入速度，将会在 IM and Presence Service 上消耗更多的 CPU 和内存。

批量管理任务流程

过程

  命令或操作 目的

步骤 1

批量重命名用户联系人 ID

上传 CSV 文件并重命名用户列表的联系人 ID。

步骤 2

批量导出用户联系人列表和非 Presence 联系人列表

此程序用于将用户的联系人列表导出到 CSV 文件。 然后，您可以使用批量管理将用户联系人列表移到另一个节点或群集。

步骤 3

批量导出用户位置详细信息

此程序用于将用户位置详细信息导出到 CSV 文件。 然后，您可以使用批量管理将用户位置详细信息列表移到另一个节点或群集。

步骤 4

完成以下任务以将用户联系人列表导入 IM and Presence Service：

批量重命名用户联系人 ID


小心

批量重命名联系人 ID 操作在将用户从 Microsoft 服务器（如 Lync）迁移到 IM and Presence Service 的时候使用。 有关如何在用户迁移过程中使用此工具的详细说明，请参阅 Cisco.com 上的《分区式域内联合指南》。 任何其他情形均不支持使用此工具。

上传 CSV 文件并重命名用户列表的联系人 ID。

过程

步骤 1

上传包含了您希望在所有联系人列表中重命名的联系人 ID 列表的 CSV 文件。

  1. 转到 IM and Presence Service 数据库发布方节点。

  2. 在 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 上传/下载文件。

  3. 单击新增。

  4. 单击浏览找到并选择 CSV 文件。 有关输入文件的更多信息，请参阅批量重命名用户联系人 ID 文件详细信息。

  5. 选择联系人作为“目标”。

  6. 选择重命名联系人 – 自定义文件作为“事务类型”。

  7. 单击保存上传该文件。

步骤 2

在发布方节点的 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 联系人列表 > 重命名联系人。

步骤 3

在文件名字段中，选择您要上传的文件。

步骤 4

选择如下操作之一：

  • 单击立即运行，以立即执行批量管理作业。
  • 单击稍后运行，以安排执行批量管理作业的时间。 有关在批量管理工具中安排作业的详细信息，请参阅 Cisco Unified CM IM and Presence 管理中的在线帮助。

步骤 5

单击提交。

如果选择立即运行作业，将在您单击“提交”后运行作业。

下一步做什么

批量导出用户联系人列表和非 Presence 联系人列表

批量重命名用户联系人 ID 文件详细信息

您在运行此作业之前上传的文件必须是以下格式的 CSV 文件：

<Contact ID>、<New Contact ID>

其中 <Contact ID> 是现有的联系人 ID，而 <New Contact ID> 是联系人 ID 的新格式。

<Contact ID> 是在 Presence 拓扑用户分配窗口上显示的用户 IM 地址。

下面是 CSV 文件示例，有一个条目：

Contact ID, New Contact ID
john.smith@example.com, jsmith@example.com

批量导出用户联系人列表和非 Presence 联系人列表

此程序用于将用户的联系人列表导出到 CSV 文件。 然后，您可以使用批量管理将用户联系人列表移到另一个节点或群集。

  • 联系人列表 — 此列表包含 IM and Presence 联系人。 没有 IM 地址的联系人将不会导出（您必须导出非 Presence 联系人列表）。

  • 非 Presence 联系人列表 — 此列表包含没有 IM 地址的联系人。

过程

步骤 1

在 Cisco Unified CM IM and Presence 管理中，执行以下任一操作：

  • 要导出联系人列表，选择批量管理 > 联系人列表 > 导出联系人列表
  • 要导出非 presence 联系人列表，选择批量管理 > 非 presence 联系人列表 > 导出非 Presence 联系人列表并跳过下一个步骤。

步骤 2

仅联系人列表。 选择要导出其联系人列表的用户：

  1. 在导出联系人列表选项下，选择要导出其联系人列表的用户的类别。 默认是导出所有用户的联系人列表。

  2. 单击查找以显示用户列表，然后单击下一步。

步骤 3

在文件名字段中，输入 CSV 文件的名称。

步骤 4

在作业信息下，配置要运行此作业的时间：

  • 立即运行 — 如果选中此按键，联系人列表会立即导出。
  • 稍后运行 — 如果要安排作业的运行时间，选中此按键。 如果选择此选项，您将需要在任务调度页面（批量管理 > 任务调度）安排此作业运行的时间。

步骤 5

单击提交。

如果您选择立即运行，导出作业会立即运行。

步骤 6

在创建导出文件后，下载导出的文件：

  1. 在 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 上传/下载文件。

  2. 单击查找并选择导出文件。

  3. 单击下载选定项并将文件下载到您可以访问的位置。

批量导出用户位置详细信息

此程序用于将用户位置详细信息导出到 CSV 文件。 然后，您可以使用批量管理将用户位置详细信息移到另一个节点或群集。

过程

步骤 1

在 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 用户位置迁移 > 导出用户位置详细信息。

步骤 2

在用户位置详细信息导出下的文件名字段中，输入 CSV 文件的名称。

步骤 3

在作业信息下，配置要运行此作业的时间：

  • 立即运行—选中此按键可立即导出用户位置详细信息。
  • 稍后运行 — 如果要安排作业的运行时间，选中此按键。 如果选择此选项，您将需要在批量管理 > 任务调度中的任务调度页面安排此作业运行的时间。

步骤 4

单击提交。

如果选择立即运行，会立即执行导出作业。

步骤 5

在创建导出文件后，下载导出的文件：

  1. 在 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 上传/下载文件。

  2. 单击查找并选择导出文件。

  3. 单击下载选定项并将文件下载到您可以访问的位置。

导出联系人列表文件详细信息

以下是 CSV 文件示例条目：

userA,example.com,userB,example.com,buddyB,General,0

BAT 允许您查找和选择要导出其联系人列表的用户。 用户联系人列表将导出为格式如下的 CSV 文件：

<User ID>、<User Domain>、<Contact ID>、<Contact Domain>、<Nickname>、<Group Name>、<State>

下表介绍了导出文件中的参数。

参数

说明

用户 ID

IM and Presence Service 用户的用户 ID。

注

 

此值是用户 IM 地址的用户部分。

用户域名

IM and Presence Service 用户的 Presence 域名。

注

 

此值是用户 IM 地址的域名部分。

示例 1：bjones@example.com—bjones 是用户 ID，example.com 是用户域。

示例 2：bjones@usa@example.com—bjones@usa 是用户 ID，example.com 是用户域。

联络人 ID

联系人列表条目的用户 ID。

联系人域名

联系人列表条目的 Presence 域名。

Nickname

联系人列表条目的昵称。

如果用户未为联系人指定昵称，则“昵称”参数将为空。

组名称

要添加联系人列表条目的组的名称。

如果用户的联系人未分类到组中，默认组名将在“组名”字段中指定。

状态

名录的状态，名录数据库以十进制格式存储它。

导出非 Presence 联系人列表文件详细信息

非 Presence 用户联系人列表将导出为格式如下的 CSV 文件：

<User JID>、<Contact JID>、<Group Name>、<Content Type>、<Version>、<Info>

下表介绍了导出文件中的参数：

参数

说明

用户 JID

用户 JID。 这是用户的 IM 地址。

联系人 JID

联系人列表条目的用户 JID（如果可用），否则为 UUID。

组名称

要添加联系人列表条目的组的名称。

内容类型

信息字段中使用的 textmime 类型和子类型。

版本

信息字段中使用的内容类型。

信息

vCard 格式的联系人列表条目的联系信息。

以下是 CSV 文件示例条目：

user2@cisco.com,ce463d44-02c3-4975-a37f-d4553e3f17e1,group01,text/directory,3,BEGIN:VCARD
ADR;TYPE=WORK:ADR\;WORK:\;\;123 Dublin rd\,\;Oranmore\;Galway\;\;Ireland
EMAIL;TYPE=X-CUSTOM1;X LABEL=Custom:testuser01@test.com N:test;user;;; NICKNAME:pizzaguy01
ORG:ABC TEL;TYPE=WORK,VOICE:5323534535 TITLE:QA VERSION:3.0 END:VCARD

导出用户位置详细信息的文件详细信息

用户位置详细信息将导出为格式如下的 CSV 文件：

<User JID>、<Access Type>、<Create Time>、<Item ID>、<Resource ID>、<Message Text>


小心

由于文件本身的大小以及存在损坏用户位置信息的风险，我们建议您不要手动修改导出的 CSV 文件。

下表介绍了导出文件中的参数：

参数

说明

用户 JID

用户 JID。 这是用户的 IM 地址。

访问类型

访问类型定义用户的访问类型。

访问类型的值如下：

  • W：白名单

  • R：名录组

  • O：开放

注

 

对 Jabber 使用 'W'。

创建时间

“创建时间”显示项目创建或更新的日期和时间。

项目 ID

“项 ID”标识用户的特定记录。

资源 ID

“资源 ID”是 Jabber 实例 ID。

消息文本

“消息文本”是用户的位置信息。

以下是 CSV 文件示例条目：

userA@example.com,W,2021-01-22 10:11:18.000001,7d0ec34c-458f-4fd2-9d15-58accac4af00,jabber_7151,
<geoloc xmlns='http://jabber.org/protocol/geoloc'><description>newlocation104</description><street>104</street><mobile>0</mobile><enable>1</enable></geoloc>

批量导入用户联系人列表

验证最大联系人列表大小

检查 IM and Presence Service 上的“最大联系人列表大小”和“最大查看器数”设置。 “最大联系人列表大小”的系统默认值为 200，“最大查看器数”的系统默认值为 200。

思科建议导入用户联系人列表时将“最大联系人列表大小”和“最大查看器数”设置设为“无限制”。 即使在使用 BAT 导入联系人列表时超过最大联系人列表大小而未丢失数据，此步骤也可确保完全导入每个迁移用户的联系人列表。 迁移所有用户后，您可以将“最大联系人列表大小”和“最大查看器数”设置重置为首选值。

您只需在群集上检查最大联系人列表大小（这些群集包含希望要对其导入联系人的用户）。 更改 Presence 设置时，更改会应用到群集中的所有节点；因此您只需在群集中的 IM and Presence 数据库发布方节点上更改这些设置。

下一步做什么

上传输入文件

上传输入文件

以下程序介绍如何使用 BAT 上传联系人列表和非 Presence 联系人列表的 CSV 输入文件。

开始之前

验证最大联系人列表大小

过程

步骤 1

在 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 上传/下载文件。

步骤 2

单击新增。

步骤 3

单击浏览找到并选择 CSV 文件。

步骤 4

对于目标设置：

步骤 5

对于事务类型：选择作为事务类型。

  • 如果您想要上传联系人列表的输入文件，选择导入用户的联系人 – 自定义文件。
  • 如果您想要上传非 Presence 联系人列表的输入文件，选择导入用户的非 Presence 联系人
  • 如果要上传用户位置迁移详细信息的输入文件，请选择导入用户位置详细信息

步骤 6

单击保存上传该文件。

下一步做什么

新建批量管理作业

导入联系人列表文件详细信息

输入文件必须是采用以下格式的 CSV 文件：

<User ID>、<User Domain>、<Contact ID>、<Contact Domain>、<Nickname>、<Group Name>、<State>

以下是 CSV 文件示例条目：

userA,example.com,userB,example.com,buddyB,General,0

下表说明输入文件中的参数。

参数

说明

用户 ID

这是必要参数。

IM and Presence Service 用户的用户 ID。 最多可包含 132 个字符。

注

 

  • 此值是用户 IM 地址的用户部分。

  • 对于包含以下字符的用户 ID，将不会创建 JSM 会话：

    º

    ª

    ²

    ¼

    ¾

    -

    ³

    µ

    ¹

    ½

    β

    ´

    ¨

    ¸

    ¯

    Æ

用户域名

这是必要参数。

IM and Presence Service 用户的 Presence 域名。 最多可包含 128 个字符。

注

 

此值是用户 IM 地址的域名部分。

示例 1：bjones@example.com—bjones 是用户 ID，example.com 是用户域。

示例 2：bjones@usa@example.com—bjones@usa 是用户 ID，example.com 是用户域。

联络人 ID

这是必要参数。

联系人列表条目的用户 ID。 最多可包含 132 个字符。

联系人域名

这是必要参数。

联系人列表条目的 Presence 域名。 域名格式需遵守以下限制：

  • 长度不能超过 128 个字符

  • 只能包含数字、大小写字母和连字符 (-)

  • 不能以连字符 (-) 开头或结尾

  • 标签长度不能超过 63 个字符

  • 顶级域名只能包含字符，并且至少要有两个字符

Nickname

联系人列表条目的昵称。 最多可包含 255 个字符。

组名称

“组名称”是必填参数。

要添加联系人列表条目的组的名称。 最多可包含 255 个字符。

状态

名录的状态，名录数据库以十进制格式存储它。

导入非 Presence 联系人列表文件详细信息

输入文件必须是采用以下格式的 CSV 文件：

<User JID>、<Contact JID>、<Group Name>、<Content Type>、<Version>、<Info>

以下是 CSV 文件示例条目：

user2@cisco.com,ce463d44-02c3-4975-a37f-d4553e3f17e1,group01,text/directory,3,BEGIN:VCARD
ADR;TYPE=WORK:ADR\;WORK:\;\;123 Dublin rd\,\;Oranmore\;Galway\;\;Ireland
EMAIL;TYPE=X-CUSTOM1;X LABEL=Custom:testuser01@test.com N:test;user;;; NICKNAME:pizzaguy01
ORG:ABC TEL;TYPE=WORK,VOICE:5323534535 TITLE:QA VERSION:3.0 END:VCARD

小心

由于文件本身的大小以及存在损坏 vCard 信息的风险，我们建议您不要手动修改 CSV 文件。

下表说明非 Presence 联系人输入文件中的参数。

参数

说明

用户 JID

用户 JID。 这是用户的 IM 地址。

联系人 JID

联系人列表条目的用户 JID（如果可用），否则为 UUID。

组名称

要添加联系人列表条目的组的名称。

内容类型

信息字段中使用的 textmime 类型和子类型。

版本

信息字段中使用的内容类型。

信息

vCard 格式的联系人列表条目的联系信息。
导入用户位置详细信息的文件详细信息

输入文件必须是采用以下格式的 CSV 文件：

<User JID>、<Access Type>、<Item ID>、<Create Time>、<Resource ID>、<Message Text>

以下是 CSV 文件示例条目：

userA@example.com,W,7d0ec34c-458f-4fd2-9d15-58accac4af00,2021-01-22 10:11:18.000001,jabber_7151,
<geoloc xmlns='http://jabber.org/protocol/geoloc'><description>newlocation104</description><street>104</street><mobile>0</mobile><enable>1</enable></geoloc>

小心

由于文件本身的大小以及存在损坏用户位置信息的风险，我们建议您不要手动修改 CSV 文件。

下表描述了输入文件中用于用户位置迁移的参数：

参数

说明

用户 JID

这是必要参数。

“用户 JID”是用户的 IM 地址。 最多可包含 255 个字符。

访问类型

这是必选参数。访问类型定义用户的访问类型。 最多可包含 128 个字符。

访问类型的值如下：

  • W：白名单

  • R：名录组

  • O：开放

注

 

对 Jabber 使用 'W'。

项目 ID

这是必要参数。

“项 ID”标识用户的特定记录。 “项 ID”的值应为“忽略”或字母数字值。 联系人列表条目的用户 ID。 最多可包含 50 个字符。

创建时间

这是必要参数。

“创建时间”显示项目创建或更新的日期和时间。 最多可包含 26 个字符。

资源 ID

这是必要参数。

“资源 ID”是 Jabber 实例 ID。 最多可包含 1023 个字符。

消息文本

这是必要参数。

“消息文本”是用户的位置信息。 最多可包含 30000 个字符。

新建批量管理作业

为联系人列表和非 Presence 联系人列表创建新的批量管理作业。

开始之前

上传输入文件

过程

步骤 1

在 Cisco Unified CM IM and Presence 管理中：

  • 如果要为联系人列表创建新的批量管理作业，选择批量管理 > 联系人列表 > 更新
  • 如果您想要创建新的联系人列表的批量管理作业，选择批量管理 > 联系人非 Presence 列表 > 导入非 Presence 联系人列表。
  • 如果要为用户位置迁移创建新的批量管理作业，请选择批量管理 > 用户位置迁移 > 导入用户位置详细信息。

步骤 2

从“文件名”下拉列表中，选择要导入的文件。

步骤 3

在“作业说明”字段中，输入此批量管理作业的说明。

步骤 4

选择下列操作之一：

  • 单击立即运行，以立即执行批量管理作业。
  • 单击稍后运行，以安排执行批量管理作业的时间。 有关在 BAT 中安排作业时间的详细信息，请参阅 Cisco Unified CM IM and Presence 管理中的在线帮助。

步骤 5

单击提交。 如果选择立即运行作业，将在您单击“提交”后运行作业。

下一步做什么

检查批量管理作业的结果

检查批量管理作业的结果

当批量管理作业完成后，IM and Presence Service BAT 工具会将联系人列表导入作业的结果写入日志文件。 该日志文件包含以下信息：

  • 已成功导入的联系人数量。

  • 尝试导入联系人时遇到的内部服务器错误的数量。

  • 未导入（忽略）的联系人数量。 日志文件会在日志文件末尾针对每个被忽略的联系人列出未导入的原因。 下面是未导入联系人的原因：

    • 格式无效 - 行格式无效，如必需字段缺失或为空

    • 联系人域无效 - 联系人域的格式无效。 有关联系人域的有效格式，请参阅与批量导入用户联系人列表相关的主题。

    • 不能将自己添加为联系人 - 如果联系人为用户本人，则无法导入该联系人。

    • 用户联系人列表大小超过上限 - 用户已达到最大联系人列表大小，无法导入该用户的更多联系人

    • 用户未分配给本地节点 - 用户尚未分配到本地节点

  • CSV 文件中由于导致 BAT 作业过早结束的错误而未处理的联系人数量。 此错误极少发生。

完成以下过程即可访问此日志文件。

开始之前

新建批量管理作业

过程

步骤 1

在 Cisco Unified CM IM and Presence 管理中，选择批量管理 > 任务调度。

步骤 2

单击查找并选择联系人列表导入作业的作业 ID。

步骤 3

单击记录文件名链接即可打开日志。