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

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

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

  • Пользователи, вызывающие только BroadWorks (не подключенные к Webex)

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

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

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

Таблица 1. Обновления Directory Sync для каталога Webex

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

Описание

Добавлено в каталог Webex через ...

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

Пользователи включены для Webex для Cisco BroadWorks

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

Пользователи, вызывающие только BroadWorks

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

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

Не вызывающие пользователя объекты

Например, телефон конференц-зала, факс, номер группы поиска.

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

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

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

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

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

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

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

Дополнительные сведения о синхронизации пользователей см. В Руководство по решению Webex для Cisco BroadWorks .

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

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

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

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

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

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

  • Синхронизация игнорирует пользователей, у которых нет номер телефона.

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

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

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

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

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

    • Расширение

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

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

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

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

  • Контакты пользователя. Webex сохраняет эти контакты для пользователя. Только пользователь, владеющий контактом, может получить доступ к записи контакта. Максимальное количество контактов - до 2000 (1500 синхронизированных контактов + 500 контактов ручного ввода).
В контакты Webex добавляются только записи из списка телефонов. Вызывающие пользователи BroadWorks и лица, не являющиеся пользователями, которые включены в синхронизацию каталогов, не добавляются в Контакты, если пользователь Webex не добавит их в Контакты вручную.

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

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

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

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

Максимум

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

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

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

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

30000 контактов

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

/directories/enterprisecommon

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

/directories/groupcommon

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

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

1500 контактов

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

 /directories/personal

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

500 контактов

н/д

н/д

Групповые контакты

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

30000 контактов в группе

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

 /directories/groupcommon

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

  • Верно - синхронизировать как групповой контакт.

  • Неверно - синхронизировать как контактное лицо организации.

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

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

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

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

  • Общий комбинированный лимит для контактов организации (30000) и групповых контактов (30000 на группу) составляет 200000.

Обновления

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

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

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

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

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

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

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

    • Для групповых контактов - обновления отображаются в приложении 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 Enterprises :

  • 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

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

600022

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

600023

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

600024

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

600025

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

600026

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

600027

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

600028

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

600029

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

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

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

Дата

Редакция

14 февраля 2023 г.

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

10 декабря 2022 г.

Обновлен термин Полная немедленная синхронизация к Запуск синхронизации каталогов

19 июля 2022 г.

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

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

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

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

9 мая 2022 г.

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

  • Грамматические правки и исправления

07 апреля 2022 г.

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

28 марта 2022 г.

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

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

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

24 марта 2022 г.

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

16 марта 2022 г.

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

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

17 декабря 2021 г.

  • Незначительные структурные изменения для исправления проблемы с отсутствующим оглавлением.

16 декабря 2021 г.

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

8 декабря 2021 г.

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

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