- Головна
- /
- Стаття
Синхронізація каталогів у 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 | Синхронізація каталогів |
Об’єкти виклику, які не є користувачами | Наприклад, телефон кімнати для конференцій, факс, номер групи пошуку | Синхронізація каталогів |
Списки телефонів BroadWorks | Записи списку телефонів BroadWorks:
| Синхронізація каталогу (синхронізація списку телефонів) |
Умови синхронізації каталогу
Адміністратори партнерів повинні ввімкнути цю функцію на рівні партнера. Адміністратори партнерів можуть увімкнути або вимкнути цю функцію для кількох організацій клієнтів за одну операцію.
За замовчуванням початкова синхронізація відбувається через тиждень після ввімкнення синхронізації (для початку синхронізації вибрано випадковий час). Однак організації клієнтів можуть використовувати Синхронізувати зараз можливість обійти тижневий період очікування та запустити негайну синхронізацію для певної організації клієнта.
За замовчуванням синхронізація каталогів виконується щотижня для кожного клієнта. Кожна синхронізація відбувається через тиждень після останньої синхронізації, незалежно від того, заплановано останню синхронізацію чи було запущено вручну за допомогою Синхронізувати зараз .
Максимальна кількість одночасних синхронізацій на кластер BroadWorks становить дві: одна запланована синхронізація та одна синхронізація на вимогу (через API або графічний інтерфейс центру партнера). Однак адміністратори не можуть одночасно запускати дві синхронізації на вимогу з одного BroadWorks. Це обмеження існує незалежно від того, чи було синхронізацію ініційовано через API чи через Синхронізувати зараз у партнерському центрі. Крім того, Webex не планує одночасно запустити дві заплановані синхронізації з одного BroadWorks.
Якщо сталася помилка синхронізації, Webex повторить спробу синхронізації автоматично кожні 24 години до наступної запланованої синхронізації.
Синхронізація ігнорує користувачів, які не мають номера телефону.
У Partner Hub можна переглянути інформацію про стан синхронізації для певного клієнта. Крім того, можна експортувати докладну інформацію про останню синхронізацію до запису CSV. Запис CSV надає більше деталей, ніж відображення Control Hub, і може допомогти у вирішенні проблем, аналітиці та аудиті.
Webex зберігає контакти користувачів у зашифрованому форматі. Доступ до ключа дешифрування має лише користувач, якому належить контакт.
Для користувачів, які здійснюють виклики лише BroadWorks, і об’єктів виклику, які не є користувачами, ця функція синхронізує такі типи телефонних номерів із BroadWorks:
Основний номер телефону
Номер мобільного телефону
Внутрішній номер
Однак синхронізація виключає користувачів, які здійснюють виклики лише BroadWorks, і об’єкти, які не є користувачами, що здійснюють виклики, із синхронізації, якщо відсутній основний номер телефону або внутрішній номер.
Налаштування служби конфіденційності на рівні користувача BroadWorks не підтримується як частина синхронізації каталогу.
Список телефонів BroadWorks і максимальні значення контактів
Синхронізація каталогу також синхронізує записи списку телефонів BroadWorks із контактами Webex. Синхронізовані записи додаються до одного з таких типів контактів:
Контакти організації. Webex зберігає ці контакти для організації. Кожен користувач може отримати доступ до контактів організації для своєї організації. Максимальна кількість — до 30 000 контактів.
Контакти користувача — Webex зберігає ці контакти для користувача. Лише користувач, якому належить контакт, може отримати доступ до запису контакту. Максимальна кількість — до 2000 контактів (1500 синхронізованих контактів + 500 контактів, що вводяться вручну).
У таблиці нижче зіставлено типи контактів Webex із джерелом контакту (синхронізовано зі списку телефонів BroadWorks або додано вручну):
Тип контакту Webex | Зв’язатися з джерелом | Максимум | Синхронізовано з BroadWorks... | API, що використовується для синхронізації |
---|---|---|---|---|
Контакти організації | Синхронізація каталогів | 30 000 контактів | Корпоративні загальні списки телефонів |
|
Групові спільні списки телефонів (для групи постачальників послуг)** |
| |||
Контакти користувача | Синхронізація каталогів | 1500 контактів | Особисті списки телефонів | /directories/personal |
Додано користувачем вручну | 500 контактів | Н/Д | Н/Д | |
Контакти групи | Синхронізація каталогів | 30 000 контактів на групу | Групові спільні списки телефонів (для корпоративної групи)** | /directories/groupcommon |
**Записи спільних телефонних списків груп синхронізуються по-різному залежно від того, перебуває BroadWorks у режимі підприємства чи в режимі постачальника послуг. Значення isBroadWorksEnterprise
Параметр (true або false) визначає спосіб синхронізації списку:
True — синхронізувати як контакт групи
Неправда — синхронізувати як контакт організації
Наведені нижче умови застосовуються щодо того, як синхронізація каталогів обробляє максимуми контактів:
Якщо організація перевищує максимальну кількість контактів, дозволених для синхронізації (30 000 контактів організації або 30 000 спільних контактів групи на групу), синхронізація каталогу виключає записи, що перевищують максимальне порогове значення. Немає конкретного порядку, застосованого до синхронізованих або пропущених контактів.
Якщо один із ваших клієнтів перевищує максимально дозволену кількість контактів у будь-якій категорії, ми рекомендуємо звернутися до Cisco, щоб виключити цю організацію з синхронізації каталогу.
Контакти вручну – це контакти, які користувач додає вручну в програмі Webex. Користувач може додати до 500 контактів вручну. Контакти, призначені вручну, належать до більшої категорії контактів користувача у Webex, але не входять до синхронізації.
Загальне загальне обмеження для контактів організації (30000) і контактів групи (30000 на групу) становить 200000.
Оновлення
Нижче описано, як каталог Webex обробляє оновлення.
Якщо ім’я контакту змінюється в BroadWorks, наявний контакт буде видалено з каталогу Webex і буде створено новий контакт.
Якщо номер контакту змінюється в BroadWorks, Webex оновить наявний контакт у каталозі Webex новим номером.
Після того як адміністратор оновить контакт у BroadWorks, під час відображення оновлення в програмі Webex користувача встановлюються такі умови:
Якщо оновлення призначено лише для користувача, який здійснює виклики BroadWorks, або для об’єкта, який не є користувачем, який здійснює виклик, оновлення відображається в програмі Webex користувача одразу після наступної синхронізації каталогу.
Якщо оновлення стосується запису списку телефонів BroadWorks:
Для контактів користувача: оновлення відображаються в програмі Webex користувача одразу після наступної синхронізації каталогу.
Для контактів групи: оновлення відображаються в програмі Webex користувачів одразу після наступної синхронізації каталогу.
Для контактів організації. Каталог Webex оновлюється під час наступної синхронізації каталогу, але користувачі не побачать зміни в програмі Webex, доки не перезапустять програму Webex або доки не закінчиться локальний 72-годинний кеш-таймер.
Обов’язкові умови синхронізації каталогу
Рекомендовано використовувати такі налаштування:
Значення обмеження швидкості — установіть такі властивості системи OverloadControl (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit—установіть значення null.
globalDirectoryTransactionLimit—установіть значення null.
Рекомендовано встановити значення userDirectoryTransactionLimit і globalDirectoryTransactionLimit до значення null. Однак якщо ви вирішите призначити значення, кожне з них має бути принаймні в п’ять разів більшим за значення транзакціїLimitPeriodSeconds (яке має бути 1).Обмеження транзакцій: установіть такі значення (XSP_ CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit — установіть принаймні 100.
транзакціїLimitPeriodSecs — установлено на 1.
Значення пейджингу — установіть властивості системи пейджингу (XSP_ CLI/Програми/Xsi-Дії/Пейджинг):
за замовчуваннямРозмір сторінки — установлено на 50
availableUserMaxLimit — установіть на 100
Інтерфейс CTI. Обов’язково передайте сертифікати CA Webex до сховища довіри інтерфейсу CTI та ввімкніть автентифікацію клієнта в інтерфейсі CTI.
Крім того, залежно від випуску BroadWorks, ми рекомендуємо застосувати такі системні виправлення до розгортання BroadWorks, перш ніж увімкнути цю функцію:
Для R22:
AP.as.22.0.1123.ap368517
Для R23:
AP.as.23.0.1075.ap368517
Для R24: виправлення не потрібно
Увімкнути синхронізацію каталогів (новий шаблон)
Адміністратори партнерів можуть увімкнути синхронізацію каталогів для шаблону клієнта під час створення нового шаблону. Для всіх нових організацій клієнтів, яких буде призначено до цього шаблону, буде ввімкнено синхронізацію каталогів. Докладніше див. в розділі "Налаштування шаблонів клієнтів". Налаштуйте свою партнерську організацію в Partner Hub в межах Посібник із рішення для Webex для Cisco BroadWorks .
Що робити далі
Переконайтеся, що ваші користувачі знають, що вони повинні натиснути Контакти натисніть у програмі Webex принаймні один раз, щоб увімкнути цю функцію в програмі Webex. Це потрібно виконати лише один раз.
Увімкнути синхронізацію каталогів (наявний шаблон)
1. | Увійдіть до Partner Hub і виберіть Налаштування . |
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 :
Список компаній BroadWorks —Використовуйте цей метод API, щоб отримати список підприємств певного постачальника послуг і кожного підприємства
id
. Необхідно ввестиspEnterpriseId
як призначено в підготовці.Оновлення синхронізації каталогів для BroadWorks Enterprise —Введіть підприємство
id
щоб оновити стан синхронізації каталогу для цього підприємства, увімкнувши або вимкнувши синхронізацію каталогів.Запустити синхронізацію каталогу для підприємства —Використовуйте цей метод API, якщо ви хочете запустити негайну синхронізацію для певного підприємства
id
. ДляsyncStatus
, введітьSYNC_NOW
команду.Отримайте стан синхронізації каталогу для підприємства —Введіть підприємство
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
Синхронізація каталогу дозволяє одночасно синхронізувати лише одне підприємство з кластера Broadworks за допомогою синхронізації на вимогу. Якщо ви спробуєте синхронізувати більше одного підприємства, ви отримаєте помилку 429
Час, необхідний для запуску синхронізації для окремого підприємства, залежить від розміру підприємства.
1. | Запустіть Список компаній BroadWorks API для створення списку підприємств, які потрібно синхронізувати. |
2. | Запустіть Запустити синхронізацію каталогу для підприємства API на першому підприємстві в списку. |
3. | Зачекайте кілька секунд, а потім запустіть Отримайте стан синхронізації каталогу API для отримання стану синхронізації. |
4. | Після завершення синхронізації виконайте кроки з 2 по 4 на наступному підприємстві в списку. Повторюйте ці кроки, доки не синхронізуєте весь список. |
Коди помилок для синхронізації каталогів
Наведені нижче коди помилок застосовуються до синхронізації каталогу.
Код помилки | Повідомлення про помилку |
---|---|
600 000 | Непередбачена помилка синхронізації користувачів зовнішнього каталогу 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 не вдалося синхронізувати всі контакти користувачів і підприємства/організації. |
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 р | Роз’яснення та виправлення до оглядової інформації:
|
9 травня 2022 р |
|
7 квітня 2022 року |
|
28 березня 2022 р. |
|
24 березня 2022 р. | Додано список синхронізованих типів телефонних номерів до Умови синхронізації каталогу . Тепер синхронізація включає номери мобільних телефонів. |
16 березня 2022 року |
|
17 грудня 2021 р |
|
16 грудня 2021 року |
|
8 грудня 2021 року |
|