Katalogsynkronisering sikrer at Webex for Cisco BroadWorks-brukere kan bruke Webex-katalogen fra Webex-appen til å ringe en anropende enhet fra BroadWorks-serveren. Denne funksjonen synkroniserer BroadWorks-anropsinformasjon som ikke var en del av brukerklargjøring til Webex-katalogen.

Webex for Cisco BroadWorks-brukerklargjøring oppdaterer Webex-katalogen med anropsinformasjon for Webex for Cisco BroadWorks-brukere (primært telefonnummer, mobiltelefonnummer, utvidelse), men utelater eksterne anropsposter. Når katalogsynkronisering er på, synkroniserer funksjonen imidlertid også følgende anropsoppføringer til Webex-katalogen.

• Brukere som kun ringer til Broadworks (som ikke er koblet til Webex)

• Enheter som ikke er brukere som ringer (f.eks. en konferanseromstelefon, faksmaskin, jaktgruppenummer)

• BroadWorks telefonlisteoppføringer

Tabellen nedenfor oppsummerer BroadWorks anropsposter og viser hvordan de blir lagt til i Webex-katalogen.

Betingelser for katalogsynkronisering

• Partneradministratorer må aktivere funksjonen på partnernivå. Partneradministratorer kan slå funksjonen på eller av for flere kundeorganisasjoner i en enkelt operasjon.

• Som standard skjer den første synkroniseringen én uke etter aktivering av synkroniseringen (tidspunktet valgt for å starte synkroniseringen er tilfeldig). Kundeorganisasjoner kan imidlertid bruke Synkroniser nå- alternativet til å omgå ventetiden på én uke og utløse en umiddelbar synkronisering for en gitt kundeorganisasjon.

• Som standard kjøres katalogsynkronisering ukentlig for hver kunde. Hver synkronisering skjer én uke etter siste synkronisering, uavhengig av om den siste synkroniseringen ble planlagt eller utløst manuelt med Synkroniser nå.

• Maksimalt antall samtidige synkroniseringer per BroadWorks-klynge er to: én planlagt synkronisering og én synkronisering på forespørsel (via API eller Partner Hub GUI). Administratorer kan imidlertid ikke kjøre to on-demand-synkroniseringer samtidig fra samme BroadWorks. Denne begrensningen eksisterer uavhengig av om synkroniseringen ble startet via API eller via Synkroniser nå- alternativet i Partner Hub. I tillegg planlegger ikke Webex to planlagte synkroniseringer som skal kjøres samtidig fra samme BroadWorks.

• Hvis det oppstår en synkroniseringsfeil, forsøker Webex synkroniseringen automatisk hver 24. time til neste planlagte synkronisering.

• Synkroniseringen ignorerer brukere som ikke har et telefonnummer.

• I Partner Hub kan du vise synkroniseringsstatusinformasjon for en gitt kunde. I tillegg kan du eksportere detaljert informasjon om den siste synkroniseringen til en CSV-post. CSV-oppføringen gir flere detaljer enn Control Hub-skjermen, og kan hjelpe deg med feilsøking, analyse og revisjon.

• Webex lagrer brukerkontakter i kryptert format. Bare brukeren som eier kontakten har tilgang til dekrypteringsnøkkelen.

• Denne funksjonen synkroniserer følgende telefonnummertyper fra BroadWorks for brukere som kun ringer Broadworks, og enheter som ikke ringer til brukere som ikke er brukere:

  • Primært telefonnummer

  • Mobiltelefonnummer

  • Utvidelse

  Synkronisering ekskluderer imidlertid kun Broadworks-anropende brukere og ikke-brukeranropende enheter fra synkroniseringen hvis verken et primært telefonnummer eller en hovedutvidelse er tilstede.

  Innstillingen for personverntjeneste på BroadWorks brukernivå støttes ikke som en del av katalogsynkronisering.

BroadWorks telefonliste og kontaktmaksimum

Katalogsynkronisering synkroniserer også BroadWorks telefonlisteoppføringer til Webex-kontakter. Synkroniserte oppføringer legges til i en av følgende kontakttyper:

• Organisasjonskontakter — Webex lagrer disse kontaktene mot en organisasjon. Hver bruker kan få tilgang til organisasjonskontaktene for organisasjonen sin. Maksimum er opptil 30000 kontakter.

• Brukerkontakter — Webex lagrer disse kontaktene mot en bruker. Bare brukeren som eier kontakten kan få tilgang til kontaktoppføringen. Maksimum er opptil 2000 kontakter (1500 synkroniserte kontakter + 500 manuelle inngangskontakter).

Tabellen nedenfor tilordner Webex-kontakttyper mot kontaktkilden (synkronisert fra en BroadWorks-telefonliste eller lagt til manuelt):

Følgende betingelser gjelder for hvordan Directory Sync håndterer maksimum antall kontakter:

• Hvis en organisasjon overskrider maksimalt tillatte kontakter for synkroniseringen (30000 organisasjonskontakter eller 30000 Gruppefelleskontakter per gruppe), ekskluderer katalogsynkronisering oppføringer over maksimumsgrensen. Det er ingen spesiell rekkefølge brukt på synkroniserte eller utelatte kontakter.

• Hvis en av kundene dine overskrider maksimalt tillatt antall kontakter i en av kategoriene, anbefaler vi at du tar opp en sak med Cisco for å få den organisasjonen ekskludert fra katalogsynkronisering.

• Manuelle kontakter er kontakter som en bruker legger til manuelt i Webex-appen. En bruker kan legge til opptil 500 manuelle kontakter. Manuelle kontakter faller innenfor den større kategorien Brukerkontakt på Webex, men er ikke inkludert i synkroniseringen.

• Den samlede kombinerte grensen for organisasjonskontakter (30000) og gruppekontakter (30000 per gruppe) er 200000.

Oppdateringer

Følgende er hvordan Webex-katalogen håndterer oppdateringer:

• Hvis kontaktnavnet endres på BroadWorks, blir den eksisterende kontakten slettet fra Webex-katalogen og en ny kontakt opprettes.

• Hvis kontaktnummeret endres på BroadWorks, oppdaterer Webex den eksisterende kontakten i Webex-katalogen med det nye nummeret.

Etter at en administrator oppdaterer en kontakt på BroadWorks, beskrives følgende forhold når oppdateringen vises i en brukers Webex-app:

• Hvis oppdateringen gjelder en Broadworks-anropende bruker eller en ikke-brukeranropende enhet, vises oppdateringen i en brukers Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

• Hvis oppdateringen er til en BroadWorks-telefonlisteoppføring:

  • For brukerkontakter — Oppdateringer vises i brukerens Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

  • For gruppekontakter - Oppdateringer vises i brukerne Webex-appen umiddelbart etter den påfølgende katalogsynkroniseringen.

  • For organisasjonskontakter — Webex-katalogen oppdateres ved den påfølgende katalogsynkroniseringen, men brukerne vil ikke se endringen i Webex-appen før de starter Webex-appen på nytt eller til den lokale 72-timers hurtigbuffertimeren utløper.

Vi anbefaler at du bruker følgende innstillinger:

• Hastighetsbegrensende verdier — Angi følgende OverloadControl-systemegenskaper (XSP_CLI/Applications/XSI-Actions/OverloadControl):

  • UserDirectoryTransactionLimit—Sett til en nullverdi.

  • GlobalDirectoryTransactionLimit—Sett til en nullverdi.

  Det anbefales at du angir UserDirectoryTransactionLimit og GlobalDirectoryTransactionLimit til en nullverdi. Men hvis du bestemmer deg for å tilordne verdier, må hver settes til minst fem ganger verdien av TransactionLimitPeriodSeconds (som skal være 1).

• Transaksjonsgrenser — Angi følgende verdier (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit—Sett til minst 100.

  • TransactionLimitPeriodSecs — Sett til 1.

• Personsøkingsverdier — Angi personsøkersystemets egenskaper (XSP_CLI/Applications/XSI-Actions/Paging):

  • DefaultPageSize — sett til 50

  • AvailableUserMaxLimit — Sett til 100

• CTI-grensesnitt — Sørg for å laste opp Webex CA-sertifikatene til CTI-grensesnittklareringslageret og aktivere klientgodkjenning på CTI-grensesnittet.

I tillegg, avhengig av BroadWorks-utgivelsen, anbefaler vi at du bruker følgende systemoppdateringer på BroadWorks-distribusjon før du aktiverer denne funksjonen:

• For R22: AP.AS.22.0.1123.AP368517

• For R23: AP.AS.23.0.1075.AP368517

• For R24: ingen patch kreves

Partneradministratorer kan aktivere katalogsynkronisering for en kundemal mens de oppretter den nye malen. Alle nye kundeorganisasjoner som blir tilordnet den malen, vil ha katalogsynkronisering aktivert. Hvis du vil ha mer informasjon, kan du se «Konfigurer onboarding-malene dine» i Konfigurer partnerorganisasjonen din i Partner Hub i løsningsveiledningen for Webex for Cisco BroadWorks.

Hva du skal gjøre neste

Forsikre deg om at brukerne vet at de må klikke på fanen Kontakter i Webex-appen minst en gang for å slå på funksjonen i Webex-appen. Dette må bare fullføres en gang.

Offentlige API-er er tilgjengelige på developer.webex.com som lar partneradministratorer oppdatere katalogsynkroniseringsinnstillinger for kundeorganisasjonene de administrerer, for å utløse en umiddelbar synkronisering eller få informasjon om synkroniseringsstatus. Katalogsynkroniseringsmetodene er gruppert under BroadWorks Enterprises:

• Liste over BroadWorks Enterprises — Bruk denne API-metoden for å få en liste over bedrifter under en gitt tjenesteleverandør og hver bedrifts ID. Du må angi SPEnterpriseID som tilordnet i klargjøring.

• Oppdater katalogsynkronisering for en BroadWorks-bedrift — Angi bedrifts- ID- en for å oppdatere katalogsyc-statusen for den bedriften, aktivere eller deaktivere katalogsynkronisering.

• Trigger katalogsynkronisering for en bedri ft — Bruk denne API-metoden hvis du vil utløse en umiddelbar synkronisering for en gitt bedrifts- ID. For SyncStatus skriver du inn kommandoen SYN C_NOW.

• Få katalogsynkroniseringsstatus for en bedrift — Angi bedrift s-ID og kjør for å få status og spor ingID for den siste synkroniseringen. Du kan bruke TrackingID til å kjøre ytterligere analyser via verktøy som Kibana og Grafana.

I tillegg kan administratorer bruke Trigger Directory Sync for a Single User API til å utløse en katalogsynkronisering på forespørsel for en enkelt bruker.

Hvis du vil ha detaljert API-dokumentasjon, kan du se https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Du må logge på for å lese API-spesifikasjonen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Følgende feilkoder gjelder for katalogsynkronisering.

Tabellen nedenfor oppsummerer oppdateringer til denne artikkelen.