Katalogsynkronisering sikrer, at Webex for Cisco BroadWorks-brugere kan bruge Webex-mappen fra Webex-appen til at ringe til enhver opkaldende enhed fra BroadWorks-serveren. Denne funktion synkroniserer BroadWorks-opkaldsoplysninger, der ikke var en del af brugerklargøring, til Webex-mappen.

Webex til Cisco BroadWorks-brugerklargøring opdaterer Webex-mappen med opkaldsoplysninger for Webex for Cisco BroadWorks-brugere (primært telefonnummer, mobiltelefonnummer, udvidelse), men udelader eksterne opkaldsoptegnelser. Men når katalogsynkronisering er aktiveret, synkroniserer funktionen også følgende opkaldsposter til Webex-mappen.

• Brugere, der kun ringer til Broadworks (som ikke er onboardet til Webex)

• Opkaldsenheder, der ikke er brugere (f.eks. en telefon i et mødelokale, en faxmaskine, et hunt-gruppenummer)

• BroadWorks telefonlisteposter

Følgende tabel opsummerer BroadWorks-opkaldsoptegnelser og viser, hvordan de føjes til Webex-mappen.

Betingelser for katalogsynkronisering

• Partneradministratorer skal aktivere funktionen på partnerniveau. Partneradministratorer kan slå funktionen til eller fra for flere kundeorganisationer i en enkelt operation.

• Som standard sker den indledende synkronisering en uge efter aktiveringen af synkroniseringen (det valgte tidspunkt for at starte synkroniseringen er tilfældigt). Kundeorganisationer kan dog bruge indstillingen Synkroniser nu til at omgå ventetiden på en uge og udløse en øjeblikkelig synkronisering for en given kundeorganisation.

• Som standard kører mappesynkronisering ugentligt for hver kunde. Hver synkronisering sker en uge efter den sidste synkronisering, uanset om den sidste synkronisering blev planlagt eller udløst manuelt med Synkroniser nu.

• Det maksimale antal samtidige synkroniseringer pr. BroadWorks-klynge er to: en planlagt synkronisering og en on-demand-synkronisering (via API eller Partner Hub GUI). Administratorer kan dog ikke køre to on-demand-synkroniseringer på samme tid fra den samme BroadWorks. Denne begrænsning eksisterer, uanset om synkroniseringen blev startet via API'en eller via indstillingen Synkroniser nu i Partner Hub. Derudover planlægger Webex ikke to planlagte synkroniseringer til at køre på samme tid fra den samme BroadWorks.

• Hvis der opstår en synkroniseringsfejl, forsøger Webex synkroniseringen automatisk hver 24. time indtil den næste planlagte synkronisering.

• Synkroniseringen ignorerer brugere, der ikke har et telefonnummer.

• I Partner Hub kan du få vist oplysninger om synkroniseringsstatus for en given kunde. Derudover kan du eksportere detaljerede oplysninger om den sidste synkronisering til en CSV-post. CSV-posten indeholder flere detaljer end Control Hub-displayet og kan hjælpe med fejlfinding, analyse og overvågning.

• Webex gemmer brugerkontakter i et krypteret format. Kun den bruger, der ejer kontakten, har adgang til dekrypteringsnøglen.

• For brugere, der kun ringer til Broadworks, og enheder, der ikke er brugere, synkroniserer denne funktion følgende telefonnummertyper fra BroadWorks:

  • Primært telefonnummer

  • Mobiltelefonnummer

  • Udvidelse

  Synkronisering udelukker dog kun Broadworks-opkaldende brugere og ikke-brugeropkaldsenheder fra synkroniseringen, hvis hverken et primært telefonnummer eller en hovedudvidelse er til stede.

  BroadWorks indstillinger for beskyttelse af personlige oplysninger på brugerniveau understøttes ikke som en del af mappesynkronisering.

BroadWorks telefonliste og kontaktmaksimum

Katalogsynkronisering synkroniserer også BroadWorks-telefonlisteposter til Webex-kontakter. Synkroniserede poster føjes til en af følgende kontakttyper:

• Organisationskontakter — Webex gemmer disse kontakter mod en organisation. Hver bruger kan få adgang til organisationens kontakter for deres organisation. Maksimumet er op til 30000 kontakter.

• Brugerkontakter — Webex gemmer disse kontakter mod en bruger. Kun den bruger, der ejer kontakten, kan få adgang til kontaktposten. Maksimumet er op til 2000 kontakter (1500 synkroniserede kontakter + 500 manuelle indgangskontakter).

Følgende tabel knytter Webex-kontakttyper til kontaktkilden (synkroniseret fra en BroadWorks-telefonliste eller tilføjet manuelt):

Følgende betingelser gælder for, hvordan Directory Sync håndterer maksimum antal kontakter:

• Hvis en organisation overskrider det maksimale tilladte antal kontakter for synkroniseringen (30000 organisationskontakter eller 30000 Gruppefælles kontakter pr. gruppe), udelukker mappesynkronisering poster over maksimumstærsklen. Der er ingen bestemt rækkefølge anvendt på synkroniserede eller udeladte kontakter.

• Hvis en af dine kunder overskrider det maksimalt tilladte antal kontakter i en af kategorierne, anbefaler vi, at du rejser en sag med Cisco for at få den pågældende organisation udelukket fra katalogsynkronisering.

• Manuelle kontakter er kontakter, som en bruger tilføjer manuelt i Webex-appen. En bruger kan tilføje op til 500 manuelle kontakter. Manuelle kontakter falder inden for den større brugerkontaktkategori på Webex, men er ikke inkluderet i synkroniseringen.

• Den samlede samlede grænse for organisationskontakter (30000) og gruppekontakter (30000 pr. gruppe) er 200000.

Opdateringer

Følgende er, hvordan Webex-mappen håndterer opdateringer:

• Hvis kontaktnavnet ændres på BroadWorks, slettes den eksisterende kontakt fra Webex-mappen, og der oprettes en ny kontakt.

• Hvis kontaktnummeret ændres på BroadWorks, opdaterer Webex den eksisterende kontakt i Webex-mappen med det nye nummer.

Når en administrator opdaterer en kontakt på BroadWorks, beskrives følgende betingelser, når opdateringen vises i en brugers Webex-app:

• Hvis opdateringen vedrører en bruger, der kun ringer til Broadworks, eller et ikke-brugeropkald, vises opdateringen i en brugers Webex-app umiddelbart efter den efterfølgende mappesynkronisering.

• Hvis opdateringen er til en BroadWorks-telefonlistepost:

  • For brugerkontakter — Opdateringer vises i brugerens Webex-app umiddelbart efter den efterfølgende mappesynkronisering.

  • For gruppekontakter - Opdateringer vises i brugernes Webex-app umiddelbart efter den efterfølgende katalogsynkronisering.

  • For organisationskontakter — Webex-mappen opdateres ved den efterfølgende katalogsynkronisering, men brugerne kan ikke se ændringen i Webex-appen, før de genstarter Webex-appen, eller indtil den lokale 72-timers cachetimer udløber.

Vi anbefaler, at du bruger følgende indstillinger:

• Hastighedsbegrænsende værdier — Indstil følgende OverloadControl-systemegenskaber (XSP_CLI/Applications/XSI-Actions/OverloadControl):

  • userDirectoryTransactionLimit—indstillet til en null-værdi.

  • GlobalDirectoryTransactionLimit—indstillet til en null-værdi.

  Det anbefales, at du indstiller UserDirectoryTransactionLimit og GlobalDirectoryTransactionLimit til en null-værdi. Men hvis du beslutter at tildele værdier, skal hver være indstillet til mindst fem gange værdien af TransactionLimitPeriodSeconds (som skal være 1).

• Transaktionsgrænser — Angiv følgende værdier (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit—indstillet til mindst 100.

  • TransactionLimitPeriodSecs — indstillet til 1.

• Personsøgningsværdier — Angiv egenskaberne for personsøgningssystemet (XSP_CLI/Applications/XSI-Actions/Paging):

  • DefaultPageSize — indstillet til 50

  • AvailableUserMaxLimit-indstillet til 100

• CTI-grænseflade — Sørg for at overføre disse Webex CA-certifikater til CTI-grænsefladens tillidslager og aktivere klientgodkendelse på CTI-grænsefladen.

Afhængigt af din BroadWorks-udgave anbefaler vi desuden, at du anvender følgende systemprogramrettelser på BroadWorks-udrulningen, før du aktiverer denne funktion:

• Til R22: AP.AS.22.0.1123.AP368517

• Til R23: AP.AS.23.0.1075.AP368517

• Til R24: ingen patch kræves

Partneradministratorer kan aktivere katalogsynkronisering for en kundeskabelon, mens de opretter den nye skabelon. Alle nye kundeorganisationer, der bliver tildelt den pågældende skabelon, vil have mappesynkronisering aktiveret. Du kan finde flere oplysninger i „Konfigurer dine onboarding-skabeloner“ i Konfigurer din partnerorganisation i Partner Hub i L øsningsvejledningen til Webex til Cisco BroadWorks.

Hvad skal man gøre næste gang

Sørg for, at dine brugere ved, at de skal klikke på fanen Kontakter i Webex-appen mindst én gang for at aktivere funktionen i Webex-appen. Dette skal kun gennemføres én gang.

Offentlige API'er er tilgængelige på developer.webex.com, der giver partneradministratorer mulighed for at opdatere indstillinger for katalogsynkronisering for de kundeorganisationer, de administrerer, for at udløse en øjeblikkelig synkronisering eller få oplysninger om synkroniseringsstatus. Metoderne til mappesynkronisering er grupperet under BroadWorks Enterprises:

• Liste over BroadWorks Enterprises — Brug denne API-metode til at få en liste over virksomheder under en given tjenesteudbyder og hver virksomheds id. Du skal angive SPEnterpriseID som tildelt i klargøring.

• Opdater katalogsynkronisering for en BroadWorks Enterprise — An giv virksomheds- id 'et for at opdatere katalogsyc-status for den pågældende virksomhed, aktivere eller deaktivere mappesynkronisering.

• Udløs katalogsynkronisering for en virksomhed — Brug denne API-metode, hvis du vil udløse en øjeblikkelig synkronisering for et givet virksomheds- id. For SyncStatus skal du indtaste kommandoen SYN C_NOW.

• Hent katalogsynkroniseringsstatus for en virksomhed — Indtast virksomheds- id' et, og kør for at få status og trackingID for den seneste synkronisering. Du kan bruge TrackingID til at køre yderligere analyser via værktøjer som Kibana og Grafana.

Derudover kan administratorer bruge API'en Trigger Directory Sync for a Single User til at udløse en on-demand-mappesynkronisering for en enkelt bruger.

Du kan finde detaljeret API-dokumentation på https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Du skal logge ind for at læse API-specifikationen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Følgende fejlkoder gælder for Directory Sync.

Følgende tabel opsummerer opdateringer til denne artikel.