У цій статті описано, як розгорнути синхронізацію каталогів у 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 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 з контактами Webex. Синхронізовані записи додаються до одного з наступних типів контактів:
Контакти організації - Webex зберігає ці контакти проти організації. Кожен користувач може отримати доступ до контактів організації для своєї організації. Максимальна кількість контактів - до 30000.
Контакти користувачів - Webex зберігає ці контакти проти користувача. Тільки користувач, який володіє контактом, може отримати доступ до запису контакту. Максимум - до 2000 контактів (1500 синхронізованих контактів + 500 контактів ручного вводу).
Лише записи зі списку телефонів додаються до контактів Webex. Користувачі, які викликають тільки BroadWorks, та не користувацькі викличні сутності, які включені до синхронізації каталогів, не додаються до контактів, якщо користувач Webex не додає їх до контактів вручну.
|
Наступна таблиця відображає типи контактів Webex з джерелом контактів (синхронізовано зі списку телефонів BroadWorks або додано вручну):
Тип контакту Webex |
Джерело контактів |
Максимум |
Синхронізовано з BroadWorks... |
API, що використовується для синхронізації |
---|---|---|---|---|
Контакти організації |
Синхронізація каталогів |
30000 контактів |
Загальні списки телефонів підприємства |
|
Групові загальні телефонні списки (для групи постачальника послуг)** |
|
|||
Контакти користувача |
Синхронізація каталогів |
1500 контактів |
Особисті списки телефонів |
/directories/personal |
Додано вручну користувачем |
500 контактів |
Н/Д |
Н/Д |
|
Групові контакти |
Синхронізація каталогів |
30000 контактів на групу |
Групові загальні телефонні списки (для корпоративної групи)** |
/directories/groupcommon |
** Записи групових загальних телефонних списків синхронізуються по-різному залежно від того, чи знаходиться BroadWorks у режимі корпоративного або постачальника послуг. Значення
|
Наступні умови стосуються того, як 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, перш ніж увімкнути цю функцію:
Для R22:
AP.as.22.0.1123.ap368517
Для R23:
AP.as.23.0.1075.ap368517
Для R24: патч не потрібен
Увімкнути синхронізацію каталогів (новий шаблон)
Адміністратори-партнери можуть увімкнути синхронізацію каталогів для шаблону клієнта під час створення нового шаблону. Будь-які нові організації-клієнти, яким призначено цей шаблон, матимуть увімкнену синхронізацію каталогів. Докладніші відомості див. у розділі "Налаштування шаблонів клієнтів" в розділі "Налаштування організації-партнера в концентраторі партнерів" посібника з рішення для Webex для Cisco BroadWorks.
Що робити далі
Переконайтеся, що ваші користувачі знають, що вони повинні щонайменше один раз натиснути вкладку Контакти в додатку Webex, щоб увімкнути цю функцію в додатку Webex. Це потрібно зробити лише один раз.
Увімкнути синхронізацію каталогів (існуючий шаблон)
1. | Увійдіть до Центру партнерів і виберіть Налаштування. |
||
2. | Перейдіть до пункту BroadWorks Calling (Виклик BroadWorks) і натисніть кнопку View Templates (Переглянути шаблони). |
||
3. | Виберіть відповідний шаблон клієнта та перейдіть до BroadWorks Directory Sync. |
||
4. | Щоб увімкнути синхронізацію каталогів за замовчуванням для нових організацій клієнтів, які використовують цей шаблон:
|
||
5. | Щоб увімкнути синхронізацію каталогів для існуючих організацій клієнтів, які використовують цей шаблон, виконайте наведені нижче дії.
|
Що далі
Переконайтеся, що ваші користувачі знають, що вони повинні щонайменше один раз натиснути вкладку Контакти в додатку Webex, щоб увімкнути цю функцію в додатку Webex. Це потрібно зробити лише один раз.
Запустити негайну синхронізацію
1. | Увійдіть у Партнерський центр (http://admin.webex.com) і виберіть Налаштування. |
2. | Перейдіть до пункту BroadWorks Calling (Виклик BroadWorks) і натисніть кнопку View Templates (Переглянути шаблони). |
3. | Виберіть відповідний шаблон клієнта та перейдіть до BroadWorks Directory Sync. |
4. | Натисніть Показати стан синхронізації списку клієнтів. |
5. | Для організації-замовника, яку потрібно синхронізувати, клацніть три крапки в крайньому правому куті та виберіть Sync Now (Синхронізувати зараз). |
6 | Натисніть Оновити, щоб переглянути результати синхронізації. |
Експортувати синхронізовані записи до CSV
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
|
1. | Запустіть API List BroadWorks Enterprises, щоб створити список підприємств, які потрібно синхронізувати.
|
2. | Запустіть синхронізацію каталогів тригерів для корпоративного API на першому підприємстві зі списку. |
3. | Зачекайте кілька секунд, а потім запустіть Get Directory Sync Status 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 не пов’язаний із конфігурацією клієнта. |
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 р. |
Роз 'яснення та виправлення до оглядової інформації:
|
09.05.2022 |
|
07 квітня 2022 р. |
|
28 березня 2022 р. |
|
24 березня 2022 р. |
Додано список типів синхронізованих номерів телефонів до умов синхронізації каталогів. Синхронізація тепер включає номери мобільних телефонів. |
16 березня 2022 р. |
|
17 грудня 2021 р. |
|
16 грудня 2021 р. |
|
08 грудня 2021 р. |
|