- Pagină de pornire
- /
- Articol
Sincronizarea directorului în Webex pentru Cisco BroadWorks
Acest articol descrie modul de implementare a sincronizării directorului în Webex pentru Cisco BroadWorks. Articolul este destinat administratorilor furnizorilor de servicii din organizațiile partenere.
Prezentare generală Sincronizare director
Sincronizarea directorului asigură faptul că utilizatorii Webex pentru Cisco BroadWorks pot utiliza directorul Webex din aplicația Webex pentru a apela orice entitate apelantă de pe serverul BroadWorks. Această caracteristică sincronizează informațiile de apelare BroadWorks care nu făceau parte din configurarea utilizatorului în directorul Webex.
Configurarea utilizatorilor Webex pentru Cisco BroadWorks actualizează directorul Webex cu detalii de apelare pentru utilizatorii Webex pentru Cisco BroadWorks (număr de telefon principal, număr de telefon mobil, extensie), dar omite înregistrările de apelare externe. Cu toate acestea, atunci când sincronizarea directorului este activată, caracteristica sincronizează, de asemenea, următoarele înregistrări de apelare în directorul Webex.
Utilizatori care apelează numai BroadWorks (care nu sunt integrați în Webex)
Entități de apelare non-utilizator (de exemplu, telefon în sala de conferințe, fax, număr grup de hunt)
Intrări în lista de telefoane BroadWorks
Următorul tabel rezumă înregistrările de apelare BroadWorks și arată modul în care acestea sunt adăugate în directorul Webex.
Înregistrări apelare BroadWorks | Descriere | Adăugat la Webex Directory prin... |
---|---|---|
Webex pentru utilizatorii Cisco BroadWorks | Utilizatorii sunt activați pentru Webex pentru Cisco BroadWorks | Configurarea utilizatorului (de exemplu, configurarea prin flux) |
Utilizatori care apelează numai BroadWorks | Utilizatori care nu sunt înscriși în Webex | Sincronizare cu directorul |
Entități de apelare non-utilizator | De exemplu, un telefon în sala de conferințe, un fax, un număr de grup de hunt | Sincronizare cu directorul |
Listele telefonice BroadWorks | Intrări pe lista de telefon BroadWorks:
| Sincronizare director (sincronizare listă telefon) |
Condiții de sincronizare a directorului
Administratorii parteneri trebuie să activeze funcția la nivelul partenerului. Administratorii parteneri pot activa sau dezactiva funcția pentru mai multe organizații ale clienților într-o singură operațiune.
În mod implicit, sincronizarea inițială are loc la o săptămână după activarea sincronizării (timpul ales pentru a începe sincronizarea este aleatoriu). Cu toate acestea, organizațiile clienților pot utiliza opțiunea Sync Now pentru a ocoli perioada de așteptare de o săptămână și pentru a declanșa o sincronizare imediată pentru o anumită organizație client.
În mod implicit, Directory Sync rulează săptămânal pentru fiecare client. Fiecare sincronizare are loc la o săptămână după ultima sincronizare, indiferent dacă ultima sincronizare a fost programată sau declanșată manual cu Sync Now.
Numărul maxim de sincronizări simultane per cluster BroadWorks este de două: o sincronizare programată și una la cerere (prin API sau Partner Hub GUI). Cu toate acestea, administratorii nu pot rula două sincronizări la cerere în același timp din același BroadWorks. Această restricție există indiferent dacă sincronizarea a fost inițiată prin API sau prin opțiunea Sync Now din Partner Hub. În plus, Webex nu va programa două sincronizări programate pentru a rula în același timp din același BroadWorks.
Dacă apare o eroare de sincronizare, Webex reîncearcă automat sincronizarea la fiecare 24 de ore până la următoarea sincronizare programată.
Sincronizarea ignoră utilizatorii care nu au un număr de telefon.
În Partner Hub, puteți vizualiza informațiile de stare de sincronizare pentru un anumit client. În plus, puteți exporta informații detaliate despre ultima sincronizare într-o înregistrare CSV. Înregistrarea CSV oferă mai multe detalii decât afișajul Control Hub și poate ajuta la depanare, analiză și audit.
Webex stochează contactele de utilizator într-un format criptat. Numai utilizatorul care deține contactul are acces la cheia de decriptare.
Pentru utilizatorii care apelează numai BroadWorks și entitățile care nu apelează utilizatori, această caracteristică sincronizează următoarele tipuri de numere de telefon din BroadWorks:
Număr de telefon principal
Număr de telefon mobil
Extensie
Cu toate acestea, sincronizarea exclude utilizatorii de apelare numai BroadWorks și entitățile de apelare non-utilizator din sincronizare dacă nu există niciun număr de telefon principal sau o extensie.
Setarea serviciului de confidențialitate BroadWorks la nivel de utilizator nu este acceptată ca parte a sincronizării directorului.
Listă de telefoane BroadWorks și Maximum de contacte
Sincronizarea directorului sincronizează, de asemenea, intrările din lista de telefon BroadWorks în Webex Contacts. Intrările sincronizate sunt adăugate la unul dintre următoarele tipuri de contacte:
Contacte organizație – Webex stochează aceste contacte împotriva unei organizații. Fiecare utilizator poate accesa contactele organizației pentru organizația lor. Maximul este de până la 30.000 de contacte.
Contacte utilizator – Webex stochează aceste contacte împotriva unui utilizator. Numai utilizatorul care deține contactul poate accesa intrarea de contact. Maximul este de până la 2000 contacte (1500 contacte sincronizate + 500 contacte de intrare manuală).
Următoarele hărți de masă ale tipurilor de contact Webex împotriva sursei de contact (sincronizate dintr-o listă de telefon BroadWorks sau adăugate manual):
Tip contact Webex | Sursă contact | Maximum | Sincronizat din BroadWorks... | API utilizat pentru sincronizare |
---|---|---|---|---|
Contacte organizație | Sincronizare cu directorul | 30.000 de contacte | Listele telefonice comune ale întreprinderii |
|
Listele telefonice comune ale grupului (pentru un grup de furnizori de servicii)** |
| |||
Contacte utilizator | Sincronizare cu directorul | 1500 contacte | Listele telefonice personale | /directories/personal |
Adăugat manual de către utilizator | 500 contacte | Nu este cazul | Nu este cazul | |
Contacte de grup | Sincronizare cu directorul | 30.000 de contacte per grup | Listele telefonice comune ale grupului (pentru un grup de întreprinderi)** | /directories/groupcommon |
**Intrările din listele de telefon comune ale grupului se sincronizează diferit, în funcție de dacă BroadWorks se află în modul Enterprise sau în modul Furnizor de servicii. Valoarea isBroadWorksEnterprise
parametrul (adevărat sau fals) determină modul în care lista se sincronizează:
Adevărat – Sincronizare ca contact de grup
Falsă – Sincronizare ca contact organizație
Următoarele condiții se aplică în ceea ce privește modul în care Directory Sync gestionează maximele de contact:
Dacă o organizație depășește contactele maxime permise pentru sincronizare (30 000 de contacte ale organizației sau 30 000 de contacte comune ale grupului per grup), sincronizarea directorului exclude intrările peste pragul maxim. Nu există o comandă specială aplicată contactelor sincronizate sau omise.
Dacă unul dintre clienții dvs. depășește numărul maxim permis de contacte din oricare categorie, vă recomandăm să ridicați un caz cu Cisco pentru ca organizația respectivă să fie exclusă din sincronizarea directorului.
Contactele manuale sunt contacte pe care un utilizator le adaugă manual în Aplicația Webex. Un utilizator poate adăuga până la 500 de contacte manuale. Contactele manuale se încadrează în categoria mai mare de contacte de utilizator din Webex, dar nu sunt incluse în sincronizare.
Limita globală combinată pentru contactele organizaționale (30 000) și contactele de grup (30 000 pe grup) este de 200000.
Actualizări
Urmează modul în care directorul Webex gestionează actualizările:
Dacă numele contactului se schimbă în BroadWorks, contactul existent este șters din directorul Webex și se creează un nou contact.
Dacă numărul de contact se schimbă în BroadWorks, Webex actualizează contactul existent în directorul Webex cu noul număr.
După ce un administrator actualizează un contact pe BroadWorks, următoarele condiții sunt afișate atunci când actualizarea se afișează în Aplicația Webex a unui utilizator:
Dacă actualizarea se adresează unui utilizator de apelare numai BroadWorks sau unei entități de apelare non-utilizator, actualizarea se afișează în Aplicația Webex a unui utilizator imediat după sincronizarea directorului ulterior.
Dacă actualizarea este la o intrare în lista de telefon BroadWorks:
Pentru contactele de utilizator – Actualizările se afișează în Aplicația Webex a utilizatorului imediat după sincronizarea directorului ulterior.
Pentru contactele de grup - Actualizările se afișează în utilizatorii Aplicației Webex imediat după sincronizarea ulterioară a directorului.
Pentru contactele organizației – directorul Webex este actualizat la sincronizarea ulterioară a directorului, dar utilizatorii nu vor vedea modificarea Aplicației Webex până când nu repornesc Aplicația Webex sau până când expiră sincronizatorul local de cache de 72 de ore.
Cerințe prealabile de sincronizare a directorului
Vă recomandăm să utilizați următoarele setări:
Valori de limitare a ratei – Setați următoarele proprietăți ale sistemului OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
utilizator DirectoryTransactionLimit—Setați la o valoare nulă.
Global DirectoryTransactionLimit—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ă alocați valori, fiecare trebuie să fie setat la cel puțin cinci ori valoarea tranzacțiilorPeriodSecunde (care ar trebui să fie 1).Limite de tranzacție – Setați următoarele valori (XSP_CLI/System/CommunicationUtility/DefaultSettings):
UserTransactionLimit—Setați la cel puțin 100.
tranzactionLimitPeriodSecs – Setat la 1.
Valori de Pagare – Setați proprietățile sistemului de Pagare (XSP_CLI/Applications/Xsi-Actions/Paging):
Dimensiunea implicită a paginii – setată la 50
disponibilUserMaxLimit—Setat la 100
Interfața CTI – Asigurați-vă că încărcați certificatele CA Webex în magazinul de încredere pentru interfața CTI și că activați autentificarea clientului pe interfața CTI.
În plus, în funcție de versiunea BroadWorks, vă recomandăm să aplicați următorii plasturi de sistem la implementarea BroadWorks înainte de a activa această funcție:
Pentru R22:
AP.as.22.0.1123.ap368517
Pentru R23:
AP.as.23.0.1075.ap368517
Pentru R24: nu este necesar niciun plasture
Activați sincronizarea directorului (șablon nou)
Administratorii parteneri pot activa Sincronizarea directorului pentru un șablon pentru clienți, creând în același timp noul șablon. Orice organizații de clienți noi care sunt atribuite acestui șablon vor avea activată sincronizarea directorului. Pentru detalii, consultați „Configurați-vă șabloanele pentru clienți” din Configurați-vă organizația parteneră în Hub-ul partenerului din Ghidul soluției pentru Webex pentru Cisco BroadWorks.
Ce trebuie făcut în continuare
Asigurați-vă că utilizatorii dvs. știu că trebuie să facă clic pe fila Contacte din Aplicația Webex cel puțin o dată pentru a activa caracteristica din Aplicația Webex. Acest lucru trebuie finalizat o singură dată.
Activați sincronizarea directorului (șablon existent)
1 | Conectați-vă la Partner Hub și alegeți Setări. |
2 | Derulați la BroadWorks Calling și faceți clic pe Vizualizare șabloane. |
3 | Selectați șablonul corespunzător al clientului și defilați la BroadWorks Directory Sync. |
4 | Pentru a activa sincronizarea implicită a directorului pentru noile organizări ale clienților care utilizează acest șablon: |
5 | Pentru a activa sincronizarea directorului pentru organizațiile client existente care utilizează acest șablon: Dacă doriți să dezactivați sincronizarea directorului, urmați procedura de mai sus și:
|
Ce este de făcut în continuare
Asigurați-vă că utilizatorii dvs. știu că trebuie să facă clic pe fila Contacte din Aplicația Webex cel puțin o dată pentru a activa caracteristica din Aplicația Webex. Acest lucru trebuie finalizat o singură dată.
Declanșare sincronizare imediată
1 | Conectați-vă la Partner Hub ( http://admin.webex.com) și alegeți Setări. |
2 | Derulați la BroadWorks Calling și faceți clic pe Vizualizare șabloane. |
3 | Selectați șablonul corespunzător al clientului și defilați la BroadWorks Directory Sync. |
4 | Faceți clic pe Afișați lista de stare de sincronizare a clienților. |
5 | Pentru organizația client pe care doriți să o sincronizați, faceți clic pe cele trei puncte din dreapta și selectați Sincronizare acum. |
6 | Faceți clic pe Reîmprospătare pentru a vedea rezultatele sincronizării. |
Exportați înregistrări de sincronizare în CSV
1 | Conectați-vă la Partner Hub ( http://admin.webex.com) și alegeți Setări. |
2 | Derulați la BroadWorks Calling și faceți clic pe Vizualizare șabloane. |
3 | Selectați șablonul corespunzător al clientului și defilați la BroadWorks Directory Sync. |
4 | Faceți clic pe Afișați lista de stare de sincronizare a clienților. |
5 | Verificați casetele de selectare adiacente pentru fiecare organizație pe care doriți să o includeți în export. |
6 | Faceți clic pe Exportați rezultatele. |
API-uri publice pentru sincronizarea directoarelor
API-urile publice sunt disponibile pe developer.webex.com care permit administratorilor parteneri să actualizeze setările de sincronizare a directorului pentru organizațiile client 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 în cadrul BroadWorks Enterprises:
List BroadWorks Enterprises—Utilizați această metodă API pentru a obține o listă de întreprinderi în cadrul unui anumit Furnizor de servicii și al fiecărei întreprinderi
id
. Trebuie să introduceţispEnterpriseId
după cum s-a alocat în configurare.Actualizați sincronizarea directorului pentru o întreprindere BroadWorks—Introduceți întreprinderea
id
pentru a actualiza starea sistemului directorului pentru acea întreprindere, activând sau dezactivând sincronizarea directorului.Sincronizare director de declanșare pentru o întreprindere—Utilizați această metodă API dacă doriți să declanșați o sincronizare imediată pentru o anumită întreprindere
id
. PentrusyncStatus
, introducețiSYNC_NOW
comandă.Obțineți starea de sincronizare a directorului pentru o întreprindere—Introduceți întreprinderea
id
și rula pentru a obține un statut șitrackingId
din cea mai recentă sincronizare. Puteți utilizatrackingID
să ruleze analize suplimentare prin instrumente precum Kibana și Grafana.
În plus, administratorii pot utiliza Trigger Directory Sync pentru un API cu un singur utilizator pentru a declanșa o sincronizare a directorului la cerere pentru un singur utilizator.
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ția API la https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Sincronizarea mai multor întreprinderi cu API
Sincronizarea directorului vă permite să sincronizați doar o singură întreprindere dintr-un cluster Broadworks la un moment dat printr-o sincronizare la cerere. Dacă încercați să sincronizați mai multe întreprinderi, veți primi o eroare de 429
Timpul necesar pentru a declanșa 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. |
2 | Rulați Sincronizarea directorului de declanșare pentru un API Enterprise pe prima întreprindere din listă. |
3 | Așteptați câteva secunde și apoi rulați API-ul Get Directory Sync Status pentru a obține starea de sincronizare. |
4 | După finalizarea sincronizării, finalizați pașii 2-4 pe 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ă sincronizării directorului.
Cod de eroare | Mesaj de Eroare |
---|---|
600000 | Eroare neaşteptată Sincronizare utilizator director extern Broadworks. |
600001 | Sincronizare utilizator de director extern Broadworks nereușită. |
600002 | Sincronizarea utilizatorului de director extern Broadworks a trebuit să fie încheiată înainte de finalizare. |
600003 | Sincronizarea utilizatorului de director extern Broadworks a reușit parțial. Anumite organizații ale clientului nu au putut fi sincronizate. |
600004 | Sincronizarea utilizatorului de director extern Broadworks nu este activată pentru setul de configurare. |
600005 | Sincronizarea utilizatorului de director extern Broadworks este în curs pentru setul de configurare. |
600006 | Șirurile de sincronizare a utilizatorului de director extern Broadworks sunt ocupate sau se opresc și deci nu vor accepta alte solicitări de sincronizare; încercați din nou mai târziu. |
600007 | Nu a fost găsită identitatea organizației în configurația de client. |
600008 | Configuraţia de client nu a fost găsită în organizaţia parteneră. |
600009 | Sincronizarea utilizatorilor directorului extern Broadworks nu poate fi rulată deoarece clusterul Broadworks asociat cu CustomerConfig este ocupat |
600010 | Sincronizarea utilizatorului de director extern Broadworks nu poate fi efectuată deoarece nu există niciun cluster broadworks asociat configurației de client. |
600011 | Sincronizarea utilizatorului de director extern Broadworks nu este activată pentru configurația de client. |
600012 | Sincronizarea utilizatorului de director extern Broadworks nu poate fi rulată deoarece sincronizarea directoarelor hibride este deja activată pentru configuraţia clientului. |
600013 | Sincronizarea utilizatorului de director extern Broadworks nu a putut adăuga utilizatori și conturi de dispozitive în memoria de identități. |
600014 | Sincronizarea utilizatorului de director extern Broadworks a eşuat în timp ce încerca să se conecteze la clusterul Broadworks. Eroare de la Broadworks - %s. |
600015 | Sincronizarea utilizatorului de director extern Broadworks nu a găsit niciun utilizator potrivit în memoria de identităţi. |
600017 | Sincronizarea listei de telefon BroadWorks nu a reușit să sincronizeze toate contactele de utilizator și de întreprindere/organizație. |
600018 | Sincronizarea listei de telefon BroadWorks a eșuat pentru utilizatorii din întreprindere/organizație. |
600019 | Sincronizarea listei de telefon BroadWorks nu a reușit să sincronizeze contactele de întreprindere/organizație. |
600020 | Sincronizarea utilizatorilor directorului extern BroadWorks nu poate fi dezactivată deoarece sincronizarea CustomerConfig este în curs. |
600022 | Sincronizarea cu un singur utilizator a directorului extern BroadWorks nu este posibilă deoarece întreprinderea nu are niciun utilizator configurat. |
600023 | Sincronizarea cu un singur utilizator a directorului extern BroadWorks nu este posibilă deoarece utilizatorul există deja în această organizație. |
600024 | Sincronizarea cu un singur utilizator a directorului extern BroadWorks nu este posibilă deoarece nu s-a găsit niciun utilizator care să corespundă în BroadWorks. |
600025 | Sincronizarea utilizatorilor directorului extern BroadWorks nu a reușit să actualizeze contul de utilizator din CI. |
600026 | Sincronizarea utilizatorilor directorului extern BroadWorks nu a reușit să actualizeze contul utilajului în CI. |
600027 | Sincronizarea cu un singur utilizator a directorului extern BroadWorks nu este posibilă deoarece au fost găsiți mai mulți utilizatori în BroadWorks. |
600028 | Sincronizarea cu un singur utilizator a directorului extern BroadWorks nu este posibilă deoarece ar fi trebuit finalizată cel puțin o sincronizare a directorului întreprinderii. |
600029 | Nu s-a reușit sincronizarea utilizatorului BroadWorks External Directory, deoarece organizația nu are configurat niciun utilizator. |
Schimbați istoricul
Următorul tabel sintetizează actualizările acestui articol.
Dată | Revizuire |
---|---|
14 februarie 2023 | S-a actualizat secțiunea Maximum Sync Directory și Sursa . |
10 decembrie 2022 | A actualizat termenul Sincronizare imediată completă pentru a declanșa sincronizarea directorului |
19 iulie 2022 | Clarificări și corecții ale informațiilor de prezentare generală:
|
9 mai 2022 |
|
07 aprilie 2022 |
|
28 martie 2022 |
|
24 martie 2022 | S-a adăugat lista tipurilor de numere de telefon sincronizate la Condițiile de sincronizare a directorului. Sincronizarea include acum numere de telefon mobil. |
16 martie 2022 |
|
17 decembrie 2021 |
|
16 decembrie 2021 |
|
08 decembrie 2021 |
|