Oversikt over katalogsynkronisering

Katalogsynkronisering sikrer at Webex for Cisco BroadWorks-brukere kan bruke Webex-katalogen fra Webex-appen til å kalle opp alle anropsenheter fra BroadWorks-serveren. Denne funksjonen synkroniserer BroadWorks-anropsinformasjon som ikke var en del av brukerklargjøringen til Webex-mappen.

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

  • BroadWorks-brukere som bare ringer (som ikke er ombord på Webex)

  • Ikke-brukeranropsenheter (f.eks. telefon i konferanserom, faksmaskin, jaktgruppenummer)

  • Oppføringer i BroadWorks-telefonliste

Tabellen nedenfor oppsummerer BroadWorks som kaller poster og viser hvordan de legges til i Webex-mappen.

Tabell 1. Oppdatering av katalogsynkronisering til Webex-mappen

BroadWorks kaller oppføringer

Beskrivelse

Lagt til i Webex Directory via...

Webex for Cisco BroadWorks-brukere

Brukere er aktivert for Webex for Cisco BroadWorks

Brukerklargjøring (f.eks. gjennomstrømningsklargjøring)

BroadWorks-brukere som bare ringer

Ringe brukere som ikke er ombord på Webex

Katalogsynkronisering

Enheter som ikke ringer opp brukere

For eksempel en telefon til konferanserom, faksmaskin, Hunt-gruppenummer

Katalogsynkronisering

BroadWorks-telefonlister

BroadWorks-telefonlisteoppføringer:

  • Felles telefonlister for virksomheter

  • Gruppere felles telefonlister (tjenesteleverandørgrupper eller virksomhetsgrupper)

  • Personlige telefonlister

Katalogsynkronisering (synkronisering av telefonliste)


Hvis du vil ha mer informasjon om brukerklargjøring, kan du se Webex for Cisco BroadWorks Solution Guide.

Betingelser for katalogsynkronisering

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

  • Som standard skjer den første synkroniseringen én uke etter at synkroniseringen er aktivert (tiden som er valgt for å starte synkroniseringen, er tilfeldig). Kundeorganisasjoner kan imidlertid bruke alternativet Synkroniser nå til å omgå ventetiden på én uke og fullføre en umiddelbar synkronisering for en gitt kundeorganisasjon.

  • Som standard kjører katalogsynkronisering ukentlig for hver kunde. Hver synkronisering skjer én uke etter siste synkronisering, uansett 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 behovsbetinget synkronisering (via API eller Partner Hub GUI). Administratorer kan imidlertid ikke kjøre to behovsbetinget synkronisering samtidig fra samme BroadWorks. Denne begrensningen finnes uavhengig av om synkroniseringen ble startet via API-et eller via alternativet Synkroniser nå i PartnerHub. I tillegg vil ikke Webex planlegge at to planlagte synkroniseringer skal kjøres samtidig fra samme BroadWorks.

  • Hvis det oppstår en synkroniseringsfeil, prøver Webex synkroniseringen på nytt automatisk hver 24.

  • Synkroniseringen ignorerer brukere som ikke har et telefonnummer.

  • I PartnerHub kan du vise informasjon om synkroniseringsstatus for en gitt kunde. I tillegg kan du eksportere detaljert informasjon om siste synkronisering til en CSV-oppføring. CSV-posten gir flere detaljer enn Control Hub-visningen og kan hjelpe deg med feilsøking, analyse og overvåking.

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

  • For BroadWorks-brukere som bare ringer og enheter som ikke ringer til brukere, synkroniserer denne funksjonen følgende telefonnummertyper fra BroadWorks:

    • Hovedtelefonnummer

    • Mobilnummer

    • Internnummer

    Synkronisering ekskluderer imidlertid broadworks-oppringingsbrukere og ikke-brukeranropende enheter fra synkroniseringen hvis verken et primært telefonnummer eller en primær filtype finnes.

Maksimumsgrense for BroadWorks-telefonliste og -kontakter

Katalogsynkronisering synkroniserer også BroadWorks-telefonlisteoppføringer med 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 organisasjonen. Maksimum er opptil 500 kontakter.

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


Bare telefonlisteoppføringer legges til i Webex-kontakter. BroadWorks-brukere som bare ringer opp og ikke-brukeroppringende enheter som er inkludert i katalogsynkronisering, legges ikke til i Kontakter med mindre en Webex-bruker legger dem til i Kontakter manuelt.

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

Tabell 2. Maksimums- og kilde for katalogsynkronisering

Webex- kontakttype

Kontakt kilde

Maksimum

Synkronisert fra BroadWorks...

API som brukes til synkronisering

Organisasjonskontakter

Katalogsynkronisering

500 kontakter

Felles telefonlister for virksomheter

/directories/enterprisecommon

Gruppere felles telefonlister (for en tjenesteleverandørgruppe)**

/directories/groupcommon

Brukerkontakter

Katalogsynkronisering

1500 kontakter

Gruppere felles telefonlister (for en virksomhetsgruppe)**

/directories/groupcommon

Personlige telefonlister

/directories/personal

Lagt til manuelt av bruker

500 kontakter

N/A

N/A


**Grupper vanlige telefonlister synkroniseres forskjellig avhengig av om BroadWorks er i enterprise-modus eller tjenesteleverandørmodus. Verdien for isBroadWorksEnterprise-parameteren (sann eller usann) bestemmer hvordan listen synkroniseres:

  • Sann– Synkroniser som brukerkontakt

  • Usann: Synkroniser som organisasjonskontakt

Følgende betingelser gjelder for hvordan katalogsynkronisering håndterer kontakt maksimumsgrensene:

  • Hvis en organisasjon overskrider maksimalt antall tillatte kontakter for synkroniseringen (500 organisasjonskontakter eller 1500 synkroniserte brukerkontakter), utelater katalogsynkronisering oppføringer over maksimumsterskelen. Det brukes ingen bestemt rekkefølge på synkroniserte eller utelatte kontakter.

  • Hvis en av kundene dine overskrider maksimalt antall kontakter i en av kategoriene, anbefaler vi at du oppretter en sak med Cisco for å få 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 brukerkontaktkategorien på Webex, men er ikke inkludert i synkroniseringen.

Oppdateringer

Slik håndterer Webex-mappen oppdateringer:

  • Hvis kontaktnavnet endres på BroadWorks, slettes den eksisterende kontakten fra Webex-mappen, og det opprettes en ny kontakt.

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

Når en administrator har oppdatert en kontakt på BroadWorks, skisseres følgende betingelser når oppdateringen vises i webex-appen til en bruker:

  • Hvis oppdateringen gjelder en bruker som bare ringer BroadWorks eller en enhet som ikke er en bruker som ringer, vises oppdateringen i Webex-appen til en bruker rett 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 organisasjonskontakter – Webex-katalogen oppdateres ved den påfølgende katalogsynkroniseringen, men brukerne ser ikke endringen i Webex-appen før webex-appen startes på nytt eller før den lokale 72-timers tidtakeren for hurtigbuffer utløper.


Oppdateringer til Webex for Cisco BroadWorks-brukerinformasjon blir håndtert som en del av klargjøringsprosessene.

Kontrollhub inneholder et alternativ for å legge til eller redigere kontakter på organisasjonsnivå i Kontrollhub via en CSV-fil. Partneradministratorer og kundeadministratorer med Control Hub-tilgang har tilgang til dette alternativet. Oppdatering av kontakter via Control Hub støttes imidlertid ikke av Webex for Cisco BroadWorks. Kontaktoppdateringer som brukes i Kontrollhub, synkroniseres ikke tilbake til BroadWorks og er utilgjengelige for katalogsøk fra bordtelefoner.

Forutsetninger for katalogsynkronisering

Vi anbefaler at du bruker følgende innstillinger:


Eksemplene nedenfor forutsetter at du bruker en XSP-server. For ADP-servere erstatter du (XSP_CLI) med (ADP_CLI).
  • 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 setter userDirectoryTransactionLimit og globalDirectoryTransactionLimit til en nullverdi. Hvis du imidlertid bestemmer deg for å tilordne verdier, må hver av dem settes til minst fem ganger verdien av transaksjonenLimitPeriodSeconds (som skal være 1).
  • Transaksjonsgrenser – Angi følgende verdier (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit – Sett til minst 100.

    • transactionLimitPeriodSecs – Sett til 1.

  • Sidevekslingsverdier – Angi egenskaper for sidevekslingssystemet (XSP_CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize – Sett til 50

    • availableUserMaxLimit – Sett til 100

  • CTI-grensesnitt – Pass på at du laster opp Webex CA-sertifikatene til klareringslageret for CTI-grensesnittet og aktiverer klientgodkjenning på CTI-grensesnittet.

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

Aktiver katalogsynkronisering (ny mal)

Partneradministratorer kan aktivere katalogsynkronisering for en kundemal mens de oppretter den nye malen. Alle nye kundeorganisasjoner som tilordnes malen, vil ha katalogsynkronisering aktivert. Hvis du vil ha mer informasjon, kan du se Konfigurere kundemaler i Konfigurere partnerorganisasjonen i PartnerHub i løsningsveiledningen for Webex for Cisco BroadWorks.

Hva du skal gjøre neste

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

Aktiver katalogsynkronisering (eksisterende mal)

Partneradministratorer kan fullføre følgende trinn for å aktivere katalogsynkronisering i en eksisterende kundemal for å aktivere funksjonen for kundeorganisasjonene som bruker malen.

1

Logg på Partner Hub, og velg Innstillinger.

2

Rull til BroadWorks Calling, og klikk Vis maler.

3

Velg riktig kundemal, og bla til BroadWorks Directory Sync.

4

Slik aktiverer du katalogsynkronisering som standard for nye kundeorganiseringer som bruker denne malen:

  1. Sett veksleknappen Aktiver synkronisering av BroadWorks-katalog og telefonliste for alle nye kundeorganisasjoner til .

  2. Klikk på Lagre.

5

Slik aktiverer du katalogsynkronisering for eksisterende kundeorganisasjoner som bruker denne malen:

  1. Klikk Vis liste over kunders synkroniseringsstatus.

  2. Merk av i de tilstøtende avmerkingsboksene for hver organisasjon du vil aktivere funksjonen for.

  3. Klikk Aktiver synkronisering.


 

Hvis du vil deaktivere katalogsynkronisering, følger du fremgangsmåten ovenfor og:

  • I trinn 4a setter du veksleknappen Aktiver synkronisering av telefonkatalog for alle nye kundeorganisasjoner til Av for å deaktivere katalogsynkronisering som standard for nye kundeorganisasjoner som bruker denne malen.

  • I trinn 5c klikker du Deaktiver synkronisering for å deaktivere funksjonen for eksisterende organisasjoner.

Hva nå?

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

Fullfør umiddelbar synkronisering

Med alternativet Synkroniser nå kan partneradministrator fullføre en behovsbetinget synkronisering for en gitt kundeorganisasjon. Dette alternativet kan bare velges for individuelle kundeorganisasjoner – det finnes ikke noe massealternativ for Synkroniser nå.

1

Logg på Partner Hub (http://admin.webex.com), og velg Innstillinger.

2

Rull til BroadWorks Calling, og klikk Vis maler.

3

Velg riktig kundemal, og bla til BroadWorks Directory Sync.

4

Klikk Vis liste over kunders synkroniseringsstatus.

5

For kundeorganisasjonen du vil synkronisere, klikker du de tre prikkene helt til høyre og velger Synkroniser nå.

6

Klikk Oppdater for å se synkroniseringsresultatene.

Eksportere synkroniseringsoppføringer til CSV

Partneradministratorer kan eksportere detaljert informasjon om siste synkronisering til en CSV-fil. CSV-filen inneholder en mer detaljert visning av synkroniseringsoppføringen enn control hub-brukergrensesnittet, og kan hjelpe deg med feilsøking og analyse.

1

Logg på Partner Hub (http://admin.webex.com), og velg Innstillinger.

2

Rull til BroadWorks Calling, og klikk Vis maler.

3

Velg riktig kundemal, og bla til BroadWorks Directory Sync.

4

Klikk Vis liste over kunders synkroniseringsstatus.

5

Merk av i de tilstøtende avmerkingsboksene for hver organisasjon du vil ta med i eksporten.

6

Klikk Eksporter resultater.

Felles APIer for katalogsynkronisering

Offentlige APIer er tilgjengelige på developer.webex.com som gjør det mulig for partneradministratorer å oppdatere katalogsynkroniseringsinnstillinger for kundeorganisasjonene de administrerer, utløse en umiddelbar synkronisering eller hente informasjon om synkroniseringsstatus. Katalogsynkroniseringsmetodene er gruppert under BroadWorks Enterprises:

  • List BroadWorks Enterprises– Bruk denne API-metoden til å hente en liste over virksomheter under en gitt tjenesteleverandør og hver virksomhets id. Du må angi spEnterpriseId som tilordnet i klargjøring.

  • Oppdater katalogsynkronisering for en BroadWorks Enterprise– Gå inn i bedriften id for å oppdatere katalogstatusen for denne organisasjonen, aktivere eller deaktivere katalogsynkronisering.

  • Utløs katalogsynkronisering for en organisasjon– Bruk denne API-metoden hvis du vil utløse en umiddelbar synkronisering for en gitt organisasjon id. For syncStatus skriver du inn SYNC_NOW kommando.

  • Hent status for katalogsynkronisering for en organisasjon– Angi organisasjonen id og kjøres for å få status og trackingId av den siste synkroniseringen. Du kan bruke trackingID for å kjøre ytterligere analyse via verktøy som Kibana og Grafana.

I tillegg kan administratorer bruke utløserkatalogsynkroniseringen for en API for én bruker til å utløse en behovsbetinget katalogsynkronisering for én 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.

Synkroniser flere bedrifter med API

Fullfør denne fremgangsmåten for å bruke de offentlige APIene til å fullføre katalogsynkronisering for flere virksomheter.

  • Katalogsynkronisering lar deg synkronisere bare én enkelt organisasjon fra en Broadworks-klynge om gangen via en behovsbetinget synkronisering. Hvis du prøver å synkronisere mer enn én organisasjon, får du en 429-feil

  • Tiden det tar å fullføre en synkronisering for én enkelt virksomhet, varierer avhengig av størrelsen på virksomheten.

1

Kjør APIen List BroadWorks Enterprises for å generere en liste over virksomheter du vil synkronisere.

  1. Sett startMed til startstrengen for organisasjons- eller tjenesteleverandøridentifikatoren.

  2. Klikk Kjør.

2

Kjør utløserkatalogsynkroniseringen for en Enterprise API på den første virksomheten i listen.

  1. Angi virksomhets-IDen .

  2. Sett syncStatus til SYNC_NOW

  3. Klikk Kjør.

    En umiddelbar synkronisering utløses for organisasjonen. Denne synkroniseringen teller mot enkel behovsbetinget synkronisering per Broadworks-grense.
3

Vent noen sekunder, og kjør deretter API-en Get Directory Sync Status for å få synkroniseringsstatus.

  1. Angi virksomhets-IDen

  2. Klikk Kjør.

4

Når synkroniseringen er fullført, fullfører du trinn 2 til 4 for neste virksomhet i listen. Gjenta disse trinnene til du har synkronisert hele listen.

Feilkoder for katalogsynkronisering

Følgende feilkoder gjelder for katalogsynkronisering.

Feilkode

Feilmelding

600000

Uventet feil for BroadWorks External Directorys synkronisering for brukere.

600001

BroadWorks External Directorys synkronisering for brukere, mislyktes.

600002

BroadWorks External Directorys synkronisering for brukere måtte avsluttes før den ble fullført.

600003

BroadWorks External Directorys synkronisering for brukere var kun delvis vellykket. Kunne ikke synkronisere enkelte kundeorganisasjoner.

600004

BroadWorks External Directorys synkronisering for brukere er ikke aktivert for ConfigSet.

600005

BroadWorks External Directorys synkronisering for brukere pågår for ConfigSet.

600006

BroadWorks External Directorys synkroniseringstråder for brukere er opptatt eller er i ferd med å avsluttes. Derfor vil ikke flere synkroniseringsforespørsler bli godtatt. Prøv igjen senere.

600007

Finner ikke identitetsorganisasjonen til CustomerConfig.

600008

Finner ikke CustomerConfig i partnerorganisasjonen.

600009

Broadworks External Directory User Sync kan ikke kjøres fordi broadworks-klyngen som er knyttet til CustomerConfig, er opptatt

600010

BroadWorks External Directorys synkronisering for brukere kan ikke kjøres fordi det ikke finnes noen BroadWorks-klynge som er tilknyttet CustomerConfig.

600011

BroadWorks External Directorys synkronisering for brukere er ikke aktivert for CustomerConfig.

600012

BroadWorks External Directorys synkronisering for brukere kan ikke kjøres fordi hybridkatalogsynkronisering allerede er aktivert for CustomerConfig.

600013

BroadWorks External Directorys synkronisering for brukere kunne ikke legge til brukere og maskinkontoer til identitetslageret.

600014

BroadWorks External Directorys synkronisering for brukere mislyktes under forsøk på å koble til Broadworks-klynge. Feil fra Broadworks - %s.

600015

Broadworks External Directorys synkronisering for brukere fant ingen samsvarende brukere i identitetslageret.

600017

Synkronisering av BroadWorks-telefonliste kan ikke synkronisere alle bruker- og organisasjons-/organisasjonskontakter.

600018

Synkronisering av BroadWorks-telefonliste mislyktes for brukere i organisasjonen/organisasjonen.

600019

Synkronisering av BroadWorks-telefonliste kan ikke synkronisere bedrifts-/organisasjonskontakter.

600020

Brukersynkronisering for BroadWorks ekstern katalog kan ikke deaktiveres fordi CustomerConfig-synkroniseringen pågår.

600022

Synkronisering av eksterne mapper for BroadWorks er ikke mulig siden organisasjonen ikke har noen klargjort bruker.

600023

Synkronisering av single user sync for BroadWorks external directory er ikke mulig fordi brukeren allerede finnes i denne organisasjonen.

600024

BroadWorks External Directory Single User Sync er ikke mulig fordi ingen samsvarende bruker ble funnet i BroadWorks.

600025

BroadWorks- synkronisering av ekstern katalog kan ikke oppdatere brukerkontoen i CI.

600026

BroadWorks- synkronisering av ekstern katalog kan ikke oppdatere maskinkontoen i CI.

600027

Synkronisering av ekstern katalog for BroadWorks er ikke mulig fordi flere brukere ble funnet i BroadWorks.

600028

Synkronisering av ekstern mappe for BroadWorks-enkeltbruker er ikke mulig fordi minst én katalogsynkronisering for organisasjonen burde vært fullført.

600029

BroadWorks-synkronisering av ekstern katalogbruker mislyktes fordi organisasjonen ikke har noen klargjort bruker.

Endre logg

Tabellen nedenfor oppsummerer oppdateringer av denne artikkelen.

Dato

Revisjon

juli 2022 kl.

Avklaringer og rettelser av oversiktsinformasjon:

  • Oppdatert oversikt over katalogsynkronisering for å klargjøre de ulike synkroniseringene som er involvert, og hvordan Webex-mappen oppdateres for hver av dem.

  • Oppdaterte BroadWorks-telefonliste og kontaktmake maksimalt for å klargjøre at bare telefonlister synkroniseres med kontakter.

  • Rettelser av oppdateringer for å klargjøre hvor lang tid det tar før Webex-appen viser oppdaterte poster.

mai 2022 kl.

  • Korrigert merknad under tabellen Katalogsynkroniseringsmakeringer og Kilde i Oversikt overkatalogsynkronisering. Også oppdatert Merknad om gjennomstrømningsklargjøring.

  • Grammatiske redigeringer og rettelser

april 2022 kl.

  • Lagt til Merknad i Oppdateringer-delen i Oversikt over katalogsynkronisering rundt begrensning av bruk av kontaktredigeringer på organisasjonsnivå i Kontrollhub.

februar 2022 kl.

  • Satte inn manglende innhold på nytt under Aktiver katalogsynkronisering (ny mal) .

  • Lagt til informasjon om synkroniseringsmake maksimumsgrensene. Du kan kjøre én planlagt synkronisering og én API-synkronisering samtidig fra samme klynge.

  • Lagt til informasjon om utløserkatalogsynkronisering for en enkelt bruker-API .

februar 2022 kl.

Lagt til liste over synkroniserte telefonnummertyper i Katalogsynkroniseringsbetingelser. Synkroniseringen inkluderer nå mobiltelefonnumre.

februar 2022 kl.

  • Lagt til nye feilkoder.

  • Lagt til innledende beskrivelsessetning for bedre brukervennlighet fra websøk.

desember 17, 2021

  • Mindre strukturelle redigeringer for å løse problemet med manglende innholdsfortegnelse.

desember 16, 2021

  • Oppdatert artikkel med økte maksimumsverdier for brukerkontakter.

desember 08, 2021

  • Lagt til delen Katalogsynkronisering og Kontaktmake maksimum for å klargjøre hvordan katalogsynkronisering avledes maksimalt antall organisasjons- og brukerkontakter.

  • Revidert tabellformatering i Feilkoder for katalogsynkronisering for bedre lesbarhet.