瞭解個人聯絡人

使用Control Hub將您的最終使用者的 Jabber 自訂聯絡人或任何第三方自訂聯絡人來源移轉至Webex個人聯絡人。 聯絡人移轉至雲端是一次性匯入，可讓您使用與 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. 選取大量管理工具 > 匯入/匯出 > 匯出，將目前主叢集的移轉使用者的最終使用者清單匯出。 這時會出現「匯出資料」視窗。

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

  2. 在「匯出資料」視窗的「使用者資料」區段底下，選擇最終使用者。

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

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

  5. 監視匯出工作的狀態。 如果工作排定在稍後執行，請使用「大量管理工具」主功能表中的「工作排程器」選項來啟動工作。

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

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

1

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

在「上傳/下載」視窗中，選取 tar 檔案，然後按一下下載所選檔案。
2

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

任務流程

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

1

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

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

從內部部署應用程式匯入個人聯絡人

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

1

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

IM and Presence 伺服器支援以下兩種IM址方案：

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

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

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

根據所選的IM址方案，將聯絡人.csv檔案 或最終使用者.csv檔案。

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

  • 對於 User@預設網域方案的方案，選取UCM IM&P 個人聯絡人 - User@預設網域從下拉式清單。 然後將最終使用者.csv您從Unified CM應用程式和聯絡人.csv檔案。


 

請確保將最終使用者.csv首先從 檔案中。 Unified CM應用程式匯出的Tar 檔案。
3

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

將 contacts.csv 檔案匯入時，匯出 Unified CM IM&Presence 聯絡人資料會顯示。 請遵循以下步驟，從 IM&Presence 伺服器匯出和下載個人聯絡人。

自訂聯絡人

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

  2. 導覽至批量管理 > non-presence 聯絡人清單 > 匯出 non-presence 聯絡人清單以下載聯絡人 csv IM&Presence 伺服器中的檔案。

一般聯絡人

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

  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 檔案中的聯絡人。


 

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

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

  • 若是自訂聯絡人 — 最終使用者檔案中的使用者電子郵件會更換成「郵件 ID」或「目錄 URI」欄位。

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

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

身分

說明

匯出的聯絡人總數

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

Webex 中的使用者聯絡人

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

待移轉的聯絡人

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

已移轉的聯絡人

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

 

  • 您可選擇按一下以取消匯入來取消匯入。 如果上傳了錯誤的檔案或想要更新聯絡人詳細資訊，則可刪除已匯入的檔案。

  • 如果在上傳 csv 檔案後出現以下警告訊息： 在輸入 csv 檔案的額外欄中找到資料，表示輸入檔案中的記錄值以逗號分隔。 這些值現在分開顯示，在 csv 檔案中顯示為兩個不同的欄。 您必須從輸入 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資訊可在移轉摘要.csv檔案。

  • 請勿修改聯絡人 UUID範本檔案或移轉摘要.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以移轉個人聯絡人

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

欄

說明

支援的值
使用者電子郵件 使用者網域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
位址 輸入地址。 範例： 紐約，NY 字元長度： 1-30
電話號碼 輸入電話號碼。 您必須有電話號碼或分機號。

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

範例： +12815550100


 

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

是，否


 

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

照片編碼

輸入相片編碼方案。

編碼方案為 Base64

照片類型

照片的類型。

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

照片內容

照片內容。

有效的 Base64 值

聯絡人 UUID

輸入聯絡人 UUID。

範例： AFS123CX

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