Könyvtárszinkronizálás – áttekintés

A címtárszinkronizálás biztosítja, hogy a Cisco BroadWorks felhasználói számára a Webex-könyvtár segítségével bármely hívó entitást felhívhat a BroadWorks kiszolgálóról. Ha ez a szolgáltatás engedélyezve van, a BroadWorks kiszolgáló teljes híváskönyvtára szinkronizálódik a Webex könyvtárral. A felhasználók hozzáférhetnek a könyvtárhoz a Webex alkalmazásból, és hívást kezdeményezhetnek a BroadWorks kiszolgáló bármely hívó entitásához.

A címtárszinkronizálás magában foglalja mind a felhasználói hívási információk, mind a telefonlisták szinkronizálását. A szinkronizált telefonlista-rekordok a Webex könyvtár két kapcsolattartó típusának egyikébe íródnak:

  • Szervezeti kapcsolattartók – Ezek a névjegyek egy szervezeten belül tárolódnak, és a szervezet minden felhasználója számára elérhetők.

  • Felhasználói kapcsolattartók – Ezek a névjegyek egy felhasználón vannak tárolva, és csak a partnert birtokos felhasználó számára érhetők el.


A Webex for Cisco BroadWorks kiépítés magában foglalja az üzenetküldő felhasználók és a hozzájuk kapcsolódó hívási információk alapértelmezett szinkronizálását a BroadWorks szerverről a Webex könyvtárba. Az alapértelmezett kiépítési szinkronizálás azonban kihagyja a nem üzenetküldő felhasználókat és a nem felhasználói entitásokat (például konferenciaterem telefon, faxgép vagy vadászcsoport száma). A Címtárszinkronizálás bekapcsolása biztosítja, hogy az összes hívó entitás bekerüljön a Webex könyvtárba.

Könyvtárszinkronizálási feltételek

  • A partner rendszergazdáinak partnerszinten be kell kapcsolniuk a funkciót. A partneradminisztrátorok egyetlen műveletben több ügyfélszervezetnél is be- vagy kikapcsolhatják a funkciót.

  • Alapértelmezés szerint a kezdeti szinkronizálás a szinkronizálás engedélyezése után egy héttel történik (a szinkronizálás indításához kiválasztott idő véletlenszerű). Az ügyfélszervezetek azonban a Szinkronizálás most lehetőséggel megkerülhetik az egyhetes várakozási időt, és azonnali szinkronizálást fejezhetnek be egy adott ügyfélszervezet számára.

  • Alapértelmezés szerint a szinkronizálás címtár szinkronizálása hetente fut minden ügyfél számára. Minden szinkronizálás egy héttel az utolsó szinkronizálás után történik, függetlenül attól, hogy a szinkronizálást manuálisan ütemezték vagy aktiválták-e a Szinkronizálás mostparancsmal.

  • Szinkronizálási hiba esetén a rendszer 24 óránként automatikusan újratelepül a szinkronizálással a következő ütemezett szinkronizálásig.

  • A szinkronizálás figyelmen kívül hagyja azokat a felhasználókat, akik nem rendelkeznek telefonszámot.

  • A Partnerközpontban megtekintheti egy adott ügyfél szinkronizálási állapotadatait. Ezenkívül részletes információkat is exportálhat az utolsó szinkronizálásról egy CSV-rekordba. A CSV-rekord részletesebb, mint a Control Hub kijelzője, és segíthet a hibaelhárításban, az elemzésben és a naplózásban.

  • A felhasználói névjegyek titkosított formátumban tárolódnak, és csak az a felhasználó férhet hozzá a visszafejtési kulcshoz, aki a kapcsolattartó tulajdonosa.

  • Ez a funkció a következő telefonlistatípusokat szinkronizálja a BroadWorks kiszolgálóról:

    • Vállalati gyakori telefonlisták

    • Közös telefonlisták csoportosítása

    • Személyes telefonlisták

Könyvtárszinkronizálás és kapcsolati maximumok

Az alábbiakban betekerve a címtárszinkronizálás által az egyes Webex-kapcsolattartók típusához lehetővé tért maximális névjegyek száma:

  • 500 Szervezeti kapcsolattartók

  • 500 Felhasználói névjegyek – Felhasználó számára a maximális érték tartalmazza a szinkronizált felhasználói névjegyeket és a manuális névjegyeket (a felhasználó manuálisan ad hozzá névjegyeket a Webex alkalmazáson keresztül)

A következő feltételek érvényesek:

  • Ha egy szervezetnek mindkét kategóriában több mint 500 névjegye van, a szinkronizálás kizárja az 500-as küszöbérték feletti bejegyzéseket. Nincs konkrét sorrend a szinkronizált vagy kihagyott névjegyekre.

  • Ha egy felhasználó manuálisan ad hozzá névjegyeket a Webex alkalmazáshoz, a felhasználó kapcsolatfelvételi maximumát a manuális névjegyek szinkronizálási felhasználói kapcsolattartókból való kivonása határozza meg. Ha például egy felhasználó manuálisan 100 névjegyet ad hozzá a Webex alkalmazáshoz, a címtárszinkronizálás lehetővé teszi akár 400 felhasználói névjegy szinkronizálását a BroadWorks-ből az adott felhasználó számára.

  • Javasoljuk, hogy ha valamelyik ügyfélszervezetnek több mint 500 névjegye van mindkét kategóriában, emeljen fel egy ügyet a Cisco-val, hogy az adott szervezet ki legyen zárva a címtár szinkronizálásából.

Az alábbi táblázat leképezi a Webex-kapcsolattartókat arra a BroadWorks telefonlistára, amelyből a rekordok szinkronizálódnak:

1. táblázat. Címtárszinkronizálás kapcsolattartótípusok és szinkronizálási forrás

Webex kapcsolattartó típusa

Szinkronizálva a BroadWorks-ből...

A szinkronizáláshoz használt API

Szervezeti kapcsolattartók

Vállalati gyakori telefonlisták

/directories/enterprisecommon

Közös telefonlisták csoportosítása (szolgáltatói módban)**

/directories/groupcommon

Felhasználói kapcsolattartók

Közös telefonlisták csoportosítása (vállalati módban)**

/directories/groupcommon

Személyes telefonlisták

/directories/personal


**A csoport közös telefonlistái eltérően szinkronizálódnak attól függően, hogy a BroadWorks vállalati vagy szolgáltató módban van-e. A isBroadWorksEnterprise a (igaz vagy hamis) paraméter határozza meg a lista szinkronizálását:

  • Igaz – Szinkronizálás szervezeti partnerként

  • Hamis – Szinkronizálás felhasználói partnerként

Frissítések

Miután egy névjegy frissült a BroadWorks-en, a következő körvonalazza, hogy a frissítés mikor jelenik meg a felhasználó Webex alkalmazásában:

  • A szervezet kapcsolattartóinak frissítései az alkalmazás újraindítása után vagy az alkalmazás helyi 72 órás gyorsítótár-időzítőjének lejárta után jelennek meg a Webex alkalmazásban.

  • A felhasználói kapcsolattartók frissítései azonnal megjelennek a Webex alkalmazásban az adott felhasználó számára.

Az alábbiakban be kell kezelni a Webex könyvtár a frissítéseket:

  • Ha a kapcsolattartó neve megváltozik a BroadWorks-en, a rendszer törli a meglévő névjegyet a Webex könyvtárból, és létrejön egy új névjegy.

  • Ha a broadworks-i telefonszám megváltozik, a Webex könyvtárban meglévő névjegy frissül az új számmal.

Címtárszinkronizálás előfeltételei

Követelmények váltása

Ehhez a funkcióhoz a következő funkció-váltások léteznek. Ezek beállításához vegye fel a kapcsolatot a Webex-szel a Cisco BroadWorks képviselőjével.

Funkció váltása

Alkalmazott...

Leírás

webex-for-broadworks-phone-list-sync

Partner

Kötelező váltó. Lehetővé teszi a telefonlista szinkronizálását a partner összes ügyfélszervezete számára.

Engedélyezni kell.

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

Ügyfélszervezet

Opcionális váltógomb. Letiltja a telefonlista szinkronizálását egy adott szervezethez, még akkor is, ha a funkció engedélyezve van a partner szintjén és az ügyfélsablonban.

Csak akkor alkalmazza ezt a váltást, ha le szeretné tiltani a telefonlista szinkronizálását egy adott ügyfélszervezethez. Ellenkező esetben letilthatja.


 
Ezt a váltást például minden olyan szervezetre alkalmaznia kell, amely több mint 500 névjegyet igényel.

hidden-personal-contacts-enabled-ga

Felhasználó

Opcionális váltógomb. Elrejti a személyes névjegyeket a felhasználó által befejezett címtárkeresésekből.

hidden-org-contacts-enabled-ga

Felhasználó

Opcionális váltógomb. Elrejti a szervezeti partnereket a felhasználó által befejezett címtárkeresésekből.

Előkonfigurációs követelmények

Javasoljuk, hogy az alábbi beállításokat használja:


Az alábbi példák azt feltételezik, hogy XSP-kiszolgálót használ. ADP-kiszolgálók esetében cserélje le az (XSP_CLI) (ADP CLI) (ADP CLI) ()._
  • Sebességkorlátozó értékek – Állítsa be a következő OverloadControl rendszertulajdonságokat (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit – Null értékre állítva.

    • globalDirectoryTransactionLimit – Null értékre állítva.


    Javasoljuk, hogy a userDirectoryTransactionLimit és a globalDirectoryTransactionLimit null értékre állítsa be. Ha azonban úgy dönt, hogy értékeket rendel hozzá, mindegyiknek a transactionLimitPeriodSeconds értékének legalább ötszörösére kell állítani (aminek 1-nek kell lennie).
  • Tranzakciókorlátok – Állítsa be a következő értékeket (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit – Legalább 100-ra állítva.

    • transactionLimitPeriodSecs – 1-re állítva.

  • Lapozási értékek – A lapozórendszer tulajdonságainak beállítása (XSP_CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize – 50-re állítva

    • availableUserMaxLimit – 100-ra állítva

  • CTI-felület – Győződjön meg arról, hogy feltölti a Webex CA-tanúsítványokat a CTI-kapcsolat megbízhatósági tárolójába, és engedélyezi az ügyfélhitelesítést a CTI-felületen.

Ezenkívül a BroadWorks kiadásától függően javasoljuk, hogy a következő rendszerjavításokat alkalmazza a BroadWorks üzembe helyezésére, mielőtt engedélyezi ezt a funkciót:


A Cisco BroadWorks webex minimális követelményét képező javításkövetelmények teljes listáját a BroadWorks szoftverkövetelmények című témakörben találja a Webex for Cisco BroadWorks megoldásiútmutatójában.

Könyvtárszinkronizálás engedélyezése (új sablon)

A partner rendszergazdái engedélyezhetik a címtárszinkronizálást egy ügyfélsablonhoz az új sablon létrehozásakor. A sablonhoz rendelt új ügyfélszervezeteknek engedélyezve lesz a címtárszinkronizálás. További részletekért lásd: "Ügyfélsablonok konfigurálása" a Partnerszervezet konfigurálása a Partnerközpontban című témakörben a Webex for Cisco BroadWorks megoldási útmutatójában.

Mi a teendő a következő

Győződjön meg arról, hogy a felhasználók tudják, hogy legalább egyszer a Webex alkalmazás Névjegyek fülére kell kattintaniuk a Webex alkalmazás funkciójának bekapcsolásához. Ezt csak egyszer kell befejezni.

Könyvtárszinkronizálás engedélyezése (meglévő sablon)

A partner rendszergazdái a következő lépéseket hajthatják végre a címtárszinkronizálás bekapcsolásához egy meglévő ügyfélsablonon belül, hogy engedélyezhessék a funkciót a sablont használó ügyfélszervezetek számára.

1

Jelentkezzen be a Partnerközpontba, és válassza a Beállításokparancsot.

2

Görgessen a BroadWorks-híváshoz, és kattintson a Sablonok megtekintése parancsra.

3

Válassza ki a megfelelő ügyfélsablont, és görgessen a BroadWorks Könyvtárszinkronizálásparancsra.

4

A sablont használó új ügyfélszervek könyvtárszinkronizálásának alapértelmezés szerint engedélyezése:

  1. Állítsa be a BroadWorks könyvtár és telefonlista szinkronizálásának engedélyezése az összes új ügyfélszervezethez, amely a Be gombra vált.

  2. Kattintson a Mentés lehetőségre.

5

A sablont használó meglévő ügyfélszervezetek könyvtárszinkronizálásának engedélyezése:

  1. Kattintson a Vevők listájának szinkronizálási állapotának megjelenítéseelemre.

  2. Jelölje be a szomszédos jelölőnégyzeteket minden olyan szervezetnél, amelyre be szeretné kapcsolni a funkciót.

  3. Kattintson a Szinkronizálás engedélyezésegombra.


 

Ha le szeretné tiltani a címtárszinkronizálást, kövesse a fenti eljárást, és:

  • A 4a lépésben állítsa be a Telefonkönyvtár szinkronizálásának engedélyezése az összes új ügyfélszervezet számára, amely a Ki gombra vált, hogy alapértelmezés szerint letiltsa a könyvtárszinkronizálást a sablont használó új ügyfélszervezetek számára.

  • Az 5c lépésben kattintson a Szinkronizálás letiltása gombra a meglévő szervezetek szolgáltatásának kikapcsolásához.

Mi a következő lépés

Győződjön meg arról, hogy a felhasználók tudják, hogy legalább egyszer a Webex alkalmazás Névjegyek fülére kell kattintaniuk a Webex alkalmazás funkciójának bekapcsolásához. Ezt csak egyszer kell befejezni.

Azonnali szinkronizálás teljes

A Szinkronizálás most beállítás lehetővé teszi a partneradminisztrátor számára, hogy igény szerinti szinkronizálást végezzen egy adott ügyfélszervezethez. Ez a beállítás csak az egyes ügyfélszervezetek számára választható ki – a Szinkronizálás most nem érhető el tömegesen.

1

Jelentkezzen be a Partnerközpontba (http://admin.webex.com), és válassza a Beállításokparancsot.

2

Görgessen a BroadWorks-híváshoz, és kattintson a Sablonok megtekintése parancsra.

3

Válassza ki a megfelelő ügyfélsablont, és görgessen a BroadWorks Könyvtárszinkronizálásparancsra.

4

Kattintson a Vevők listájának szinkronizálási állapotának megjelenítéseelemre.

5

A szinkronizálni kívánt ügyfélszervezet esetében kattintson a jobb szélen lévő három pontra, és válassza a Szinkronizálás mostlehetőséget.

6

Kattintson a Frissítés gombra a szinkronizálási eredmények megtekintéséhez.

Rekordok szinkronizálásának exportálása CSV-be

A partneradminisztrátorok részletes információkat exportálhatnak az utolsó szinkronizálásról egy CSV-fájlba. A CSV részletesebb képet tartalmaz a szinkronizálási rekordról, mint a Control Hub GUI, és segíthet a hibaelhárításban és az elemzésben.

1

Jelentkezzen be a Partnerközpontba (http://admin.webex.com), és válassza a Beállításokparancsot.

2

Görgessen a BroadWorks-híváshoz, és kattintson a Sablonok megtekintése parancsra.

3

Válassza ki a megfelelő ügyfélsablont, és görgessen a BroadWorks Könyvtárszinkronizálásparancsra.

4

Kattintson a Vevők listájának szinkronizálási állapotának megjelenítéseelemre.

5

Jelölje be az exportálásba felvenni kívánt minden olyan szervezet szomszédos jelölőnégyzetét, amelyet fel szeretne venni.

6

Kattintson a Eredmények exportálásaelemre.

Nyilvános API-k a címtárszinkronizáláshoz

Nyilvános API-k érhetők el developer.webex.com amelyek lehetővé teszik a partner rendszergazdák számára, hogy frissítsék az általuk kezelt ügyfélszervezetek címtárszinkronizálási beállításait, azonnali szinkronizálást indítsanak el, vagy szinkronizálási állapotadatokat szerezzenek be. A címtárszinkronizálási módszerek a BroadWorks Enterprises csoportban vannak csoportosítva. Négy API van:

  • BroadWorks-vállalkozásoklistázása – Ezzel az API-módszerrel szerezheti be az adott Szolgáltató és az egyes vállalkozások id. Be kell adnia a spEnterpriseId a kiépítésben hozzárendelt módon.

  • A könyvtárszinkronizálás frissítése BroadWorks nagyvállalathoz– Belépés a vállalatba id a címtár syc állapotának frissítéséhez, a könyvtár szinkronizálásának engedélyezéséhez vagy letiltásához.

  • Könyvtárszinkronizálás aktiválása vállalati verzióhoz– Használja ezt az API-módszert, ha azonnali szinkronizálást szeretne indítani egy adott vállalkozás számára id. A syncStatus, írja be a SYNC_NOW parancs.

  • Könyvtárszinkronizálási állapot lekérte egy vállalathoz– Adja meg a vállalatot id és fuss annak érdekében, hogy a státuszt, és trackingId A legújabb szinkronizálás. Használhatja a trackingID további elemzéseket futtatni olyan eszközökön keresztül, mint a Kibana és a Grafana.

A részletes API-dokumentációt a https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Be kell jelentkeznie az API specifikációjának olvasásához a https://developer.webex.com/docs/api/v1/broadworks-subscriberscímen: .

Több vállalat szinkronizálása API-val

Ezzel az eljárással a nyilvános API-k segítségével több vállalkozás könyvtárszinkronizálását is elvégezhet.

  • A címtárszinkronizálás lehetővé teszi egyszerre csak egyetlen vállalkozás szinkronizálását. Ha egynél több vállalat szinkronizálására törekszik, 429-es hiba jelenik meg.

  • Az egyetlen vállalat szinkronizálásának befejezéséhez szükséges idő a vállalat méretétől függően változik.

1

Futtassa a List BroadWorks Enterprises API-t a szinkronizálni kívánt vállalatok listájának létrehozásához.

  1. Állítsa a startWith értéket a vállalati vagy szolgáltatói azonosító kezdő karakterláncára.

  2. Kattintson a Futtatásgombra.

2

Futtassa a Trigger Directory Sync for a Enterprise API-t a lista első vállalatán.

  1. Adja meg a vállalati azonosítót .

  2. A syncStatus beállításaSYNC_NOW

  3. Kattintson a Futtatásgombra.

    Azonnali szinkronizálás indul a vállalkozás számára. Ez a szinkronizálás beleszámít a példányonkénti egy szinkronizálási korlátba.
3

Várjon néhány másodpercet, majd futtassa a Címtár szinkronizálási állapotának befutása API-t a szinkronizálás állapotának lekértéhez.

  1. Adja meg a vállalati azonosítót

  2. Kattintson a Futtatásgombra.

4

A szinkronizálás befejezése után hajtsa végre a listában szereplő következő vállalat 2–4. lépéseit. Ismételje meg ezeket a lépéseket, amíg nem szinkronizálta a teljes listát.

Hibakódok a címtárszinkronizáláshoz

A következő hibakódok vonatkoznak a címtárszinkronizálásra.

Hibakód

Hibaüzenet

600000

Broadworks Külső könyvtár felhasználói szinkronizálás váratlan hiba.

600001

A Broadworks külső címtár felhasználói szinkronizálása nem sikerült.

600002

A Broadworks external directory felhasználói szinkronizálását a befejezés előtt le kellett szüntetni.

600003

A Broadworks external directory felhasználói szinkronizálása csak részben sikerült. Egyes ügyfélszervezetek nem tudtak szinkronizálni.

600004

A Broadworks external Directory felhasználói szinkronizálása nincs engedélyezve a ConfigSet számára.

600005

A Broadworks external Directory felhasználói szinkronizálása folyamatban van a ConfigSet számára.

600006

A Broadworks external Directory User Sync szálak elfoglaltak vagy leállnak, ezért nem fogadnak el több szinkronizálási kérelmet, próbálkozzon később.

600007

A CustomerConfig Identity Org nem található.

600008

A CustomerConfig nem található a partnerszervezetben.

600009

A Broadworks külső címtár felhasználói szinkronizálása nem futtatható, mivel a CustomerConfighoz társított széles körű fürt foglalt

600010

A Broadworks External Directory felhasználói szinkronizálása nem futtatható, mivel a CustomerConfighoz nincs széles körű fürt társítva.

600011

A Broadworks external directory felhasználói szinkronizálása nincs engedélyezve a CustomerConfig számára.

600012

A Broadworks external Directory felhasználói szinkronizálása nem futtatható, mivel a hibrid címtár szinkronizálása már engedélyezve van a CustomerConfig számára.

600013

A Broadworks External Directory felhasználói szinkronizálása nem tudott felhasználókat és gépfiókokat hozzáadni az Identity Store-hoz.

600014

A Broadworks külső könyvtár felhasználói szinkronizálása nem sikerült, miközben megpróbált csatlakozni a Broadworks fürthöz. Hiba a Broadworks - %s- tól.

600015

A Broadworks External Directory felhasználói szinkronizálása nem talált megfelelő felhasználót az Identity Store-ban.

600017

A BroadWorks telefonlista-szinkronizálása nem tudta szinkronizálni az összes felhasználói és vállalati/szervezeti partnert.

600018

A BroadWorks telefonlista szinkronizálása nem sikerült a vállalat/szervezet felhasználói számára.

600019

A BroadWorks telefonlista szinkronizálása nem tudta szinkronizálni a vállalati/szervezeti partnereket.