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

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

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

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

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

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

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

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

Записи дзвінків BroadWorks

Опис

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

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

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

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

Виклик користувачів лише на BroadWorks

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

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

Організації, які не телефонують без користувачів

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

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

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

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

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

  • Загальні списки телефонів групи (групи постачальників послуг або корпоративні групи)

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

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


Щоб дізнатися більше про підготовку користувачів, перегляньте Посібник з рішень Webex для Cisco BroadWorks.

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

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

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

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

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

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

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

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

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

  • Для користувачів, які телефонують лише на BroadWorks, і організацій, які не телефонують, ця функція синхронізує такі типи телефонних номерів із BroadWorks:

    • Основний номер телефону

    • Номер мобільного телефону

    • Внутрішній номер

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

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

Синхронізація каталогів також синхронізує записи списку телефонів BroadWorks з webex-контактами. Синхронізовані записи додаються до одного з таких типів контактів:

  • Контакти організації – Вебекс зберігає ці контакти в організації. Кожен користувач може отримати доступ до контактів організації для своєї організації. Максимум - до 500 контактів.

  • Контакти користувача — Webex зберігає ці контакти проти користувача. Лише користувач, якому належить контакт, може отримати доступ до запису контакту. Максимум - до 2000 контактів (1500 синхронізованих контактів + 500 контактів ручного введення).


До контактів Webex додаються лише записи списку телефонів. Користувачі, які телефонують лише на broadWorks, і сутності, які не телефонують користувачам, які входять до синхронізації каталогів, не додаються до контактів, якщо користувач Webex не додає їх до контактів вручну.

У наведеній нижче таблиці відображено типи контактів Webex із джерелом контактів (синхронізовано зі списку телефонів BroadWorks або додано вручну):

Таблиця 2. Максимум синхронізації каталогів і джерело

Тип контакту Webex

Контактне джерело

Максимум

Синхронізовано з BroadWorks...

API, який використовується для синхронізації

Контакти організації

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

500 контактів

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

/directories/enterprisecommon

Загальні списки телефонів групи (для групи постачальників послуг)**

/directories/groupcommon

Контакти користувачів

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

1500 контактів

Загальні списки телефонів групи (для корпоративної групи)**

/directories/groupcommon

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

/directories/personal

Додано користувачем вручну

500 контактів

Н/Д

Н/Д


**Записи загальних телефонних списків групи синхронізуються по-різному залежно від того, чи знаходиться BroadWorks у корпоративному режимі чи в режимі постачальника послуг. Значення isBroadWorksEnterprise параметр (true або false) визначає, як синхронізується список:

  • Правда – синхронізація як контакту користувача

  • Хибно: синхронізація як контакту організації

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

  • Якщо в організації перевищує максимально дозволені контакти для синхронізації (500 контактів організації або 1500 синхронізованих контактів користувачів), синхронізація каталогів виключає записи, що перевищують максимальний поріг. До синхронізованих або пропущених контактів не застосовується особливий порядок.

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

  • Ручні контакти – це контакти, які користувач додає вручну в додаток Webex. Користувач може додати до 500 контактів вручну. Ручні контакти належать до більшої категорії контактів користувачів у Webex, але не включаються до синхронізації.

Оновлення

Нижче наведено, як каталог Webex обробляє оновлення:

  • Якщо ім'я контакту змінюється на BroadWorks, наявний контакт видаляється з каталогу Webex і створюється новий контакт.

  • Якщо на BroadWorks змінюється контактний номер, Webex оновлює існуючий контакт в каталозі Webex новим номером.

Після того, як адміністратор оновлює контакт на BroadWorks, наведені нижче умови відображаються в програмі Webex користувача:

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

  • Якщо оновлення до запису списку телефонів BroadWorks:

    • Для контактів користувача — оновлення відображаються в додатку Webex користувача відразу після подальшої синхронізації каталогів.

    • Для контактів організації — каталог Webex оновлюється під час подальшої синхронізації каталогів, але користувачі не побачать зміни в додатку Webex, доки не перезапустять програму Webex або доки не закінчиться термін дії локального 72-годинного таймера кешу.


Оновлення webex для Cisco BroadWorks інформація про користувачів обробляється як частина процесів підготовки.

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

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

Рекомендуємо скористатися наступними настройками:


Наведені нижче приклади припускають, що ви використовуєте XSP-сервер. Для серверів ADP замініть (XSP_CLI) на (ADP_CLI).
  • Граничні значення швидкості — встановіть наступні властивості системи управління перевантаженням (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, перш ніж активувати цю функцію:

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

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

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

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

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

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

1.

Увійдіть у Партнерський центр і виберіть елемент Настройки.

2.

Прокрутіть до пункту Виклики BroadWorks і виберіть пункт Переглянути шаблони.

3.

Виберіть відповідний шаблон клієнта та прокрутіть до розділу Синхронізаціякаталогів BroadWorks.

4.

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

  1. Установіть перемикач Увімкнути каталог BroadWorks і синхронізацію списку телефонів для всіх нових організацій клієнтів у положення Увімкнуто.

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

5.

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

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

  2. Установіть суміжні прапорці для кожної організації, для якої потрібно ввімкнути цю функцію.

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


 

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

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

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

Що далі

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

Завершення негайної синхронізації

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

1.

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

2.

Прокрутіть до пункту Виклики BroadWorks і виберіть пункт Переглянути шаблони.

3.

Виберіть відповідний шаблон клієнта та прокрутіть до розділу Синхронізаціякаталогів BroadWorks.

4.

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

5.

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

6

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

Експорт записів синхронізації в CSV

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

1.

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

2.

Прокрутіть до пункту Виклики BroadWorks і виберіть пункт Переглянути шаблони.

3.

Виберіть відповідний шаблон клієнта та прокрутіть до розділу Синхронізаціякаталогів BroadWorks.

4.

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

5.

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

6

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

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

Загальнодоступні ІНТЕРФЕЙСИ API доступні на developer.webex.com , які дають змогу адміністраторам партнерів оновлювати настройки синхронізації каталогів для організацій клієнтів, якими вони керують, ініціювати негайну синхронізацію або отримувати відомості про стан синхронізації. Методи синхронізації каталогів згруповані в розділі BroadWorks Enterprises:

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

  • Оновлення синхронізації каталогів для широкого робочого підприємства— enter the enterprise id щоб оновити стан syc каталогу для цього підприємства, увімкнувши або вимкнувши синхронізацію каталогів.

  • Синхронізація служби підтримки для підприємств– використовуйте цей метод API, якщо потрібно ініціювати негайну синхронізацію для певного підприємства id. Для syncStatus, введіть SYNC_NOW команда.

  • Отримання стану синхронізації каталогів для підприємства– enter the enterprise id і бігти для того, щоб отримати статус і trackingId останньої синхронізації. Можна скористатися trackingID для запуску додаткової аналітики за допомогою таких інструментів, як 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

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

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

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

1.

Запустіть API списку BroadWorks Enterprises , щоб створити список підприємств, які потрібно синхронізувати.

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

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

2.

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

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

  2. Установити синхронізаціюстатус на SYNC_NOW

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

    Для підприємства запускається негайна синхронізація. Ця синхронізація має значення для єдиної синхронізації на вимогу відповідно до ліміту Broadworks.
3.

Зачекайте кілька секунд, а потім запустіть 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 не можна запустити, оскільки кластер широкої роботи, пов'язаний із 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 не вдалася, оскільки підприємство не має підготовленого користувача.

Журнал змін

У наведеній нижче таблиці наведено оновлення цієї статті.

Дата

Редакція

Липень 19, 2022

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

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

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

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

Травень 09, 2022

  • У розділі Оглядсинхронізації каталогів виправлено примітка в таблиці "Максимум синхронізації каталогів" і "Джерело ". Також оновлено Примітку про потокове забезпечення.

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

Квітень 07, 2022

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

Березня 28, 2022

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

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

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

Березня 24, 2022

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

Березня 16, 2022

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

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

17 Грудня, 2021

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

16 Грудня, 2021

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

08 Грудня, 2021

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

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