Все, что нужно знать о личных контактах

Миграция контактов в облако – это единовременный импорт, который позволяет выполнять поиск, совершать вызовы, обмениваться сообщениями или приглашать людей из списка контактов аналогично Jabber.

Конечные пользователи определяют личные контакты Webex в приложении Webex.

Настраиваемые контакты Jabber — это контакты вне каталога, которые не относятся к вашей организации и контактам, которые хранятся в базе данных службы обмена мгновенными сообщениями и состояния доступности Cisco Unified Communications Manager.

Контакты сторонних разработчиков – это контакты вне вашей организации, которые могут экспортироваться или импортироваться в Webex позднее.

Предварительное требование

Прежде чем начать миграцию личных контактов, проверьте выполнение указанных далее требований.

  • Изучите азы работы в Control Hub.

    Webex Control Hub – это интерфейс управления для платформы Webex. Дополнительную информацию см. в статье Начало работы с Webex Control Hub.

  • Войдите в Control Hub, используя права администратора.

    С полными правами администратора любому пользователю в вашей организации вы можете назначить одну или несколько ролей. Обязательно назначьте какому-либо пользователю права администратора, чтобы иметь возможность выполнить миграцию для остальных настраиваемых контактов Jabber. Дополнительную информацию см. в статье Назначение ролей учетным записям пользователей организации в Webex Control Hub.

  • Для использования мастера миграции Control Hub потребуется, чтобы локальные приложения, из которых вы планируете переносить личные контакты, например, Cisco Unified Communications Manager (Unified CM) и служба обмена мгновенными сообщениями и состояния доступности Unified CM, имели версию 11.5 или более позднюю.

  • При переносе пользовательских контактов Jabber конечных пользователей воспользуйтесь bulk Administration для скачивания файла конечных пользователей из Cisco Unified Communications Manager (Unified CM) и файла контактов из Unified CM - IM и Presence.

    Для импорта пользователей в приложении Cisco Unified Communications Manager используйте меню Import/Export (Импорт и экспорт). Подробную информацию см. в статье Экспорт пользователей с помощью функции массового администрирования Unified CM.

  • При импорте пользовательских контактов из сторонних источников воспользуйтесь процедурой, описанной в "Импорт личных контактов из источников сторонних источников".

  • Убедитесь, что в рамках задачи по миграции допускается не более чем 500 контактов на пользователя, при этом один файл может содержать не более 10 000 контактов. Рекомендуется, чтобы файл состоял из контактов одного типа.

Экспорт пользователей с помощью функции массового администрирования Unified CM

Для экспорта и последующего импорта пользователей в Control Hub используйте функцию массового администрирования в приложении Unified CM.

Выполните эту процедуру для получения файла enduser из службы обмена мгновенными сообщениями и состояния доступности Cisco Unified Communications Manager, если схема адреса для обмена мгновенными сообщениями выглядит как "пользователь@домен_по_умолчанию".

  1. Выберите Bulk Administration (Массовое администрирование) > Import/Export (Импорт и экспорт) > Export (Экспорт), чтобы экспортировать список enduser из текущего домашнего кластера. Будет отображено окно Export Data (Экспорт данных).

    При повторной загрузке нового файла или того же файла средство обнаруживает только дублирующиеся личные контакты, но не может избежать их создания.

  2. Выберите Конечный пользователь в разделе Данные пользователя в окне Экспорт данных .

  3. Выберите имя файла для данных списка экспорта. В поле Job Description (Описание задания) введите описание, которое необходимо добавить для задания. Конфигурация экспорта является описанием по умолчанию.

  4. Щелкните Run Immediately (Выполнить сейчас) или запланируйте выполнение задания на другое время. Нажмите кнопку Отправить.

  5. Отслеживайте состояние задания экспорта. Чтобы активировать задание, воспользуйтесь параметром Job Scheduler (Планировщик заданий) в главном меню Bulk Administration (Массовое администрирование).

    Не изменяйте и не обновляйте файл TAR после экспорта файла из приложения Unified CM.

Выполните указанные ниже шаги, чтобы импортировать пользователей из приложения Cisco Unified CM.

1

Скачайте файл экспорта и сохраните его для дальнейшего использования: он понадобится по завершении переноса пользователей. Выберите Cisco Unified CM Administration (Администрирование Cisco Unified CM) > Bulk Administration (Массовое администрирование) > Upload/Download Files (Загрузка и скачивание файлов).

В окне Загрузка/скачивание выберите файл TAR и щелкните Скачать выбранное.

2

С помощью команды tar -xvf распакуйте файл с расширением .tar в любом расположении на компьютере. Извлеките файл enduser.csv в указанное расположение. Подробную информацию см. в статье Конфигурация и администрирование службы обмена мгновенными сообщениями и состояния доступности.

Алгоритм выполнения задач
Синхронизируйте контакты пользователя из локального развертывания в Webex Control Hub с помощью карточки "Миграция личных контактов в Webex".
1

В представлении клиента в Webex Control Hub перейдите к меню Обновления и миграции.

2

На карточке Миграция личных контактов в Webex щелкните Начать. Будет отображена страница синхронизации контактов.

Импорт персональных контактов из локального приложения
Выполняйте эту процедуру для импорта списков контактов из локального приложения. Можно удалить импортированный файл, все ожидающие миграции задачи или отчет об ошибках.
1

Чтобы импортировать данные, щелкните раскрывающийся список Выбрать тип контактов для импорта , а затем выберите тип адреса домена.

Система im и сервер Presence server поддерживают две следующие схемы адресации мгновенных данных:

  • Схема адресов мгновенных сообщений URI каталога. Поддерживает несколько доменов, выравнивание с адресом электронной почты пользователя и выравнивание с URI SIP Microsoft.

  • User@default схема домена. Это схема адреса im по умолчанию при установке сервера мгновенных мгновенных данных и присутствия.

Чтобы узнать схему, используемую локального сервера IM&Presence, см. настройки сервера IM&Presence. Дополнительные сведения о схеме адресации см. в статье Настройка схемы адресации мгновенных сообщений.
2

В зависимости от выбранных схем адресации мгновенных данных перетащите файл contact.csv или enduser.csv .

  • Для схемы адреса im URI каталога выберите UCM IM&P Персональные контакты – Схема адресов im URI каталога из раскрывающийся список. Затем перетащите файл contact.csv , чтобы импортировать список контактов для сервера Unified IM&Presence.

  • Для схемы User@default выберите UCM IM&P Персональные контакты – User@default домена из раскрывающийся список. Затем перетащите файл enduser.csv , экспорт из приложения Unified CM и файл contact.csv .

Сначала необходимо импортировать файл enduser.csv из файла .tar, экспортируемого из приложения Unified CM.

3

Чтобы получить подробные инструкции по импорту файла, щелкните See file download details (См. сведения о скачивании файла).

При импорте файла contacts.csv отображается окно Export Unified CM IM&Presence contact data (Экспорт данных контактов унифицированной службы обмена мгновенными сообщениями и состояния доступности). Выполните следующие шаги, чтобы экспортировать и скачать личные контакты с сервера IM&Presence.

Настраиваемые контакты

  1. Войдите в приложение администрирования мгновенных унифицированная (служба) Cisco CM и службы администрирования присутствия.

  2. Перейдите к списку контактов «Bulk administration > non-presence> Export Non-Presence Contact List (Экспортировать список контактов без присутствия), чтобы скачать файл csv контактов с сервера im&Presence.

Обычные контакты

  1. Войдите в приложение для администрирования унифицированной службы обмена мгновенными сообщениями и состояния доступности Cisco Unified CM.

  2. Перейдите к ссылке Массовое администрирование > списка контактов > экспортировать список контактов, чтобы скачать файл csv контактов с сервера im&Presence.

Эта функция не поддерживает миграцию группы пользователей Active Directory с сервера Cisco IM&Presence с помощью файла CSV. Кроме того, Webex не поддерживает группы Active Directory (AD). Можно вручную отредактировать файл CSV, чтобы добавить группы AD. По завершении миграции эти группы отображаются в Webex как личные группы,

При импорте файла enduser.csv отображается окно Export Unified CM user data (Экспорт данных пользователей Unified CM). Чтобы экспортировать и скачать данные пользователей из Unified CM, выполните указанные далее действия.

  1. В разделе Bulk Administration (Массовое администрирование) выберите Import/Export (Импорт и экспорт) и нажмите Export (Экспорт).

  2. Из списка экспортных файлов выберите enduser.csv.

  3. В разделе Job Information (Сведения о задании) укажите имя файла и выберите время для выполнения задания. Нажмите кнопку Отправить.

  4. По готовности файл появится в списке файлов Upload/Download (Загрузка и скачивание) в разделе массового администрирования.

  5. Скачайте файл CSV. Не изменяйте файл до завершения миграции.

При реализации политики автоматического удаления удаляются загруженные или сохраненные данные, хранимые более 90 дней назад.
4

После успешного завершения загрузки Control Hub проверяет контакты в файлах csv.

В ходе проверки в зависимости от схемы по умолчанию эти изменения можно просмотреть в файле "Обзор".

  • Если схема адреса для обмена мгновенными сообщениями отличается от схемы "пользователь@домен по умолчанию". Адрес электронной почты пользователя и контакта заменяется значением поля MAIL ID (ПОЧТОВЫЙ ИДЕНТИФИКАТОР) или DIRECTORY URI (URI КАТАЛОГА) из файла enduser.

  • Настраиваемые контакты. Адрес электронной почты пользователя заменяется значением поля MAIL ID (ПОЧТОВЫЙ ИДЕНТИФИКАТОР) или DIRECTORY URI (URI КАТАЛОГА) из файла enduser.

Замененное значение отображается в поле User Email (Адрес электронной почты пользователя) или Contact Email (Адрес электронной почты контакта). Control Hub использует этот адрес электронной почты, чтобы проверить, существует ли пользователь или контакт в общих параметрах идентификации (CI).

На экране отображаются указанные далее сведения.

Удостоверения

Описание

Общее количество импортированных контактов

Общее количество контактов, импортированных из сервера унифицированной службы обмена мгновенными сообщениями и состояния доступности Unified CM в файле BAT.

Контакты пользователя в Webex

Общее количество контактов, связанных с пользователем и прошедших миграцию в Webex.

Контакты, подлежащие миграции

Общее количество контактов, готовых к миграции в список контактов пользователя.

Контакты, прошедшие миграцию

Общее количество контактов, которые успешно прошли миграцию в список контактов пользователя.

  • Чтобы отменить импорт, выберите Click to cancel import (Щелкните для отмены импорта). Если вы загрузили не тот файл или хотите обновить сведения о контакте, можно удалить импортированный файл.

  • Если после загрузки файла csv отображается предупреждение Found data in extra columns in input csv file (Найдены данные в дополнительных столбцах файла csv со вводными данными), подразумевается, что значение записи в файле вводных данных разделено запятой. Теперь эти значения разделены и отображаются в файле csv в двух раздельных столбцах. Вам необходимо вручную исправить это значение из файла ввода csv , скачаного с сервера унифицированная (служба) Cisco IM&Presence. Если не исправить файл и продолжить проверку, миграции могут быть подвергнуты неверные данные.

(Дополнительно)

  1. Щелкните меню дополнительных параметров, с помощью которых можно просмотреть импортированный файл, нажав View (Просмотр), или же удалить его, нажав Delete (Удалить).

  2. Выберите оба этих варианта, чтобы активировать кнопку Delete (Удалить). Убедитесь, что вы понимаете, к чему приводит каждое из этих действий. Это действие невозможно отменить.

  • Я подтверждаю удаление всех импортированных данных.

  • Я подтверждаю удаление всех несинхронизированных записей.

5

При проверке файла csv кнопка Review for sync (Проверка синхронизации) активна. На странице проверки синхронизации можно просмотреть список контактов, прошедших проверку, и контактов, в связи с которыми возникли ошибки.

6

Щелкните Bulk Edit (Массовое редактирование), чтобы исправить найденные ошибки. Щелкните Download XLS file (Скачать файл XLS), чтобы скачать отчет об ошибках. Перейдите в столбец Failure reason (Причина ошибки) в отчете и примите соответствующие меры для исправления ошибки, после чего загрузите актуальную версию файла. Подробную информацию см. в статье Контакты, прошедшие миграцию. Щелкните Choose file (Выбрать файл), чтобы загрузить файл, и выполните проверку файла снова.

7

По завершении обработки будет отображено общее количество действительных контактов, которые готовы к миграции в приложение Webex. Щелкните Migrate Contacts (Миграция контактов), чтобы начать миграцию.

8

Чтобы начать миграцию, введите название задачи и щелкните Подтвердить и перенести.

9

Будет создана соответствующая задача. Чтобы узнать состояние миграции, можно просмотреть ход выполнения в разделе Track Migration (Отслеживание миграции). По завершении выполнения задачи ознакомьтесь с KPI Success (Успешно) в разделе отслеживания миграции, чтобы определить количество контактов, которые успешно прошли миграцию.

Миграция выполняется только для действительных записей. Миграция недействительных записей невозможна.

10

Чтобы скачать сводный отчет, щелкните стрелку вниз рядом с заголовком Errors (Ошибки) в разделе отслеживания миграции.

Теперь контакты, для которых вы только что выполнили миграцию, будут отображаться в приложении Webex.

Импорт персональных контактов из источников сторонних источников

Эта функция предоставляет общий механизм импорта контактов всех пользователей в базу данных персональных контактов (службы контактов) Webex. Это общий характер, поскольку источником контактов могут быть локальный развертывания, облачные системы связи с конкурентами или даже развертывания Webex Calling MT. Он открывает сценарии миграции для поддержки любого случая импорта личный контакт , а не только Unified CM.

  • Замените старые сведения о контакте новыми сведениями, которые предоставляются в новом общем файле, с помощью UUID контакта.

  • Инструмент заполняет поле Contact UUID (UUID контакта). После миграции контакта соответствующая информация об UUID контакта доступна в файле Migration Summary.csv .

  • Не изменяйте поле Contact UUID в файле шаблона или файле Migration Summary.csv. Кроме того, не должно быть дублировать UUIDконтактов в файле шаблона. Следовательно, не копируйте записи, чтобы создать другую строку в файле.

  • Если вы хотите обновить какие-либо сведения, касающиеся контакта, необходимо добавить все сведения о контакте в новый файл в дополнение к UUID контакта. Используйте UUID контакта в последнем файле Migration Summary.csv .

Для импорта персональных контактов пользователей, которые находятся в сторонних источниках, воспользуйтесь следующей процедурой.

1

Чтобы импортировать данные, щелкните раскрывающийся список Выбрать тип контактов для импорта и выберите Общие личные контакты.

2

Щелкните Скачать образец шаблона.

3

После заполнения файла шаблона данными для всех персональных контактов перетащите его в раздел Импорт личных контактов . Также можно нажать найти файлы и перейти в папку, в которой находится заполненный файл шаблона, и загрузить его.

  • В поле "Тип фотографии" поддерживаются форматы JPEG, PNG, BMP и GIF.

  • Схема кодиации фотографии должна иметь базу64 для обработки данных.

  • Следующие поля в файле шаблона являются обязательными.

    • Адрес электронной почты пользователя

    • Отображаемое имя

    • Контактный адрес электронной почты или Номер телефона

      – Необходимо заполнить одно из этих полей.

    Если какой-либо из обязательных полей в шаблоне не заполнен, во время проверки запись, соответствующая этому личному контакту, помечется как недействительная.

4

После успешной загрузки Control Hub проверяет контакты в файле CSV.

По завершению процесса проверки рядом с контактами будет отображаться метка Настраиваемая.

Подробнее о KPIS можно найти в таблице раздела Импорт личных контактов из локального приложения.

5

Выполните действия 5–10 в разделе Импорт личных контактов из локального приложения.

Контакты, прошедшие миграцию

На этой странице отображается список сообщений об ошибках и предупреждений для выбранных контактов. Кроме того, на ней приводятся необходимые рекомендации и решения, которые позволяют устранить возникшие проблемы. Прежде чем продолжить, необходимо исправить ошибки. Предупреждения же можно проигнорировать.

Примечание. Можно также удалить контакты с ошибками и продолжить.

1

Можно просмотреть количество перечисленных далее значений.

  • Недействительные контакты

  • Недействительные пользователи

  • Действительные пользователи

  • Контакты, для которых можно выполнить миграцию.

2

Щелкните Bulk Edit (Массовое редактирование), чтобы исправить найденные ошибки. Щелкните Download XLS file (Скачать файл XLS), чтобы скачать отчет об ошибках. Перейдите в столбец Failure reason (Причина ошибки) в отчете и примите соответствующие меры для исправления ошибки, после чего загрузите актуальную версию файла. Щелкните Choose file (Выбрать файл), чтобы загрузить файл, и выполните проверку файла снова.

3

Щелкните Migrate Contacts (Миграция контактов).

Будет отображен ход выполнения миграции контактов. До завершения миграции у вас не будет возможности выполнять какие-либо действия.

4

Просмотрите состояние миграции на странице Track Migration Status (Отслеживание состояния миграции). На этой странице отображается количество контактов, которые успешно прошли миграцию, и контактов, миграцию которых выполнить не удалось.

Подготовьте файл CSV для переноса личных контактов

В этой таблице можно узнать, какие поля являются обязательными или необязательными, а также что необходимо определить при массовой миграции личных контактов.

Столбец

Описание

Поддерживаемые значения

Адрес электронной почты пользователяИдентификатор домена пользователя. Он может содержать не более 128 символов.Значение представляет собой доменную часть адреса электронной почты пользователя.

bjones@example.com, где bjones — идентификатор пользователя, а example.com — домен

Контактный адрес электронной почтыИдентификатор домена контакта. Он может содержать не более 128 символов.Значение является доменной частью адреса электронной почты контакта.

bjones@example.com, где bjones — идентификатор контакта, а example.com — домен

Имя группыИмя группы, в которую необходимо добавить запись списка контактов.Если контакты пользователя не отсортированы в группы, в поле «Имя группы» будет указано имя группы по умолчанию.
Отображаемое имяВведите отображаемое имя.Пример: Тестировать

Поддерживаются только символы UTF-8.

Длина в символах: 1-30
ИмяВведите имя, чтобы отобразить имя контакта.Пример: Тед

Поддерживаются только символы UTF-8.

Длина в символах: 1-30
ФамилияВведите фамилию, чтобы отобразить имя контакта.Пример: Росс

Поддерживаются только символы UTF-8.

Длина в символах: 1-30
КомпанияВведите название компании.Пример: Длина символов ABC: 1-30
ЗаголовокВведите название.Пример: Длина Символа заголовка: 1-30
АдресВведите адрес.Пример: Нью-Йорк, Нью-Йорк: 1-30
Номер телефонаВведите номер телефона. У вас должен быть либо номер телефона, либо добавочный номер.

Импорт файла CSV разрешен только для номеров в формате E.164.

Пример: +12815550100

Номер телефона должен отображаться на вкладке Номера в Control Hub.

Тип номера телефонаВведите тип номера телефона.

Да, Нет

Если тип номера телефона не задан, вызов невозможен.

Кодирование фотографий

Введите схему кодирования фотографий.

Схема кодирования Base64

Тип фотографии

Тип фотографии.

Типы фотографий: JPEG, PNG, BMP и GIF

Контент фотографии

Контент фотографии.

Допустимое значение Base64

UUID контакта

Введите UUID контакта.

Пример: AFS123CX

Длина символа: 36 буквенно-цифровых символов.