Преглед на синхронизирането на директории

Синхронизирането на директория гарантира, че 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.

Условия за синхронизиране на директория

  • Администраторите на партньори трябва да активират функцията на ниво партньор. Администраторите партньори могат да включат или изключат функцията за няколко клиентски организации в една операция.

  • По подразбиране първоначалното синхронизиране възниква една седмица след разрешаването на синхронизирането (времето, избрано за стартиране на синхронизирането, е случайно). Клиентските организации обаче могат да използват опцията Синхронизиране сега , за да пропуснат едноседмичния период на изчакване и да задействат незабавно синхронизиране за дадена клиентска организация.

  • По подразбиране синхронизирането на директорията се изпълнява седмично за всеки клиент. Всяко синхронизиране възниква една седмица след последното синхронизиране, независимо от това дали последното синхронизиране е планирано или задействано ръчно с "Синхронизиране сега".

  • Максималният брой едновременни синхронизирания на BroadWorks клъстер е два: едно планирано синхронизиране и едно синхронизиране по заявка (чрез API или GUI на центъра за партньори). Администраторите обаче не могат да изпълняват две синхронизирания по заявка едновременно от едни и същи BroadWorks. Това ограничение съществува независимо от това дали синхронизирането е започнато чрез API или чрез опцията Синхронизиране сега в центъра за партньори. Освен това Webex няма да насрочи две планирани синхронизирания, за да се изпълняват едновременно от една и съща BroadWorks.

  • Ако възникне неизправност в синхронизирането, Webex пренаблюдава синхронизирането автоматично на всеки 24 часа до следващото планирано синхронизиране.

  • Синхронизирането игнорира потребители, които нямат телефонен номер.

  • В центъра за партньори можете да прегледате информацията за състоянието на синхронизирането за даден клиент. Освен това можете да експортирате подробна информация за последното синхронизиране в CSV запис. CSV записът предоставя по-подробни данни от дисплея на контролния център и може да помогне при отстраняване на неизправности, анализ и проверка.

  • Webex съхранява потребителски контакти в шифрован формат. Само потребителят, който притежава контакта, има достъп до ключа за де криптиране.

  • За BroadWorks само обаждащи се потребители и не-потребителски повикващи обекти тази функция синхронизира следните типове телефонни номера от BroadWorks:

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

    • Мобилен телефонен номер

    • Вътрешен номер

    Обаче синхронизиране изключва BroadWorks само повикване потребители и не-потребител извикване обекти от синхронизирането, ако нито основен телефонен номер или разширение е налице.

    Настройката на услугата за поверителност на ниво потребител на BroadWorks не се поддържа като част от синхронизирането на указатели.

Списък с телефони на BroadWorks и максимуми за контакт

Синхронизирането на директорията също така синхронизира записите в списъка с телефони на BroadWorks към Webex Контакти. Синхронизираните записи се добавят към един от следните типове контакти:

  • Организация Контакти—Webex съхранява тези контакти срещу организация. Всеки потребител има достъп до контактите на организацията за своята организация. Максимумът е до 30000 контакти.

  • Потребителски контакти—Webex съхранява тези контакти срещу потребител. Само потребителят, който притежава контакта, има достъп до записа за контакт. Максимумът е до 2000 контакта (1500 синхронизирани контакта + 500 ръчни контакта за въвеждане).

Само записите в Списъка с телефони се добавят към Webex Контакти. BroadWorks само повикване потребители и не-потребител извикване обекти, които са включени в Синхронизиране на директория не се добавят към Контакти, освен ако потребител на Webex ги добавя към Контакти ръчно.

Следните таблица карти Webex типове контакти срещу източника на контакт (синхронизирани от BroadWorks телефонен списък или добавени ръчно):

Таблица 2. Директория синхронизиране максимуми и източник

Webex тип контакт

Източник на контакт

Максимално

Синхронизиран от BroadWorks...

API, използван за синхронизиране

Контакти на организацията

Синхронизиране на указатели

30000 контакти

Корпоративни общи телефонни списъци

/directories/enterprisecommon

Групиране на общи телефонни списъци (за група доставчици на услуги)**

/директории/groupcommon

Потребителски контакти

Синхронизиране на указатели

1500 контакти

Лични телефонни списъци

/директории/личен

Добавя се ръчно от потребителя

500 контакта

Няма

Няма

Групови контакти

Синхронизирана с указател

30000 контакти на група

Групиране на общи телефонни списъци (за корпоративна група)**

/директории/groupcommon

**Групови общи телефонни списъци записите се синхронизират по различен начин в зависимост от това дали BroadWorks е в режим на предприятие или доставчик на услуги режим. Стойността на параметъра isBroadWorksEnterprise (вярно или невярно) определя как се синхронизира списъкът:

  • Вярно – Синхронизиране като групов контакт

  • Невярно—Синхронизиране като контакт с организация

Следните условия се прилагат около начина, по който Directory Sync обработва максимумите на контактите:

  • Ако дадена организация надвиши максимално позволените контакти за синхронизирането (30000 контакти на организацията или 30000 общи контакти на група за група), синхронизирането на указатели изключва записи над максималния праг. Няма особена поръчка, приложена към синхронизирани или пропуснати контакти.

  • Ако някой от вашите клиенти надвишава максималния позволен брой контакти в някоя от двете категории, ви препоръчваме да повдигнете случай с Cisco, за да имате тази организация изключена от синхронизирането на директории.

  • Ръчните контакти са контакти, които потребителят добавя ръчно в Приложението Webex. Потребителят може да добави до 500 ръчни контакти. Ръчните контакти попадат в по-голямата категория контакти на Потребителя в Webex, но не са включени в синхронизирането.

  • Общото комбинирано ограничение за контактите на организацията (30000) и групови контакти (30000 за група) е 200000.

Актуализации

По-долу е как Webex директория обработва актуализации:

  • Ако името на контакта се промени в BroadWorks, съществуващият контакт се изтрива от директорията webex и се създава нов контакт.

  • Ако номерът на контакта се промени в BroadWorks, Webex актуализира съществуващия контакт в директорията Webex с новия номер.

След администратор актуализира контакт на BroadWorks, следните условия очертайте, когато актуализацията показва в Webex App на потребителя:

  • Ако актуализацията е на потребител, който се обажда само на BroadWorks или не потребител, който се обажда, актуализацията показва в Webex App на потребителя веднага след последващото синхронизиране на директорията.

  • Ако актуализацията е към запис в телефонен списък на BroadWorks:

    • За потребителски контакти—Актуализации показване в Webex App на потребителя веднага след последващото синхронизиране на директории.

    • За групови контакти – актуализациите се показват в приложението Webex на потребителите веднага след последващото синхронизиране на указателя.

    • За контактите на организацията —Директорията Webex се актуализира при последващото синхронизиране на директорията, но потребителите няма да видят промяната в Приложението Webex, докато не рестартират Webex App или докато не изтече локалният 72-часов таймер за кеша.

Актуализации на Webex за Cisco BroadWorks потребителска информация се обработват като част от процесите на осигуряване.
Контролният център съдържа опция за добавяне или редактиране на контакти на ниво организация в контролния център чрез CSV файл. Администраторите на партньори и администраторите на клиенти с достъп до контролния център могат да получат достъп до тази опция. Актуализирането на контакти чрез Control Hub обаче не се поддържа от Webex за Cisco BroadWorks. Актуализациите на контактите, прилагани в контролния център, не се синхронизират обратно към BroadWorks и са недостъпни за търсения в директорията от настолни телефони.

Предпоставки за синхронизиране на директория

Препоръчваме ви да използвате следните настройки:

По-долу примери предполагат, че използвате XSP сървър. За ADP сървъри заменете (XSP_CLI) с (ADP_CLI).
  • Rate Limiting Values—Задайте следните свойства на системата OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit—Задаване на null стойност.

    • globalDirectoryTransactionLimit—Задайте null стойност.

    Препоръчително е да зададете userDirectoryTransactionLimit и globalDirectoryTransactionLimit на null стойност. Ако обаче решите да присвоите стойности, всяка трябва да бъде зададена на поне пет пъти стойността на транзакциятаLimitPeriodSeconds (която трябва да бъде 1).
  • Ограничения на транзакциите—Задаване на следните стойности (XSP_CLI/Система/Комуникация Полезност/Настройки по подразбиране):

    • потребителTransactionLimit—Задайте на най-малко 100.

    • транзакцияLimitPeriodSecs—Задайте на 1.

  • Стойности на виртуална памет—Задаване на свойствата на системата за виртуална памет (XSP_CLI/Приложения/Xsi-Действия/Виртуална памет):

    • defaultPageSize—Задаване на 50

    • наличниUserMaxLimit—Задаване на 100

  • CTI интерфейс—Уверете се, за да качите, че Webex CA сертификати в хранилището на доверие CTI интерфейс и да разрешите удостоверяване на клиента на CTI интерфейс.

Освен това, в зависимост от вашето издание на BroadWorks, ви препоръчваме да приложите следните системни корекции към разполагането на BroadWorks, преди да разрешите тази функция:

За пълния списък с изискванията за корекции, които формират минималното изискване за Webex за Cisco BroadWorks, вижте изискванията за софтуера BroadWorks в Ръководството за решения за Webex за Cisco BroadWorks.

Разрешаване на синхронизиране на директории (нов шаблон)

Администраторите на партньори могат да активират Синхронизиране на директория за шаблон на клиент, докато създават новия шаблон. Всички нови клиентски организации, които се причислят към този шаблон, ще имат разрешено синхронизиране на директорията. За подробности вижте "Конфигуриране на вашите шаблони за клиенти" в Конфигуриране на вашата партньорска организация в партньорския център в рамките на Ръководството за решения за Webex за Cisco BroadWorks.

Какво да правим Напред

Уверете се, че потребителите ви знаят, че трябва да кликват върху раздела Контакти в Приложението Webex поне веднъж, за да включат функцията в Приложението Webex. Това трябва да бъде завършено само веднъж.

Разреши синхронизирането на директории (съществуващ шаблон)

Администраторите на партньори могат да изпълнят следните стъпки, за да включат Синхронизиране на директория в рамките на съществуващ Шаблон за клиент, за да се разреши функцията за клиентските организации, които използват шаблона.
1

Влезте в Центъра за партньори и изберете Настройки.

2

Превъртете до BroadWorks Calling и щракнете върху Преглед на шаблони.

3

Изберете подходящия шаблон за клиент и превъртете до Синхронизиранена директорията на BroadWorks.

4

За да разрешите синхронизирането на директории по подразбиране за нови клиентски органзии, които използват този шаблон:

  1. Задайте Активиране на директорията на BroadWorks & Синхронизиране на телефонен списък за всички нови клиентски организации превключват на Вкл.

  2. Щракнете върху Запиши.

5

За да разрешите синхронизирането на директории за съществуващи клиентски организации, които използват този шаблон:

  1. Кликнете върху Показване на списъка с клиенти за синхронизиране на състоянието.

  2. Поставете отметка в съседните квадратчета за всяка организация, за която искате да включите функцията.

  3. Щракнете върху Разреши синхронизирането.

Ако искате да забраните синхронизирането на директории, следвайте горепосочената процедура и:

  • В стъпка 4a задайте Активиране на синхронизирането на телефонни указатели за всички нови клиентски организации превключвате към Изкл .

  • В стъпка 5c щракнете върху Забрани синхронизирането , за да изключите функцията за съществуващи организации.

Какво да направите след това

Уверете се, че потребителите ви знаят, че трябва да кликват върху раздела Контакти в Приложението Webex поне веднъж, за да включат функцията в Приложението Webex. Това трябва да бъде завършено само веднъж.

Задействане на незабавно синхронизиране

Опцията Синхронизиране сега позволява на партньорския администратор да задейства синхронизиране по заявка за дадена клиентска организация. Тази опция може да бъде избрана само за отделни клиентски организации –няма опция за групово синхронизиране сега.
1

Влезте в Partner Hub ( http://admin.webex.com) и изберете Настройки.

2

Превъртете до BroadWorks Calling и щракнете върху Преглед на шаблони.

3

Изберете подходящия шаблон за клиент и превъртете до Синхронизиранена директорията на BroadWorks.

4

Кликнете върху Показване на списъка с клиенти за синхронизиране на състоянието.

5

За организацията на клиентите, която искате да синхронизирате, щракнете върху трите точки в най-дясната и изберете Синхронизиране сега.

6

Щракнете върху Обновяване , за да видите резултатите от синхронизирането.

Експортиране на записи за синхронизиране в CSV

Администраторите на партньори могат да експортират подробна информация за последното синхронизиране в CSV файл. CSV съдържа по-подробен изглед на записа за синхронизиране от GUI на контролния център и може да помогне при отстраняването на неизправности и анализите.
1

Влезте в Partner Hub ( http://admin.webex.com) и изберете Настройки.

2

Превъртете до BroadWorks Calling и щракнете върху Преглед на шаблони.

3

Изберете подходящия шаблон за клиент и превъртете до Синхронизиранена директорията на BroadWorks.

4

Кликнете върху Показване на списъка с клиенти за синхронизиране на състоянието.

5

Поставете отметка в съседните квадратчета за всяка организация, която искате да включите в експортирането.

6

Кликнете върху Експортиране на резултатите.

Публични API за синхронизиране на указатели

Публичните API са налични на developer.webex.com , които позволяват на администраторите на партньори да актуализират настройките за синхронизиране на директорията за организациите на клиентите, които управляват, да задействат незабавно синхронизиране или да получат информация за състоянието на синхронизирането. Методите за синхронизиране на директорията са групирани под BroadWorks Enterprises:

  • Списък на предприятията на BroadWorks – Използвайте този метод на API, за да получите списък на предприятията под даден доставчик на услуги и ИД на всяко предприятие. Трябва да въведете spEnterpriseId , както е зададен в осигуряването.

  • Актуализиране на синхронизирането на указатели за предприятие на BroadWorks – въведете ИД на предприятието, за да актуализирате състоянието на syc на указателя за това предприятие, като активирате или деактивирате синхронизирането на указатели.

  • Задействане на синхронизиране на указател за предприятие – използвайте този метод на API, ако искате да задействате незабавно синхронизиране за даден ИД на предприятие. За syncStatus въведете командата СИНХРОНИЗИРАНЕ_СЕГА .

  • Получаване на статус на синхронизиране на указател за предприятие – въведете ИД на предприятието и изпълнете, за да получите статус и 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

Завършете тази процедура, за да използвате публичните API за задействане на синхронизиране на указатели за множество предприятия.
  • Синхронизирането на директория ви позволява да синхронизирате само едно предприятие от клъстер на Broadworks в даден момент чрез синхронизиране по заявка. Ако се опитате да синхронизирате повече от едно предприятие, ще получите грешка 429

  • Времето, необходимо за задействане на синхронизиране за едно предприятие, варира в зависимост от размера на предприятието.

1

Изпълнете API на предприятията на List BroadWorks , за да генерирате списък с предприятия, които искате да синхронизирате.

  1. Задайте стартС началния низ на идентификатора на предприятието или доставчика на услуги.

  2. Кликнете върху Изпълнение.

2

Изпълнете синхронизирането на директорията на задействане за Enterprise API на първото предприятие в списъка.

  1. Въведете идентификационния номерна предприятието .

  2. Задаване на syncStatus на СИНХРОНИЗИРАНЕ_СЕГА

  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

CustomerConfig не е намерено в организацията на партньора.

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

Пояснения и корекции на информацията за преглед:

  • Актуализиран преглед на синхронизирането на директорията, за да се изяснят различните включени синхронизирания и как директорията Webex се актуализира за всеки.

  • Актуализиран Списък с телефони на BroadWorks и Максимуми за контакти, за да се изясни, че само телефонните списъци се синхронизират с Контакти.

  • Корекции на Актуализации, за да се изясни колко време отнема на Приложението Webex да показва актуализирани записи.

09 май 2022 г.

  • В прегледна синхронизиране на директория коригирани Забележка под директория синхронизиране максимуми и източник таблица. Също така актуализира Забележка относно осигуряването на потока.

  • Граматически редакци и поправки

април 07, 2022

  • Добавена бележка към раздела актуализации в Преглед на синхронизирането на директории около ограничаване на прилагането на редактиране на контакти на ниво организация в контролния център.

28 март 2022 г.

  • Повторно вмъкнато липсващо съдържание под Разрешаване на синхронизиране на директория (нов шаблон) .

  • Добавена е информация за максимумите за синхронизиране. Можете да изпълните едно планирано синхронизиране и един API синхронизиране едновременно от същия клъстер.

  • Добавена е информация за "Синхронизиране на директорията на задействане" за един потребителски API.

24 март 2022 г.

Добавен списък на синхронизираните типове телефонни номера към "Условия засинхронизиране на директория". Синхронизирането вече включва мобилни телефонни номера.

16 март 2022 г.

  • Добавени са нови кодове на грешки.

  • Добавена е уводна декларация за описание за по-добра използваемост от уеб търсения.

17 декември 2021 г.

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

16 декември 2021 г.

  • Актуализирана статия с повишени максимални стойности за потребителски контакти.

08 декември 2021 г.

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

  • Преработено форматиране на таблица в Кодове на грешки за синхронизиране на директория за по-добра четливост.