Oversikt over katalogsynkronisering

Katalogsynkronisering sikrer at Webex for Cisco BroadWorks-brukere kan bruke Webex-katalogen til å kalle opp alle anropsenheter fra BroadWorks-serveren. Når denne funksjonen er aktivert, synkroniseres den fullstendige anropsmappen fra BroadWorks-serveren til Webex-mappen. Brukere kan få tilgang til katalogen fra Webex-appen og foreta et kall til alle anropsenheter fra BroadWorks-serveren.

Katalogsynkronisering inkluderer synkronisering av både brukersamtaleinformasjon og telefonlister. Synkroniserte telefonlisteoppføringer skrives til én av to kontakttyper i Webex-mappen:

  • Organisasjonskontakter – Disse kontaktene lagres mot en organisasjon og er tilgjengelige for alle brukere i organisasjonen.

  • Brukerkontakter: Disse kontaktene lagres mot en bruker og er bare tilgjengelige for brukeren som eier kontakten.


Webex for Cisco BroadWorks-klargjøring inkluderer en standard synkronisering av meldingsbrukere og tilhørende anropsinformasjon fra BroadWorks-serveren til Webex-katalogen. Standard klargjøringssynkronisering utelater imidlertid ikke-meldingsbrukere og ikke-brukerenheter (for eksempel en telefon i konferanserommet, faksmaskin eller jaktgruppenummer). Hvis du aktiverer katalogsynkronisering, sikrer du at alle anropsenheter legges til i Webex-mappen.

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 synkroniseringen ble planlagt eller utløst manuelt med Synkroniser nå.

  • Hvis det oppstår en synkroniseringsfeil, oppdateres synkroniseringen 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 er mer detaljert enn Control Hub-visningen og kan hjelpe deg med feilsøking, analyse og revisjon.

  • Brukerkontakter lagres i et kryptert format, og bare brukeren som eier kontakten, har tilgang til dekrypteringsnøkkelen.

  • Denne funksjonen synkroniserer følgende telefonlistetyper fra BroadWorks-serveren:

    • Felles telefonlister for virksomheter

    • Gruppere felles telefonlister

    • Personlige telefonlister

Maksimalt katalogsynkronisering og kontakt

Følgende er maksimalt antall kontakter som katalogsynkronisering tillater for hver Webex-kontakttype:

  • 500 organisasjonskontakter

  • 500 brukerkontakter – For en bruker inkluderer maksimum synkroniserte brukerkontakter og manuelle kontakter (kontakter brukeren legger til manuelt via Webex-appen)

Følgende betingelser gjelder:

  • Hvis en organisasjon har mer enn 500 kontakter i en av kategoriene, utelater synkroniseringen oppføringer over grensen på 500 grenser. Det brukes ingen bestemt rekkefølge på synkroniserte eller utelatte kontakter.

  • Hvis en bruker legger til kontakter manuelt i Webex-appen, bestemmes maksimumsverdien for brukerkontakten ved å trekke de manuelle kontaktene fra synkroniserte brukerkontakter. Hvis en bruker for eksempel legger til 100 kontakter manuelt i Webex-appen, tillater katalogsynkronisering at opptil 400 brukerkontakter synkroniseres fra BroadWorks for denne brukeren.

  • Vi anbefaler at hvis en av kundeorganisasjonene har mer enn 500 kontakter i en av kategoriene, må du ta opp en sak med Cisco for å få organisasjonen ekskludert fra katalogsynkronisering.

Tabellen nedenfor tilordner Webex-kontakttypene til BroadWorks-telefonlisten som oppføringene synkroniseres fra:

Tabell 1. Kontakttyper for katalogsynkronisering og synkroniseringskilde

Webex- kontakttype

Synkronisert fra BroadWorks...

API som brukes til synkronisering

Kontakter for organisasjon

Felles telefonlister for virksomheter

/directories/enterprisecommon

Gruppere felles telefonlister (mens du er i tjenesteleverandørmodus)**

/directories/groupcommon

Brukerkontakter

Gruppere felles telefonlister (mens du er i virksomhetsmodus)**

/directories/groupcommon

Personlige telefonlister

/directories/personal


**Felles telefonlister for gruppe 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 organisasjonskontakt

  • Usann – Synkroniser som brukerkontakt

Oppdateringer

Når en kontakt er oppdatert på BroadWorks, viser følgende når oppdateringen vises i webex-appen til en bruker:

  • Oppdateringer for organisasjonskontakt vises i Webex-appen etter at brukeren har startet appen på nytt, eller etter at appens lokale 72-timers tidtaker for hurtigbuffer utløper.

  • Brukerkontaktoppdateringer vises umiddelbart i Webex-appen for denne brukeren.

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, oppdateres den eksisterende kontakten i Webex-mappen med det nye nummeret.

Forutsetninger for katalogsynkronisering

Aktiver/deaktiver krav

Følgende funksjonsvekslinger finnes for denne funksjonen. Sørg for å kontakte Webex for Cisco BroadWorks-representanten for å angi disse.

Veksle mellom funksjoner

Brukes på...

Deskripton

webex-for-broadworks-phone-list-sync

Partner

Obligatorisk veksleknapp. Aktiverer synkronisering av telefonliste for alle kundeorganisasjoner under denne partneren.

Må være Aktivert.

webex-for-broadworks-phone-list-sync-disable

Kundeorganisasjon

Valgfri veksleknapp. Deaktiverer synkronisering av telefonliste for en gitt organisasjon, selv om funksjonen er aktivert på partnernivå og i kundemalen.

Bruk denne veksleknappen bare hvis du vil deaktivere synkronisering av telefonliste for en bestemt kundeorganisasjon. Ellers kan du la den være deaktivert.


 
Du bør for eksempel bruke denne veksleknappen på alle organisasjoner som krever mer enn 500 kontakter.

hidden-personal-contacts-enabled-ga

Bruker

Valgfri veksleknapp. Skjuler personlige kontakter fra katalogsøk som er fullført av denne brukeren.

hidden-org-contacts-enabled-ga

Bruker

Valgfri veksleknapp. Skjuler organisasjonskontakter fra katalogsøk som er fullført av denne brukeren.

Krav til forhåndskonfigurering

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:


Hvis du vil se den fullstendige listen over oppdateringskrav som utgjør minimumskravet for Webex for Cisco BroadWorks, kan du se BroadWorks Software Requirements i Solution Guide for Webex for Cisco BroadWorks.

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å PartnerHub, og velg Innstillinger.

2

Rull til BroadWorks-anrop, og klikk Vis maler .

3

Velg riktig kundemal, og rull til BroadWorks Katalogsynkronisering.

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 På .

  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å PartnerHub (http://admin.webex.com) og velg Innstillinger.

2

Rull til BroadWorks-anrop, og klikk Vis maler .

3

Velg riktig kundemal, og rull til BroadWorks Katalogsynkronisering.

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å PartnerHub (http://admin.webex.com) og velg Innstillinger.

2

Rull til BroadWorks-anrop, og klikk Vis maler .

3

Velg riktig kundemal, og rull til BroadWorks Katalogsynkronisering.

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. Det finnes fire APIer:

  • Liste overBroadWorks-virksomheter – 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.

  • Få status for katalogsynkronisering for en organisasjon– Gå inn i bedriften 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.

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 om gangen. 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 grensen for én synkronisering per forekomst.
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 ved synkronisering av ekstern katalogbruker.

600001

Synkronisering av broadworks ekstern katalogbruker mislyktes.

600002

Broadworks Ekstern katalogbrukersynkronisering måtte avsluttes før den var fullført.

600003

Broadworks ekstern katalogbrukersynkronisering lyktes bare delvis. Noen kundeorganisasjoner ble ikke synkronisert.

600004

Broadworks External Directory User Sync er ikke aktivert for ConfigSet.

600005

Broadworks External Directory User Sync pågår for ConfigSet.

600006

Broadworks Brukersynkroniseringstråder for ekstern katalog er opptatt eller avsluttes, og vil derfor ikke godta mer synkroniseringsforespørsel.

600007

Finner ikke Identity Org for 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 Directory User Sync kan ikke kjøres fordi det ikke er noen broadworks-klynge knyttet til CustomerConfig.

600011

Broadworks External Directory User Sync er ikke aktivert for CustomerConfig.

600012

Broadworks-synkronisering for ekstern katalog kan ikke kjøres fordi hybrid katalogsynkronisering allerede er aktivert for CustomerConfig.

600013

Broadworks Brukersynkronisering av ekstern katalog kan ikke legge til brukere og maskinkontoer i identitetslageret.

600014

Broadworks Ekstern katalogbrukersynkronisering mislyktes under forsøk på å koble til Broadworks-klyngen. Feil fra Broadworks - %s.

600015

Broadworks External Directory User Sync fant ingen samsvarende bruker 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.