Katalogsynkronisering säkerställer att Webex för Cisco BroadWorks-användare kan använda Webex-katalogen från Webex-appen för att ringa alla anropande enheter från BroadWorks-servern. Den här funktionen synkroniserar BroadWorks-samtalsinformation som inte ingick i användarprovisioneringen till Webex-katalogen.

Webex för Cisco BroadWorks-användarprovisionering uppdaterar Webex-katalogen med samtalsinformation för Webex för Cisco BroadWorks-användare (primärt telefonnummer, mobiltelefonnummer, tillägg), men utelämnar externa samtalsposter. Men när katalogsynkronisering är aktiverad synkroniserar funktionen även följande samtalsposter till Webex-katalogen.

• Användare som endast ringer till Broadworks (som inte är inloggade på Webex)

• Samtalsenheter som inte är användare (t.ex. en konferenslokalstelefon, faxmaskin, jaktgruppsnummer)

• BroadWorks telefonlistposter

Följande tabell sammanfattar BroadWorks samtalsposter och visar hur de läggs till i Webex-katalogen.

Villkor för katalogsynkronisering

• Partneradministratörer måste aktivera funktionen på partnernivå. Partneradministratörer kan aktivera eller inaktivera funktionen för flera kundorganisationer i en enda åtgärd.

• Som standard sker den första synkroniseringen en vecka efter aktiveringen av synkroniseringen (den tid som valts för att starta synkroniseringen är slumpmässig). Kundorganisationer kan dock använda alternativet Synkronisera nu för att kringgå en veckas väntetid och utlösa en omedelbar synkronisering för en viss kundorganisation.

• Som standard körs katalogsynkronisering varje vecka för varje kund. Varje synkronisering sker en vecka efter den senaste synkroniseringen, oavsett om den senaste synkroniseringen schemalagdes eller utlöstes manuellt med Synkronisera nu.

• Det maximala antalet samtidiga synkroniseringar per BroadWorks-kluster är två: en schemalagd synkronisering och en synkronisering på begäran (via API eller Partner Hub GUI). Administratörer kan dock inte köra två on-demand-synkroniseringar samtidigt från samma BroadWorks. Denna begränsning existerar oavsett om synkroniseringen initierades via API:et eller via alternativet Synkronisera nu i Partner Hub. Dessutom schemalägger Webex inte två schemalagda synkroniseringar för att köras samtidigt från samma BroadWorks.

• Om ett synkroniseringsfel inträffar försöker Webex synkroniseringen automatiskt var 24:e timme tills nästa schemalagda synkronisering.

• Synkroniseringen ignorerar användare som inte har ett telefonnummer.

• I Partner Hub kan du visa synkroniseringsstatusinformation för en viss kund. Dessutom kan du exportera detaljerad information om den senaste synkroniseringen till en CSV-post. CSV-posten innehåller mer information än Control Hub-skärmen och kan hjälpa till vid felsökning, analys och granskning.

• Webex lagrar användarkontakter i ett krypterat format. Endast användaren som äger kontakten har tillgång till dekrypteringsnyckeln.

• Den här funktionen synkroniserar följande telefonnummertyper från BroadWorks för användare som endast ringer Broadworks och som inte är användare:

  • Primär telefonnummer

  • Mobiltelefonnummer

  • Förlängning

  Synkronisering utesluter dock Broadworks-endast samtalsanvändare och icke-användarenheter från synkroniseringen om varken ett primärt telefonnummer eller ett huvudtillägg finns.

  BroadWorks inställningar för sekretesstjänster på användarnivå stöds inte som en del av katalogsynkronisering.

BroadWorks telefonlista och kontaktmaxima

Katalogsynkronisering synkroniserar också BroadWorks telefonlistposter till Webex-kontakter. Synkroniserade poster läggs till i någon av följande kontakttyper:

• Organisationskontakter — Webex lagrar dessa kontakter mot en organisation. Varje användare kan komma åt organisationens kontakter för sin organisation. Maximalt är upp till 30000 kontakter.

• Användarkontakter — Webex lagrar dessa kontakter mot en användare. Endast användaren som äger kontakten kan komma åt kontaktposten. Maximalt är upp till 2000 kontakter (1500 synkroniserade kontakter + 500 manuella ingångskontakter).

I följande tabell mappar Webex-kontakttyper mot kontaktkällan (synkroniseras från en BroadWorks-telefonlista eller läggs till manuellt):

Följande villkor gäller för hur Directory Sync hanterar maximalt antal kontakter:

• Om en organisation överskrider det högsta tillåtna antalet kontakter för synkroniseringen (30000 organisationskontakter eller 30000 Gruppera gemensamma kontakter per grupp) utesluter katalogsynkronisering poster över det maximala tröskelvärdet. Det finns ingen särskild ordning som tillämpas på synkroniserade eller utelämnade kontakter.

• Om en av dina kunder överskrider det högsta tillåtna antalet kontakter i någon av kategorierna rekommenderar vi att du tar upp ett ärende med Cisco för att den organisationen ska uteslutas från katalogsynkronisering.

• Manuella kontakter är kontakter som en användare lägger till manuellt i Webex-appen. En användare kan lägga till upp till 500 manuella kontakter. Manuella kontakter faller inom den större kategorin Användarkontakt på Webex, men ingår inte i synkroniseringen.

• Den totala kombinerade gränsen för organisationskontakter (30000) och gruppkontakter (30000 per grupp) är 200000.

Uppdateringar

Följande är hur Webex-katalogen hanterar uppdateringar:

• Om kontaktnamnet ändras på BroadWorks tas den befintliga kontakten bort från Webex-katalogen och en ny kontakt skapas.

• Om kontaktnumret ändras på BroadWorks uppdaterar Webex den befintliga kontakten i Webex-katalogen med det nya numret.

När en administratör uppdaterar en kontakt på BroadWorks beskrivs följande villkor när uppdateringen visas i en användares Webex-app:

• Om uppdateringen gäller en Broadworks-anropande användare eller en icke-användaranropande enhet visas uppdateringen i en användares Webex-app omedelbart efter den efterföljande katalogsynkroniseringen.

• Om uppdateringen gäller en post i BroadWorks telefonlista:

  • För användarkontakter — Uppdateringar visas i användarens Webex-app omedelbart efter efterföljande katalogsynkronisering.

  • För gruppkontakter - Uppdateringar visas i användarnas Webex-app omedelbart efter efterföljande katalogsynkronisering.

  • För organisationskontakter — Webex-katalogen uppdateras vid efterföljande katalogsynkronisering, men användarna ser inte ändringen i Webex-appen förrän de startar om Webex-appen eller tills den lokala 72-timmars cachetimern löper ut.

Vi rekommenderar att du använder följande inställningar:

• Hastighetsbegränsande värden — Ange följande systemegenskaper för OverloadControl (XSP_CLI/Applications/XSI-Actions/OverloadControl):

  • UserDirectoryTransactionLimit—Ställ in till ett nullvärde.

  • GlobalDirectoryTransactionLimit—Ange ett nollvärde.

  Vi rekommenderar att du anger UserDirectoryTransactionLimit och GlobalDirectoryTransactionLimit till ett nullvärde. Men om du bestämmer dig för att tilldela värden måste var och en vara inställd på minst fem gånger värdet för TransactionLimitPeriodSeconds (vilket bör vara 1).

• Transaktionsgränser — Ange följande värden (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit—Ställ in på minst 100.

  • TransactionLimitPeriodSecs — Ställ in på 1.

• Personsökningsvärden — Ange egenskaperna för personsökningssystemet (XSP_CLI/Applications/XSI-Actions/Paging):

  • DefaultPageSize — Ställ in på 50

  • AvailableUserMaxLimit — Ställ in på 100

• CTI-gränssnitt — Se till att överföra Webex CA-certifikaten till CTI-gränssnittets förtroendelager och aktivera klientautentisering i CTI-gränssnittet.

Beroende på din BroadWorks-version rekommenderar vi dessutom att du tillämpar följande systemkorrigeringar på BroadWorks-distributionen innan du aktiverar den här funktionen:

• För R22: AP.AS.22.0.1123.AP368517

• För R23: AP.AS.23.0.1075.AP368517

• För R24: ingen patch krävs

Partneradministratörer kan aktivera katalogsynkronisering för en kundmall när de skapar den nya mallen. Alla nya kundorganisationer som tilldelas den mallen kommer att ha katalogsynkronisering aktiverad. Mer information finns i ”Konfigurera dina onboarding-mallar” i Konfigurera din partnerorganisation i Partner Hub i Lösningsguiden för Webex för Cisco BroadWorks.

Vad du ska göra härnäst

Se till att användarna vet att de måste klicka på fliken Kontakter i Webex-appen minst en gång för att aktivera funktionen i Webex-appen. Detta behöver bara slutföras en gång.

Offentliga API:er finns tillgängliga på developer.webex.com som gör det möjligt för partneradministratörer att uppdatera katalogsynkroniseringsinställningar för de kundorganisationer som de hanterar, för att utlösa en omedelbar synkronisering eller få information om synkroniseringsstatus. Katalogsynkroniseringsmetoderna är grupperade under BroadWorks Enterprises:

• Lista BroadWorks Enterprises — Använd denna API-metod för att få en lista över företag under en viss tjänsteleverantör och varje företags id. Du måste ange SPEnterpriseID som tilldelats vid etablering.

• Uppdatera katalogsynkronisering för ett BroadWorks Enterprise — Ange företags- id för att uppdatera katalogsyc-statusen för det företaget, aktivera eller inaktivera katalogsynkronisering.

• Trigger katalogsynkronisering för ett företag — Använd den här API-metoden om du vill utlösa en omedelbar synkronisering för ett visst företags- id. Ange kommandot SYNC_NOW för Syn cStatus.

• Hämta katalogsynkroniseringsstatus för ett företag — Ange företags- id och kör för att få status och spårnings-ID för den senaste synkroniseringen. Du kan använda TrackingID för att köra ytterligare analyser via verktyg som Kibana och Grafana.

Dessutom kan administratörer använda API: et Trigger Directory Sync for a Single User för att utlösa en katalogsynkronisering på begäran för en enskild användare.

För detaljerad API-dokumentation, se https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Du måste logga in för att läsa API-specifikationen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Följande felkoder gäller för katalogsynkronisering.

Följande tabell sammanfattar uppdateringar av den här artikeln.