- Головна
- /
- Стаття
Синхронізація каталогів у Webex для Cisco BroadWorks
У цій статті описано, як розгорнути синхронізацію каталогів у Webex для Cisco BroadWorks. Стаття призначена для адміністраторів постачальників послуг партнерських організацій.
Огляд синхронізації каталогів
Синхронізація каталогів гарантує, що користувачі Webex для Cisco BroadWorks можуть використовувати каталог Webex із програми Webex для виклику будь-якого суб'єкта виклику з сервера BroadWorks. Ця функція синхронізує інформацію, яка викликає BroadWorks, яка не була частиною підготовки користувачів до каталогу Webex.
Підготовка користувачів Webex для Cisco BroadWorks оновлює каталог Webex з деталями дзвінків webex для користувачів Cisco BroadWorks (основний номер телефону, номер мобільного телефону, розширення), але пропускає записи зовнішніх дзвінків. Однак, коли синхронізацію служби каталогів увімкнуто, ця функція також синхронізує наведені нижче записи викликів із каталогом Webex.
-
BroadWorks – лише виклик користувачів (які не підключені до Webex)
-
Організації, які не телефонують без користувачів (наприклад, телефон конференц-залу, факсимільний апарат, номер мисливської групи)
-
Записи списку телефонів BroadWorks
У наведеній нижче таблиці наведено записи викликів BroadWorks і показано, як їх додають до каталогу Webex.
Записи дзвінків BroadWorks |
Опис |
Додано до каталогу Webex через... |
---|---|---|
Webex для користувачів Cisco BroadWorks |
Користувачі ввімкнуті для Webex для Cisco BroadWorks |
Підготовка користувачів (наприклад, потокове забезпечення) |
Виклик користувачів лише на BroadWorks |
Виклик користувачів, які не підключені до Webex |
Синхронізація каталогів |
Організації, які не телефонують без користувачів |
Наприклад, телефон конференц-залу, факсимільний апарат, номер групи Hunt |
Синхронізація каталогів |
Списки телефонів BroadWorks |
Записи списку телефонів BroadWorks:
|
Синхронізація каталогів (синхронізація списку телефонів) |
Умови синхронізації каталогів
-
Адміністратори партнерів повинні ввімкнути цю функцію на рівні партнера. Адміністратори партнерів можуть вмикати або вимикати цю функцію для кількох організацій клієнтів в одній операції.
-
За замовчуванням початкова синхронізація відбувається через тиждень після ввімкнення синхронізації (час, вибраний для початку синхронізації, є випадковим). Однак організації клієнтів можуть використовувати параметр Синхронізувати зараз , щоб обходити однотижневий період очікування та ініціювати негайну синхронізацію для певної організації клієнта.
-
За замовчуванням синхронізація каталогів виконується щотижня для кожного клієнта. Кожна синхронізація відбувається через тиждень після останньої синхронізації, незалежно від того, чи була запланована остання синхронізація або запущена вручну з функцією Sync Now.
-
Максимальна кількість одночасних синхронізацій на кластер BroadWorks – дві: одна запланована синхронізація та одна синхронізація на вимогу (через API або графічний інтерфейс партнерського центру). Однак адміністратори не можуть запускати дві синхронізації на вимогу одночасно з одного BroadWorks. Це обмеження існує незалежно від того, чи було ініційовано синхронізацію через API або за допомогою опції Sync Now у Партнерському центрі. Крім того, Webex не планує дві заплановані синхронізації для одночасного виконання з одного BroadWorks.
-
Якщо сталася помилка синхронізації, Webex автоматично повторно використовуватиме синхронізацію кожні 24 години до наступної запланованої синхронізації.
-
Синхронізація ігнорує користувачів, які не мають номера телефону.
-
У Partner Hub можна переглянути відомості про стан синхронізації для певного клієнта. Крім того, можна експортувати докладні відомості про останню синхронізацію в запис CSV. Запис CSV надає докладніші відомості, ніж дисплей Центру керування, і може допомогти в усуненні несправностей, аналітиці та аудиті.
-
Webex зберігає контакти користувачів в зашифрованому форматі. Тільки користувач, якому належить контакт, має доступ до ключа дешифрування.
-
Для користувачів, які телефонують лише на BroadWorks, і організацій, які не телефонують, ця функція синхронізує такі типи телефонних номерів із BroadWorks:
-
Основний номер телефону
-
Номер мобільного телефону
-
Внутрішній номер
Однак синхронізація виключає із синхронізації лише виклики користувачів, які не є користувачами, які не є користувачами, якщо немає основного номера телефону або розширення.
Налаштування служби конфіденційності BroadWorks на рівні користувача не підтримується як частина синхронізації каталогу.
-
Список телефонів BroadWorks і максимум контактів
Синхронізація каталогів також синхронізує записи списку телефонів BroadWorks з webex-контактами. Синхронізовані записи додаються до одного з таких типів контактів:
-
Контакти організації – Вебекс зберігає ці контакти в організації. Кожен користувач може отримати доступ до контактів організації для своєї організації. Максимальна кількість контактів складає до 30000.
-
Контакти користувача — Webex зберігає ці контакти проти користувача. Лише користувач, якому належить контакт, може отримати доступ до запису контакту. Максимум - до 2000 контактів (1500 синхронізованих контактів + 500 контактів ручного введення).
У наведеній нижче таблиці відображено типи контактів Webex із джерелом контактів (синхронізовано зі списку телефонів BroadWorks або додано вручну):
Тип контакту Webex |
Контактне джерело |
Максимум |
Синхронізовано з BroadWorks... |
API, який використовується для синхронізації |
---|---|---|---|---|
Контакти організації |
Синхронізація каталогів |
30000 контактів |
Загальні корпоративні списки телефонів |
|
Загальні списки телефонів групи (для групи постачальників послуг)** |
| |||
Контакти користувачів |
Синхронізація каталогів |
1500 контактів |
Особисті списки телефонів | /каталоги/особисті |
Додано користувачем вручну |
500 контактів |
Н/Д |
Н/Д | |
Контакти групи |
Синхронізація каталогів |
30000 контактів у групі |
Загальні списки телефонів групи (для корпоративної групи)** | /каталоги/ groupcommon |
**Записи загальних телефонних списків групи синхронізуються по-різному залежно від того, чи знаходиться BroadWorks у корпоративному режимі чи в режимі постачальника послуг. Значення параметра isBroadWorksEnterprise
(true або false) визначає, як синхронізується список:
-
Істина — синхронізувати як контакт групи
-
Хибно: синхронізація як контакту організації
Наведені нижче умови застосовуються до того, як синхронізація служби каталогів обробляє максимум контактів:
-
Якщо організація перевищує максимальну дозволену кількість контактів для синхронізації (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-годинного таймера кешу.
-
Передумови синхронізації каталогів
Рекомендуємо скористатися наступними настройками:
-
Граничні значення швидкості — встановіть наступні властивості системи управління перевантаженням (XSP_CLI/Програми/Xsi-дії/ПеревантаженняКонтроль):
-
userDirectoryTransactionLimit—Установити Null-значення.
-
globalDirectoryTransactionLimit —Установити нульове значення.
Рекомендується встановити користувачевідиректоріюTransactionLimit і globalDirectoryTransactionLimit на нульове значення. Однак, якщо ви все-таки вирішили присвоїти значення, кожне з яких повинно бути встановлено як мінімум в п'ять разів більше значення транзакціїLimitPeriodSeconds (яке повинно бути 1). -
-
Ліміти транзакцій — встановіть такі значення (XSP_CLI/Система/Комунікаційне використання/Налаштування за замовчуванням):
-
userTransactionLimit — Встановлено значення принаймні 100.
-
транзакціяLimitPeriodSecs—Set to 1.
-
-
Значення підкачки — встановіть властивості системи підкачки (XSP_CLI/Програми/Xsi-дії/Пейджинг):
-
за замовчуваннямPageSize — Встановити значення 50
-
доступнийUserMaxLimit — Встановлено на 100
-
-
Інтерфейс CTI — обов'язково завантажте сертифікати Webex CA в сховище довіри інтерфейсу CTI та ввімкніть автентифікацію клієнта в інтерфейсі CTI.
Крім того, залежно від вашого випуску BroadWorks, ми рекомендуємо застосовувати такі системні виправлення до розгортання BroadWorks, перш ніж активувати цю функцію:
-
Для R22:
AP.as.22.0.1123.ap368517
-
Для R23:
AP.as.23.0.1075.ap368517
-
Для R24: патч не потрібен
Увімкнути синхронізацію каталогів (новий шаблон)
Адміністратори партнерів можуть увімкнути синхронізацію служби каталогів для шаблону клієнта під час створення нового шаблону. У будь-яких нових організаціях-клієнтах, яким буде призначено цей шаблон, буде ввімкнуто синхронізацію каталогів. Докладнішу інформацію можна знайти в розділі «Настроювання шаблонів клієнтів» у розділі Настроювання партнерської організації в Партнерському центрі в Посібнику з рішень для Webex для Cisco BroadWorks.
Що робити Далі
Переконайтеся, що ваші користувачі знають, що вони повинні принаймні один раз натиснути вкладку Контакти в додатку Webex, щоб увімкнути цю функцію в додатку Webex. Це потрібно завершити лише один раз.
Увімкнути синхронізацію каталогів (наявний шаблон)
1 |
Увійдіть у Партнерський центр і виберіть елемент Настройки. |
2 |
Прокрутіть до пункту Виклики BroadWorks і виберіть пункт Переглянути шаблони. |
3 |
Виберіть відповідний шаблон клієнта та прокрутіть до розділу Синхронізаціякаталогів BroadWorks. |
4 |
Щоб увімкнути синхронізацію каталогів за замовчуванням для нових організацій клієнтів, які використовують цей шаблон, виконайте такі дії: |
5 |
Щоб увімкнути синхронізацію каталогів для наявних організацій клієнтів, які використовують цей шаблон, виконайте такі дії: Якщо потрібно вимкнути синхронізацію каталогів, виконайте наведені вище дії та виконайте наведені нижче дії.
|
Що далі
Переконайтеся, що ваші користувачі знають, що вони повинні принаймні один раз натиснути вкладку Контакти в додатку Webex, щоб увімкнути цю функцію в додатку Webex. Це потрібно завершити лише один раз.
Запустити негайну синхронізацію
1 |
Увійдіть до концентратора партнера ( http://admin.webex.com) і виберіть Налаштування. |
2 |
Прокрутіть до пункту Виклики BroadWorks і виберіть пункт Переглянути шаблони. |
3 |
Виберіть відповідний шаблон клієнта та прокрутіть до розділу Синхронізаціякаталогів BroadWorks. |
4 |
Виберіть пункт Показати стансинхронізації списку клієнтів. |
5 |
Для організації клієнта, яку потрібно синхронізувати, клацніть три крапки праворуч і виберіть команду Синхронізувати зараз. |
6 |
Натисніть кнопку Оновити , щоб переглянути результати синхронізації. |
Експорт записів синхронізації в CSV
1 |
Увійдіть до концентратора партнера ( http://admin.webex.com) і виберіть Налаштування. |
2 |
Прокрутіть до пункту Виклики BroadWorks і виберіть пункт Переглянути шаблони. |
3 |
Виберіть відповідний шаблон клієнта та прокрутіть до розділу Синхронізаціякаталогів BroadWorks. |
4 |
Виберіть пункт Показати стансинхронізації списку клієнтів. |
5 |
Установіть суміжні прапорці для кожної організації, яку потрібно включити до експортування. |
6 |
Натисніть кнопку Експорт результатів. |
Загальнодоступні API для синхронізації каталогів
Загальнодоступні ІНТЕРФЕЙСИ API доступні на developer.webex.com , які дають змогу адміністраторам партнерів оновлювати настройки синхронізації каталогів для організацій клієнтів, якими вони керують, ініціювати негайну синхронізацію або отримувати відомості про стан синхронізації. Методи синхронізації каталогів згруповані в розділі BroadWorks Enterprises:
-
Список підприємств BroadWorks. Використовуйте цей метод API, щоб отримати список підприємств під певним постачальником послуг і
ідентифікатором кожного підприємства
. Необхідно ввестиspEnterpriseId
як призначено під час підготовки. -
Оновити синхронізацію каталогів для підприємства BroadWorks — введіть
ідентифікатор
підприємства, щоб оновити стан syc каталогів для цього підприємства та ввімкнути або вимкнути синхронізацію каталогів. -
Запустити синхронізацію каталогу для підприємства — Використовуйте цей метод API, якщо потрібно запустити негайну синхронізацію для певного
ідентифікатора підприємства
. Для стануsyncStatus
введіть командуSYNC_NOW
. -
Отримати стан синхронізації каталогу для підприємства—введіть
ідентифікатор
підприємства та запустіть його, щоб отримати стан іідентифікатор відстеження
останньої синхронізації. Можна використовуватиідентифікатор відстеження
, щоб запустити додаткову аналітику за допомогою таких інструментів, як Kibana або Grafana.
Крім того, адміністратори можуть використовувати синхронізацію каталогу trigger для 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
-
Синхронізація каталогів дає змогу одночасно синхронізувати лише одне підприємство з кластера Broadworks за допомогою синхронізації на вимогу. Якщо спробувати синхронізувати кілька підприємств, з'явиться повідомлення про помилку 429
-
Час, необхідний для запуску синхронізації для одного підприємства, варіюється залежно від розміру підприємства.
1 |
Запустіть API списку BroadWorks Enterprises , щоб створити список підприємств, які потрібно синхронізувати. |
2 |
Запустіть синхронізацію каталогу тригерів для корпоративного API на першому підприємстві у списку. |
3 |
Зачекайте кілька секунд, а потім запустіть API стану синхронізації каталогів , щоб отримати статус синхронізації. |
4 |
Після завершення синхронізації виконайте кроки 2–4 для наступного підприємства у списку. Повторюйте ці кроки, доки не синхронізуєте весь список. |
Коди помилок для синхронізації каталогів
Наведені нижче коди помилок застосовуються до синхронізації служби каталогів.
Код помилки |
Повідомлення про помилку |
---|---|
600000 |
Непередбачена помилка синхронізації користувачів зовнішнього каталогу Broadworks. |
600001 |
Не вдалося синхронізувати користувача із зовнішнім каталогом Broadworks. |
600002 |
Синхронізацію користувачів зовнішнього каталогу Broadworks довелося припинити до завершення. |
600003 |
Синхронізація користувачів із зовнішнім каталогом Broadworks вдалася лише частково. Деякі організації клієнтів не вдалося синхронізувати. |
600004 |
Синхронізацію користувачів зовнішнього каталогу Broadworks не ввімкнено для ConfigSet. |
600005 |
Виконується синхронізація користувачів зовнішнього каталогу Broadworks для ConfigSet. |
600006 |
Потоки синхронізації користувачів зовнішнього каталогу Broadworks зайняті або закриваються, тому не прийматимуть додаткові запити на синхронізацію. Спробуйте ще раз пізніше. |
600007 |
Ідентифікаційну організацію CustomerConfig не знайдено. |
600008 |
Конфігурацію клієнта не знайдено в партнерській організації. |
600009 |
Синхронізацію користувача зовнішнього каталогу 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 не вдалося синхронізувати контакти підприємств і організацій. |
600020 |
Синхронізацію користувача зовнішнього каталогу BroadWorks не можна вимкнути, оскільки виконується синхронізація 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 |
Роз'яснення та виправлення оглядової інформації:
|
Травень 09, 2022 |
|
Квітень 07, 2022 |
|
Березня 28, 2022 |
|
Березня 24, 2022 |
Додано список синхронізованих типів телефонних номерів до умов синхронізації служби каталогів. Синхронізація тепер включає номери мобільних телефонів. |
Березня 16, 2022 |
|
17 Грудня, 2021 |
|
16 Грудня, 2021 |
|
08 Грудня, 2021 |
|