- Головна
- /
- Стаття
Синхронізація каталогів у 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:
|
Синхронізація каталогів (синхронізація списку телефонів) |
Умови синхронізації каталогів
-
Адміністратори партнерів повинні ввімкнути цю функцію на рівні партнера. Адміністратори-партнери можуть вмикати або вимикати цю функцію для кількох організацій-клієнтів за одну операцію.
-
За замовчуванням початкова синхронізація відбувається через тиждень після включення синхронізації (час, обраний для початку синхронізації, є випадковим). Однак організації-клієнти можуть використовувати параме тр Синхронізувати зараз, щоб обійти тижневий період очікування та запустити негайну синхронізацію для певної організації клієнта.
-
За замовчуванням синхронізація каталогів виконується щотижня для кожного клієнта. Кожна синхронізація відбувається через тиждень після останньої синхронізації, незалежно від того, чи була остання синхронізація запланована чи запущена вручну за допомогою синхронізації зараз.
-
Максимальна кількість одночасних синхронізацій для кожного кластера BroadWorks становить дві: одна запланована синхронізація та одна синхронізація на вимогу (через API або графічний інтерфейс партнерського центру). Однак адміністратори не можуть одночасно запускати дві синхронізації на вимогу з одного і того ж BroadWorks. Це обмеження існує незалежно від того, чи була синхронізація ініційована через API чи за допомогою параметра С инхронізувати зараз у центрі партнерів. Крім того, 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 |
Джерело контакту |
Максимум |
Синхронізовано з BroadWorks... |
API, що використовується для синхронізації |
|---|---|---|---|---|
|
Контакти організації |
Синхронізація каталогів |
30000 контактів |
Загальні списки телефонів підприємств |
|
|
Спільні списки телефонів групи (для групи постачальників послуг) ** |
| |||
|
Контакти користувачів |
Синхронізація каталогів |
1500 контактів |
Особисті телефонні списки | /каталоги/особисті |
|
Додано вручну користувачем |
500 контактів |
N/A |
N/A | |
|
Групові контакти |
Синхронізація каталогів |
30000 контактів на групу |
Спільні телефонні списки груп (для групи підприємств) ** | /каталоги/групазагальні |
**Записи групових списків телефонів синхронізуються по-різному залежно від того, чи перебуває BroadWorks у корпоративному режимі чи в режимі постачальника послуг. Значення параметра isBroadworksEnterprise (true або false) визначає спосіб синхронізації списку:
-
True — синхронізація як груповий контакт
-
Неправда — синхронізація як контакт організації
Наступні умови застосовуються щодо того, як синхронізація каталогів обробляє максимум контактів:
-
Якщо організація перевищує максимум дозволених контактів для синхронізації (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/Applications/XSI-Action/Overload Control):
-
UserDirectoryTransactionLimit—встановлено нульове значення.
-
GlobalDirectoryTransactionLimit—встановлено нульове значення.
Рекомендується встановити значення UserDirectoryTransactionLimit і GlobalDirectoryTransactionLimit на нульове значення. Однак, якщо ви все-таки вирішите призначити значення, кожне з них має бути встановлено щонайменше у п'ять разів більше значення transactionLimitPeriodSeconds (яке повинно бути 1). -
-
Обмеження транзакцій. Встановіть такі значення (XSP_CLI/System/CommunicationUtility/DefaultSettings):
-
Обмеження транзакцій користувача — встановлено як мінімум 100.
-
Лімітний період транзакціїSecs — встановлено значення 1.
-
-
Значення сторінки—Встановлення властивостей системи підкачки (XSP_CLI/Програми/XSI-Action/Page):
-
За замовчуванням PageSize — встановлено значення 50
-
Доступний UserMaxLimit — встановлено на 100
-
-
Інтерфейс CTI — переконайтеся, що ви завантажили сертифікати Webex CA до сховища довіри інтерфейсу CTI та увімкніть автентифікацію клієнта в інтерфейсі CTI.
Крім того, залежно від вашого випуску BroadWorks, ми рекомендуємо застосувати наступні системні виправлення до розгортання BroadWorks, перш ніж увімкнути цю функцію:
-
Для R24: патч не потрібен
Увімкнути синхронізацію каталогів (новий шаблон)
Адміністратори-партнери можуть увімкнути синхронізацію каталогів для шаблону клієнта під час створення нового шаблону. Будь-які нові організації-клієнти, які будуть присвоєні до цього шаблону, матимуть увімкнену синхронізацію каталогів. Докладніші відомості див. у розділі «Налаштування шаблонів адаптації» у розділі Налаштування партнерської організації в центрі партнерів у Посіб нику з рішень для Webex для Cisco BroadWorks.
Що робити далі
Переконайтеся, що ваші користувачі знають, що вони повинні натиснути вклад ку Контакти у програмі Webex принаймні один раз, щоб увімкнути цю функцію в додатку Webex. Це потрібно виконати лише один раз.
Увімкнути синхронізацію каталогів (існуючий шаблон)
| 1 |
Увійдіть у Партнерський центр і виберіть «Клієнти». |
| 2 |
У розділі Ш аблони в ступу виберіть Замовника. |
| 3 |
Натисніть на налаштування служби, у розділі Налаштування вклю чіть синхронізацію каталогів. |
| 4 |
Щоб увімкнути синхронізацію каталогів за замовчуванням для нових організацій клієнтів, які використовують цей шаблон: |
| 5 |
Щоб увімкнути синхронізацію каталогів для існуючих організацій-клієнтів, які використовують цей шаблон: Якщо ви хочете вимкнути синхронізацію каталогів, виконайте наведену вище процедуру та:
|
Що робити далі
Переконайтеся, що ваші користувачі знають, що вони повинні натиснути вклад ку Контакти у програмі Webex принаймні один раз, щоб увімкнути цю функцію в додатку Webex. Це потрібно виконати лише один раз.
Запустіть негайну синхронізацію
| 1 |
Увійдіть у Партнерський центр (http://admin.webex.com) та виберіть «Н алаштування». |
| 2 |
Прокрутіть до пункту BroadWorks Calling і натисніть Переглянути шаблони. |
| 3 |
Виберіть відповідний шаблон клієнта та перейдіть до пункту Син хронізація каталогів BroadWorks. |
| 4 |
Натисніть Показати статус синхронізації списку клієнтів. |
| 5 |
Для організації клієнтів, яку потрібно синхронізувати, клацніть три крапки у крайньому правому куті та виберіть Син хронізувати зараз. |
| 6 |
Натисніть Онов ити, щоб побачити результати синхронізації. |
Експортувати записи синхронізації в CSV
| 1 |
Увійдіть у Партнерський центр (http://admin.webex.com) та виберіть «Н алаштування». |
| 2 |
Прокрутіть до пункту BroadWorks Calling і натисніть Переглянути шаблони. |
| 3 |
Виберіть відповідний шаблон клієнта та перейдіть до пункту Син хронізація каталогів BroadWorks. |
| 4 |
Натисніть Показати статус синхронізації списку клієнтів. |
| 5 |
Позначте сусідні прапорці для кожної організації, яку потрібно включити до експорту. |
| 6 |
Натисніть Експортувати результати. |
Загальнодоступні API для синхронізації каталогів
Загальнодоступні API доступні на developer.webex.com, які дозволяють адміністраторам партнерам оновлювати параметри синхронізації каталогів для організацій-клієнтів, якими вони керують, ініціювати негайну синхронізацію або отримувати інформацію про стан синхронізації. Методи синхронізації каталогів згруповані під BroadWorks Enterprises:
-
Список підприємств BroadWorks
— Використовуйте цей метод API, щоб отримати список підприємств під певним постачальником послуг та ідентифікатор кожного підприємства.Необхідно ввестиSPEnterpriseID, призначенийпід час підготовки. -
Оновити синхронізацію каталогів для BroadWorks Enterprise — введіть ідентифікатор підприємства, щоб онов
итистатус syc каталогу для цієї компанії, увімкнувши або вимкнувши синхронізацію каталогів. -
Запуск синхронізації каталогів для підприємства
. Використовуйте цей метод API, якщо ви хочете запустити негайну синхронізацію для певного ідентифікатора підприємства.Длясинхронізації статусу введіть команду_NOW.SYNC -
Отримати статус синхронізації каталогів для підприємства — введіть іденти
фікаторпідприємства та запустіть, щоб отримати статус та ідентифікатор відстеження останньоїсинхронізації. Ви можете використовувати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 |
Запустіть API List 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 не може бути запущена, оскільки кластер 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 |
Синхронізація користувачів зовнішнього каталогу 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 |
|