- Domů
- /
- Článek
Synchronizace adresáře v aplikaci Webex pro Cisco BroadWorks
Tento článek popisuje, jak nasadit synchronizaci adresářů ve Webexu pro Cisco BroadWorks. Článek je určen pro správce poskytovatelů služeb v partnerských organizacích.
Přehled synchronizace adresářů
Synchronizace adresářů zajišťuje, že uživatelé Webexu pro Cisco BroadWorks mohou použít adresář Webex z aplikace Webex k volání libovolné volající entity ze serveru BroadWorks. Tato funkce synchronizuje informace o volání BroadWorks, které nebyly součástí zřizování uživatelů, do adresáře Webex.
Webex pro zřizování uživatelů Cisco BroadWorks aktualizuje adresář Webex s podrobnostmi o volání pro Webex pro uživatele Cisco BroadWorks (primární telefonní číslo, číslo mobilního telefonu, linka), ale vynechá externí záznamy volání. Pokud je však synchronizace adresářů zapnutá, funkce také synchronizuje následující záznamy volání do adresáře Webex.
-
BroadWorks-only volající uživatele (kteří nejsou připojeni k Webexu)
-
Neuživatelské volající entity (např. telefon do konferenční místnosti, fax, číslo lovecké skupiny)
-
Položky telefonního seznamu BroadWorks
Následující tabulka shrnuje záznamy volání BroadWorks a ukazuje, jak se přidávají do adresáře Webex.
Záznamy volání BroadWorks |
Popis |
Přidáno do adresáře Webex prostřednictvím... |
---|---|---|
Webex pro uživatele Cisco BroadWorks |
Uživatelé jsou povoleni pro Webex pro Cisco BroadWorks |
Zřizování uživatelů (např. zřizování toku) |
Volání uživatelů pouze BroadWorks |
Volání uživatelů, kteří nejsou připojeni k Webexu |
Synchronizace adresářů |
Neuživatelské volající entity |
Např. telefon v konferenční místnosti, fax, číslo huntské skupiny |
Synchronizace adresářů |
Telefonní seznamy BroadWorks |
Položky telefonního seznamu BroadWorks:
|
Synchronizace adresářů (synchronizace seznamu telefonů) |
Podmínky synchronizace adresářů
-
Správci partnerů musí tuto funkci povolit na úrovni partnera. Správci partnerů mohou tuto funkci zapnout nebo vypnout pro více organizací zákazníků v jedné operaci.
-
Ve výchozím nastavení dochází k počáteční synchronizaci jeden týden po povolení synchronizace (čas zvolený pro spuštění synchronizace je náhodný). Organizace zákazníků však mohou pomocí možnosti Synchronizovat nyní obejít čekací lhůtu jednoho týdne a spustit okamžitou synchronizaci pro danou organizaci zákazníků.
-
Ve výchozím nastavení se synchronizace adresářů spouští týdně pro každého zákazníka. Ke každé synchronizaci dochází jeden týden po poslední synchronizaci bez ohledu na to, zda byla poslední synchronizace naplánována nebo spuštěna ručně pomocí funkce Synchronizovat nyní.
-
Maximální počet současných synchronizací na cluster BroadWorks je dva: jedna naplánovaná synchronizace a jedna synchronizace na vyžádání (prostřednictvím rozhraní API nebo grafického uživatelského rozhraní partnerského centra). Správci však nemohou spustit dvě synchronizace na vyžádání současně ze stejného BroadWorks. Toto omezení existuje bez ohledu na to, jestli byla synchronizace zahájena prostřednictvím rozhraní API nebo prostřednictvím možnosti Synchronizovat nyní v partnerském centru. Kromě toho Webex nenaplánuje spuštění dvou naplánovaných synchronizací současně ze stejného BroadWorks.
-
Pokud dojde k selhání synchronizace, Webex se automaticky pokusí o synchronizaci každých 24 hodin až do další naplánované synchronizace.
-
Synchronizace ignoruje uživatele, kteří nemají telefonní číslo.
-
V partnerském centru můžete zobrazit informace o stavu synchronizace pro daného zákazníka. Kromě toho můžete exportovat podrobné informace o poslední synchronizaci do záznamu CSV. Záznam CSV poskytuje více podrobností než displej Centra řízení a může pomoci při řešení potíží, analýzách a auditování.
-
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 uživatele volající pouze BroadWorks a neuživatelské volající entity tato funkce synchronizuje následující typy telefonních čísel z BroadWorks:
-
Primární telefonní číslo
-
Číslo mobilního telefonu
-
Rozšíření
Synchronizace však ze synchronizace vyloučí pouze volající uživatele BroadWorks a neuživatelské volající entity, pokud není k dispozici primární telefonní číslo ani linka.
Nastavení služby ochrany osobních údajů na úrovni uživatele služby Broadworks není v rámci synchronizace adresářů podporováno.
-
Telefonní seznam BroadWorks a maximální počet kontaktů
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 – Webex ukládá tyto kontakty proti organizaci. Každý uživatel má přístup ke kontaktům organizace pro svou organizaci. Maximální počet kontaktů je až 30000.
-
Kontakty uživatelů – Webex ukládá tyto kontakty proti uživateli. K položce kontaktu má přístup pouze uživatel, který kontakt vlastní. Maximálně 2000 kontaktů (1500 synchronizovaných kontaktů + 500 kontaktů pro ruční zadání).
Následující tabulka mapuje typy kontaktů Webex na zdroj kontaktů (synchronizované ze seznamu telefonů BroadWorks nebo přidané ručně):
Typ kontaktu Webex |
Zdroj kontaktu |
Maximálně |
Synchronizováno z BroadWorks... |
Rozhraní API používané pro synchronizaci |
---|---|---|---|---|
Kontakty organizace |
Synchronizace adresářů |
30000 kontaktů |
Podnikové běžné telefonní seznamy |
|
Skupina Běžné telefonní seznamy (pro skupinu poskytovatelů služeb)** |
| |||
Kontakty uživatelů |
Synchronizace adresářů |
1500 kontaktů |
Osobní telefonní seznamy | /adresáře/osobní |
Přidáno ručně uživatelem |
Kontakty: 500 |
– |
– | |
Skupinové kontakty |
Synchronizace adresářů |
30 000 kontaktů na skupinu |
Skupina Běžných telefonních seznamů (pro skupinu enterprise)** | /adresáře/groupcommon |
**Položky společných telefonních seznamů se synchronizují odlišně v závislosti na tom, zda je BroadWorks v podnikovém režimu nebo v režimu poskytovatele služeb. Hodnota parametru isBroad Enterprise
(true nebo false) určuje, jak se seznam synchronizuje:
-
True – synchronizovat jako skupinový kontakt
-
False – Synchronizace jako kontakt organizace
Následující podmínky platí pro způsob, jakým Synchronizace adresářů zpracovává maximální počet kontaktů:
-
Pokud organizace překročí maximální povolené kontakty pro synchronizaci (30000 kontaktů organizace nebo 30000 společných kontaktů skupiny pro skupinu), synchronizace adresářů vylučuje položky nad maximální prahovou hodnotou. Pro synchronizované nebo vynechané kontakty není použito žádné konkrétní pořadí.
-
Pokud některý z vašich zákazníků překročí maximální povolený počet kontaktů v obou kategoriích, doporučujeme vznést případ u společnosti Cisco, aby byla tato 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 kontaktů uživatele ve Webexu, ale nejsou zahrnuty do synchronizace.
-
Celkový kombinovaný limit pro kontakty organizace (30000) a skupinové kontakty (30000 na skupinu) je 200000.
Aktualizace
Následuje způsob, jakým adresář Webex zpracovává aktualizace:
-
Pokud se jméno kontaktu v BroadWorks změní, existující kontakt se odstraní z adresáře Webex a vytvoří se nový kontakt.
-
Pokud se číslo kontaktu změní v BroadWorks, Webex aktualizuje existující kontakt v adresáři Webex novým číslem.
Poté, co správce aktualizuje kontakt na BroadWorks, následující podmínky popisují, kdy se aktualizace zobrazí v aplikaci Webex uživatele:
-
Pokud je aktualizace určena pouze volajícímu uživateli BroadWorks nebo neuživatelské volající entitě, aktualizace se zobrazí v aplikaci Webex uživatele bezprostředně po následné synchronizaci adresáře.
-
Pokud je aktualizace 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ásledné synchronizaci adresáře, ale uživatelé neuvidí změnu v aplikaci Webex, dokud nerestartují aplikaci Webex nebo dokud nevyprší platnost místního 72hodinového časovače mezipaměti.
-
Požadavky na synchronizaci adresářů
Doporučujeme použít následující nastavení:
-
Hodnoty omezující rychlost – Nastavte následující vlastnosti systému OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
-
userDirectoryTransactionLimit – Nastavte hodnotu null.
-
globalDirectoryTransactionLimit – Nastavte hodnotu null.
Doporučuje se nastavit userDirectoryTransactionLimit a globalDirectoryTransactionLimit na hodnotu null. Pokud se však rozhodnete přiřadit hodnoty, musí být každá z nich nastavena alespoň na pětinásobek hodnoty transactionLimitPeriodSeconds (což by mělo být 1). -
-
Limity transakcí – Nastavte následující hodnoty (XSP_CLI/System/CommunicationUtility/DefaultSettings):
-
userTransactionLimit – Nastavte alespoň na 100.
-
transactionLimitPeriodSecs – Nastavte na 1.
-
-
Hodnoty stránkování – Nastavte vlastnosti stránkovacího systému (XSP_CLI/Applications/Xsi-Actions/Paging):
-
defaultPageSize – Nastavte na 50
-
availableUserMaxLimit – Nastavte na 100
-
-
Rozhraní CTI – Nezapomeňte nahrát certifikáty certifikační autority Webex do úložiště důvěryhodných certifikátů rozhraní CTI a povolit ověřování klientů v rozhraní CTI.
Kromě toho v závislosti na vaší verzi BroadWorks doporučujeme před povolením této funkce použít následující systémové opravy pro nasazení BroadWorks:
-
Pro R22:
AP.as.22.0.1123.ap368517
-
Pro R23:
AP.as.23.0.1075.ap368517
-
Pro R24: není nutná žá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 povolenou synchronizaci adresářů. Podrobnosti naleznete v části "Konfigurace šablon zákazníků" v tématu Konfigurace partnerské organizace v partnerském centru v Průvodci řešením pro Webex pro Cisco BroadWorks.
Co dělat dál
Ujistěte se, že uživatelé vědí, že musí alespoň jednou kliknout na kartu Kontakty v aplikaci Webex, aby mohli tuto funkci zapnout v aplikaci Webex. To je třeba dokončit pouze jednou.
Povolit synchronizaci adresářů (existující šablona)
1 |
Přihlaste se k partnerskému centru a zvolte Nastavení. |
2 |
Posuňte se na Volání BroadWorks a klikněte na Zobrazit šablony. |
3 |
Vyberte příslušnou šablonu zákazníka a přejděte na BroadWorks Directory Sync. |
4 |
Povolení synchronizace adresářů ve výchozím nastavení pro nové organizace zákazníků, které používají tuto šablonu: |
5 |
Povolení synchronizace adresářů pro existující organizace zákazníků, které používají tuto šablonu: Pokud chcete zakázat synchronizaci adresářů, postupujte podle výše uvedeného postupu a:
|
Co dělat dál
Ujistěte se, že uživatelé vědí, že musí alespoň jednou kliknout na kartu Kontakty v aplikaci Webex, aby mohli tuto funkci zapnout v aplikaci Webex. To je třeba dokončit pouze jednou.
Spustit okamžitou synchronizaci
1 |
Přihlaste se do partnerského centra ( http://admin.webex.com) a zvolte Nastavení. |
2 |
Posuňte se na Volání BroadWorks a klikněte na Zobrazit šablony. |
3 |
Vyberte příslušnou šablonu zákazníka a přejděte na BroadWorks Directory Sync. |
4 |
Klikněte na Zobrazit seznam stavusynchronizace zákazníků. |
5 |
Pro organizaci zákazníků, kterou chcete synchronizovat, klikněte na tři tečky zcela vpravo a vyberte Synchronizovat nyní. |
6 |
Kliknutím na Aktualizovat zobrazíte výsledky synchronizace. |
Export synchronizačních záznamů do formátu CSV
1 |
Přihlaste se do partnerského centra ( http://admin.webex.com) a zvolte Nastavení. |
2 |
Posuňte se na Volání BroadWorks a klikněte na Zobrazit šablony. |
3 |
Vyberte příslušnou šablonu zákazníka a přejděte na BroadWorks Directory Sync. |
4 |
Klikněte na Zobrazit seznam stavusynchronizace zákazníků. |
5 |
Zaškrtněte sousední zaškrtávací políčka pro každou organizaci, kterou chcete zahrnout do exportu. |
6 |
Klikněte na Exportovat výsledky. |
Veřejná rozhraní API pro synchronizaci adresářů
Veřejná rozhraní API jsou k dispozici na developer.webex.com , která umožňují partnerským správcům aktualizovat nastavení synchronizace adresářů pro organizace zákazníků, které spravují, aktivovat okamžitou synchronizaci nebo získat informace o stavu synchronizace. Metody synchronizace adresářů jsou seskupeny pod BroadWorks Enterprises:
-
Seznam podniků Broadworks – Pomocí této metody API získáte seznam podniků pod daným poskytovatelem služeb a
id
každého podniku. Musíte zadatID sp
přiřazené ve zřizování. -
Aktualizace synchronizace adresáře pro podnik Broadworks – zadejte
ID
pro aktualizaci stavu syc adresáře pro daný podnik a povolte nebo zakažte synchronizaci adresáře. -
Spustit synchronizaci adresáře pro podnik – Použijte tuto metodu API, pokud chcete spustit okamžitou synchronizaci pro dané
ID podniku
. Pro položkuStatus
zadejte příkazSYNC_NOW
. -
Získání stavu synchronizace adresáře pro podnik– zadejte podnikové
ID
a spusťte, abyste získali stav aID
nejnovější synchronizace.ID
můžete použít ke spuštění další analýzy pomocí nástrojů, jako je Kibana a Grafana.
Kromě toho mohou správci použít aktivační synchronizaci adresářů pro rozhraní API pro jednoho uživatele ke spuštění synchronizace adresářů na vyžádání pro jednoho uživatele.
Podrobnou dokumentaci k rozhraní API naleznete v tématu https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Chcete-li si přečíst specifikaci rozhraní API na adrese https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Synchronizace více podniků s rozhraním API
-
Synchronizace adresářů umožňuje synchronizovat pouze jeden podnik z clusteru Broadworks najednou prostřednictvím synchronizace na vyžádání. Pokud se pokusíte synchronizovat více než jednu podnikovou jednotku, zobrazí se chyba 429
-
Doba potřebná k aktivaci synchronizace pro jeden podnik se liší v závislosti na velikosti podniku.
1 |
Spuštěním rozhraní API List BroadWorks Enterprises vygenerujte seznam podniků, které chcete synchronizovat. |
2 |
Spusťte aktivační synchronizaci adresáře pro rozhraní Enterprise API v prvním podniku v seznamu. |
3 |
Počkejte několik sekund a pak spusťte rozhraní API Get Directory Sync Status API, abyste získali stav synchronizace. |
4 |
Po dokončení synchronizace proveďte kroky 2 až 4 v dalším podniku v seznamu. Opakujte tyto kroky, dokud nesynchronizujete celý seznam. |
Kódy chyb pro synchronizaci adresářů
Následující kódy chyb platí pro synchronizaci adresářů.
Kód chyby |
Zpráva o chybě |
---|---|
600000 |
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 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 |
BroadWorks Phone List Sync se nepodařilo synchronizovat všechny kontakty uživatelů a podniků/organizací. |
600018 |
Synchronizace telefonního seznamu BroadWorks se nezdařila pro uživatele v podniku nebo organizaci. |
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 již v této organizaci existuje. |
600024 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože v 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 |
Synchronizaci uživatelů externího adresáře BroadWorks se nepodařilo aktualizovat účet počítače v CI. |
600027 |
Synchronizace jednoho uživatele externího adresáře BroadWorks není možná, protože v BroadWorks bylo nalezeno více uživatelů. |
600028 |
Synchronizace externích adresářů BroadWorks pro jednoho uživatele není možná, protože by měla být dokončena alespoň jedna synchronizace podnikových 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
Následující tabulka shrnuje aktualizace tohoto článku.
Datum |
Revize |
---|---|
14. února 2023 |
Byla aktualizována část Maxima synchronizace adresářů a zdrojová část. |
10. prosince 2022 |
Byl aktualizován pojem Complete Immediate Sync na Trigger Directory Sync |
Července 19, 2022 |
Objasnění a opravy přehledových informací:
|
Května 09, 2022 |
|
Dubna 07, 2022 |
|
28. března 2022 |
|
24. března 2022 |
Přidán seznam synchronizovaných typů telefonních čísel do Podmínek synchronizace adresářů. Synchronizace nyní obsahuje čísla mobilních telefonů. |
16. března 2022 |
|
Prosince 17, 2021 |
|
Prosince 16, 2021 |
|
Prosince 08, 2021 |
|