Prezentare generală a sincronizării directorului

Sincronizarea directorului asigură faptul că webex pentru Cisco BroadWorks utilizatorii pot utiliza directorul Webex pentru a apela orice entitate apelante de pe serverul BroadWorks. Când această caracteristică este activată, directorul complet de apelare de pe serverul BroadWorks este sincronizat cu directorul Webex. Utilizatorii pot accesa directorul din Webex App și pot efectua un apel către orice entitate apelantă de pe serverul BroadWorks.

Sincronizarea directorului include sincronizarea atât a informațiilor de apelare a utilizatorilor, cât și a listelor de telefoane. Înregistrările listei de telefoane sincronizate sunt scrise într-unul dintre cele două tipuri de persoane de contact din directorul Webex:

  • Persoane de contact de organizație - Aceste persoane de contact sunt stocate împotriva unei organizații și sunt disponibile pentru fiecare utilizator din organizație.

  • Persoane de contact utilizator - Aceste persoane de contact sunt stocate împotriva unui utilizator și sunt disponibile numai pentru utilizatorul care deține persoana de contact.


Asigurarea accesului Webex pentru Cisco BroadWorks include o sincronizare implicită a utilizatorilor de mesagerie și a informațiilor de apelare asociate acestora de pe serverul BroadWorks în directorul Webex. Cu toate acestea, sincronizarea implicită de asigurare a accesului omite utilizatorii care nu trimit mesaje și entitățile non-utilizator (de exemplu, un telefon din sala de conferințe, un fax sau un număr de grup de vânătoare). Activarea sincronizării directorului asigură adăugarea tuturor entităților apelante la directorul Webex.

Condiții de sincronizare a directorului

  • Administratorii partenerilor trebuie să activeză caracteristica la nivel de partener. Administratorii de parteneri pot activa sau dezactiva caracteristica pentru mai multe organizații de clienți într-o singură operațiune.

  • În mod implicit, sincronizarea inițială are loc la o săptămână după activarea sincronizării (ora aleasă pentru a porni sincronizarea este aleatorie). Cu toate acestea, organizațiile de clienți pot utiliza opțiunea Sincronizare acum pentru a ocoli perioada de așteptare de o săptămână și pentru a finaliza o sincronizare imediată pentru o anumită organizație de clienți.

  • În mod implicit, sincronizarea directorului se execută săptămânal pentru fiecare client. Fiecare sincronizare are loc la o săptămână după ultima sincronizare, indiferent dacă acea sincronizare a fost programată sau declanșată manual cu Sincronizare acum.

  • Dacă apare o eroare de sincronizare, sincronizarea este rettempted automat la fiecare 24 de ore până la următoarea sincronizare programată.

  • Sincronizarea ignoră utilizatorii care nu au un număr de telefon.

  • În Hubul pentru parteneri, puteți vizualiza informațiile despre starea sincronizării pentru un anumit client. În plus, puteți exporta informații detaliate despre ultima sincronizare într-o înregistrare CSV. Înregistrarea CSV este mai detaliată decât afișarea Centrului de control și poate ajuta la depanare, analiză și audit.

  • Persoanele de contact ale utilizatorilor sunt stocate într-un format criptat, numai utilizatorul care deține persoana de contact având acces la cheia de decriptare.

  • Această caracteristică sincronizează următoarele tipuri de liste de telefoane de pe serverul BroadWorks:

    • Liste de telefoane comune pentru întreprinderi

    • Liste de telefoane comune de grup

    • Liste de telefoane personale

Sincronizare director și maxime de contact

Iată numărul maxim de contacte pe care sincronizarea directorului le permite pentru fiecare tip de persoană de contact Webex:

  • 500 de persoane de contact ale organizației

  • 500 de persoane de contact ale utilizatorilor - Pentru un utilizator, maximul include contacte sincronizate ale utilizatorilor și persoane de contact manuale (persoane de contact pe care utilizatorul le adaugă manual prin intermediul aplicației Webex App)

Se aplică următoarele condiții:

  • Dacă o organizație are mai mult de 500 de persoane de contact în oricare dintre categorii, sincronizarea exclude intrările care depășesc pragul limită de 500. Nu există o anumită ordine aplicată persoanelor de contact sincronizate sau omise.

  • Dacă un utilizator adaugă manual persoane de contact pe Webex App, maximul persoanei de contact utilizator este determinat prin scăderea contactelor manuale din persoanele de contact sincronizate ale utilizatorilor. De exemplu, dacă un utilizator adaugă manual 100 de persoane de contact pe Webex App, sincronizarea directorului permite sincronizarea a până la 400 de persoane de contact de utilizator din BroadWorks pentru acel utilizator.

  • Vă recomandăm ca, dacă una dintre organizațiile de clienți are mai mult de 500 de persoane de contact în oricare dintre categorii, să se adreseze unui caz cu Cisco pentru ca organizația respectivă să fie exclusă din sincronizarea directorului.

Următorul tabel mapează tipurile de persoane de contact Webex la lista de telefoane BroadWorks din care se sincronizează înregistrările:

Tabelul 1. Tipuri de persoane de contact sincronizare director și sursă de sincronizare

Tip de persoană de contact Webex

Sincronizat de la BroadWorks ...

API utilizat pentru sincronizare

Persoane de contact ale organizației

Liste de telefoane comune pentru întreprinderi

/directories/enterprisecommon

Grupați liste de telefoane comune (în timp ce vă a aflați în modul furnizor de servicii)**

/directories/groupcommon

Contacte utilizator

Grup liste de telefoane comune (în timp ce în modul Enterprise)**

/directories/groupcommon

Liste de telefoane personale

/directories/personal


**Liste de telefoane comune de grup sunt sincronizate diferit, în funcție de faptul dacă BroadWorks este în modul Enterprise sau în modul Furnizor de servicii. Valoarea isBroadWorksEnterprise parametru (adevărat sau fals) determină modul în care lista se sincronizează:

  • True - Sincronizare ca persoană de contact din organizație

  • Fals - Sincronizare ca persoană de contact utilizator

Actualizări

După ce o persoană de contact este actualizată pe BroadWorks, următoarele schițe atunci când actualizarea se afișează în aplicația Webex a unui utilizator:

  • Actualizările contactelor organizației se afișează în Webex App după ce utilizatorul repornește Aplicația sau după expirarea cronometrului cache local de 72 de ore al aplicației.

  • Actualizările contactelor utilizatorilor se afișează imediat în Webex App pentru acel utilizator.

Iată cum gestionează directorul Webex actualizările:

  • Dacă numele persoanei de contact se modifică în BroadWorks, persoana de contact existentă este ștearsă din directorul Webex și se creează o persoană de contact nouă.

  • Dacă numărul de contact se modifică pe BroadWorks, persoana de contact existentă în directorul Webex este actualizată cu noul număr.

Cerințe preliminare pentru sincronizarea directorului

Cerințe de comutare

Următoarele comutatori de caracteristici există pentru această caracteristică. Asigurați-vă că contactați reprezentantul Webex pentru Cisco BroadWorks pentru a le seta.

Comutare caracteristică

Aplicat la...

Descripton

webex-for-broadworks-phone-list-sync

Partener

Comutare obligatorie. Permite sincronizarea listei de telefoane pentru toate organizațiile de clienți aflate sub acest partener.

Trebuie să fie activat.

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

Organizarea clienților

Comutare opțională. Dezactivează sincronizarea listei de telefoane pentru o anumită organizație, chiar dacă caracteristica este activată la nivel de partener și în șablonul de client.

Aplicați acest comutator numai dacă doriți să dezactivați sincronizarea listei de telefoane pentru o anumită organizație de clienți. În caz contrar, îl puteți lăsa dezactivat.


 
De exemplu, ar trebui să aplicați acest comutator oricărei organizații care necesită mai mult de 500 de persoane de contact.

hidden-personal-contacts-enabled-ga

Utilizator

Comutare opțională. Ascunde persoanele de contact personale din căutările în director finalizate de acest utilizator.

hidden-org-contacts-enabled-ga

Utilizator

Comutare opțională. Ascunde persoanele de contact ale organizației din căutările în director finalizate de acest utilizator.

Cerințe de preconfigurare

Vă recomandăm să utilizați următoarele setări:


Exemplele de mai jos presupun că utilizați un server XSP. Pentru serverele ADP, înlocuiți (XSP_CLI) cu (ADP_CLI).
  • Evaluați valorile de limitare a ratei - Setați următoarele proprietăți ale sistemului OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit - Setați la o valoare nulă.

    • globalDirectoryTransactionLimit - Setați la o valoare nulă.


    Se recomandă să setați userDirectoryTransactionLimit și globalDirectoryTransactionLimit la o valoare nulă. Cu toate acestea, dacă decideți să atribuiți valori, fiecare trebuie setat la cel puțin cinci ori valoarea transactionLimitPeriodSeconds (care ar trebui să fie 1).
  • Limite de tranzacții - Setați următoarele valori (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit - Setați la cel puțin 100.

    • transactionLimitPeriodSecs - Setați la 1.

  • Valori de paginare - Setați proprietățile sistemului de paginare (XSP_CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize - Setați la 50

    • availableUserMaxLimit - Setat la 100

  • Interfață CTI - Asigurați-vă că încărcați certificatele Ca Webex în depozitul de încredere al interfeței CTI și activați autentificarea clientului pe interfața CTI.

În plus, în funcție de lansarea BroadWorks, vă recomandăm să aplicați următoarele corecții de sistem la implementarea BroadWorks înainte de a activa această caracteristică:


Pentru lista completă a cerințelor de corecție care formează cerința minimă pentru Webex pentru Cisco BroadWorks, consultați Cerințele de software BroadWorks din Ghidul de soluții pentru Webex pentru CiscoBroadWorks.

Activare sincronizare director (șablon nou)

Administratorii parteneri pot activa Directory Sync pentru un șablon de client în timp ce creează noul șablon. Orice organizații client noi care sunt atribuite acelui șablon vor avea sincronizarea directorului activată. Pentru detalii, consultați "Configurați-vă șabloanele pentru clienți" din Configurarea organizației partenere în Hubul de parteneri din Ghidul de soluții pentruWebex pentru Cisco BroadWorks.

Ce trebuie să faceți în continuare

Asigurați-vă că utilizatorii știu că trebuie să facă clic pe fila Persoane de contact din Webex App cel puțin o dată pentru a activa caracteristica pe Webex App. Acest lucru trebuie să fie finalizat o singură dată.

Activare sincronizare director (șablon existent)

Administratorii de parteneri pot parcurge următorii pași pentru a activa Sincronizare director într-un șablon de client existent pentru a activa caracteristica pentru organizațiile client care utilizează șablonul.

1

Conectați-vă la Hubul pentru parteneri și alegeți Setări.

2

Defilați la BroadWorks Calling și faceți clic pe Vizualizare șabloane .

3

Selectați șablonul de client corespunzător și defilați la BroadWorks Directory Sync.

4

Pentru a activa sincronizarea directorului în mod implicit pentru noile organziații client care utilizează acest șablon:

  1. Setați Activarea BroadWorks Directory & Phone List Sync pentru toate organizațiile de clienți noi comutați la Activat .

  2. Faceți clic pe Salvare.

5

Pentru a activa sincronizarea directorului pentru organizațiile de clienți existente care utilizează acest șablon:

  1. Faceți clic pe Afișare listă de clienți stare sincronizare.

  2. Bifați casetele de selectare adiacente pentru fiecare organizație pentru care doriți să activați caracteristica.

  3. Faceți clic pe Activare sincronizare.


 

Dacă doriți să dezactivați sincronizarea directorului, urmați procedura de mai sus și:

  • În pasul 4a, setați Activați sincronizarea directorului telefonului pentru toate organizațiile de clienți noi comutați la Dezactivat pentru a dezactiva sincronizarea directorului în mod implicit pentru organizațiile de clienți noi care utilizează acest șablon.

  • În pasul 5c, faceți clic pe Dezactivare sincronizare pentru a dezactiva caracteristica pentru organizațiile existente.

Ce trebuie să faceți în continuare

Asigurați-vă că utilizatorii știu că trebuie să facă clic pe fila Persoane de contact din Webex App cel puțin o dată pentru a activa caracteristica pe Webex App. Acest lucru trebuie să fie finalizat o singură dată.

Sincronizare imediată completă

Opțiunea Sincronizare acum permite administratorului partener să finalizeze o sincronizare la cerere pentru o anumită organizație de clienți. Această opțiune poate fi selectată numai pentru organizațiile individuale de clienți - nu există nicio opțiune în bloc pentru Sincronizare acum.

1

Conectați-vă la Hubul pentru parteneri (http://admin.webex.com) și alegeți Setări.

2

Defilați la BroadWorks Calling și faceți clic pe Vizualizare șabloane .

3

Selectați șablonul de client corespunzător și defilați la BroadWorks Directory Sync.

4

Faceți clic pe Afișare listă de clienți stare sincronizare.

5

Pentru organizația client pe care doriți să o sincronizați, faceți clic pe cele trei puncte din extrema dreaptă și selectați Sincronizare acum.

6

Faceți clic pe Reîmprospătare pentru a vedea rezultatele sincronizării.

Exportul înregistrărilor de sincronizare în CSV

Administratorii parteneri pot exporta informații detaliate despre ultima sincronizare într-un fișier CSV. CSV-ul conține o vizualizare mai detaliată a înregistrării de sincronizare decât interfața grafică a Centrului de control și poate ajuta la depanare și analiză.

1

Conectați-vă la Hubul pentru parteneri (http://admin.webex.com) și alegeți Setări.

2

Defilați la BroadWorks Calling și faceți clic pe Vizualizare șabloane .

3

Selectați șablonul de client corespunzător și defilați la BroadWorks Directory Sync.

4

Faceți clic pe Afișare listă de clienți stare sincronizare.

5

Bifați casetele de selectare adiacente pentru fiecare organizație pe care doriți să o includeți în export.

6

Faceți clic pe Export rezultate.

API-uri publice pentru sincronizarea directorului

API-urile publice sunt disponibile pe developer.webex.com care permit administratorilor parteneri să actualizeze setările Directory Sync pentru organizațiile de clienți pe care le gestionează, să declanșeze o sincronizare imediată sau să obțină informații despre starea sincronizării. Metodele de sincronizare a directorului sunt grupate sub BroadWorks Enterprises. Există patru API-uri:

  • Lista BroadWorks Intreprinderi-Utilizați această metodă API pentru a obține o listă de întreprinderi în cadrul unui anumit furnizor de servicii și a fiecărei întreprinderi id. Trebuie să introduceți spEnterpriseId așa cum este atribuit în provizionare.

  • Actualizare Sincronizare director pentru o întreprindere BroadWorks- Introduceți întreprinderea id pentru a actualiza starea syc director pentru acea întreprindere, activarea sau dezactivarea sincronizare director.

  • Trigger Directory Sync pentru o întreprindere- Utilizați această metodă API dacă doriți să declanșați o sincronizare imediată pentru o anumită întreprindere id. Pentru syncStatus, introduceți SYNC_NOW comanda.

  • Obțineți starea de sincronizare a directorului pentru oîntreprindere - Introduceți întreprinderea id și a alerga în scopul de a obține un statut și trackingId a celei mai recente sincronizări. Puteți utiliza trackingID pentru a rula analize suplimentare prin instrumente precum Kibana și Grafana.

Pentru documentația API detaliată, consultați https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Trebuie să vă conectați pentru a citi specificațiile API la https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Sincronizarea mai multor întreprinderi cu API

Finalizați această procedură pentru a utiliza API-urile publice pentru a finaliza sincronizarea directorului pentru mai multe întreprinderi.

  • Sincronizarea directorului vă permite să sincronizați o singură întreprindere simultan. Dacă încercați să sincronizați mai multe întreprinderi, veți primi o eroare 429.

  • Timpul necesar pentru a finaliza o sincronizare pentru o singură întreprindere variază în funcție de dimensiunea întreprinderii.

1

Rulați API-ul Listă BroadWorks Enterprises pentru a genera o listă de întreprinderi pe care doriți să le sincronizați.

  1. Setați startWith la șirul de pornire al identificatorului de întreprindere sau furnizor de servicii.

  2. Faceți clic pe Executare.

2

Rulați Trigger Directory Sync pentru un API Enterprise pe prima întreprindere din listă.

  1. Introduceți id-ul de întreprindere .

  2. Setați syncStatus la SYNC_NOW

  3. Faceți clic pe Executare.

    Se declanșează o sincronizare imediată pentru întreprindere. Această sincronizare contează pentru o limită de sincronizare per instanță.
3

Așteptați câteva secunde, apoi rulați API-ul Get Directory Sync Status pentru a obține starea sincronizării.

  1. Introduceți ID-ul întreprinderii

  2. Faceți clic pe Executare.

4

După terminarea sincronizării, finalizați pașii de la 2 la 4 la următoarea întreprindere din listă. Repetați acești pași până când ați sincronizat întreaga listă.

Coduri de eroare pentru sincronizarea directorului

Următoarele coduri de eroare se aplică la Sincronizare director.

Cod de eroare

Mesaj de Eroare

600000

Broadworks External Directory User Sync eroare neașteptată.

600001

Broadworks External Directory User Sync nu a reușit.

600002

Broadworks External Directory User Sync a trebuit să fie reziliat înainte de finalizare.

600003

Broadworks External Directory User Sync doar parțial a reușit. Unele organizații de clienți nu au reușit să se sincronizeze.

600004

Broadworks External Directory User Sync nu este activată pentru ConfigSet.

600005

Broadworks External Directory User Sync este în curs de desfășurare pentru ConfigSet.

600006

Broadworks Externe Directory User Sync fire sunt ocupate sau închiderea, prin urmare, nu va accepta mai multe cerere de sincronizare, încercați din nou mai târziu.

600007

Org identitatea CustomerConfig nu este găsit.

600008

CustomerConfig nu se găsește în organizația parteneră.

600009

Broadworks External Directory User Sync nu poate fi rulat ca cluster broadworks asociate customerconfig este ocupat

600010

Broadworks External Directory User Sync nu se poate executa, deoarece nu există nici un cluster broadworks asociate cu CustomerConfig.

600011

Broadworks External Directory User Sync nu este activată pentru CustomerConfig.

600012

Broadworks External Directory User Sync nu poate fi rulat ca sincronizarea director hibrid este deja activat pentru CustomerConfig.

600013

Broadworks External Directory User Sync nu a reușit să adauge utilizatori și conturi de mașină la depozitul de identitate.

600014

Broadworks External Directory User Sync nu a reușit în timp ce încercați să vă conectați la cluster Broadworks. Eroare de la Broadworks - %s.

600015

Broadworks External Directory User Sync nu a găsit niciun utilizator potrivit în magazinul de identitate.

600017

BroadWorks Phone List Sync nu a reușit să sincronizeze toate persoanele de contact utilizator și întreprindere/organizație.

600018

BroadWorks Lista de telefon sincronizare nu a reușit pentru utilizatorii din întreprindere/organizație.

600019

BroadWorks Phone List Sync nu a reușit să sincronizeze persoanele de contact întreprindere/organizație.