- Начало
- /
- Статия
Синхронизиране на указатели в 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 или 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 тип контакт |
Източник на контакт |
Максимално |
Синхронизиран от BroadWorks... |
API, използван за синхронизиране |
---|---|---|---|---|
Контакти на организацията |
Синхронизиране на указатели |
30000 контакти |
Корпоративни общи телефонни списъци |
|
Групиране на общи телефонни списъци (за група доставчици на услуги)** |
| |||
Потребителски контакти |
Синхронизиране на указатели |
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-часов таймер за кеша.
-
Предпоставки за синхронизиране на директория
Препоръчваме ви да използвате следните настройки:
-
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, преди да разрешите тази функция:
-
За R22:
AP.as.22.0.1123.ap368517
-
За R23:
AP.as.23.0.1075.ap368517
-
За R24: не е необходим пластир
Разрешаване на синхронизиране на директории (нов шаблон)
Администраторите на партньори могат да активират Синхронизиране на директория за шаблон на клиент, докато създават новия шаблон. Всички нови клиентски организации, които се причислят към този шаблон, ще имат разрешено синхронизиране на директорията. За подробности вижте "Конфигуриране на вашите шаблони за клиенти" в Конфигуриране на вашата партньорска организация в партньорския център в рамките на Ръководството за решения за Webex за Cisco BroadWorks.
Какво да правим Напред
Уверете се, че потребителите ви знаят, че трябва да кликват върху раздела Контакти в Приложението Webex поне веднъж, за да включат функцията в Приложението Webex. Това трябва да бъде завършено само веднъж.
Разреши синхронизирането на директории (съществуващ шаблон)
1 |
Влезте в Центъра за партньори и изберете Настройки. |
2 |
Превъртете до BroadWorks Calling и щракнете върху Преглед на шаблони. |
3 |
Изберете подходящия шаблон за клиент и превъртете до Синхронизиранена директорията на BroadWorks. |
4 |
За да разрешите синхронизирането на директории по подразбиране за нови клиентски органзии, които използват този шаблон: |
5 |
За да разрешите синхронизирането на директории за съществуващи клиентски организации, които използват този шаблон: Ако искате да забраните синхронизирането на директории, следвайте горепосочената процедура и:
|
Какво да направите след това
Уверете се, че потребителите ви знаят, че трябва да кликват върху раздела Контакти в Приложението Webex поне веднъж, за да включат функцията в Приложението Webex. Това трябва да бъде завършено само веднъж.
Задействане на незабавно синхронизиране
1 |
Влезте в Partner Hub ( http://admin.webex.com) и изберете Настройки. |
2 |
Превъртете до BroadWorks Calling и щракнете върху Преглед на шаблони. |
3 |
Изберете подходящия шаблон за клиент и превъртете до Синхронизиранена директорията на BroadWorks. |
4 |
Кликнете върху Показване на списъка с клиенти за синхронизиране на състоянието. |
5 |
За организацията на клиентите, която искате да синхронизирате, щракнете върху трите точки в най-дясната и изберете Синхронизиране сега. |
6 |
Щракнете върху Обновяване , за да видите резултатите от синхронизирането. |
Експортиране на записи за синхронизиране в CSV
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
-
Синхронизирането на директория ви позволява да синхронизирате само едно предприятие от клъстер на Broadworks в даден момент чрез синхронизиране по заявка. Ако се опитате да синхронизирате повече от едно предприятие, ще получите грешка 429
-
Времето, необходимо за задействане на синхронизиране за едно предприятие, варира в зависимост от размера на предприятието.
1 |
Изпълнете API на предприятията на List BroadWorks , за да генерирате списък с предприятия, които искате да синхронизирате. |
2 |
Изпълнете синхронизирането на директорията на задействане за Enterprise 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 |
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 |
Пояснения и корекции на информацията за преглед:
|
09 май 2022 г. |
|
април 07, 2022 |
|
28 март 2022 г. |
|
24 март 2022 г. |
Добавен списък на синхронизираните типове телефонни номера към "Условия засинхронизиране на директория". Синхронизирането вече включва мобилни телефонни номера. |
16 март 2022 г. |
|
17 декември 2021 г. |
|
16 декември 2021 г. |
|
08 декември 2021 г. |
|