Synchronizace adresářů zajišťuje, že uživatelé Webex pro Cisco BroadWorks mohou používat 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.

Zřizování uživatelů Webex pro Cisco BroadWorks aktualizuje adresář Webex podrobnostmi o volání pro uživatele Webex pro uživatele Cisco BroadWorks (primární telefonní číslo, číslo mobilního telefonu, rozšíření), ale vynechá externí záznamy hovorů. Pokud je však zapnutá synchronizace adresářů, funkce také synchronizuje následující záznamy volání do adresáře Webex.

• Volající uživatelé pouze pro Broadworks (kteří nejsou připojeni k Webex)

• Volající subjekty, které nejsou uživateli (např. telefon v konferenční místnosti, fax, číslo skupiny vyhledávání)

• Položky seznamu telefonů BroadWorks

Následující tabulka shrnuje záznamy volání BroadWorks a ukazuje, jak jsou přidány do adresáře Webex.

Podmínky synchronizace adresáře

• Správci partnerů musí funkci povolit na úrovni partnera. Správci partnerů mohou funkci zapnout nebo vypnout pro více zákaznických organizací v jedné operaci.

• Ve výchozím nastavení dochází k počáteční synchronizaci týden po aktivaci synchronizace (čas zvolený pro spuštění synchronizace je náhodný). Zákaznické organizace však mohou pomocí možnosti Synchronizovat nyní obejít týdenní čekací dobu a spustit okamžitou synchronizaci pro danou organizaci zákazníků.

• Ve výchozím nastavení je synchronizace adresářů spuštěna každý týden pro každého zákazníka. Ke každé synchronizaci dochází 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 simultánních synchronizací na cluster BroadWorks je dva: jedna naplánovaná synchronizace a jedna synchronizace na vyžádání (přes rozhraní API nebo GUI partnerského centra). Správci však nemohou spouštět dvě synchronizace na vyžádání současně ze stejného zařízení BroadWorks. Toto omezení existuje bez ohledu na to, zda byla synchronizace spuštěna prostřednictvím rozhraní API nebo prostřednictvím možnosti Synchronizovat nyní v Partnerském centru. Webex navíc neplánuje dvě naplánované synchronizace spuštěné současně ze stejného zařízení BroadWorks.

• Pokud dojde k selhání synchronizace, Webex se o synchronizaci pokusí automaticky každých 24 hodin až do další naplánované synchronizace.

• Synchronizace ignoruje uživatele, kteří nemají telefonní číslo.

• V Partner Hub 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 ovládacího centra a může pomoci při odstraňování problémů, analýze a auditování.

• Webex ukládá uživatelské kontakty v šifrovaném formátu. K dešifrovacímu klíči má přístup pouze uživatel, který vlastní kontakt.

• Tato funkce synchronizuje následující typy telefonních čísel od společnosti BroadWorks pro uživatele volající pouze pro služby Broadworks a jiné volající entity:

  • Primární telefonní číslo

  • Číslo mobilního telefonu

  • Prodloužení

  Synchronizace však ze synchronizace vylučuje volající uživatele pouze pro službu Broadworks a neuživatelské volající entity ze synchronizace, pokud není k dispozici primární telefonní číslo nebo rozšíření.

  Nastavení služby ochrany osobních údajů na úrovni uživatele BroadWorks není podporováno jako součást synchronizace adresářů.

Seznam telefonů BroadWorks a maximální počet kontaktů

Synchronizace adresářů také synchronizuje položky seznamu telefonů BroadWorks s kontakty Webex. Synchronizované položky se přidají k jednomu 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. Maximum je až 30000 kontaktů.

• Kontakty uživatele — Webex ukládá tyto kontakty proti uživateli. Přístup k položce kontaktu má pouze uživatel, který vlastní kontakt. Maximální je až 2000 kontaktů (1500 synchronizovaných kontaktů + 500 kontaktů ručního zadávání).

Následující tabulka mapuje typy kontaktů Webex se zdrojem kontaktů (synchronizované ze seznamu telefonů BroadWorks nebo přidané ručně):

Pokud jde o způsob, jakým Directory Sync zpracovává maximální počet kontaktů, platí následující podmínky:

• Pokud organizace překročí maximální povolené kontakty pro synchronizaci (30000 kontaktů organizace nebo 30000 skupinových společných kontaktů na skupinu), synchronizace adresářů vyloučí položky nad maximální prahovou hodnotou. Na synchronizované nebo vynechané kontakty není aplikováno žádné konkrétní pořadí.

• Pokud některý z vašich zákazníků překročí maximální povolený počet kontaktů v kterékoli kategorii, doporučujeme vám vznést u společnosti Cisco případ, aby byla tato organizace vyloučena ze synchronizace adresářů.

• Ruční kontakty jsou kontakty, které uživatel přidá ručně v aplikaci Webex. Uživatel může přidat až 500 manuálních kontaktů. Ruční kontakty spadají do větší kategorie uživatelských kontaktů na Webex, ale nejsou zahrnuty do synchronizace.

• Celkový kombinovaný limit pro kontakty organizace (30000) a skupinových kontaktů (30000 na skupinu) je 200000.

Aktualizace

Následuje způsob, jakým adresář Webex zpracovává aktualizace:

• Pokud se název kontaktu změní na BroadWorks, stávající kontakt se odstraní z adresáře Webex a vytvoří se nový kontakt.

• Pokud se číslo kontaktu změní na BroadWorks, Webex aktualizuje existující kontakt v adresáři Webex novým číslem.

Poté, co správce aktualizuje kontakt na serveru BroadWorks, nastíní následující podmínky, kdy se aktualizace zobrazí v aplikaci Webex uživatele:

• Pokud se aktualizace týká pouze volajícího uživatele Broadworks nebo neuživatelského volajícího subjektu, zobrazí se aktualizace v aplikaci Webex uživatele bezprostředně po následné synchronizaci adresáře.

• Pokud se aktualizace týká položky seznamu telefonů BroadWorks:

  • Pro kontakty uživatele — 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ářů, ale uživatelé neuvidí změnu v aplikaci Webex, dokud restartují aplikaci Webex nebo dokud nevyprší časovač místní 72hodinové mezipaměti.

Doporučujeme použít následující nastavení:

• Hodnoty omezení rychlosti — Nastavte následující vlastnosti systému OverloadControl (XSP_CLI/Applications/XSI-Action/OverloadControl):

  • UserDirectoryTransactionLimit—nastaveno na hodnotu null.

  • GlobalDirectoryTransactionLimit—nastaveno na hodnotu null.

  Doporučujeme nastavit hodnotu UserDirectoryTransactionLimit a GlobalDirectoryTransactionLimit na hodnotu null. Pokud se však rozhodnete přiřadit hodnoty, musí být každá nastavena na alespoň pětinásobek hodnoty TransactionLimitPeriodSeconds (což by mělo být 1).

• Omezení transakcí — Nastavte následující hodnoty (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit—nastaveno na hodnotu alespoň 100.

  • TransactionLimitPeriodSecs — nastaveno na hodnotu 1.

• Hodnoty stránkování—Nastavte vlastnosti stránkovacího systému (XSP_CLI/Applications/XSI-Action/Paging):

  • DefaultPageSize — nastaveno na hodnotu 50

  • AvailableUserMaxLimit — nastaveno na hodnotu 100

• Rozhraní CTI — Nezapomeňte nahrát certifikáty certifikační autority Webex do úložiště důvěryhodnosti rozhraní CTI a povolit ověřování klienta v rozhraní CTI.

Kromě toho doporučujeme, abyste v závislosti na verzi BroadWorks před povolením této funkce použili 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á náplast

Správci partnerů mohou při vytváření nové šablony povolit synchronizaci adresářů pro šablonu zákazníka. 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 pro přihlášení“ v části Konfigurace partnerské organizace v centru partnerů 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 tuto funkci zapnuli 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í správcům partnerů aktualizovat nastavení synchronizace adresářů pro zákaznické organizace, které spravují, spustit okamžitou synchronizaci nebo získat informace o stavu synchronizace. Metody synchronizace adresářů jsou seskupeny do skupiny 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 SPEnterpriseID, jak je přiřazen při zřizování.

• Aktualizovat synchronizaci adresářů pro společnost BroadWorks Enterprise — Zadáním podnikového id aktualizujete stav syc adresáře pro daný podnik a povolíte nebo zakážete synchronizaci adresářů.

• Spouštějte synchronizaci adresářů pro podnik — Tuto metodu API použijte, pokud chcete spustit okamžitou synchronizaci pro dané podnikové ID. Do pole SyncStatus zadejte příkaz SYN C_NOW.

• Získat stav synchronizace adresářů pro podnik — Zadejte podnikové id a spusťte, abyste získali stav a ID sledování nejnovější synchronizace. TrackingID můžete použít ke spuštění dalších analýz pomocí nástrojů, jako jsou Kibana a Grafana.

Kromě toho mohou správci použít rozhraní API pro synchronizaci adresářů pro jednoho uživatele ke spuštění synchronizace adresářů na vyžádání pro jednoho uživatele.

Podrobnou dokumentaci k rozhraní API naleznete na adrese https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Pro přečtení specifikace API se musíte přihlásit na adrese https://developer.webex.com/docs/api/v1/broadworks-subscribers.

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

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