Огляд синхронізації каталогів

Синхронізація каталогів гарантує, що користувачі Webex для Cisco BroadWorks можуть використовувати каталог Webex з додатка Webex для виклику будь-якого виклику об 'єкта з сервера BroadWorks. Ця функція синхронізує інформацію виклику BroadWorks, яка не була частиною підготовки користувача до каталогу Webex.

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

  • Користувачі, які дзвонять лише через BroadWorks (які не підключені до Webex)

  • Суб 'єкти, які не є користувачами дзвінків (наприклад, телефон конференц-залу, факс, номер групи полювання)

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

Наступна таблиця узагальнює записи викликів BroadWorks і показує, як вони додаються до каталогу Webex.

Таблиця 1. Синхронізація каталогу з оновленнями каталогу Webex

BroadWorks Calling Records

Опис

Додано до каталогу Webex через...

Webex для користувачів Cisco BroadWorks

Користувачів увімкнено для Webex для Cisco BroadWorks

Підготовка користувачів (наприклад, підготовка через потік)

Користувачі, які здійснюють дзвінки лише через BroadWorks

Виклик користувачів, які не підключені до Webex

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

Суб 'єкти, які не викликають користувачів

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

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

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

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

  • Загальні списки телефонів підприємства

  • Групові загальні телефонні списки (групи постачальників послуг або групи підприємств)

  • Особисті списки телефонів

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


Докладніші відомості про підготовку користувачів див. у посібнику Webex for Cisco BroadWorks Solution Guide.

Умови синхронізації каталогів

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

  • За замовчуванням початкова синхронізація відбувається через тиждень після ввімкнення синхронізації (час, вибраний для запуску синхронізації, є випадковим). Тим не менш, організації-клієнти можуть використовувати опцію Sync Now, щоб обійти тижневий період очікування і викликати негайну синхронізацію для даної організації-клієнта.

  • За замовчуванням, синхронізація каталогів працює щотижня для кожного клієнта. Кожна синхронізація відбувається через тиждень після останньої синхронізації, незалежно від того, чи була остання синхронізація запланована або запущена вручну за допомогою програми Sync Now.

  • Максимальна кількість одночасних синхронізацій на кластер BroadWorks становить два: одна запланована синхронізація та одна синхронізація на вимогу (через API або графічний інтерфейс Partner Hub). Однак адміністратори не можуть запускати дві синхронізації на вимогу одночасно з одного BroadWorks. Це обмеження існує незалежно від того, чи була синхронізація ініційована через API, чи через опцію Sync Now у Partner Hub. Крім того, Webex не буде планувати дві заплановані синхронізації для запуску одночасно з того ж BroadWorks.

  • Якщо відбувається збій синхронізації, Webex повторює спробу синхронізації автоматично кожні 24 години до наступної запланованої синхронізації.

  • Синхронізація ігнорує користувачів, у яких немає номера телефону.

  • У Партнерському центрі можна переглянути інформацію про стан синхронізації для певного клієнта. Крім того, ви можете експортувати детальну інформацію про останню синхронізацію до запису CSV. Запис CSV надає більше деталей, ніж дисплей Control Hub, і може допомогти у усуненні несправностей, аналітиці та аудиті.

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

  • Для користувачів, які здійснюють виклики лише через BroadWorks, та не користувачів, які здійснюють виклики, ця функція синхронізує наступні типи номерів телефонів з 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 параметр (true або false) визначає, як синхронізується список:

  • Синхронізувати як груповий контакт

  • Помилково синхронізувати як контакт організації

Наступні умови стосуються того, як Directory Sync обробляє максимум контактів:

  • Якщо організація перевищує максимально дозволені контакти для синхронізації (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 for Cisco BroadWorks обробляються як частина процесів забезпечення.

Центр керування містить можливість додавання або редагування контактів на рівні організації в Центрі керування за допомогою файлу CSV. Адміністратори-партнери та адміністратори клієнтів з доступом до Центру керування можуть отримати доступ до цієї опції. Однак оновлення контактів через Control Hub не підтримується Webex для Cisco BroadWorks. Оновлення контактів, застосовані в Control Hub, не синхронізуються з BroadWorks і недоступні для пошуку в каталогах з настільних телефонів.

Передумови синхронізації каталогів

Рекомендуємо використовувати наступні налаштування:


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

    • userDirectoryTransactionLimit—Set до значення NULL.

    • globalDirectoryTransactionLimit—Set до значення NULL.


    Рекомендується встановити значення userDirectoryTransactionLimit і globalDirectoryTransactionLimit на NULL. Однак, якщо ви вирішите призначити значення, кожне з них повинно бути встановлено принаймні в п 'ять разів більше значення transactionLimitPeriodSeconds (яке повинно бути 1).
  • Ліміти транзакцій - Встановіть наступні значення (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit—Set принаймні 100.

    • transactionLimitPeriodSecs—Set до 1.

  • Значення підкачки - Встановіть властивості системи підкачки (XSP_CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize—Set до 50

    • availableUserMaxLimit—Set до 100

  • Інтерфейс CTI - обов 'язково завантажте сертифікати Webex CA до довірчого сховища інтерфейсу CTI та увімкніть автентифікацію клієнта в інтерфейсі CTI.

Крім того, залежно від вашого випуску BroadWorks, ми рекомендуємо вам застосувати наступні системні патчі до розгортання BroadWorks, перш ніж увімкнути цю функцію:

Увімкнути синхронізацію каталогів (новий шаблон)

Адміністратори-партнери можуть увімкнути синхронізацію каталогів для шаблону клієнта під час створення нового шаблону. Будь-які нові організації-клієнти, яким призначено цей шаблон, матимуть увімкнену синхронізацію каталогів. Докладніші відомості див. у розділі "Налаштування шаблонів клієнтів" в розділі "Налаштування організації-партнера в концентраторі партнерів" посібника з рішення для Webex для Cisco BroadWorks.

Що робити далі

Переконайтеся, що ваші користувачі знають, що вони повинні щонайменше один раз натиснути вкладку Контакти в додатку Webex, щоб увімкнути цю функцію в додатку Webex. Це потрібно зробити лише один раз.

Увімкнути синхронізацію каталогів (існуючий шаблон)

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

1.

Увійдіть до Центру партнерів і виберіть Налаштування.

2.

Перейдіть до пункту BroadWorks Calling (Виклик BroadWorks) і натисніть кнопку View Templates (Переглянути шаблони).

3.

Виберіть відповідний шаблон клієнта та перейдіть до BroadWorks Directory Sync.

4.

Щоб увімкнути синхронізацію каталогів за замовчуванням для нових організацій клієнтів, які використовують цей шаблон:

  1. Встановіть параметр Enable BroadWorks Directory & Phone List Sync (Увімкнути синхронізацію каталогів і списків телефонів BroadWorks) для всіх нових організацій-клієнтів у положенні On ( Увімкнути

  2. Клацніть Зберегти.

5.

Щоб увімкнути синхронізацію каталогів для існуючих організацій клієнтів, які використовують цей шаблон, виконайте наведені нижче дії.

  1. Натисніть Показати стан синхронізації списку клієнтів.

  2. Позначте прапорці поруч для кожної організації, для якої ви хочете увімкнути цю функцію.

  3. Натисніть Увімкнути синхронізацію.


 

Якщо ви хочете вимкнути синхронізацію каталогів, виконайте наведену вище процедуру та:

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

  • На кроці 5c натисніть Вимкнути синхронізацію, щоб вимкнути цю функцію для існуючих організацій.

Що далі

Переконайтеся, що ваші користувачі знають, що вони повинні щонайменше один раз натиснути вкладку Контакти в додатку Webex, щоб увімкнути цю функцію в додатку Webex. Це потрібно зробити лише один раз.

Запустити негайну синхронізацію

Параметр Sync Now (Синхронізувати зараз) дозволяє адміністратору-партнеру запускати синхронізацію на вимогу для певної організації-замовника. Цей параметр можна вибрати лише для окремих організацій-замовників - для синхронізації зараз не існує опції масової синхронізації.

1.

Увійдіть у Партнерський центр (http://admin.webex.com) і виберіть Налаштування.

2.

Перейдіть до пункту BroadWorks Calling (Виклик BroadWorks) і натисніть кнопку View Templates (Переглянути шаблони).

3.

Виберіть відповідний шаблон клієнта та перейдіть до BroadWorks Directory Sync.

4.

Натисніть Показати стан синхронізації списку клієнтів.

5.

Для організації-замовника, яку потрібно синхронізувати, клацніть три крапки в крайньому правому куті та виберіть Sync Now (Синхронізувати зараз).

6.

Натисніть Оновити, щоб переглянути результати синхронізації.

Експортувати синхронізовані записи до CSV

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

1.

Увійдіть у Партнерський центр (http://admin.webex.com) і виберіть Налаштування.

2.

Перейдіть до пункту BroadWorks Calling (Виклик BroadWorks) і натисніть кнопку View Templates (Переглянути шаблони).

3.

Виберіть відповідний шаблон клієнта та перейдіть до BroadWorks Directory Sync.

4.

Натисніть Показати стан синхронізації списку клієнтів.

5.

Позначте прапорці поруч для кожної організації, яку ви хочете включити до експорту.

6.

Натисніть Експортувати результати.

Загальнодоступні API для синхронізації каталогів

Загальнодоступні API доступні на developer.webex.com, які дозволяють адміністраторам-партнерам оновлювати налаштування синхронізації каталогів для організацій-замовників, якими вони керують, запускати негайну синхронізацію або отримувати інформацію про стан синхронізації. Методи синхронізації каталогів згруповані в BroadWorks Enterprises:

  • Список підприємств BroadWorks- Використовуйте цей метод API, щоб отримати список підприємств під даним постачальником послуг і кожного підприємства id. Необхідно ввести spEnterpriseId як призначено в забезпеченні.

  • Оновлення синхронізації каталогу для BroadWorks Enterprise- Введіть підприємство id для оновлення статусу каталогу SYC для цього підприємства, увімкнення або вимкнення синхронізації каталогів.

  • Тригер синхронізації каталогів для підприємства- Використовуйте цей метод API, якщо ви хочете запустити негайну синхронізацію для даного підприємства id. Для syncStatus, введіть SYNC_NOW командування.

  • Отримати статус синхронізації каталогів для підприємства- Введіть підприємство id і бігти, щоб отримати статус і trackingId останньої синхронізації. Ви можете використовувати trackingID для запуску додаткової аналітики за допомогою таких інструментів, як Kibana та Grafana.

Крім того, адміністратори можуть використовувати Trigger Directory Sync для 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, щоб створити список підприємств, які потрібно синхронізувати.

  1. Встановіть startWith на початковий рядок ідентифікатора підприємства або постачальника послуг.

  2. Натисніть Виконати.

2.

Запустіть синхронізацію каталогів тригерів для корпоративного API на першому підприємстві зі списку.

  1. Введіть ідентифікатор підприємства.

  2. Встановити syncStatus на SYNC_NOW

  3. Натисніть Виконати.

    Миттєва синхронізація спрацьовує для підприємства. Ця синхронізація враховує єдину синхронізацію на вимогу на ліміт Broadworks.
3.

Зачекайте кілька секунд, а потім запустіть Get Directory Sync Status API, щоб отримати статус синхронізації.

  1. Введіть ідентифікатор підприємства

  2. Натисніть Виконати.

4.

Після завершення синхронізації виконайте кроки з 2 по 4 на наступному підприємстві у списку. Повторюйте ці дії, поки не синхронізуєте весь список.

Коди помилок для синхронізації каталогів

Наступні коди помилок застосовуються до синхронізації каталогів.

Код помилки

Повідомлення про помилку

600000

Непередбачена помилка синхронізації користувачів зовнішнього каталогу Broadworks.

600001

Не вдалося синхронізувати користувача із зовнішнім каталогом Broadworks.

600002

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

600003

Синхронізація користувачів із зовнішнім каталогом Broadworks вдалася лише частково. Деякі організації клієнтів не вдалося синхронізувати.

600004

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

600005

Виконується синхронізація користувачів зовнішнього каталогу Broadworks для ConfigSet.

600006

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

600007

Ідентифікаційну організацію CustomerConfig не знайдено.

600008

Конфігурацію клієнта не знайдено в партнерській організації.

600009

Синхронізацію користувачів зовнішнього каталогу Broadworks неможливо запустити, оскільки кластер Broadworks, пов 'язаний з CustomerConfig, зайнятий

600010

Синхронізацію користувачів зовнішнього каталогу Broadworks не можна запустити, оскільки кластер Broadworks не пов’язаний із конфігурацією клієнта.

600011

Синхронізація користувачів зовнішнього каталогу Broadworks не ввімкнена для конфігурації клієнта.

600012

Синхронізацію користувачів із зовнішнім каталогом Broadworks не можна запустити, оскільки синхронізація каталогу гібридного типу вже ввімкнена для конфігурації клієнта.

600013

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

600014

Помилка синхронізації користувачів зовнішнього каталогу Broadworks під час спроби підключення до кластера Broadworks. Помилка з Broadworks - %s.

600015

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

600017

BroadWorks Phone List Sync не вдалося синхронізувати всі контакти користувача та підприємства/організації.

600018

Помилка синхронізації списку телефонів BroadWorks для користувачів підприємства/організації.

600019

BroadWorks Phone List Sync не вдалося синхронізувати контакти підприємства/організації.

600020

Синхронізацію користувачів зовнішнього каталогу BroadWorks неможливо вимкнути, оскільки виконується синхронізація CustomerConfig.

600022

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

600023

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

600024

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

600025

BroadWorks External Directory User Sync не вдалося оновити обліковий запис користувача в CI.

600026

BroadWorks External Directory User Sync не вдалося оновити обліковий запис комп 'ютера в CI.

600027

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

600028

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

600029

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

Історія змін

У наступній таблиці узагальнено оновлення цієї статті.

Дата

Редакція

14 лютого 2023 р.

Оновлено розділ "Максимальна синхронізація каталогів" та "Джерело".

10 грудня 2022 р.

Оновлено термін Complete Immediate Sync to Trigger Directory Sync

19 липня 2022 р.

Роз 'яснення та виправлення до оглядової інформації:

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

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

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

09.05.2022

  • У Directory Sync Overview (Огляд синхронізації каталогів) виправлено Note (Примітка) у таблиці Directory Sync Maximums and Source (Максимальні значення синхронізації каталогів та джерело) Також оновлено примітку щодо забезпечення потоку.

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

07 квітня 2022 р.

  • Додано примітку до розділу Оновлення в Огляді синхронізації каталогів щодо обмеження застосування редагувань контактів на рівні організації в Центрі керування.

28 березня 2022 р.

  • Повторно вставлено відсутній вміст у розділі Увімкнути синхронізацію каталогів (новий шаблон).

  • Додано інформацію про максимуми синхронізації. Ви можете запустити одну заплановану синхронізацію і одну синхронізацію API одночасно з одного кластера.

  • Додано інформацію про Trigger Directory Sync для одного користувача API.

24 березня 2022 р.

Додано список типів синхронізованих номерів телефонів до умов синхронізації каталогів. Синхронізація тепер включає номери мобільних телефонів.

16 березня 2022 р.

  • Додано нові коди помилок.

  • Додано вступний опис для кращого зручності користування з веб-пошуку.

17 грудня 2021 р.

  • Незначні структурні зміни для виправлення проблеми з відсутнім змістом.

16 грудня 2021 р.

  • Оновлена стаття з підвищеними максимальними значеннями для контактів користувача.

08 грудня 2021 р.

  • Додано розділ «Синхронізація каталогу та максимальні контакти», щоб пояснити, як синхронізація каталогу отримує максимальну кількість контактів організації та користувача.

  • Переглянуте форматування таблиці в кодах помилок для синхронізації каталогів для кращої читабельності.