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

Синхронизирането на директории гарантира, че webex за потребителите на Cisco BroadWorks могат да използват директорията Webex, за да се обадят на всеки повикващия обект от сървъра на BroadWorks. Когато тази функция е активирана, пълната директория за обаждания от сървъра на BroadWorks се синхронизира с директорията Webex. Потребителите могат да получат достъп до директорията от приложението Webex и да поставят обаждане до всеки повикващи обект от сървъра на BroadWorks.

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

  • Контакти на организацията—Тези контакти се съхраняват срещу организация и са достъпни за всеки потребител в организацията.

  • Контакти на потребители—Тези контакти се съхраняват срещу потребител и са достъпни само за потребителя, който притежава контакта.


Осигуряването на Webex за Cisco BroadWorks включва синхронизиране по подразбиране на потребителите на съобщения и свързаната с тях повикваща информация от сървъра на BroadWorks към директорията Webex. Синхронизирането на осигуряването по подразбиране обаче пропуска потребители без съобщения и обекти, които не са потребители (например телефон в конферентна зала, факс машина или номер на ловна група). Включването на синхронизирането на directory гарантира, че всички извикващи обекти се добавят към директорията webex.

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

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

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

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

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

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

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

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

  • Тази функция синхронизира следните типове телефонни списъци от сървъра на BroadWorks:

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

    • Групиране на общи телефонни списъци

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

Директория синхронизиране и контакт максимуми

Следват максималния брой контакти, които синхронизирането на директория позволява за всеки тип контакти на Webex:

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

  • 500 Потребителски контакти—За потребител максимумът включва синхронизирани потребителски контакти и ръчни контакти (контакти, които потребителят добавя ръчно чрез Приложението Webex)

Прилагат се следните условия:

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

  • Ако даден потребител добави контакти ръчно в Приложението Webex, максимумът за контакт с потребителя се определя чрез изваждане на ръчните контакти от синхронизираните потребителски контакти. Ако например потребител добави 100 контакта ръчно в Webex App, синхронизирането на директория позволява да се синхронизират до 400 потребителски контакти от BroadWorks за този потребител.

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

Следната таблица съпоставя типовете контакти на Webex в списъка с телефони BroadWorks, от който се синхронизират записите:

Таблица 1. Синхронизиране на директория типове контакти и източник на синхронизиране

Webex тип контакт

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

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

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

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

/directories/enterprisecommon

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

/directories/groupcommon

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

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

/directories/groupcommon

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

/directories/personal


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

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

  • Невярно—Синхронизиране като потребителски контакт

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

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

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

  • Актуализациите на потребителски контакти се показват в приложението Webex за този потребител незабавно.

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

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

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

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

Превключване на изисквания

За тази функция съществуват следните превключвания на функции. Уверете се, че сте се свързали с вашия Webex за представител на Cisco BroadWorks, за да зададете тези.

Превключване на функции

Приложено към...

Описание

webex-for-broadworks-phone-list-sync

Партньор

Задължително превключване. Разрешава синхронизирането на телефонни списъци за всички организации на клиенти под този партньор.

Трябва да е разрешено.

webex-for-broadworks-phone-list-sync-disable

Организация на клиентите

Незадължителен превключвач. Забранява синхронизирането на телефонен списък за дадена организация, дори ако функцията е разрешена на ниво партньор, и в шаблона на клиента.

Прилагайте този превключващ елемент само ако искате да забраните синхронизирането на списъка с телефони за конкретна организация на клиенти. В противен случай можете да го оставите за инвалид.


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

hidden-personal-contacts-enabled-ga

Потребител

Незадължителен превключвач. Скрива личните контакти от търсения в директорията, завършени от този потребител.

hidden-org-contacts-enabled-ga

Потребител

Незадължителен превключвач. Скрива контактите на организацията от търсения в директорията, завършени от този потребител.

Изисквания за предконфигуриране

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


По-долу примери предполагат, че използвате 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 и щракнете върху Преглед на шаблони .

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 съдържа по-подробен изглед на записа за синхронизиране от GUI на контролния център и може да помогне при отстраняването на неизправности и анализите.

1

Влезте в Центъра за партньори (http://admin.webex.com) и изберете Настройки.

2

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

3

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

4

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

5

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

6

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

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

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

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

  • Актуализиране на синхронизиране на директория за предприятие за BroadWorks— Въведете предприятието id за актуализиране на състоянието на директорията syc за това предприятие, разрешаване или забраняване на синхронизирането на директории.

  • Задействане на синхронизиране на директория за предприятие—Използвайте този метод на API, ако искате да задействате незабавно синхронизиране за дадено предприятие id. За syncStatus, въведете SYNC_NOW команда.

  • Получаване на състояние на синхронизиране на директория за предприятие— Въведете предприятието id и да се изпълнява, за да получите статус и trackingId от най-новото синхронизиране. Можете да използвате trackingID за изпълнение на допълнителни анализи чрез инструменти като Kibana и Grafana.

За подробна документация за 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, за да завършите синхронизирането на директории за няколко предприятия.

  • Синхронизирането на директория ви позволява да синхронизирате само едно предприятие в даден момент. Ако се опитате да синхронизирате повече от едно предприятие, ще получите грешка 429.

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

1

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

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

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

2

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

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

  2. Задаване на синхронизиранеСтатус на SYNC_NOW

  3. Щракнете върху Изпълнение.

    За предприятието се задейства незабавна синхронизация. Това синхронизиране се брои срещу ограничението за синхронизиране на екземпляр.
3

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

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

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

4

След приключване на синхронизирането изпълнете стъпки от 2 до 4 на следващото предприятие в списъка. Повторете тези стъпки, докато не синхронизирате целия списък.

Кодове на грешки за синхронизиране на директория

Следните кодове на грешки се прилагат за синхронизиране на директория.

Код на грешка

Съобщение за грешка

600000

Broadworks външна директория потребител синхронизиране неочаквана грешка.

600001

Неуспешно синхронизиране на потребители на външни директории на Broadworks.

600002

Broadworks външна директория потребителско синхронизиране трябваше да бъде прекратено преди завършване.

600003

Broadworks външна директория потребителско синхронизиране само частично успя. Някои клиентски организации не успяват да се синхронизират.

600004

Синхронизирането на потребители на външни директории на Broadworks не е разрешено за ConfigSet.

600005

Синхронизиране на потребители на външни указатели на Broadworks е в ход за ConfigSet.

600006

Нишките за синхронизиране на потребители на Broadworks External Directory са заети или се изключват, оттам няма да приемат повече искане за синхронизиране, опитайте отново по-късно.

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 не успя да синхронизира контактите на предприятието/организацията.