Synchronizacja katalogów zapewnia, że użytkownicy Webex dla Cisco BroadWorks mogą używać katalogu Webex z aplikacji Webex do wywoływania dowolnej jednostki wywołującej z serwera BroadWorks. Ta funkcja synchronizuje informacje o wywołaniach BroadWorks, które nie były częścią aprowizacji użytkowników, do katalogu Webex.

Webex dla Cisco BroadWorks użytkowników aktualizuje katalog Webex o szczegóły połączeń dla Webex dla użytkowników Cisco BroadWorks (podstawowy numer telefonu, numer telefonu komórkowego, rozszerzenie), ale pomija zewnętrzne rekordy połączeń. Jednak gdy synchronizacja katalogów jest włączona, funkcja synchronizuje również następujące rekordy połączeń z katalogiem Webex.

• BroadWorks-tylko dzwoniący do użytkowników (którzy nie są dołączeni do Webex)

• Podmioty niebędące użytkownikami (np. telefon do sali konferencyjnej, faks, numer grupy myśliwskiej)

• Wpisy listy telefonicznej BroadWorks

Poniższa tabela podsumowuje rekordy wywołań BroadWorks i pokazuje, w jaki sposób są one dodawane do katalogu Webex.

Warunki synchronizacji katalogów

• Administratorzy partnerów muszą włączyć tę funkcję na poziomie partnera. Administratorzy partnerów mogą włączać i wyłączać tę funkcję dla wielu organizacji klientów w ramach jednej operacji.

• Domyślnie synchronizacja początkowa następuje tydzień po włączeniu synchronizacji (czas wybrany do rozpoczęcia synchronizacji jest losowy). Jednak organizacje klientów mogą użyć opcji Synchronizuj teraz , aby pominąć tygodniowy okres oczekiwania i uruchomić natychmiastową synchronizację dla danej organizacji klienta.

• Domyślnie synchronizacja katalogów jest uruchamiana co tydzień dla każdego klienta. Każda synchronizacja odbywa się tydzień po ostatniej synchronizacji, niezależnie od tego, czy ostatnia synchronizacja została zaplanowana, czy wyzwolona ręcznie za pomocą funkcji Synchronizuj teraz.

• Maksymalna liczba jednoczesnych synchronizacji na klaster BroadWorks wynosi dwa: jedna zaplanowana synchronizacja i jedna synchronizacja na żądanie (za pośrednictwem interfejsu API lub interfejsu GUI Partnera Hub). Jednak administratorzy nie mogą uruchamiać dwóch synchronizacji na żądanie w tym samym czasie z tego samego BroadWorks. To ograniczenie istnieje niezależnie od tego, czy synchronizacja została zainicjowana za pośrednictwem interfejsu API, czy za pomocą opcji Synchronizuj teraz w Centrum partnerów. Ponadto Webex nie zaplanuje dwóch zaplanowanych synchronizacji do uruchomienia w tym samym czasie z tego samego BroadWorks.

• Jeśli wystąpi błąd synchronizacji, Webex ponownie próbuje automatycznie przeprowadzić synchronizację co 24 godziny, aż do następnej zaplanowanej synchronizacji.

• Synchronizacja ignoruje użytkowników, którzy nie mają numeru telefonu.

• W Centrum partnerów można wyświetlić informacje o stanie synchronizacji dla danego klienta. Ponadto można wyeksportować szczegółowe informacje o ostatniej synchronizacji do rekordu CSV. Rekord CSV zawiera więcej szczegółów niż wyświetlacz Control Hub i może pomóc w rozwiązywaniu problemów, analizach i inspekcji.

• Webex przechowuje kontakty użytkowników w zaszyfrowanym formacie. Tylko użytkownik, który jest właścicielem kontaktu, ma dostęp do klucza deszyfrującego.

• Dla użytkowników wywołujących tylko BroadWorks i encji wywołujących innych użytkowników, ta funkcja synchronizuje następujące typy numerów telefonów z BroadWorks:

  • Podstawowy numer telefonu

  • Numer telefonu komórkowego

  • Numer wewnętrzny

  Jednak synchronizacja wyklucza z synchronizacji tylko użytkowników wywołujących BroadWorks i jednostki wywołujące inne niż użytkownicy, jeśli nie ma podstawowego numeru telefonu ani rozszerzenia.

  Ustawienie usługi prywatności na poziomie użytkownika środowiska BroadWorks nie jest obsługiwane w ramach synchronizacji katalogów.

Lista telefonów BroadWorks i maksymalne liczby kontaktów

Synchronizacja katalogów synchronizuje również wpisy listy telefonów BroadWorks z kontaktami Webex. Zsynchronizowane wpisy są dodawane do jednego z następujących typów kontaktów:

• Kontakty organizacji — Webex przechowuje te kontakty w organizacji. Każdy użytkownik może uzyskać dostęp do kontaktów organizacji dla swojej organizacji. Maksymalna liczba kontaktów wynosi 30 000.

• Kontakty użytkowników — Webex przechowuje te kontakty względem użytkownika. Tylko użytkownik, który jest właścicielem kontaktu, może uzyskać dostęp do wpisu kontaktu. Maksymalnie do 2000 kontaktów (1500 zsynchronizowanych kontaktów + 500 kontaktów ręcznego wprowadzania).

Poniższa tabela mapuje typy kontaktów Webex na źródło kontaktu (zsynchronizowane z listą telefonów BroadWorks lub dodane ręcznie):

Następujące warunki dotyczą sposobu, w jaki Synchronizacja katalogów obsługuje maksymalne kontakty:

• Jeśli organizacja przekroczy maksymalną dozwoloną liczbę kontaktów dla synchronizacji (30000 kontaktów organizacji lub 30000 wspólnych kontaktów grupowych na grupę), synchronizacja katalogów wyklucza pozycje powyżej maksymalnego progu. Nie ma określonej kolejności stosowanej do zsynchronizowanych lub pominiętych kontaktów.

• Jeśli jeden z Twoich klientów przekroczy maksymalną dozwoloną liczbę kontaktów w którejkolwiek z kategorii, zalecamy zgłoszenie sprawy do Cisco, aby wykluczyć tę organizację z synchronizacji katalogów.

• Kontakty ręczne to kontakty, które użytkownik dodaje ręcznie w aplikacji Webex. Użytkownik może dodać do 500 kontaktów ręcznych. Kontakty ręczne należą do większej kategorii kontaktów użytkownika w Webex, ale nie są uwzględniane w synchronizacji.

• Całkowity łączny limit kontaktów organizacji (30000) i kontaktów grupowych (30000 na grupę) wynosi 200000.

Aktualizacje

Poniżej opisano, w jaki sposób katalog Webex obsługuje aktualizacje:

• Jeśli nazwa kontaktu zmieni się w BroadWorks, istniejący kontakt zostanie usunięty z katalogu Webex i zostanie utworzony nowy kontakt.

• Jeśli numer kontaktowy zmieni się w BroadWorks, Webex zaktualizuje istniejący kontakt w katalogu Webex o nowy numer.

Po zaktualizowaniu kontaktu przez administratora w BroadWorks, następujące warunki określają, kiedy aktualizacja jest wyświetlana w aplikacji Webex użytkownika:

• Jeśli aktualizacja dotyczy tylko użytkownika wywołującego BroadWorks lub encji wywołującej nie-użytkownika, aktualizacja zostanie wyświetlona w aplikacji Webex użytkownika natychmiast po późniejszej synchronizacji katalogu.

• Jeśli aktualizacja dotyczy wpisu listy telefonów BroadWorks:

  • W przypadku kontaktów użytkownika — aktualizacje są wyświetlane w aplikacji Webex użytkownika natychmiast po późniejszej synchronizacji katalogu.

  • W przypadku kontaktów grupowych — aktualizacje są wyświetlane w aplikacji Webex użytkowników natychmiast po kolejnej synchronizacji katalogów.

  • W przypadku kontaktów organizacji — katalog Webex jest aktualizowany podczas późniejszej synchronizacji katalogów, ale użytkownicy nie zobaczą zmiany w aplikacji Webex, dopóki nie uruchomią ponownie aplikacji Webex lub nie wygaśnie lokalny 72-godzinny licznik czasu pamięci podręcznej.

Zalecamy korzystanie z następujących ustawień:

• Wartości graniczne szybkości — ustaw następujące właściwości systemu OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit — ustaw wartość null.

  • globalDirectoryTransactionLimit — ustaw wartość null.

  Zaleca się ustawienie userDirectoryTransactionLimit i globalDirectoryTransactionLimit na wartość null. Jeśli jednak zdecydujesz się przypisać wartości, każda z nich musi być ustawiona na co najmniej pięciokrotność wartości transactionLimitPeriodSeconds (która powinna wynosić 1).

• Limity transakcji — ustaw następujące wartości (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit — ustaw wartość co najmniej 100.

  • transactionLimitPeriodSecs — ustaw wartość 1.

• Wartości stronicowania — ustaw właściwości systemu stronicowania (interfejs wiersza polecenia XSP_/Aplikacje/Xsi-Actions/Stronicowanie):

  • defaultPageSize — ustaw wartość 50

  • availableUserMaxLimit — ustaw wartość 100

• Interfejs CTI — upewnij się, że certyfikaty Urzędu Certyfikacji Webex zostały przekazane do magazynu zaufania interfejsu CTI i włączono uwierzytelnianie klienta na interfejsie CTI.

Ponadto, w zależności od wersji BroadWorks, zalecamy zastosowanie następujących poprawek systemowych do wdrożenia BroadWorks przed włączeniem tej funkcji:

• Dla R22: AP.as.22.0.1123.ap368517

• Dla R23: AP.as.23.0.1075.ap368517

• Dla R24: nie wymaga poprawki

Administratorzy partnerscy mogą włączyć synchronizację katalogów dla szablonu klienta podczas tworzenia nowego szablonu. Wszystkie nowe organizacje klientów, które zostaną przypisane do tego szablonu, będą miały włączoną synchronizację katalogów. Aby uzyskać szczegółowe informacje, zobacz "Konfigurowanie szablonów klientów" w temacie Konfigurowanie organizacji partnerskiej w programie Partner Hub w Przewodniku po rozwiązaniach webex dla Cisco BroadWorks.

Co dalej

Upewnij się, że użytkownicy wiedzą, że muszą kliknąć kartę Kontakty w aplikacji Webex co najmniej raz, aby włączyć tę funkcję w aplikacji Webex. Należy to zrobić tylko raz.

Publiczne interfejsy API są dostępne w developer.webex.com , które umożliwiają administratorom partnerów aktualizowanie ustawień synchronizacji katalogów dla zarządzanych przez nich organizacji klientów, wyzwalanie natychmiastowej synchronizacji lub uzyskiwanie informacji o stanie synchronizacji. Metody synchronizacji katalogów są zgrupowane w BroadWorks Enterprises:

• Lista przedsiębiorstw BroadWorks — ta metoda API umożliwia uzyskanie listy przedsiębiorstw pod określonym dostawcą usług i identyfikatora każdego przedsiębiorstwa. Należy wprowadzić identyfikator spEnterpriseId przypisany w konfiguracji.

• Aktualizuj synchronizację katalogów dla przedsiębiorstwa BroadWorks — wprowadź identyfikator przedsiębiorstwa, aby zaktualizować stan syc katalogów dla tego przedsiębiorstwa, włączając lub wyłączając synchronizację katalogów.

• Uruchom synchronizację katalogów dla przedsiębiorstwa — użyj tej metody API, jeśli chcesz uruchomić natychmiastową synchronizację dla danego identyfikatora przedsiębiorstwa. W polu syncStatus wprowadź polecenie SYNC_NOW .

• Uzyskaj stan synchronizacji katalogów dla przedsiębiorstwa — wprowadź identyfikator przedsiębiorstwa i uruchom, aby uzyskać stan i trackingId najnowszej synchronizacji. Za pomocą identyfikatora trackingID można uruchomić dodatkową analizę za pośrednictwem narzędzi, takich jak Kibana i Grafana.

Ponadto administratorzy mogą używać funkcji Trigger Directory Sync for a Single User API do wyzwalania synchronizacji katalogów na żądanie dla jednego użytkownika.

Aby uzyskać szczegółową dokumentację interfejsu API, zobacz https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Musisz się zalogować, aby przeczytać specyfikację interfejsu API pod adresem https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Poniższe kody błędów dotyczą synchronizacji katalogów.

W poniższej tabeli podsumowano aktualizacje tego artykułu.