Обзор синхронизации каталогов

Синхронизация каталогов гарантирует, что пользователи Webex для Cisco BroadWorks могут использовать каталог Webex из приложения Webex для вызова любого вызываемого объекта с сервера BroadWorks. Эта функция синхронизирует информацию о вызовах BroadWorks, которая не была частью обеспечения пользователя для каталога Webex.

При обеспечении webex для пользователя Cisco BroadWorks каталог Webex обновляется с учетом сведений о вызовах Webex для пользователей Cisco BroadWorks (основной номер телефона, номер мобильного телефона, расширение), но не записывают записи внешних вызовов. Однако, когда синхронизация каталогов в настоящее время находится в сети, она также синхронизирует следующие записи о вызовах с каталогом Webex.

  • Вызовы только BroadWorks (пользователи, не которых нет в Webex)

  • Объекты вызовов не пользователей (например, комната для совещаний, факс, сервисная группа номер)

  • Записи списка телефонов BroadWorks

В таблице ниже фиксируют записи вызовов BroadWorks и показано, как они добавляются в каталог Webex.

Таблица 1. Обновление синхронизации каталогов для каталога Webex

Записи вызовов BroadWorks

Описание

Добавлено в каталог Webex с помощью...

Webex для пользователей Cisco BroadWorks

Для пользователей включена webex для Cisco BroadWorks

Обеспечение пользователя (например, поминая подготовка)

Вызовы пользователей только BroadWorks

Вызов пользователей, не которых нет в Webex

Синхронизация каталогов

Объекты вызовов, не взывающих пользователей

Например, номер комната для совещаний телефона, факса, номера группы поисков

Синхронизация каталогов

Списки телефонов BroadWorks

Записи списка телефонов BroadWorks:

  • Общие списки телефонов предприятия

  • Общие списки телефонов групп (групп поставщиков услуг или корпоративных групп).

  • Личные списки телефонов

Синхронизация каталогов (синхронизация списка телефонов)


Более подробные сведения об обеспечении пользователя см. в руководстве по решению Webex для Cisco BroadWorks.

Условия синхронизации каталогов

  • Администраторы-партнеры должны включить эту функцию на уровне партнера. Администраторы партнеров могут включить или выключить эту функцию для нескольких клиентских организаций с помощью одной операции.

  • По умолчанию начальная синхронизация осуществляется через неделю после включения синхронизации (время для запуска синхронизации выбирается случайным образом). Однако для обхода недельного периода ожидания и выполнения немедленной синхронизации определенной клиентской организации клиентскими организациями может использоваться параметр Синхронизировать сейчас.

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

  • Максимальное количество одновременных синхронизаций для кластера BroadWorks составляет два: одна запланированная синхронизация и одна синхронизация по запросу (посредством API или GUI Partner Hub). Однако администраторы не могут одновременно запускать две синхронизации "по запросу" из одной broadWorks. Это ограничение существует независимо от того, была ли синхронизация инициирована с помощью API или с помощью параметра Синхронизировать сейчас в Partner Hub. Кроме того, Webex не будет планировать две запланированные синхронизации, которые будут запускаться одновременно с одной и той же BroadWorks.

  • В случае сбоя синхронизации Webex будет автоматически переключена каждые 24 часа до следующей запланированной синхронизации.

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

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

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

  • Для пользователей, которые звонят только в BroadWorks, и устройств, вызывающих не пользователей, эта функция синхронизирует следующие типы номеров телефона с BroadWorks:

    • Основной номер телефона

    • Номер мобильного телефона

    • Расширение

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

Список телефонов BroadWorks и максимальное число контактов

Синхронизация каталогов также синхронизирует записи списка телефонов BroadWorks со списком контактов Webex. Синхронизированные записи добавляются в один из следующих типов контактов:

  • Контакты организации. Webex сохраняет эти контакты в отношении организации. Каждый пользователь имеет доступ к контактам организации. Максимум 500 контактов.

  • Контакты пользователя. Webex сохраняет эти контакты в отношении пользователя. Доступ к записи контакта может получить только тот пользователь, который является владельцем контакта. Максимум до 2000 контактов (1500 синхронизированных контактов + 500 контактов для ввода вручную).


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

В таблице ниже сопомечируются типы контактов Webex с источником контактов (синхронизированные со списком телефонов BroadWorks или добавленные вручную).

Таблица 2. Максимальное количество и источник синхронизации каталогов

Тип контакта Webex

Источник контакта

Maximum (Максимум)

Синхронизировано из BroadWorks...

API синхронизации

Контакты организации

Синхронизация каталогов

500 контактов

Общие списки телефонов предприятия

/directories/enterprisecommon

Общие списки телефонов группы (для группы поставщиков услуг) **

/directories/groupcommon

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

Синхронизация каталогов

1500 контактов

Общие списки телефонов группы (для корпоративной группы) **

/directories/groupcommon

Личные списки телефонов

/directories/personal

Добавлено пользователем вручную

500 контактов

н/д

н/д


** Общие списки телефонов группы синхронизируются по-разному в зависимости от того, находится ли BroadWorks в корпоративном или поставщик услуг режиме. Значение isBroadWorksEnterprise параметра (истина или ложь) определяет способ синхронизации списка.

  • True. Синхронизировать с контактом пользователя

  • False. Синхронизировать как контакт организации

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

  • Если в организации превышено максимально разрешенное количество контактов для синхронизации (500 контактов организации или 1500 синхронизированных контактов пользователей), синхронизация каталогов исключает записи выше максимального порогового значения. К синхронизированным и пропущенным контактам не применяется определенный порядок.

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

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

Обновления

Ниже приведены условия обработки обновлений каталогом Webex.

  • Если имя контакта изменяется в BroadWorks, существующий контакт удаляется из каталога Webex и создается новый контакт.

  • Если номер контакта изменится в BroadWorks, Webex обноит существующий контакт в каталоге Webex новым номером.

После обновления контакта администратором в BroadWorks при отобрачении обновления в приложении Webex пользователя будут отображаться следующие условия.

  • Если обновление действительно для вызываемого пользователя с возможностью только BroadWorks или вызываемого объекта, который не является пользователем, обновление отображается в приложении Webex пользователя сразу после последующей синхронизации каталогов.

  • Если обновление имеет место для записи списка телефонов BroadWorks,

    • Для контактов пользователей. Обновления отображаются в приложении Webex пользователя сразу после последующей синхронизации каталогов.

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


Обновления Webex для Cisco BroadWorks информация о пользователе обрабатываются как часть процессов обеспечения.

В Control Hub есть параметр добавления или редактирования контактов на уровне организации в Control Hub с помощью файла CSV. Доступ к этой опции есть у администраторов-партнеров и администраторов клиентов с доступом Control Hub. Однако обновление контактов с помощью Control Hub не поддерживается Webex для Cisco BroadWorks. Обновления контактов, примененные в Control Hub, не синхронизируются с BroadWorks и недоступны для поиска в каталоге со настольных телефонов.

Предварительные требования для синхронизации каталогов

Рекомендуется использовать следующие настройки.


В приведенном ниже примере предполагается, что используется сервер XSP. Для серверов ADP замените (XSP_CLI) на (ADP_CLI).
  • Значения ограничения скорости: задайте следующие свойства системы для управления устранением перегрузки (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit — Установите значение «null».

    • globalDirectoryTransactionLimit — Установите значение «null».


    Рекомендуется установить userDirectoryTransactionLimit и globalDirectoryTransactionLimit на нулевое значение. Но если вы решите установить значения, каждое из них должно быть как минимум в пять раз больше значения transactionLimitPeriodSecond (которое должно быть равным 1).
  • Ограничения транзакций – задайте следующие значения (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimits – установите значение не менее "100".

    • transactionLimitPeriodSeconds – установите значение "1".

  • Значения пейджинга – задайте свойства системы пейджинга (XSP_CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize – Значение «50»

    • availableUserMaxLimit – Значение «100»

  • Интерфейс CTI — Убедитесь в том, что вы загрузили сертификаты Webex CA в trust store интерфейса CTI и в том, что вы включили аутентификацию клиента в интерфейсе CTI.

Кроме того, в зависимости от выпуска BroadWorks, рекомендуется применить указанные далее системные исправления к развертыванию BroadWorks перед тем, как включить эту функцию.

Включение синхронизации каталогов (новый шаблон)

Администраторы партнеров могут включить функцию синхронизации каталогов для шаблона клиента при создании нового шаблона. Для всех новых клиентских организаций, которые назначены этому шаблону, будет включена синхронизация каталогов. Подробности см. в разделе "Настройка шаблонов клиентов" раздела Настройка партнерской организации в центре партнера в руководстве по решению Webex для Cisco BroadWorks.

Дальнейшие действия

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

Включение синхронизации каталогов (существующий шаблон)

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

1

Войдите в центр партнера и щелкните Настройки.

2

Прокрутите страницу до раздела Вызовы BroadWorks и щелкните Просмотр шаблонов.

3

Выберите соответствующий шаблон клиента и прокрутите страницу до раздела Синхронизация каталога BroadWorks.

4

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

  1. Установите переключатель Включить синхронизацию каталога BroadWorks и списка телефонов для всех новых организаций клиента в положение Включено.

  2. Щелкните Сохранить.

5

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

  1. Щелкните Показать список состояний синхронизации клиентов.

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

  3. Щелкните Включить синхронизацию.


 

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

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

  • На этапе 5c щелкните Отключить синхронизацию, чтобы отключить эту функцию для существующих организаций.

Дальнейшие действия

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

Выполнение немедленной синхронизации

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

1

Войдите в центр партнера (http://admin.webex.com) и щелкните Настройки.

2

Прокрутите страницу до раздела Вызовы BroadWorks и щелкните Просмотр шаблонов.

3

Выберите соответствующий шаблон клиента и прокрутите страницу до раздела Синхронизация каталога BroadWorks.

4

Щелкните Показать список состояний синхронизации клиентов.

5

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

6

Чтобы отобразить результат синхронизации, щелкните Обновить.

Экспорт записей синхронизации в файл CSV

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

1

Войдите в центр партнера (http://admin.webex.com) и щелкните Настройки.

2

Прокрутите страницу до раздела Вызовы BroadWorks и щелкните Просмотр шаблонов.

3

Выберите соответствующий шаблон клиента и прокрутите страницу до раздела Синхронизация каталога BroadWorks.

4

Щелкните Показать список состояний синхронизации клиентов.

5

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

6

Щелкните Результаты экспорта.

Общедоступные API для синхронизации каталогов

Общедоступные API размещены на веб-сайте developer.webex.com. С их помощью администраторы партнеров могут обновлять настройки синхронизации каталогов для клиентских организаций, которыми они управляют, запускать немедленную синхронизацию или получать информацию о состоянии синхронизации. Методы синхронизации каталогов сгруппируются по предприятиям BroadWorks:

  • List BroadWorks Enterprises (Перечисление предприятий BroadWorks). Используйте этот метод API для получения списка предприятий у определенного поставщика услуг, а также отображения для каждого предприятия его id. Необходимо ввести значение spEnterpriseId, назначенное при подготовке.

  • Update Directory Sync for a BroadWorks Enterprise (Обновление синхронизации каталогов для предприятия BroadWorks). Введите id предприятия, чтобы обновить состояние синхронизации каталога для этого предприятия, включая или отключая синхронизацию каталогов.

  • Trigger Directory Sync for an Enterprise (Запуск синхронизации каталогов для предприятия). Используйте этот метод API, чтобы инициировать немедленную синхронизацию для определенного id. Для параметра syncStatus введите команду SYNC_NOW.

  • Get Directory Sync Status for an Enterprise (Получение данных о состоянии синхронизации каталогов для предприятия). Введите id предприятия и запустите для получения сведений о состоянии и значения trackingId для последней синхронизации. Значение trackingID можно использовать для запуска дополнительных аналитик с помощью таких инструментов, как Kibana и Grafana.

Кроме того, администраторы могут использовать триггерную синхронизацию каталога для API одного пользователя для запуска синхронизации каталогов по запросу для одного пользователя.

Подробную документацию относительно API см. по ссылке https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Чтобы ознакомиться с спецификацией API, необходимо войти в https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Синхронизация нескольких предприятий с помощью API

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

  • Синхронизация каталогов позволяет синхронизировать только одно предприятие с кластером Broadworks одновременно посредством синхронизации по запросу. При попытке синхронизировать несколько предприятий вы получите ошибку 429

  • Время, которое требуется для выполнения синхронизации одного предприятия, зависит от размера предприятия.

1

Запустите API List BroadWorks Enterprises (Перечисление предприятий BroadWorks), чтобы создать список предприятий, которые необходимо синхронизировать.

  1. Для параметра startWith установите значение, соответствующее начальной строке идентификатора предприятия или поставщика услуг.

  2. Нажмите кнопку Запуск.

2

Запустите API Trigger Directory Sync for an Enterprise (Запуск синхронизации каталогов для предприятия) на первом предприятии в списке.

  1. Введите идентификатор предприятия.

  2. Для параметра syncStatus задайте значение SYNC_NOW

  3. Нажмите кнопку Запуск.

    Для предприятия будет запущена немедленная синхронизация. При такой синхронизации учитывается ограничение на одну синхронизацию по запросу для Broadworks.
3

Подождите несколько секунд и запустите API Get Directory Sync Status (Получение данных о состоянии синхронизации каталогов для предприятия), чтобы получить сведения о состоянии синхронизации.

  1. Введите идентификатор предприятия

  2. Нажмите кнопку Запуск.

4

По завершении синхронизации выполните шаги 2–4 для следующего предприятия в списке. Повторяйте эти шаги, пока не будет синхронизирован весь список.

Коды ошибок для синхронизации каталогов

К синхронизации каталогов применяются перечисленные ниже коды ошибок.

Код ошибки

Сообщение об ошибке

600000

Непредвиденная ошибка синхронизации пользователей внешнего каталога Broadworks.

600001

Не удалось синхронизировать пользователей внешнего каталога Broadworks.

600002

Синхронизация пользователей внешнего каталога Broadworks прервана до завершения.

600003

Синхронизация пользователей внешнего каталога Broadworks успешно выполнена только частично. Не удалось синхронизировать некоторые клиентские организации.

600004

Синхронизация пользователей внешнего каталога Broadworks не включена для параметра ConfigSet.

600005

Выполняется синхронизация пользователей с внешним каталогом Broadworks для параметра ConfigSet.

600006

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

600007

Идентифицируемая организация CustomerConfig не найдена.

600008

Параметр CustomerConfig не найден в партнерской организации.

600009

Невозможно запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку кластер Broadworks, связанный с CustomerConfig, занят.

600010

Не удается запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку отсутствует кластер BroadWorks, связанный с CustomerConfig.

600011

Синхронизация пользователей внешнего каталога Broadworks не включена для CustomerConfig.

600012

Не удается запустить синхронизацию пользователей внешнего каталога Broadworks, поскольку синхронизация каталогов гибридного типа уже включена для CustomerConfig.

600013

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

600014

Ошибка синхронизации пользователей внешнего каталога Broadworks при попытке подключения к кластеру Broadworks. Ошибка Broadworks: %s.

600015

При синхронизации пользователей внешнего каталога Broadworks не найдены соответствующие пользователи в хранилище удостоверений.

600017

При синхронизации списка телефонов BroadWorks не удалось синхронизировать все контакты пользователя и предприятия/организации.

600018

Синхронизация списка телефонов BroadWorks не удалась для пользователей в предприятии/организации.

600019

При синхронизации списка телефонов BroadWorks не удалось синхронизировать контакты предприятия/организации.

600020

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

600022

Синхронизация пользователей с внешним каталогом BroadWorks не возможна, поскольку в организации нет предусмотренного пользователя.

600023

Синхронизация пользователей с внешним каталогом BroadWorks невозможен, поскольку пользователь уже существует в этой организации.

600024

Синхронизация с одним пользователем из внешнего каталога BroadWorks не возможна, поскольку в BroadWorks не найдено ни одного совместимго пользователя.

600025

Не удалось обновить данные синхронизации пользователей внешнего каталога BroadWorks в учетная запись пользователя CI.

600026

Не удалось обновить учетную запись компьютера в CI в BroadWorks External Directory User Sync.

600027

Синхронизация пользователей с внешним каталогом BroadWorks не возможна, поскольку в BroadWorks было обнаружено несколько пользователей.

600028

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

600029

Не удалось синхронизировать пользователей с внешним каталогом BroadWorks, поскольку в организации не предусмотрен пользователь.

История изменений

В следующей таблице подводятся краткие итоги по обновлениям этой статьи.

Дата

Редакция

19 июля 2022 г.

Разъяснения и исправления обзорной информации.

  • Обновлен обзор синхронизации каталогов, чтобы уточнить различные синхронизации и способ обновления каталога Webex для каждой из них.

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

  • Внесение исправлений в обновления для уточнения длительности отображения обновленных записей в приложении Webex.

9 мая 2022 г.

  • В обзоре синхронизации каталоговисправлено Примечание в таблице "Максимальное количество синхронизаций каталогов и источник ". Кроме того, обновлена заметка о потеке и предоставлении.

  • Grammatical edits и fixes (Редактирование и исправления)

7 апреля 2022 г.

  • Добавлено примечание в раздел " Обновления" в разделе "Обзор синхронизации каталогов" об ограничении применения изменений контактов на уровне организации в Control Hub.

28 марта 2022 г.

  • Повторно отодержимому контента в меню Включить синхронизацию каталогов (новый шаблон) .

  • Добавлена информация о максимальной синхронизации. Можно выполнить одну запланированную синхронизацию и одну синхронизацию API одновременно из одного кластера.

  • Добавлена информация о триггерной синхронизации каталога для API одного пользователя.

24 марта 2022 г.

Добавлен список типов синхронизированных номеров телефона в условия синхронизации каталогов. Теперь синхронизация включает номера мобильных телефонов.

16 марта 2022 г.

  • Добавлены новые коды ошибок.

  • Добавлено вводное описание для улучшения использования при поиске в Интернете.

17 декабря 2021 г.

  • Незначительные изменения исправлений, чтобы устранить проблему с отсутствуют TOC.

16 декабря 2021 г.

  • Обновлена статья: увеличено максимальное значение для контактов пользователей.

8 декабря 2021 г.

  • Добавлен раздел "Синхронизация каталогов и максимальное количество контактов", чтобы уточнить, каким образом синхронизация каталогов определяет максимальное количество контактов организации и пользователя.

  • Изменено форматирование таблицы Коды ошибок для синхронизации каталогов для большего удобства чтения.