Katalogsynkronisering i Webex for Cisco BroadWorks

Katalogsynkronisering sikrer at Webex for Cisco BroadWorks-brukere kan bruke Webex-katalogen fra Webex-appen til å ringe en hvilken som helst anropsenhet 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 samtaledetaljer for Webex for Cisco BroadWorks-brukere (primærtelefon , mobiltelefonnummer, internnummer), men utelater eksterne samtaleoppføringer. Når katalogsynkronisering er på, synkroniserer imidlertid funksjonen også følgende anropsoppføringer til Webex-katalogen.

• Brukere som kun anroper BroadWorks (som ikke er integrert i Webex)

• Anropsenheter som ikke er brukere (f.eks. en telefon i et konferanserom, faks, nummer for huntgruppe )

• Oppføringer i BroadWorks-telefonliste

Tabellen nedenfor oppsummerer BroadWorks-anropsoppføringer og viser hvordan de legges til i Webex-katalogen.

Vilkår for synkronisering av katalog

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

• Som standard skjer den første synkroniseringen én uke etter aktivering av synkroniseringen (tidspunktet som er valgt for å starte synkroniseringen er tilfeldig). Kundeorganisasjoner kan imidlertid bruke Synkroniser nå alternativet for å 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 synkroniseringer på forespørsel samtidig fra samme BroadWorks. Denne begrensningen finnes uavhengig av om synkroniseringen ble startet via API-en eller via Synkroniser nå alternativet i Partner Hub. I tillegg planlegger ikke Webex å kjøre to planlagte synkroniseringer samtidig fra samme BroadWorks.

• Hvis det oppstår en synkroniseringsfeil, prøver Webex å synkronisere på nytt automatisk hver 24. time frem til neste planlagte synkronisering.

• Synkroniseringen ignorerer brukere som ikke har et telefonnummer.

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

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

• For brukere som bare ringer BroadWorks og enheter som ikke bruker anrop, synkroniserer denne funksjonen følgende telefonnummer fra BroadWorks:

  • Hovedtelefonnummer

  • Mobilnummer

  • Internnummer

  Synkronisering utelater imidlertid BroadWorks-anropsbrukere og ikke-brukeranropsenheter fra synkroniseringen hvis verken et primærtelefon eller internlinje finnes.

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

BroadWorks-telefonliste og maksimalt antall kontakter

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

• Organisasjonskontakter – Webex lagrer disse kontaktene mot en organisasjon. Hver bruker har tilgang til organisasjonskontaktene for sin organisasjon. Maksimalt antall er opptil 30 000 kontakter.

• Brukerkontakter – Webex lagrer disse kontaktene mot en bruker. Bare brukeren som eier kontakten, har tilgang til kontaktoppføringen. Maksimalt antall er opptil 2000 kontakter (1500 synkroniserte kontakter + 500 kontakter med manuell oppføring).

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 maksimalt antall kontakter:

• Hvis en organisasjon overskrider det maksimale antallet tillatte kontakter for synkroniseringen (30 000 organisasjonskontakter eller 30 000 felles gruppekontakter per gruppe), ekskluderer katalogsynkronisering oppføringer over maksimumsterskelen. Det er ingen bestemt 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 håndterer oppdateringer i Webex-katalogen:

• Hvis kontaktnavn endres på BroadWorks, slettes den eksisterende kontakten 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.

Når en administrator har oppdatert en kontakt på BroadWorks, viser følgende forhold når oppdateringen vises i en brukers Webex-app:

• Hvis oppdateringen er til en bruker som bare ringer BroadWorks eller en enhet som ikke er bruker, vises oppdateringen i en brukers Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

• Hvis oppdateringen gjelder en oppføring i BroadWorks-telefonlisten:

  • For brukerkontakter – oppdateringer vises i brukerens Webex-app umiddelbart etter påfølgende katalogsynkronisering.

  • For gruppekontakter – oppdateringer vises i brukerens Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

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

Vi anbefaler at du bruker følgende innstillinger:

• Frekvensbegrensende verdier – Angi følgende systemegenskaper for OverloadControl (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit – angis til en nullverdi.

  • globalDirectoryTransactionLimit – angis til en nullverdi.

  Det anbefales at du angir en nullverdi for userDirectoryTransactionLimit og globalDirectoryTransactionLimit. Hvis du imidlertid bestemmer deg for å tilordne verdier, må hver angis til minst fem ganger verdien av transactionLimitPeriodSeconds (som skal være 1).

• Transaksjonsgrenser – Angi følgende verdier (XSP_ CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit – angis til minst 100.

  • transactionLimitPeriodSecs – angis til 1.

• Sidevekslingsverdier – Angi egenskapene for personvekslingssystemet (XSP_ CLI/Programmer/Xsi-Actions/Paging):

  • defaultPageSize – Angis til 50

  • availableUserMaxLimit – Angis til 100

• CTI-grensesnitt – Sørg for å laste opp disse Webex CA-sertifikatene til klareringslageret for CTI-grensesnittet, og for å aktivere klientgodkjenning på CTI-grensesnittet.

I tillegg, avhengig av BroadWorks-versjonen, 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 oppdatering kreves

Partneradministratorer kan aktivere Katalogsynkronisering for en kundemal mens de oppretter den nye malen. Alle nye kundeorganisasjoner som blir tilordnet denne malen, vil ha katalogsynkronisering aktivert. Hvis du vil ha mer informasjon, se «Konfigurere kundemaler» i Konfigurer partnerorganisasjonen din i Partner Hub innenfor Løsningsveiledning for Webex for Cisco BroadWorks .

Hva du bør gjøre Neste

Kontroller at brukerne vet at de må klikke på Kontakter i Webex-appen minst én gang for å aktivere funksjonen i Webex-appen. Dette må bare fullføres én gang.

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

• Vis en liste over BroadWorks-bedrifter –Bruk denne API-metoden til å hente 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 BroadWorks Enterprise – Skriv inn bedriften id for å oppdatere katalogsyc-statusen for den bedriften, aktivere eller deaktivere katalogsynkronisering.

• Utløs katalogsynkronisering for en bedrift –Bruk denne API-metoden hvis du vil utløse en umiddelbar synkronisering for en gitt bedrift id. For syncStatus, angi SYNC_NOW kommandoen.

• Få status for katalogsynkronisering for en bedrift – Skriv inn bedriften id og kjør for å få en status og trackingId av den nyeste synkroniseringen. Du kan bruke trackingID for å kjøre ytterligere analyser via verktøy som Kibana og Grafana.

I tillegg kan administratorer bruke Utløs katalogsynkronisering for én bruker API for å utløse en katalogsynkronisering på forespørsel for én bruker.

Hvis du vil ha detaljert API-dokumentasjon, sehttps://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 Directory Sync.

Tabellen nedenfor oppsummerer oppdateringer av denne artikkelen.