- Pagină de pornire
- /
- Articol
Sincronizarea directorului în Webex pentru Cisco BroadWorks
Acest articol descrie cum se implementează Sincronizare director în Webex pentru Cisco BroadWorks. Articolul este destinat administratorilor furnizorilor de servicii din cadrul organizațiilor partenere.
Prezentare generală a sincronizării directorului
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 au făcut parte din asigurarea accesului utilizatorilor în directorul Webex.
Webex pentru Cisco BroadWorks, care asigură asigurarea accesului utilizatorilor, 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 apelurilor externe. Cu toate acestea, atunci când sincronizarea directorului este activată, caracteristica sincronizează, de asemenea, următoarele înregistrări de apelare în directorul Webex.
-
Apelarea exclusivă a utilizatorilor BroadWorks (care nu sunt înscriși pe Webex)
-
Entități care nu apelează utilizatori (de exemplu, un telefon din sala de conferințe, un fax, un număr de grup de vânătoare)
-
Intrările din lista de telefoane BroadWorks
Următorul tabel rezumă înregistrările de apelare BroadWorks și arată cum se adaugă acestea în directorul Webex.
Înregistrări de apelare BroadWorks |
Descriere |
Adăugat la Directorul Webex prin... |
---|---|---|
Webex pentru utilizatorii Cisco BroadWorks |
Utilizatorii sunt activați pentru Webex pentru Cisco BroadWorks |
Asigurarea accesului utilizatorilor (de exemplu, asigurarea accesului prin flux) |
Apelarea exclusivă a utilizatorilor BroadWorks |
Apelarea utilizatorilor care nu sunt înscriși pe Webex |
Sincronizare director |
Entități apelante non-utilizator |
De exemplu, un telefon în sala de conferințe, fax, numărul grupului Hunt |
Sincronizare director |
Liste de telefoane BroadWorks |
Intrările din lista de telefon BroadWorks:
|
Sincronizare director (sincronizare listă telefon) |
Condiții de sincronizare a directorului
-
Administratorii parteneri trebuie să activeze caracteristica la nivel de partener. Administratorii 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 aleatoare). Cu toate acestea, organizațiile clienților pot utiliza opțiunea Sync No w 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, 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ă ultima sincronizare a fost programată sau declanșată manual cu Sincronizare acum.
-
Numărul maxim de sincronizări simultane per cluster BroadWorks este de două: o sincronizare programată și o sincronizare la cerere (prin API sau GUI pentru hub-ul pentru parteneri). Cu toate acestea, administratorii nu pot executa 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 Sincronizare acum din Hubul pentru parteneri. Î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 reattemptează 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 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 oferă mai multe detalii decât afișajul Control Hub și vă poate ajuta la depanare, analiză și auditare.
-
Webex stochează contactele utilizatorilor într-un format criptat. Numai utilizatorul care deține persoana de contact are acces la cheia de decriptare.
-
Pentru utilizatorii de apelare numai BroadWorks și entitățile de apelare non-utilizator, această caracteristică sincronizează următoarele tipuri de numere de telefon din BroadWorks:
-
Număr de telefon principal
-
Numărul de telefon mobil
-
Extindere
Cu toate acestea, sincronizarea exclude utilizatorii care apelează numai BroadWorks și entitățile de apelare non-utilizator din sincronizare dacă nu există nici un 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.
-
Lista de telefoane BroadWorks și maximele de contact
Sincronizarea directorului sincronizează, de asemenea, intrările din lista de telefoane BroadWorks cu Persoanele de contact Webex. Intrările sincronizate sunt adăugate la unul dintre următoarele tipuri de persoane de contact:
-
Persoane de contact ale organizației - Webex stochează aceste persoane de contact împotriva unei organizații. Fiecare utilizator poate accesa persoanele de contact ale organizației pentru organizația sa. Maximul este de până la 30.000 de contacte.
-
Persoane de contact ale utilizatorilor - Webex stochează aceste persoane de contact împotriva unui utilizator. Numai utilizatorul care deține persoana de contact poate accesa intrarea de contact. Maximul este de până la 2000 de contacte (1500 de contacte sincronizate + 500 de contacte de intrare manuală).
Următorul tabel mapează tipurile de persoane de contact Webex cu sursa de contact (sincronizate dintr-o listă de telefoane BroadWorks sau adăugate manual):
Tip de contact Webex |
Sursă de contact |
Maximum |
Sincronizate de la BroadWorks ... |
API-ul utilizat pentru sincronizare |
---|---|---|---|---|
Persoane de contact ale organizației |
Sincronizare director |
30.000 de contacte |
Liste de telefoane comune pentru întreprinderi |
|
Gruparea listelor telefonice comune (pentru un grup de furnizori de servicii)** |
| |||
Persoanele de contact ale utilizatorilor |
Sincronizare director |
1500 de persoane de contact |
Liste de telefon personal | /directoare/personal |
Adăugat manual de utilizator |
500 de contacte |
Nu este cazul |
Nu este cazul | |
Contacte de grup |
Sincronizare cu directorul |
30.000 de contacte per grup |
Gruparea listelor de telefoane comune (pentru un grup Enterprise)** | /directoare/grupcomun |
**Intrările din listele de telefon comune de grup se sincronizează diferit, în funcție de faptul dacă BroadWorks este în modul Enterprise sau în modul Furnizor de servicii. Valoarea parametrului isBroadWorksEnterprise
(adevărat sau fals) determină modul în care lista se sincronizează:
-
Adevărat – Sincronizare ca contact de grup
-
Fals - Sincronizarea ca persoană de contact a organizației
Următoarele condiții se aplică în jurul modului în care Sincronizare director tratează 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 anumită ordine aplicată persoanelor de contact sincronizate sau omise.
-
Dacă unul dintre clienți depășește numărul maxim permis de contacte din oricare dintre categorii, vă recomandăm să ridicați un caz cu Cisco pentru ca organizația respectivă să fie exclusă de la sincronizarea directorului.
-
Persoanele de contact manuale sunt persoane de contact pe care un utilizator le adaugă manual în aplicația Webex. Un utilizator poate adăuga până la 500 de contacte manuale. Persoanele de contact manuale se încadrează în categoria mai mare de persoane de contact ale utilizatorului de pe 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
Iată cum gestionează directorul Webex actualizările:
-
Dacă numele persoanei de contact se modifică pe BroadWorks, persoana de contact existentă este ștearsă din directorul Webex și se creează o nouă persoană de contact.
-
Dacă numărul de contact se modifică pe BroadWorks, Webex actualizează persoana de contact existentă în directorul Webex cu noul număr.
După ce un administrator actualizează o persoană de contact pe BroadWorks, se conturează următoarele condiții atunci când actualizarea se afișează în aplicația Webex a unui utilizator:
-
Dacă actualizarea este la un utilizator apelant doar BroadWorks sau la o entitate apelantă non-utilizator, actualizarea se afișează în aplicația Webex a unui utilizator imediat după sincronizarea ulterioară a directorului.
-
Dacă actualizarea este la o intrare listă de telefon BroadWorks:
-
Pentru persoanele de contact ale utilizatorilor - Actualizările se afișează în aplicația Webex a utilizatorului imediat după sincronizarea ulterioară a directorului.
-
Pentru contactele de grup - Actualizările se afișează în utilizatorii Aplicației Webex imediat după sincronizarea ulterioară a directorului.
-
Pentru persoanele de contact din organizație - directorul Webex este actualizat la sincronizarea ulterioară a directorului, dar utilizatorii nu vor vedea modificarea în aplicația Webex până când nu repornesc aplicația Webex sau până când expiră cronometrul cache local de 72 de ore.
-
Cerințe preliminare pentru sincronizarea directorului
Vă recomandăm să utilizați următoarele setări:
-
Evaluați valorile limită — 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 Webex CA în magazinul 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 R22:
AP.as.22.0.1123.ap368517
-
Pentru R23:
AP.as.23.0.1075.ap368517
-
Pentru R24: nu este necesar un plasture
Activați sincronizarea directorului (șablon nou)
Administratorii parteneri pot activa Sincronizare director pentru un șablon de client în timp ce creați noul șablon. Orice organizații client noi care sunt atribuite acelui șablon vor avea activată sincronizarea directorului. Pentru detalii, consultați "Configurarea șabloanelor de client" în Configurarea organizației partenere în Hubul pentru parteneri din Ghidul de soluții pentru Webex 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 aplicația Webex cel puțin o dată pentru a activa caracteristica în aplicația Webex. Acest lucru trebuie finalizat o singură dată.
Activare sincronizare director (șablon existent)
1 |
Conectați-vă la Hubul pentru parteneri și alegeți Setări. |
2 |
Defilați la Apelare BroadWorks și faceți clic pe Vizualizare șabloane. |
3 |
Selectați șablonul de client corespunzător și defilați la Sincronizare directorBroadWorks. |
4 |
Pentru a activa sincronizarea directorului în mod implicit pentru organziații client noi care utilizează acest șablon: |
5 |
Pentru a activa sincronizarea directorului pentru organizațiile de clienți existente care utilizează acest șablon: Dacă doriți să dezactivați sincronizarea directorului, urmați procedura de mai sus și:
|
Ce trebuie să faceți în continuare
Asigurați-vă că utilizatorii știu că trebuie să facă clic pe fila Persoane de contact din aplicația Webex cel puțin o dată pentru a activa caracteristica în 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 |
Defilați la Apelare BroadWorks și faceți clic pe Vizualizare șabloane. |
3 |
Selectați șablonul de client corespunzător și defilați la Sincronizare directorBroadWorks. |
4 |
Faceți clic pe Afișare listă de clienți starede sincronizare. |
5 |
Pentru organizația de clienți 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
1 |
Conectați-vă la Partner Hub ( http://admin.webex.com) și alegeți Setări. |
2 |
Defilați la Apelare BroadWorks și faceți clic pe Vizualizare șabloane. |
3 |
Selectați șablonul de client corespunzător și defilați la Sincronizare directorBroadWorks. |
4 |
Faceți clic pe Afișare listă de clienți starede 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 sincronizare director
API-urile publice sunt disponibile pe developer.webex.com care permit administratorilor parteneri să actualizeze setările de sincronizare director 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 sub BroadWorks Enterprises:
-
Listați întreprinderile BroadWorks—Utilizați această metodă API pentru a obține o listă de întreprinderi de la un anumit Furnizor de servicii și
ID-ul
fiecărei întreprinderi. Trebuie să introducețispEnterpriseId
așa cum a fost alocat în configurare. -
Actualizați sincronizarea directorului pentru o întreprindere BroadWorks—Introduceți
id-ul
întreprinderii pentru a actualiza starea sincronizării directorului pentru acea întreprindere, activând sau dezactivând sincronizarea directorului. -
Declanșați sincronizarea directorului pentru o întreprindere—Utilizați această metodă API dacă doriți să declanșați o sincronizare imediată pentru un anumit
id
de întreprindere. PentrusyncStatus
, introduceți comandaSYNC_NOW
. -
Obțineți starea sincronizării directorului pentru o întreprindere — Introduceți
ID-ul întreprinderii
și rulați pentru a obține o stare și unID de urmărire
ale celei mai recente sincronizări. Puteți utilizaID-ul de urmărire
pentru a rula statistici suplimentare prin intermediul unor instrumente precum Kibana și Grafana.
În plus, administratorii pot utiliza Trigger Directory Sync pentru un SINGUR UTILIZATOR API pentru a declanșa o sincronizare de director 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 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 |
Executați Trigger Directory Sync pentru un API enterprise pe prima întreprindere din listă. |
3 |
Așteptați câteva secunde, apoi rulați API-ul Obțineți starea sincronizării directorului pentru a obține starea de sincronizare. |
4 |
După terminarea sincronizării, parcurgeți pașii de la 2 la 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ă la Sincronizare director.
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 |
Broadworks External Directory User Sync nu se poate executa ca cluster broadworks asociate 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 telefoane BroadWorks nu a reușit să sincronizeze toate persoanele de contact ale utilizatorilor și ale întreprinderii/organizației. |
600018 |
Sincronizarea listei de telefoane BroadWorks nu a reușit pentru utilizatorii din întreprindere/organizație. |
600019 |
Sincronizarea listei de telefoane BroadWorks nu a reușit să sincronizeze persoanele de contact de întreprindere/organizație. |
600020 |
BroadWorks External Directory User Sync nu poate fi dezactivată, deoarece sincronizarea CustomerConfig este în curs de desfășurare. |
600022 |
BroadWorks External Directory Single User Sync nu este posibilă, deoarece întreprinderea nu are niciun utilizator furnizat. |
600023 |
BroadWorks External Directory Single User Sync nu este posibilă, deoarece utilizatorul există deja în această organizație. |
600024 |
BroadWorks External Directory Single User Sync nu este posibilă, deoarece nici un utilizator de potrivire a fost găsit în BroadWorks. |
600025 |
BroadWorks External Directory User Sync nu a reușit să actualizeze contul de utilizator în CI. |
600026 |
BroadWorks External Directory User Sync nu a reușit să actualizeze contul de mașină în CI. |
600027 |
BroadWorks External Directory Single User Sync nu este posibilă, deoarece mai mulți utilizatori au fost găsiți în BroadWorks. |
600028 |
BroadWorks External Directory Single User Sync nu este posibilă, deoarece cel puțin o sincronizare director de întreprindere ar fi trebuit să fie finalizată. |
600029 |
BroadWorks External Directory User Sync nu a reușit, deoarece întreprinderea nu are niciun utilizator furnizat. |
Istoricul schimbărilor
Următorul tabel rezumă actualizările acestui articol.
Dată |
Revizie |
---|---|
14 februarie 2023 |
S-a actualizat secțiunea Maximum Sync Directory și Surs a . |
10 decembrie 2022 |
A actualizat termenul Sincronizare imediată complet ă pentru a declanșa sincronizarea directorului |
iulie 19, 2022 |
Clarificări și corecții ale informațiilor generale:
|
Mai 09, 2022 |
|
Aprilie 07, 2022 |
|
martie 28, 2022 |
|
martie 24, 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. |
martie 16, 2022 |
|
decembrie 17, 2021 |
|
decembrie 16, 2021 |
|
decembrie 08, 2021 |
|