Oversigt over adressebogssynkronisering

Adressebogssynkronisering sikrer, at Webex for Cisco BroadWorks-brugere kan bruge Webex-adresselisten til at ringe til en enhed, der ringer, fra BroadWorks-serveren. Når denne funktion er aktiveret, synkroniseres den fulde opkaldsmappe fra BroadWorks-serveren til Webex-adresselisten. Brugere kan tilgå adresselisten fra Webex-appen og ringe op til en enhed, der ringer op, fra BroadWorks-serveren.

Adressebogssynkronisering omfatter synkronisering af både brugeropkaldsoplysninger samt telefonlister. Synkroniserede telefonlisteposter bliver skrevet til én af to kontakttyper i Webex-adresselisten:

  • Organisationskontakter – disse kontakter gemmes mod en organisation og er tilgængelige for alle brugere i organisationen.

  • Brugerkontakter – disse kontakter gemmes mod en bruger og er kun tilgængelige for brugeren, som ejer kontakten.


Webex til Cisco BroadWorks-klargøring omfatter en standardsynkronisering af meddelelsesbrugere og deres tilknyttede opkaldsoplysninger fra BroadWorks-serveren til Webex-mappen. Standardsynkroniseringssynkronisering udelader dog ikke-meddelelsesbrugere og ikke-brugerenheder (for eksempel en Konferencerum telefon, faxmaskine eller viderestillingsgruppe nummer). Aktivering af adressebogssynkronisering sikrer, at alle opkaldsenheder føjes til Webex-adresselisten.

Betingelser for adressebogssynkronisering

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

  • Som standard sker den indledende synkronisering en uge efter aktivering af synkroniseringen (tidspunktet, der vælges til at starte synkroniseringen, er tilfældig). Dog kan kundeorganisationer bruge valgmuligheden Synkroniser nu til at omgå ventetiden pr. uge og fuldføre en øjeblikkelig synkronisering for en bestemt kundeorganisation.

  • Som standard kører adressebogssynkronisering ugentligt for hver kunde. Hver synkronisering finder sted én uge efter den sidste synkronisering, uanset om denne synkronisering blev planlagt eller udløst manuelt med Synkroniser nu.

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

  • Synkroniseringen ignorerer brugere, der ikke har et telefonnummer.

  • I Partner Hub kan du se oplysninger om synkroniseringsstatus for en bestemt kunde. Derudover kan du eksportere detaljerede oplysninger om den sidste synkronisering til en CSV-post. CSV-posten er mere detaljeret end visningen i Control Hub og kan hjælpe med fejlfinding, analyser og auditering.

  • Brugerkontakter gemmes i et krypteret format kun med den bruger, der ejer kontakten, der har adgang til dekrypteringsnøglen.

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

    • Virksomheds almindelige telefonlister

    • Almindelige telefonlister for grupper

    • Personlig telefonlister

Maksimale adressebogssynkroniserings- og kontaktoplysninger

Følgende er det maksimale antal kontakter, som adressebogssynkronisering tillader for hver Webex-kontakttype:

  • 500 organisationens kontakter

  • 500 brugerkontakter - For en bruger omfatter maksimalt synkroniserede brugerkontakter og manuelle kontakter (kontakter, som brugeren tilføjer manuelt via Webex-appen)

Følgende forhold gælder:

  • Hvis en organisation har mere end 500 kontakter i en af kategorierne, ekskluderer synkroniseringen poster over grænsen på 500. Der gælder ingen bestemt ordre for synkroniserede eller kontaktkontakter.

  • Hvis en bruger tilføjer kontakter manuelt på Webex-appen, bestemmes maksimumsværdien for brugerkontakter ved at tilføje manuelle kontakter fra synkroniserede brugerkontakter. Hvis en bruger for eksempel tilføjer 100 kontakter manuelt på Webex-appen, tillader adressebogssynkronisering det muligt at synkronisere op til 400 brugerkontakter fra BroadWorks for den pågældende bruger.

  • Vi anbefaler, at hvis en af dine kundeorganisationer har mere end 500 kontakter i en af kategorierne, skal du r sag hos Cisco for at få den pågældende organisation udelukket fra adressebogssynkronisering.

Følgende tabel kortlægger Webex-kontakttyper til telefonlisten i BroadWorks, hvorfra posterne bliver synkroniseret:

Tabel 1. Adressebogssynkroniseringskontakttyper og synkroniseringskilde

Webex-kontakttype

Synkroniseret fra BroadWorks...

API brugt til synkronisering

Organisationens kontakter

Virksomheds almindelige telefonlister

/directories/enterprisecommon

Almindelige telefonlister for grupper (i Tjenesteudbyder tilstand)**

/directories/groupcommon

Brugerkontakter

Almindelige telefonlister for grupper (i virksomhedstilstand)**

/directories/groupcommon

Personlig telefonlister

/directories/personal


**Almindelige telefonlister for grupper synkroniseres forskelligt, afhængigt af om BroadWorks er i virksomhedstilstand eller Tjenesteudbyder tilstand. Værdien af den isBroadWorksEnterprise parameter (sand eller falsk) afgør, hvordan listen synkroniserer:

  • Sand – Synkronisering som organisationskontakt

  • False – Synkroniser som brugerkontakt

Opdateringer

Når en kontakt er opdateret på BroadWorks, vises følgende oversigter, når opdateringen vises i en brugers Webex-app:

  • Opdateringer af organisationskontakter vises i Webex-appen, når brugeren genstarter appen, eller efter appens lokale cachetimer på 72 timer udløber.

  • Opdateringer af brugerkontakter vises med det samme i Webex-appen for den pågældende bruger.

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

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

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

Forudsætninger for adressebogssynkronisering

Slå krav til/fra

Følgende funktions skift findes for denne funktion. Sørg for at kontakte din Webex for Cisco BroadWorks-repræsentant for at indstille disse.

Funktion til eller fra

Anvendt på ...

Afskrift

webex-for-broadworks-phone-list-sync

Partner

Obligatorisk skift. Aktiverer telefonlistesynkronisering for alle kundeorganisationer under denne partner.

Skal være aktiveret.

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

Kundeorganisation

Valgfrit skift. Deaktiverer telefonlistesynkronisering for en bestemt organisation, selvom funktionen er aktiveret på partnerniveau og i kundeskabelonen.

Anvend kun denne til/fra, hvis du vil deaktivere telefonlistesynkronisering for en bestemt kundeorganisation. Ellers kan du efterlade det deaktiveret.


 
Du skal for eksempel anvende denne funktion til/fra for alle organisationer, der kræver mere end 500 kontakter.

hidden-personal-contacts-enabled-ga

Bruger

Valgfrit skift. Skjuler personlige kontakter fra adressebogssøgninger udført af denne bruger.

hidden-org-contacts-enabled-ga

Bruger

Valgfrit skift. Skjuler organisationskontakter fra adressebogssøgninger, der er udført af denne bruger.

Krav til forudkonfiguration

Vi anbefaler, at du bruger følgende indstillinger:


Nedenstående eksempler antager, at du bruger en XSP-server. For ADP-servere, udskift (XSP_CLI) med (ADP_CLI).
  • Hastighedsbegrænsningsværdier – Indstil følgende OverloadControl-systemegenskaber (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit– Indstil til en nulværdi.

    • globalDirectoryTransactionLimit– Indstil til en nulværdi.


    Det anbefales, at du indstiller userDirectoryTransactionLimit og globalDirectoryTransactionLimit til en nulværdi. Men hvis du beslutter at tildele værdier, skal hver indstilles til mindst fem gange værdien af transaktionenLimitPeriodSeconds (som bør være 1).
  • Transaktionsgrænser – Indstil følgende værdier (XSP_CLI/System/CommunicationUtilitet/Standardindstillinger):

    • userTransactionLimit–Indstil til mindst 100.

    • transactionLimitPeriodSecs– Indstil til 1.

  • Paging-værdier – Indstil paging-systemegenskaber (XSP_CLI/Applications/Xsi-Actions/Paging):

    • defaultPageSize – Indstil til 50

    • availableUserMaxLimit – Indstil til 100

  • CTI-grænseflade – Sørg for at overføre webex CA-certifikater til CTI-grænsefladetillidslageret og for at aktivere klientgodkendelse på CTI-grænsefladen.

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


Du kan se den komplette liste over programrettelseskrav, der udgør minimumskravene til Webex til Cisco BroadWorks, i BroadWorks-softwarekrav i Løsningsvejledning tilWebex til Cisco BroadWorks.

Aktiver adressebogssynkronisering (ny skabelon)

Partneradministratorer kan aktivere Adressebogssynkronisering for en kundeskabelon, mens den nye skabelon oprettes. Alle nye kundeorganisationer, der bliver tildelt denne skabelon, vil have adressebogssynkronisering aktiveret. Se "Konfigurer dine kundeskabeloner" i Konfigurer din partnerorganisation i Partner Hub i Løsningsvejledningen til Webex til Cisco BroadWorks.

Hvad er næste trin?

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

Aktiver adressebogssynkronisering (eksisterende skabelon)

Partneradministratorer kan udføre følgende trin for at aktivere Adressebogssynkronisering i en eksisterende kundeskabelon for at aktivere funktionen for de kundeorganisationer, der bruger skabelonen.

1

Log ind på Partner Hub, og vælg Indstillinger.

2

Rul ned til BroadWorks-opkald, og klik på Vis skabeloner .

3

Vælg den relevante kundeskabelon, og rul til BroadWorks-adressebogssynkronisering.

4

For at aktivere adressebogssynkronisering som standard for nye kundeorganziationer, der bruger denne skabelon:

  1. Indstil aktivér BroadWorks Directory & Phone List Sync for alle nye kundeorganisationer til og fra .

  2. Klik på Gem.

5

Sådan aktiveres adressebogssynkronisering for eksisterende kundeorganisationer, der bruger denne skabelon:

  1. Klik på Vis liste over kunders synkroniseringsstatus.

  2. Marker de nærliggende afkrydsningsfelter for hver organisation, som du vil aktivere funktionen for.

  3. Klik på Aktiver synkronisering.


 

Hvis du ønsker at deaktivere adressebogssynkronisering, skal du følge ovenstående procedure og:

  • I trin 4a skal du indstille Aktiver telefonbogssynkronisering for alle nye kundeorganisationer og skifte til Fra for at deaktivere adressebogssynkronisering som standard for nye kundeorganisationer, der bruger denne skabelon.

  • I trin 5c skal du klikke Deaktiver synkronisering for at deaktivere funktionen for eksisterende organisationer.

Hvad er næste trin?

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

Fuldfør øjeblikkelig synkronisering

Valgmuligheden Synkroniser nu giver partneradministratoren mulighed for at udføre en on-demand synkronisering for en bestemt kundeorganisation. Denne valgmulighed kan kun vælges for individuelle kundeorganisationer – der er ingen massevalgmulighed for Synkroniser nu.

1

Log ind på Partner Hub (http://admin.webex.com), og vælg Indstillinger.

2

Rul ned til BroadWorks-opkald, og klik på Vis skabeloner .

3

Vælg den relevante kundeskabelon, og rul til BroadWorks-adressebogssynkronisering.

4

Klik på Vis liste over kunders synkroniseringsstatus.

5

For den kundeorganisation, du vil synkronisere, skal du klikke på de tre prik helt til højre og vælge Synkroniser nu.

6

Klik på Genind opdater for at se synkroniseringsresultaterne.

Eksporter synkroniseringsposter til CSV

Partneradministratorer kan eksportere detaljerede oplysninger om den seneste synkronisering til en CSV-fil. CSV indeholder en mere detaljeret visning af synkroniseringsposten end Control Hub GUI og kan hjælpe med fejlfinding og analyser.

1

Log ind på Partner Hub (http://admin.webex.com), og vælg Indstillinger.

2

Rul ned til BroadWorks-opkald, og klik på Vis skabeloner .

3

Vælg den relevante kundeskabelon, og rul til BroadWorks-adressebogssynkronisering.

4

Klik på Vis liste over kunders synkroniseringsstatus.

5

Marker de nærliggende afkrydsningsfelter for hver organisation, som du vil inkludere i eksporten.

6

Klik på Eksportresultater.

Offentlige API'er til adressebogssynkronisering

Offentlige API'er er tilgængelige på developer.webex.com, der giver partneradministratorer mulighed for at opdatere adressebogssynkroniseringsindstillinger for de kundeorganisationer, de administrerer, for at udløse øjeblikkelig synkronisering eller opnå synkroniseringsstatusoplysninger. Adressebogssynkroniseringsmetoder grupperes under BroadWorks-virksomheder. Der findes fire API'er:

  • Anfør BroadWorks-virksomheder – Brug denne API-metode til at få en liste over virksomhederunder et bestemt Tjenesteudbyder og hver virksomheds id. Du skal indtaste spEnterpriseId som tildelt i klargøring.

  • Opdater adressebogssynkronisering for enBroadWorks-virksomhed – indtast virksomheden id for at opdatere adressebogs-syc-status for denne virksomhed, aktivere eller deaktivere adressebogssynkronisering.

  • Udløs adressebogssynkroniseringfor en virksomhed - Brug denne API-metode, hvis du vil udløse en øjeblikkelig synkronisering for en bestemt virksomhed id. For den syncStatus, indtast SYNC_NOW Kommando.

  • Få adressebogssynkroniseringsstatusfor en virksomhed – indtast virksomhedens id og køre for at få en status og trackingId seneste synkronisering. Du kan bruge trackingID at køre yderligere analyser via værktøjer såsom Kibana og Grafana.

For detaljeret API-dokumentation, se 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.

Synkroniser flere virksomheder med API

Fuldfør denne procedure for at bruge de offentlige API'er til at gennemføre adressebogssynkronisering for flere virksomheder.

  • Adressebogssynkronisering lader dig kun synkronisere en enkelt virksomhed ad gangen. Hvis du forsøger at synkronisere mere end én virksomhed, modtager du en 429-fejl.

  • Tiden, det tager at udføre en synkronisering for en enkelt virksomhed, varierer afhængigt af virksomhedens størrelse.

1

Kør listen BroadWorks Enterprises API for at generere en liste over virksomheder, som du ønsker at synkronisere.

  1. Indstil StartWith til virksomheds- eller serviceudbyderens identifikators startstreng.

  2. Klik på Kør.

2

Kør udløsermappesynkronisering for en virksomheds API på den første virksomhed på listen.

  1. Indtast virksomheds-id' .

  2. Indstil syncStatus til SYNC_NOW

  3. Klik på Kør.

    En øjeblikkelig synkronisering udløses for virksomheden. Denne synkronisering tæller med i grænsen på én synkronisering pr. tilfælde.
3

Vent i et par sekunder, og kør derefter Get Directory Sync Status API for at få synkroniseringsstatus.

  1. Indtast virksomheds-id'et

  2. Klik på Kør.

4

Når synkroniseringen er færdig, skal du udføre trin 2 til 4 på den næste virksomhed på listen. Gentag disse trin indtil du har synkroniseret hele listen.

Fejlkoder til adressebogssynkronisering

Følgende fejlkoder gælder for adressebogssynkronisering.

Fejlkode

Fejlmeddelelse

600000

Broadworks ekstern adressebog brugersynkronisering uventet fejl.

600001

Broadworks ekstern adressebog brugersynkronisering mislykkedes.

600002

Broadworks ekstern adressebog brugersynkronisering skulle afsluttes før fuldførelse.

600003

Broadworks ekstern mappebrugersynkronisering er kun delvist udført. Nogle kundeorganisationer kunne ikke synkroniseres.

600004

Broadworks ekstern adressebog brugersynkronisering er ikke aktiveret for ConfigSet.

600005

Broadworks ekstern adressebog brugersynkronisering er i gang for ConfigSet.

600006

Broadworks eksterne adressebog brugersynkroniseringstråde er optaget eller lukker ned, derfor vil ikke acceptere mere synkronisering anmodning, prøv igen senere.

600007

Identity Org for CustomerConfig blev ikke fundet.

600008

CustomerConfig blev ikke fundet i partnerorganisationen.

600009

Broadworks ekstern adressebog brugersynkronisering kan ikke køres, da den broadworks-klynge, der er knyttet til kundekonfigurationen, er optaget

600010

Broadworks ekstern adressebog brugersynkronisering kan ikke køres, da der ikke er nogen broadworks-klynge, der er knyttet til CustomerConfig.

600011

Broadworks ekstern adressebog brugersynkronisering er ikke aktiveret for CustomerConfig.

600012

Broadworks ekstern adressebog brugersynkronisering kan ikke køres, da Hybrid Directory synkronisering allerede er aktiveret for CustomerConfig.

600013

Broadworks ekstern adressebog brugersynkronisering kunne ikke tilføje brugere og maskinkonti til identitetslager.

600014

Broadworks ekstern adressebog brugersynkronisering mislykkedes under forsøg på at oprette forbindelse til Broadworks-klynge. Fejl fra Broadworks - %s.

600015

Broadworks ekstern adressebog brugersynkronisering fandt ingen matchende bruger i identitetslager.

600017

BroadWorks-telefonlistesynkronisering kunne ikke synkronisere alle kontakter for brugere og virksomheder/organisationer.

600018

BroadWorks-telefonlistesynkronisering mislykkedes for brugere i virksomheden/organisationen.

600019

BroadWorks-telefonlistesynkronisering kunne ikke synkronisere virksomheds-/organisationskontaktpersoner.