Synchronizace adresáře v aplikaci Webex pro Cisco BroadWorks

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.

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ě):

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.

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

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.

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 zadat ID 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žku Status zadejte příkaz SYNC_NOW .

• Získání stavu synchronizace adresáře pro podnik– zadejte podnikové ID a spusťte, abyste získali stav a ID 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.

Následující kódy chyb platí pro synchronizaci adresářů.

Následující tabulka shrnuje aktualizace tohoto článku.