Tento článek popisuje, jak nasadit synchronizaci adresářů v Webex pro Cisco BroadWorks. Tento článek je určen správcům poskytovatelů služeb v partnerských organizacích.
Přehled synchronizace adresářů
Synchronizace adresářů zajišťuje, že uživatelé služby Webex pro Cisco BroadWorks mohou použít adresář Webex z aplikace Webex k volání jakékoli volající entity ze serveru BroadWorks. Tato funkce synchronizuje informace o volání BroadWorks, které nebyly součástí zřizování uživatelů, s adresářem Webex .
Zřizování uživatelů služby Webex pro Cisco BroadWorks aktualizuje adresář služby Webex o podrobnosti o volání pro uživatele služby Webex pro Cisco BroadWorks (primární telefon číslo, číslo číslo mobilního telefonu, linka), ale vynechává externí záznamy o hovorech. Když je však synchronizace adresářů zapnutá, funkce také synchronizuje následující záznamy hovorů s adresářem služby Webex .
Volající uživatelé pouze BroadWorks (kteří nejsou zaregistrováni ve službě Webex)
Volající entity, které nepatří uživatele (např. telefon konferenční místnosti, fax, číslo skupina sdružených linek )
Položky telefonního seznamu BroadWorks
Následující tabulka shrnuje záznamy volání BroadWorks a ukazuje, jak byly přidány do adresáře Webex .
Záznamy volání BroadWorks |
Popis |
Přidáno do adresáře služby Webex prostřednictvím... |
---|---|---|
Webex pro uživatele Cisco BroadWorks |
Uživatelé mají povolenou službu Webex for Cisco BroadWorks |
Zřizování uživatelů (např. zřizování toků) |
Uživatelé pouze pro volání BroadWorks |
Volání uživatelům, kteří jsou ne zaregistrován ve službě Webex |
Synchronizace adresáře |
Entity, které nejsou volající uživatele |
Např. telefon konferenční místnosti, fax, číslo skupiny sdružených linek |
Synchronizace adresáře |
Telefonní seznamy BroadWorks |
Položky telefonního seznamu BroadWorks:
|
Synchronizace adresářů (synchronizace telefonního seznamu) |
Další podrobnosti o zřizování uživatelů naleznete v Průvodce řešením Webex pro Cisco BroadWorks .
|
Podmínky synchronizace adresářů
Správci partnerů musí funkci povolit na úrovni partnera. Správci partnerů mohou jednou operací zapnout nebo vypnout funkci pro více organizací zákazníků.
Ve výchozím nastavení dochází k počáteční synchronizaci jeden týden po povolení synchronizace (čas vybraný pro zahájení synchronizace je náhodný). Organizace zákazníků však mohou použít Synchronizovat nyní možnost přeskočit týdenní čekací dobu a spustit okamžitou synchronizaci pro danou organizaci zákazníka.
Ve výchozím nastavení se synchronizace adresářů spouští každý týden pro každého zákazníka. Každá synchronizace je provedena jeden týden po poslední synchronizaci bez ohledu na to, zda byla poslední synchronizace naplánována nebo spuštěna ručně Synchronizovat nyní .
maximální počet současných synchronizací na cluster BroadWorks jsou dva: jedna naplánovaná synchronizace a jedna synchronizace na vyžádání (přes API nebo grafické uživatelské rozhraní rozhraní Partner Hub). Správci však nemohou z jednoho zařízení BroadWorks spustit dvě synchronizace na vyžádání současně. Toto omezení existuje bez ohledu na to, zda byla synchronizace zahájena prostřednictvím API nebo prostřednictvím rozhraní API Synchronizovat nyní v centru Partner Hub. Webex navíc nenaplánuje spuštění dvou naplánovaných synchronizací ze stejného zařízení BroadWorks současně.
Pokud dojde k selhání synchronizace, Webex se pokusí o synchronizaci automaticky každých 24 hodin až do další naplánované synchronizace.
Synchronizace ignoruje uživatele, kteří nemají telefonní číslo.
V centru Partner Hub si můžete zobrazit informace o stavu synchronizace pro daného zákazníka. Navíc můžete exportovat podrobné informace o poslední synchronizaci do záznamu CSV . Záznam CSV poskytuje více podrobností než displej v prostředí Control Hub a může pomoci při řešení potíží, s analýzou a auditem.
Webex ukládá kontakty uživatelů v šifrovaném formátu. K dešifrovacímu klíči má přístup pouze uživatel, který kontakt vlastní.
Pro volající uživatele pouze BroadWorks a entity nevolající uživatele tato funkce synchronizuje následující typy telefonní číslo z BroadWorks:
Primární telefonní číslo
Číslo mobilního telefonu
Linka
Synchronizace však ze synchronizace vyloučí volající uživatele pouze BroadWorks a volající entity, které nejsou uživatelem, pokud není přítomno ani primární telefon číslo ani linka.
Maximální počet telefonních seznamů a kontaktů BroadWorks
Synchronizace adresářů také synchronizuje položky telefonního seznamu BroadWorks s kontakty Webex . Synchronizované položky se přidají do jednoho z následujících typů kontaktů:
Kontakty organizace – služba Webex ukládá tyto kontakty proti organizaci. Každý uživatel má přístup ke kontaktům organizace pro svou organizaci. Maximum je 30 000 kontaktů.
Kontakty uživatele – Webex ukládá tyto kontakty proti uživateli. K položce kontaktu má přístup pouze uživatel, který kontakt vlastní. Maximum je 2 000 kontaktů (1 500 synchronizovaných kontaktů + 500 kontaktů pro ruční zadání).
Do kontaktů Webex se přidají pouze položky telefonního seznamu. Volající uživatelé pouze BroadWorks a volající entity neuživatele, kteří jsou zahrnuti v synchronizaci adresářů, nebudou přidáni do kontaktů, pokud je uživatel služby Webex nepřidá do kontaktů ručně.
|
Následující tabulka mapuje typy kontaktů Webex podle zdroje kontaktů (synchronizovaných z telefonního seznamu BroadWorks nebo přidaných ručně):
Typ kontaktu Webex |
Kontaktovat zdroj |
Maximálně |
Synchronizováno z BroadWorks... |
API používané pro synchronizaci |
---|---|---|---|---|
Kontakty na organizaci |
Synchronizace adresáře |
30 000 kontaktů |
Společné telefonní seznamy Enterprise |
|
Společné telefonní seznamy pro skupinu (pro skupinu poskytovatelů služeb)** |
|
|||
Kontakty na uživatele |
Synchronizace adresáře |
1500 kontaktů |
Osobní telefonní seznamy |
/directories/personal |
Přidáno ručně uživatelem |
500 kontaktů |
– |
– |
|
Skupinové kontakty |
Synchronizace adresáře |
30 000 kontaktů na skupinu |
Společné telefonní seznamy pro skupinu (pro podnikovou skupinu)** |
/directories/groupcommon |
** Položky běžného telefonního seznamu skupin se synchronizují různým způsobem podle toho, zda je společnost BroadWorks v režimu Enterprise nebo v režimu poskytovatele služeb. Hodnota
|
Pro způsob, jakým aplikace Directory Sync zpracovává maximum kontaktů, se vztahují následující podmínky:
Pokud organizace překročí maximální povolený počet kontaktů pro synchronizaci (30 000 kontaktů organizace nebo 30 000 společných kontaktů skupiny na skupinu), synchronizace adresáře vyloučí položky překračující tuto prahovou hodnotu. Na synchronizované nebo vynechané kontakty není uplatněno žádné konkrétní pořadí.
Pokud jeden z vašich zákazníků překročí maximální povolený počet kontaktů v kterékoli kategorii, doporučujeme otevřít případ společnosti Cisco a zajistit, aby byla organizace vyloučena ze synchronizace adresářů.
Ruční kontakty jsou kontakty, které uživatel přidá ručně do aplikace Webex . Uživatel může přidat až 500 ručních kontaktů. Ruční kontakty spadají do větší kategorie uživatelských kontaktů v Webex, ale nejsou zahrnuty do synchronizace.
Celkový kombinovaný limit pro kontakty organizace (30 000) a skupinové kontakty (30 000 na skupinu) je 200 000.
Aktualizace
Adresář služby Webex zpracovává aktualizace následujícím způsobem:
Pokud se změní jméno kontaktu na BroadWorks, stávající kontakt bude odstraněn z adresáře Webex a bude vytvořen nový kontakt.
Pokud se změní číslo kontaktu na platformě BroadWorks, služba Webex aktualizuje stávající kontakt v adresáři služby Webex pomocí nového čísla.
Jakmile správce aktualizuje kontakt na platformě BroadWorks, pro zobrazení aktualizace v aplikaci Webex uživatele si vyžádejte následující podmínky:
Pokud je aktualizace pro volajícího uživatele pouze BroadWorks nebo entitu, která nevolá uživatele, aktualizace se zobrazí v aplikaci Webex uživatele ihned po následující synchronizaci adresáře.
Pokud se aktualizace týká položky telefonního seznamu BroadWorks:
Pro kontakty uživatelů: Aktualizace se zobrazí v aplikaci Webex uživatele ihned po následné synchronizaci adresáře.
Pro skupinové kontakty: aktualizace se zobrazí v aplikaci Webex uživatelů ihned po následné synchronizaci adresáře.
Pro kontakty organizace: Adresář Webex se aktualizuje při následující synchronizaci adresáře, ale uživatelé tuto změnu v aplikaci Webex neuvidí, dokud aplikaci Webex nerestartuje nebo dokud nevyprší místní 72hodinový časovač mezipaměti.
Aktualizace informace o uživateli služby Webex pro Cisco BroadWorks jsou zpracovány v rámci zřizovacích procesů.
|
Control Hub obsahuje možnost přidat nebo upravit kontakty na úrovni organizace v Control Hubu prostřednictvím soubor CSV. K této možnosti mají přístup správci partnerů a správci zákazníků s přístupem k rozbočovači Control Hub. Aktualizace kontaktů prostřednictvím prostředí Control Hub však není službou Webex pro Cisco BroadWorks podporována. Aktualizace kontaktů použité v centru Control Hub se nesynchronizují zpět s BroadWorks a nejsou dostupné pro hledání v adresáři ze stolních telefonů.
|
Předpoklady synchronizace adresářů
Doporučujeme použít následující nastavení:
V níže uvedených příkladech se předpokládá, že používáte server XSP. U serverů ADP nahraďte (XSP_ CLI) pomocí (ADP_ CLI).
|
Omezené hodnoty četnosti – Nastavte následující vlastnosti systému OverloadControl (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit – Je nastaveno na nulovou hodnotu.
globalDirectoryTransactionLimit – Nastaveno na nulovou hodnotu.
Doporučujeme nastavit parametry userDirectoryTransactionLimit a globalDirectoryTransactionLimit na nulovou hodnotu. Pokud se však rozhodnete přiřadit hodnoty, musí být každá nastavena na nejméně pětinásobek hodnotytransationLimitPeriodSeconds (která by měla být 1).Limity transakcí – nastavte následující hodnoty (XSP_ CLI/Systém/CommunicationUtility/Výchozí nastavení):
userTransactionLimit – Nastavte alespoň na 100.
transationLimitPeriodSecs – nastaveno na 1.
Hodnoty pagingu – Nastavení vlastností pagingového systému (XSP_ CLI/Applications/Xsi-Actions/Paging):
defaultPageSize – Je nastaveno na 50
dostupnéUserMaxLimit – nastaveno na 100
Rozhraní CTI – Nezapomeňte nahrát tyto certifikáty CA služby Webex do úložiště důvěryhodnosti rozhraní CTI a povolit ověření klienta v rozhraní CTI .
Navíc v závislosti na vaší verzi BroadWorks doporučujeme před povolením této funkce použít následující opravy systému pro nasazení BroadWorks:
Pro R22:
AP.as.22.0.1123.ap368517
Pro R23:
AP.as.23.0.1075.ap368517
Pro R24: není vyžadována žádná oprava
Povolit synchronizaci adresářů (nová šablona)
Správci partnerů mohou povolit synchronizaci adresářů pro šablonu zákazníka při vytváření nové šablony. Všechny nové organizace zákazníků, které budou přiřazeny k této šabloně, budou mít synchronizaci adresářů povolenou. Podrobnosti naleznete v části „Konfigurace šablon pro zákazníky“ v Nakonfigurujte partnerskou organizaci v centru Partner Hub v rámci Průvodce řešením pro Webex pro Cisco BroadWorks .
Co dělat dále
Ujistěte se, že uživatelé vědí, že musí kliknout na možnost Kontakty v aplikaci Webex alespoň jednou, abyste mohli tuto funkci v aplikaci Webex zapnout. Tuto akci je nutné provést pouze jednou.
Povolit synchronizaci adresářů (stávající šablona)
1 | Přihlaste se k centru Partner Hub a vyberte Nastavení . |
||
2 | Přejděte na Volání BroadWorks a klikněte Zobrazit šablony . |
||
3 | Vyberte požadovanou šablonu zákazníka a přejděte na Synchronizace adresářů BroadWorks . |
||
4 | Jak povolit synchronizaci adresářů ve výchozím nastavení pro organizace nových zákazníků, které používají tuto šablonu:
|
||
5 | Povolení synchronizace adresářů pro organizace stávajících zákazníků, které používají tuto šablonu:
|
Co dělat dál
Ujistěte se, že uživatelé vědí, že musí kliknout na možnost Kontakty v aplikaci Webex alespoň jednou, abyste mohli tuto funkci v aplikaci Webex zapnout. Tuto akci je nutné provést pouze jednou.
Aktivovat okamžitou synchronizaci
1 | Přihlaste se k centru Partner Hub (http://admin.webex.com ) a vyberte Nastavení . |
2 | Přejděte na Volání BroadWorks a klikněte Zobrazit šablony . |
3 | Vyberte požadovanou šablonu zákazníka a přejděte na Synchronizace adresářů BroadWorks . |
4 | Klikněte Zobrazit stav synchronizace seznamu zákazníků . |
5 | U organizace zákazníka, kterou chcete synchronizovat, klikněte na tři tečky zcela vpravo a vyberte možnost Synchronizovat nyní . |
6 | Klikněte Obnovit zobrazte výsledky synchronizace. |
Exportujte záznamy synchronizace do CSV
1 | Přihlaste se k centru Partner Hub (http://admin.webex.com ) a vyberte Nastavení . |
2 | Přejděte na Volání BroadWorks a klikněte Zobrazit šablony . |
3 | Vyberte požadovanou šablonu zákazníka a přejděte na Synchronizace adresářů BroadWorks . |
4 | Klikněte Zobrazit stav synchronizace seznamu zákazníků . |
5 | Zaškrtněte sousední políčka u každé organizace, kterou chcete zahrnout do exportu. |
6 | Klikněte Exportovat výsledky . |
Veřejná rozhraní API pro synchronizaci adresářů
Veřejná rozhraní API jsou dostupná na developer.webex.com které správcům partnerů umožňují aktualizovat nastavení synchronizace adresářů pro organizace zákazníků, které spravují, aktivovat okamžitou synchronizaci nebo získávat informace o stavu synchronizace. Metody synchronizace adresáře jsou seskupeny do Podniky BroadWorks :
Seznam podniků BroadWorks – Tuto metodu API použijte k získání seznamu podniků pod daným poskytovatelem služeb a jednotlivých podniků
id
. Je nutné zadatspEnterpriseId
jak je přiřazeno při zřizování.Aktualizujte synchronizaci adresářů pro podnik BroadWorks –Zadejte podnik
id
aktualizovat stav synchronizace adresáře pro daný podnik, a to povolení nebo zakázání synchronizace adresářů.Spustit synchronizaci adresářů pro podnik – Tuto metodu API použijte, pokud chcete aktivovat okamžitou synchronizaci pro daný podnik
id
. ProsyncStatus
, zadejteSYNC_NOW
příkaz.Získejte stav synchronizace adresářů pro podnik –Zadejte podnik
id
a spustit, abyste získali stav atrackingId
nejnovější synchronizace. Můžete použíttrackingID
spouštět další analýzy prostřednictvím nástrojů, jako je Kibana a Grafana.
Navíc mohou správci použít Spustit synchronizaci adresářů pro jednoho uživatele API pro spuštění synchronizace adresáře na vyžádání pro jednoho uživatele.
Podrobnou dokumentaci API naleznete zdehttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
Chcete-li si přečíst specifikaci API , je nutné se přihlásit se nahttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Synchronizovat více podniků pomocí API
|
1 | Spusťte soubor Seznam podniků BroadWorks API pro vygenerování seznamu podniků, které chcete synchronizovat.
|
2 | Spusťte soubor Spustit synchronizaci adresářů pro podnik API na první organizaci na seznamu. |
3 | Počkejte několik sekund a pak spusťte aplikaci Získat stav synchronizace adresářů API pro zjištění stavu synchronizace.
|
4 | Po dokončení synchronizace dokončete kroky 2 až 4 u další organizace na seznamu. Tyto kroky opakujte, dokud nesynchronizujete celý seznam. |
Kódy chyb pro synchronizaci adresářů
Následující kódy chyb se vztahují na synchronizaci adresářů.
Kód chyby |
Zpráva o chybě |
---|---|
600 000 |
Neočekávaná chyba synchronizace uživatelů externího adresáře Broadworks. |
600001 |
Synchronizace uživatelů externího adresáře Broadworks se nezdařila. |
600002 |
Synchronizaci uživatelů externího adresáře Broadworks bylo nutné před dokončením ukončit. |
600003 |
Synchronizace uživatelů externího adresáře Broadworks uspěla jen částečně. Některé organizace zákazníka se nepodařilo synchronizovat. |
600004 |
Synchronizace uživatelů externího adresáře Broadworks není povolená pro ConfigSet. |
600005 |
Probíhá synchronizace uživatelů externího adresáře Broadworks pro ConfigSet. |
600006 |
Vlákna synchronizace uživatelů externího adresáře Broadworks jsou zaneprázdněná nebo se vypínají, takže nepřijmou žádnou další žádost o synchronizaci. Zkuste to znovu později. |
600007 |
Organizace identity pro CustomerConfig nebyla nalezena. |
600008 |
CustomerConfig jsme v partnerské organizaci nenašli. |
600009 |
Synchronizaci uživatelů externího adresáře Broadworks nelze spustit, protože cluster Broadworks přidružený k nabídce CustomerConfig je zaneprázdněn. |
600010 |
Synchronizaci uživatelů externího adresáře Broadworks nelze spustit, protože ke CustomerConfig není přiřazený žádný cluster Broadworks. |
600011 |
Synchronizace uživatelů externího adresáře Broadworks není povolená pro CustomerConfig. |
600012 |
Synchronizaci uživatelů externího adresáře Broadworks nelze spustit, protože už je pro CustomerConfig povolená synchronizace hybridního adresáře. |
600013 |
Synchronizaci uživatelů externího adresáře Broadworks se nepodařilo přidat účty uživatelů a zařízení do úložiště identit. |
600014 |
Synchronizace uživatelů externího adresáře Broadworks selhala při pokusu o připojení ke clusteru Broadworks. Chyba od Broadworks – %s. |
600015 |
Synchronizace uživatelů externího adresáře Broadworks nenašla v úložišti identit žádného vyhovujícího uživatele. |
600017 |
Synchronizaci telefonního seznamu BroadWorks se nepodařilo synchronizovat všechny kontakty na uživatele a podnik/organizaci. |
600018 |
Synchronizace telefonního seznamu BroadWorks se u uživatelů v podniku/organizaci nezdařila. |
600019 |
Synchronizaci telefonního seznamu BroadWorks se nepodařilo synchronizovat kontakty podniku/ organizace. |
600020 |
Synchronizaci uživatelů externího adresáře BroadWorks nelze zakázat, protože probíhá synchronizace CustomerConfig. |
600022 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože podnik nemá žádného zřízeného uživatele. |
600023 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože uživatel v této organizaci již existuje. |
600024 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože v oblasti BroadWorks nebyl nalezen žádný odpovídající uživatel. |
600025 |
Synchronizaci uživatelů externího adresáře BroadWorks se nepodařilo aktualizovat uživatelský účet v CI. |
600026 |
Synchronizace uživatelů externího adresáře BroadWorks se nepodařilo aktualizovat účet zařízení v CI. |
600027 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože v aplikaci BroadWorks bylo nalezeno více uživatelů. |
600028 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože měla být dokončena nejméně jedna synchronizace podnikový adresář . |
600029 |
Synchronizace uživatelů externího adresáře BroadWorks se nezdařila, protože podnik nemá žádného zřízeného uživatele. |
Historie změn
V následující tabulce je uveden přehled aktualizací tohoto článku.
Datum |
Revize |
---|---|
14. února 2023 |
Aktualizováno Maximum a zdroj synchronizace adresářů části. |
10. prosince 2022 |
Byl aktualizován výraz Dokončete okamžitou synchronizaci komu Aktivovat synchronizaci adresářů |
19. července 2022 |
Upřesnění a opravy přehledových informací:
|
9. května 2022 |
|
7. dubna 2022 |
|
28. března 2022 |
|
24. března 2022 |
Byl přidán seznam synchronizovaných typů telefonní číslo do Podmínky synchronizace adresářů . Synchronizace nyní zahrnuje čísla mobilní telefon . |
16. března 2022 |
|
17. prosince 2021 |
|
16. prosince 2021 |
|
8. prosince 2021 |
|