瞭解個人聯絡人

聯絡人移轉至雲端是一次性匯入，可讓您使用與 Jabber 類似的搜尋、查詢、通話、訊息或邀請聯絡人等功能。

最終使用者可在 Webex 應用程式中定義 Webex 個人聯絡人。

Jabber 自訂聯絡人是指組織外部的非目錄聯絡人，以及儲存在 Cisco Unified Communications Manager - IM & Presence 服務資料庫中的聯絡人。

協力廠商聯絡人是指您組織外部的聯絡人，他們可能在被匯出之後匯入 Webex。

前備事務

開始移轉個人聯絡人之前，請確保您符合下列要求：

  • 熟悉 Control Hub。

    Webex Control Hub 是 Webex 平台的管理介面。如需相關資訊，請參閱開始使用 Webex Control Hub。

  • 使用完全管理員特權存取 Control Hub。

    如果您具有完全管理員特權，則可以將一或多個角色指定給組織中的任何使用者。請務必指定具有管理員權限的使用者，以便您可以移轉其餘的 Jabber 自訂聯絡人。如需相關資訊，請參閱在 Webex Control Hub 中指定組織帳戶角色。

  • 您打算移轉其個人聯絡人的內部部署應用程式（如 Cisco Unified Communications Manager (Unified CM)、Unified CM - IM and Presence 服務）需為 11.5 版或更新版本，才能使用 Control Hub 移轉精靈。

  • 如果您要移化一些最終使用者的 Jabber 自訂聯絡人，請使用批量管理從 Cisco Unified Communications Manager （Unified CM） 下載最終使用者檔案，以及從 Unified CM - IM and Presence 下載聯絡人檔案。

    使用 Cisco Unified Communications Manager 應用程式中的「匯入/匯出」功能表匯入使用者。如需詳細資訊，請參閱使用 Unified CM 大量管理工具匯出使用者。

  • 如果從協力廠商來源輸入自訂聯絡人， 請使用從協力廠商來源匯出個人聯絡人中所述的程式。

  • 每位使用者的移轉任務人數不得超過 500 位聯絡人，單一檔案不得超過 10,000 位聯絡人。我們建議將同一類型的聯絡人放在同一個檔案中。

使用 Unified CM 大量管理工具匯出使用者

使用 Unified CM 應用程式中的大量管理工具來匯出使用者，並在之後將其匯入至 Control Hub。

如果 IM 位址配置為 User@Default Domain，請使用以下程序取得 Cisco Unified Communications Manager IM & Presence Service 的最終使用者檔案。

  1. 選取大量管理工具 > 匯入/匯出 > 匯出，將目前主叢集的移轉使用者的最終使用者清單匯出。這時會出現「匯出資料」視窗。

    Unified CM 應用程式螢幕，顯示「批量管理」功能表，其中「匯入/匯出」和「匯出」選項已反白顯示。

    當您再次上傳新檔案或相同檔案時，該工具只會偵測但無法避免建立重複的個人聯絡人。

  2. 選擇一般使用者 在使用者資料 區段中的匯出資料 視窗。

  3. 為匯出的清單資料選擇檔名。在工作說明欄位中，輸入您想要為該工作提供的說明。Export Configuration 是預設說明。

    Unified CM 應用程式（在「匯出使用者組態」螢幕上）。

  4. 按一下立即執行，或將工作排定為稍後執行。按一下提交。

  5. 監視匯出工作的狀態。使用工作排程器 選項中的批量管理 主功能表以啟動工作（如果工作排定為稍後執行）。

    工作排程器螢幕上的 Unified CM 應用程式。

    從 Unified CM 應用程式中匯出 tar 檔案後，請勿修改或更新該檔案。

完成下列步驟，從 Cisco Unified CM 應用程式匯入使用者：

1

下載匯出檔案並儲存，以供使用者移轉完成後使用。選取 Cisco Unified CM 管理 > 批量管理 > 上傳/下載檔案。

從上傳/下載 視窗選取 tar 檔案並按一下下載選取的項目。

Unified CM 應用程式（位於「尋找及列出檔案」螢幕）；指向已選取的匯出使用者檔案的箭頭。
2

將 .tar 檔案解壓縮至機器上的任何位置（使用 tar -xvf 指令）。將 enduser.csv 檔案解壓縮至指定的位置。如需詳細資訊，請參閱 IM and Presence 服務的組態和管理。

Task Flow
使用「將個人聯絡人移轉至 Webex」選項卡，以將內部部署的使用者聯絡人與 Webex Control Hub 進行同步處理。
1

從 Webex Control Hub 的客戶檢視畫面中，轉至更新和移轉。

2

在將個人聯絡人移轉至 Webex 選項卡上，按一下開始使用。隨即顯示「聯絡人同步處理」頁面。

從內部部署應用程式匯出個人聯絡人
使用此程序將內部部署應用程式中的聯絡人清單匯入。您可刪除已匯入的檔案、任何待處理的移轉作業或失敗報告。
1

若要匯入資料，按一下選取要匯入的聯絡人類型 下拉清單，然後選取網域位址類型。

IM and Presence 伺服器支援下列兩種 IM 定址配置：

  • 目錄 URI IM 位址方案 — 支援多個網域、對齊使用者的電子郵件地址，以及對齊 Microsoft SIP URI。

  • User@default網域配置— 這是當您安裝 IM and Presence 伺服器時的預設 IM 位址配置。

若要瞭解內部部署 IM&Presence 伺服器所使用的配置，請參閱 IM&Presence 伺服器設定。有關定址方案的更多詳細資訊，請參閱配置 IM 位址方案。

2

根據所選的 IM 位址方案，拖放contact.csv 檔案或enduser.csv 檔案。

  • 對於目錄 URI IM 位址配置 ，從目錄選取 UCM IM&P 個人聯絡人 - 目錄 URI IM 位址配置下拉清單。然後拖放contact.csv 檔案以匯入 Unified IM&Presence 伺服器的聯絡人清單。

  • 對於User@default配置 ，選取 UCM IM&P 個人聯絡人 - 從User@default選取 下拉清單。然後拖放enduser.csv 您從 Unified CM 應用程式匯出的contact.csv 檔案。

確保您已匯入enduser.csv 首先從您從 Unified CM 應用程式匯出的 .tar 檔案。

3

有關匯入檔案的詳細說明，請按一下查看檔案下載詳細資訊。

的匯出 Unified CM IM&Presence 聯絡人資料 匯入時顯示視窗contacts.csv 檔案。請遵循下列步驟，從 IM&Presence 伺服器匯出及下載個人聯絡人。

自訂聯絡人

  1. 登入 Cisco Unified CM IM and Presence 管理應用程式。

  2. 導覽至批量管理 > Non-Presence 聯絡人清單 > 匯出 Non-Presence 聯絡人清單 以下載contacts csv 檔案。

一般聯絡人

  1. 登入 Cisco Unified CM IM and Presence 管理 應用程式。

  2. 導覽至批量管理 > 聯絡人清單 > 匯出聯絡人清單 以下載contacts csv 檔案。

此功能不支援使用 CSV 檔案從 Cisco IM&Presence Active Directory移移使用者群組。Webex 也不支援 Active Directory (AD) 群組。您可以手動編輯 CSV 檔案來新增 AD 群組。完成移轉後，這些群組會在 Webex 上顯示為個人群組。

將 enduser.csv 檔案匯入時，匯出 Unified CM 使用者資料視窗會顯示。若要從 Unified CM 匯出和下載使用者資料，請按照下列步驟進行操作：

  1. 在「大量管理工具」底下，選取匯入/匯出，然後選取匯出。

  2. 從匯出的檔案清單中，選取 enduser.csv。

  3. 在「作業資訊」底下指定檔案名稱並選取要執行該作業的時間表。按一下提交。

  4. 檔案就緒時會列在「大量管理工具」中的上傳/下載底下。

  5. 下載 CSV 檔案。在移轉完成之前，請勿修改檔案。

在執行自動刪除策略時，會刪除超過 90 天上傳或儲存的資料。

4

成功完成上傳後，Control Hub 會驗證 csv 檔案中的聯絡人。

根據預設配置在驗證期間，您可以在檢查檔案中看到這些變更。

  • 如果 IM 位址配置是 User@DefaultDomain — 最終使用者檔案中的使用者電子郵件和聯絡人電子郵件會更換成「郵件 ID」或「目錄 URI」欄位。
  • 若是自訂聯絡人 — 最終使用者檔案中的使用者電子郵件會更換成「郵件 ID」或「目錄 URI」欄位。

您可在 Review 檔案中的「使用者電子郵件」或「聯絡人電子郵件」欄位中看到原本的值。Control Hub 會使用此電子郵件地址來檢查使用者或聯絡人是否存在於其 Common Identity (CI) 中。

下列詳細資訊會出現在螢幕上：

身分

說明

匯出的聯絡人總數

使用 BAT 檔案從 Unified CM IM & Presence 伺服器匯入的聯絡人總數。

Webex 中的使用者聯絡人

與使用者關聯且移轉至 Webex 的聯絡人總數。

待移轉的聯絡人

已就緒可移轉至使用者聯絡人清單的聯絡人總數。

已移轉的聯絡人

已成功移轉至使用者聯絡人清單的聯絡人總數。

  • 您可選擇按一下以取消匯入來取消匯入。如果上傳了錯誤的檔案或想要更新聯絡人詳細資訊，則可刪除已匯入的檔案。
  • 如果在上傳 csv 檔案後出現以下警告訊息：在輸入 csv 檔案的額外欄中找到資料，表示輸入檔案中的記錄值以逗號分隔。這些值現在分開顯示，在 csv 檔案中顯示為兩個不同的欄。您必須手動更正此值input csv 您從 Cisco Unified IM& Presence 伺服器下載的檔案。如果您未更正檔案就繼續進行驗證，可能會移轉不正確的資料。

(選用)

  1. 按一下更多選項以查看或刪除所匯入的檔案。

  2. 勾選這兩個選項以啟用刪除按鈕。確保您瞭解所執行動作的結果。此動作無法復原。

  • 我同意刪除所有已匯入的資料。

  • 我同意刪除所有未同步處理的記錄。

5

驗證 csv 檔案時，會啟用檢查是否同步處理按鈕。「檢查是否同步處理」頁面可讓您查看符合條件的聯絡人與發生錯誤的聯絡人的清單。

6

按一下大量編輯以修正標記的錯誤。按一下下載 XLS 檔案以下載錯誤報告。導覽至報告中的失敗原因，並採取適當的動作來解決錯誤，然後上傳最新的檔案。如需詳細資訊，請參閱已移轉的聯絡人。按一下選擇檔案以上傳檔案並再次驗證檔案。

7

處理完成後，會顯示已備妥可移轉至 Webex 應用程式的有效聯絡人總數。按一下移轉聯絡人即可開始移轉。

8

若要開始移入，請輸入工作名稱，然後按一下 確認和移入。

9

隨即會建立一個作業，而且您可以查看「追蹤移轉」進度以瞭解移轉狀態。作業完成時，請參閱「追蹤移轉」進度底下的成功 KPI，以知道成功移轉的聯絡人數。

只會移轉有效記錄，不會移轉無效記錄。

10

按一下「追蹤移轉」區段中「錯誤」旁的下拉箭頭以下載「摘要」報告。

然後新移轉的聯絡人就會列在 Webex 應用程式中。

從協力廠商來源中輸入個人聯絡人

此功能提供了將任何使用者的聯絡人新入 Webex 個人聯絡人（聯絡人服務）資料庫的通用機制。這是通用的，因為聯絡來源可能來自內部部署部署、雲端競爭對手的聯絡系統，甚至是Webex Calling MT 部署。它開啟了移轉場景，以支援任何個人聯絡人匯入案例，而不僅僅是Unified CM。

  • 將舊的聯絡人詳細資料取代為 使用聯絡人 UUID 的新通用檔案中提供的新詳細資料。

  • 此工具會填入聯絡 UUID 欄位。移轉聯絡人後，對應的聯絡人 UUID 資訊位於Migration Summary.csv 檔案。

  • 請勿修改範本檔案或 移移摘要.csv 檔案中的聯絡 UUID 欄位。此外，範本檔案中 不應有重複的聯絡人 UUID。因此，請勿複製記錄以在檔案中建立另一列。

  • 若要更新與聯絡 人有關的任何資訊，除了聯絡人 UUID 之外，還必須將聯絡人的所有詳細資料新增加到新檔案中。使用聯絡人 UUID 從最新的Migration Summary.csv 檔案。

使用下列程式來輸入駐留于協力廠商來源的使用者個人聯絡人。

1

若要匯入資料，按一下選取要匯入的聯絡人類型 下拉清單並選擇 一般個人聯絡人。

2

按一下 下載範例範本。

3

在用所有個人聯絡人的資料 填入範本檔案後，將其拖放至匯出個人聯絡人 部分。或者，按一下 流覽以尋找 檔案，並導覽至包含填入範本檔案範例的資料夾位置並上傳它。

  • 相片類型欄位支援 的格式為 JPEG、PNG、BMP 和 GIF。

  • 相片 編碼 方案必須是 Base64，以便處理資料。

  • 範本檔案中的下欄欄位為必要欄位：

    • 使用者電子郵件

    • 顯示名稱

    • 聯絡人電子郵件 或電話號碼— 必須填寫其中一個欄位。

    如果未填入範本中的必要欄位，則對應于該個人聯絡人的記錄在驗證過程中會標示為無效。

4

上傳成功後， Control Hub 會驗證 CSV 檔案中的聯絡人。

驗證過程完成後，標籤 自訂 會顯示在聯絡人旁邊。

如需有關 KPI 的詳細資訊，請參閱 從內部部署應用程式將個人聯絡人從內部部署應用程式部分中的 表格。

5

在從內部部署應用程式將個人聯絡人從內部部署應用程式區段執行步驟 5– 10 。

已移轉的聯絡人

此頁會列出所選聯絡人的錯誤和警告訊息。它還為您提供必要的建議和解決方案來解決錯誤。請先解決錯誤，然後再繼續。但是，您可以忽略警告。

附註：您也可以移除發生錯誤的聯絡人，然後繼續進行作業。

1

可查看下列值的計數：

  • 無效的聯絡人數

  • 無效的使用者

  • 有效使用者

  • 可移轉的聯絡人數。

2

按一下大量編輯以修正標記的錯誤。按一下下載 XLS 檔案以下載錯誤報告。導覽至報告中的「失敗原因」，並採取適當的動作來解決錯誤，然後上傳最新的檔案。按一下選擇檔案以上傳檔案並再次驗證檔案。

3

按一下移轉聯絡人。

隨即顯示移轉聯絡人進度列，而且在移轉完成之前，您無法執行任何動作。

4

在追蹤移轉狀態頁面查看移轉的狀態。此頁面會顯示移轉成功的聯絡人及移轉失敗的聯絡人計數。

Prepare your CSV to migrate personal contacts

使用此表格來查看哪些欄位是必填或可選的，以及批量移轉個人聯絡人時需要確定的內容。

欄

描述

支援的值

使用者電子郵件使用者網域 ID。最多可包含 128 個字元。該值是使用者電子郵件地址的網域部分。

bjones@example .com，其中 bjones 是使用者 ID，example.com 是網域

聯絡人電子郵件聯絡人網域 ID。最多可包含 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
地址輸入地址。範例：New York, NY 字元長度：1-30
電話號碼輸入電話號碼。您必須有電話號碼或分機號。

僅允許 E.164 號碼用於 CSV 匯入。

範例：+12815550100

電話號碼必須位於 Control Hub 中的號碼標籤上。

電話號碼類型輸入電話號碼類型。

工作、行動裝置、住家、其他。

如果未設定電話號碼類型，則無法呼叫。

照片編碼

輸入相片編碼配置。

編碼方案為 Base64

照片類型

照片的類型。

照片類型為 JPEG、PNG、BMP 和 GIF

相片內容

相片內容。

有效的 Base64 值

聯絡人 UUID

輸入聯絡人 UUID。

範例：AFS123CX

字元長度：36 個字元的英數字元。