Denne artikel beskriver, hvordan du installerer Directory Sync i Webex til Cisco BroadWorks. Artiklen er beregnet til tjenesteudbyderadministratorer i partnerorganisationer.
Oversigt over telefonbogssynkronisering
Katalogsynkronisering sikrer, at Webex til Cisco BroadWorks-brugere kan bruge Webex -telefonbogen fra Webex -appen til at ringe til enhver opkaldsenhed fra BroadWorks-serveren. Denne funktion synkroniserer BroadWorks-opkaldsoplysninger, der ikke var en del af brugerklargøring, til Webex telefonbogen.
Webex til Cisco BroadWorks-brugerklargøring opdaterer Webex -telefonbogen med opkaldsoplysninger for Webex til Cisco BroadWorks-brugere (primær telefon , mobiltelefonnummer, lokalnummer), men udelader eksterne opkaldsposter. Men når Telefonbogssynkronisering er aktiveret, synkroniserer funktionen også følgende opkaldsposter til Webex telefonbogen.
Brugere, der kun opkalder BroadWorks (som ikke er onboardet i Webex)
Opkaldsenheder, der ikke er bruger (f.eks. en telefon i et konferencelokale, fax, nummer på viderestillingsgruppe )
Poster i BroadWorks-telefonlisten
Følgende tabel opsummerer BroadWorks-opkaldsposter og viser, hvordan de bliver føjet til Webex telefonbogen.
BroadWorks-opkaldsposter |
Beskrivelse |
Føjet til Webex -telefonbogen via... |
---|---|---|
Webex til Cisco BroadWorks-brugere |
Brugere er aktiveret til Webex til Cisco BroadWorks |
Brugerklargøring (f.eks. flow-through-klargøring) |
Brugere, der kun opkalder BroadWorks |
Ringer op til brugere, der er ikke onboardet til Webex |
Katalogsynkronisering |
Opkaldsenheder, der ikke er bruger |
F.eks. en telefon i et konferencelokale, en faxmaskine, et søgegruppenummer |
Katalogsynkronisering |
BroadWorks-telefonlister |
Poster i BroadWorks-telefonlisten:
|
Telefonbogssynkronisering (synkronisering af telefonliste) |
Få flere oplysninger om brugerklargøring i Vejledning til løsning af Webex til Cisco BroadWorks .
|
Betingelser for synkronisering af telefonbog
Partneradministratorer skal aktivere funktionen på partnerniveau. Partneradministratorer kan slå funktionen til eller fra 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ældigt). Kundeorganisationer kan dog bruge Synkroniser nu mulighed for at tilsidesætte den ene uges venteperiode og udløse en øjeblikkelig synkronisering for en given kundeorganisation.
Som standard kører mappesynkronisering ugentligt for hver kunde. Hver synkronisering finder sted en uge efter den seneste synkronisering, uanset om den seneste synkronisering blev planlagt eller udløst manuelt med Synkroniser nu .
Det maksimale antal samtidige synkroniseringer pr. BroadWorks-klynge er to: én planlagt synkronisering og én on-demand-synkronisering (via API eller Partner Hub GUI). Administratorer kan dog ikke køre to on-demand-synkroniseringer på samme tid fra den samme BroadWorks. Denne begrænsning findes, uanset om synkroniseringen blev startet via API'en eller via Synkroniser nu valgmulighed i Partner Hub. Derudover planlægger Webex ikke at køre to planlagte synkroniseringer på samme tid fra den samme BroadWorks.
Hvis der opstår en synkroniseringsfejl, Webex automatisk synkroniseringen igen 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 given kunde. Derudover kan du eksportere detaljeret information om den seneste synkronisering til en CSV -post. CSV -posten giver flere detaljer end Control Hub-skærmen og kan hjælpe med fejlfinding, analyser og revision.
Webex gemmer brugerkontakter i et krypteret format. Kun den bruger, der ejer kontakten, har adgang til dekrypteringsnøglen.
For brugere, der kun opkalder BroadWorks, og opkaldsenheder, der ikke er bruger, synkroniserer denne funktion følgende telefonnummer fra BroadWorks:
Primært telefonnummer
Mobiltelefonnummer
Lokalnummer
Synkronisering udelukker dog BroadWorks-opkaldsbrugere og ikke-brugeropkaldsenheder fra synkroniseringen, hvis der hverken er et primær telefon eller lokalnummer til stede.
BroadWorks-telefonliste og maksimum antal kontakter
Telefonbogssynkronisering synkroniserer også poster i BroadWorks-telefonlisten til Webex -kontaktpersoner. Synkroniserede poster føjes til en af følgende kontakttyper:
Organisationskontakter – Webex gemmer disse kontakter i en organisation. Hver bruger har adgang til organisationens kontaktpersoner for deres organisation. Det maksimale antal er op til 30.000 kontakter.
Brugerkontakter – Webex gemmer disse kontakter mod en bruger. Kun den bruger, der ejer kontakten, kan få adgang til kontaktposten. Det maksimale antal er op til 2000 kontakter (1500 synkroniserede kontakter + 500 kontakter med manuel indtastning).
Kun poster i telefonlisten føjes til Webex kontakter. Brugere, der kun opkalder BroadWorks, og opkaldsenheder, der ikke er bruger, der er inkluderet i Katalogsynkronisering, føjes ikke til Kontakter, medmindre en Webex -bruger føjer dem til Kontakter manuelt.
|
Følgende tabel knytter Webex -kontakttyper til kontaktkilden (synkroniseret fra en BroadWorks-telefonliste eller tilføjet manuelt):
Webex |
Kontaktkilde |
Maksimal |
Synkroniseret fra BroadWorks... |
API bruges til synkronisering |
---|---|---|---|---|
Organisationskontakter |
Katalogsynkronisering |
30.000 kontakter |
Almindelige virksomhedstelefonlister |
|
Gruppe almindelige telefonlister (for en tjenesteudbydergruppe)** |
|
|||
Brugerkontakter |
Katalogsynkronisering |
1500 kontakter |
Personlige telefonlister |
/directories/personal |
Tilføjet manuelt af brugeren |
500 kontakter |
Ikke anvendelig |
Ikke anvendelig |
|
Gruppe kontakter |
Katalogsynkronisering |
30.000 kontakter pr. gruppe |
Gruppe almindelige telefonlister (for en virksomhedsgruppe)** |
/directories/groupcommon |
**Poster i gruppeopkaldslister synkroniseres forskelligt, afhængigt af om BroadWorks er i virksomhedstilstand eller tjenesteudbydertilstand. Værdien af
|
Følgende betingelser gælder for, hvordan Directory Sync håndterer maksimum antal kontakter:
Hvis en organisation overskrider det maksimalt tilladte antal kontakter for synkroniseringen (30.000 organisationskontakter eller 30.000 gruppe fælles kontakter pr. gruppe), udelukker telefonbogssynkronisering poster over den maksimale grænse. Der er ingen bestemt rækkefølge anvendt på synkroniserede eller udeladte kontakter.
Hvis en af dine kunder overskrider det maksimalt tilladte antal kontakter i begge kategorier, anbefaler vi, at du rejser en sag med Cisco for at få den pågældende organisation udelukket fra telefonbogssynkronisering.
Manuelle kontakter er kontakter, som en bruger tilføjer manuelt i Webex appen. En bruger kan tilføje op til 500 manuelle kontakter. Manuelle kontakter falder inden for den større kategori Brugerkontaktpersoner på Webex, men er ikke inkluderet i synkroniseringen.
Den samlede grænse for organisationskontakter (30.000) og gruppekontakter (30.000 pr. gruppe) er 200000.
Opdateringer
Følgende er, hvordan Webex telefonbogen håndterer opdateringer:
Hvis kontaktnavn ændres på BroadWorks, slettes den eksisterende kontakt fra Webex telefonbogen, og der oprettes en ny kontakt.
Hvis kontaktnummeret ændres på BroadWorks, opdaterer Webex den eksisterende kontakt i Webex telefonbogen med det nye nummer.
Når en administrator opdaterer en kontaktperson på BroadWorks, skitserer følgende forhold, når opdateringen vises i en brugers Webex -app:
Hvis opdateringen er til en bruger, der kun opkalder BroadWorks, eller en opkaldsenhed, der ikke er bruger, vises opdateringen i en brugers Webex -app umiddelbart efter den efterfølgende telefonbogssynkronisering.
Hvis opdateringen er til en post i BroadWorks-telefonlisten:
For brugerkontakter – opdateringer vises i brugerens Webex -app umiddelbart efter den efterfølgende telefonbogssynkronisering.
For gruppekontakter – opdateringer vises i brugerens Webex -app umiddelbart efter den efterfølgende telefonbogssynkronisering.
For organisationskontakter – Webex -telefonbogen opdateres ved den efterfølgende telefonbogssynkronisering, men brugerne vil ikke se ændringen i Webex -appen, før de genstarter Webex -appen, eller før den lokale 72-timers cache-timer udløber.
Opdateringer af Webex til Cisco BroadWorks brugeroplysninger håndteres som en del af klargøringsprocesserne.
|
Control Hub indeholder en valgmulighed for at tilføje eller redigere kontakter på organisationsniveau i Control Hub via en CSV-fil. Partneradministratorer og kundeadministratorer med Control Hub-adgang har adgang til denne valgmulighed. Opdatering af kontakter via Control Hub understøttes dog ikke af Webex til Cisco BroadWorks. Opdateringer af kontaktpersoner i Control Hub synkroniseres ikke tilbage til BroadWorks og er ikke tilgængelige for telefonbogssøgninger fra fastnettelefoner.
|
Forudsætninger for telefonbogssynkronisering
Vi anbefaler, at du bruger følgende indstillinger:
Eksemplerne nedenfor forudsætter, at du bruger en XSP-server. For ADP-servere skal du erstatte (XSP_ CLI) med (ADP_ CLI).
|
Hastighedsbegrænsende værdier – Angiv følgende OverloadControl-systemegenskaber (XSP_ CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit – indstillet til en nulværdi.
globalDirectoryTransactionLimit – indstilles 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 af dem være indstillet til mindst fem gange værdien af transactionLimitPeriodSeconds (som skal være 1).Transaktionsgrænser – Angiv følgende værdier (XSP_ CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit – Indstil til mindst 100.
transactionLimitPeriodSecs – Indstil til 1.
Paging-værdier – Angiv egenskaberne for personsøgningssystemet (XSP_ CLI/Applikationer/Xsi-Actions/Paging):
standardSidestørrelse – Indstil til 50
availableUserMaxLimit – Indstil til 100
CTI -grænseflade – Sørg for at uploade 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 installerer følgende systemrettelser på BroadWorks-installationen, før du aktiverer denne funktion:
For 22 kr:
AP.as.22.0.1123.ap368517
For 23 kr:
AP.as.23.0.1075.ap368517
For 24 kr: der kræves ingen programrettelse
Aktivér mappesynkronisering (ny skabelon)
Partneradministratorer kan aktivere Katalogsynkronisering for en kundeskabelon, mens de opretter den nye skabelon. Alle nye kundeorganisationer, der bliver tildelt den pågældende skabelon, vil have telefonbogssynkronisering aktiveret. Få flere oplysninger i "Konfigurer dine kundeskabeloner" i Konfigurer din partnerorganisation i Partner Hub inden for Løsningsvejledning til Webex til Cisco BroadWorks .
Hvad skal du gøre?
Sørg for, at dine brugere ved, at de skal klikke på Kontakter fanen på Webex appen mindst én gang for at aktivere funktionen på Webex -appen. Dette skal kun udføres én gang.
Aktivér mappesynkronisering (eksisterende skabelon)
1 | Log ind på Partner Hub, og vælg Indstillinger . |
||
2 | Rul til BroadWorks-opkald og klik Vis skabeloner . |
||
3 | Vælg den relevante kundeskabelon, og rul til BroadWorks Directory Sync . |
||
4 | Sådan aktiveres telefonbogssynkronisering som standard for nye kundeorganisationer, der bruger denne skabelon:
|
||
5 | Sådan aktiveres telefonbogssynkronisering for eksisterende kundeorganisationer, der bruger denne skabelon:
|
Næste trin
Sørg for, at dine brugere ved, at de skal klikke på Kontakter fanen på Webex appen mindst én gang for at aktivere funktionen på Webex -appen. Dette skal kun udføres én gang.
Udløs øjeblikkelig synkronisering
1 | Log ind på Partner Hub (http://admin.webex.com ), og vælg Indstillinger . |
2 | Rul til BroadWorks-opkald og klik Vis skabeloner . |
3 | Vælg den relevante kundeskabelon, og rul til BroadWorks Directory Sync . |
4 | Klik på Vis liste over kunders synkroniseringsstatus . |
5 | For den kundeorganisation, du vil synkronisere, skal du klikke på de tre prikker yderst til højre og vælge Synkroniser nu . |
6 | Klik på Genindlæs for at se synkroniseringsresultaterne. |
Eksporter synkroniseringsposter til CSV
1 | Log ind på Partner Hub (http://admin.webex.com ), og vælg Indstillinger . |
2 | Rul til BroadWorks-opkald og klik Vis skabeloner . |
3 | Vælg den relevante kundeskabelon, og rul til BroadWorks Directory Sync . |
4 | Klik på Vis liste over kunders synkroniseringsstatus . |
5 | Markér de tilstødende afkrydsningsfelter for hver organisation, som du vil medtage i eksporten. |
6 | Klik på Eksporter resultater . |
Offentlige API'er til Directory Sync
Offentlige API'er er tilgængelige på developer.webex.com der tillader partneradministratorer at opdatere indstillinger for mappesynkronisering for de kundeorganisationer, de administrerer, for at udløse en øjeblikkelig synkronisering eller få oplysninger om synkroniseringsstatus. Katalogsynkroniseringsmetoderne er grupperet under BroadWorks Enterprises :
Angiv BroadWorks-virksomheder – Brug denne API-metode til at få en liste over virksomheder under en given tjenesteudbyder og hver virksomheds
id
. Du skal indtastespEnterpriseId
som tildelt i klargøring.Opdater Directory Sync for en BroadWorks Enterprise – Indtast virksomheden
id
for at opdatere telefonbogens status for den pågældende virksomhed ved at aktivere eller deaktivere telefonbogssynkronisering.Udløs mappesynkronisering for en virksomhed – Brug denne API-metode, hvis du vil udløse en øjeblikkelig synkronisering for en given virksomhed
id
. ForsyncStatus
, skal du indtasteSYNC_NOW
kommando.Få status for telefonbogssynkronisering for en virksomhed – Indtast virksomheden
id
og kør for at få en status ogtrackingId
af den seneste synkronisering. Du kan brugetrackingID
til at køre yderligere analyser via værktøjer som Kibana og Grafana.
Derudover kan administratorer bruge Udløs mappesynkronisering for en enkelt bruger API til at udløse en on-demand-katalogsynkronisering for en enkelt bruger.
For detaljeret API-dokumentation, sehttps://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
|
1 | Kør Angiv BroadWorks-virksomheder API til at generere en liste over virksomheder, som du ønsker at synkronisere.
|
2 | Kør Udløs mappesynkronisering for en virksomhed API på den første virksomhed på listen. |
3 | Vent et par sekunder, og kør derefter Få status for telefonbogssynkronisering API for at få synkroniseringsstatus.
|
4 | Når synkroniseringen er fuldført, 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 for Directory Sync
Følgende fejlkoder gælder for Directory Sync.
Fejlkode |
Fejlmeddelelse |
---|---|
600.000 |
Uventet fejl i forbindelse med synkronisering af bruger i Broadworks' eksterne adressebog. |
600001 |
Synkronisering af bruger i BroadWorks' eksterne adressebog mislykkedes. |
600002 |
Synkronisering af bruger i BroadWorks' eksterne adressebog skulle afsluttes, før den blev fuldført. |
600003 |
Synkronisering af bruger i BroadWorks' eksterne adressebog lykkedes kun delvist. Nogle kundeorganisationer kunne ikke synkronisere. |
600004 |
Synkronisering af bruger i BroadWorks' eksterne adressebog er ikke aktiveret for ConfigSet. |
600005 |
Synkronisering af bruger i BroadWorks' eksterne adressebog er i gang for ConfigSet. |
600006 |
Tråde til synkronisering af bruger i BroadWorks' eksterne adressebog er optaget eller lukker ned, og accepterer derfor ikke flere anmodninger om synkronisering. Prøv igen senere. |
600007 |
Identitetsorganisationen for CustomerConfig blev ikke fundet. |
600008 |
CustomerConfig er ikke fundet i partnerorganisationen. |
600009 |
Synkronisering af bruger i Broadworks' eksterne adressebog kan ikke køres, da den Broadworks-klynge, der er knyttet til CustomerConfig, er optaget |
600010 |
Synkronisering af bruger i BroadWorks' eksterne adressebog kan ikke køres, da der ikke er nogen BroadWorks-klynge, der er knyttet til CustomerConfig. |
600011 |
Synkronisering af bruger i BroadWorks' eksterne adressebog er ikke aktiveret for CustomerConfig. |
600012 |
Synkronisering af bruger i Broadworks' eksterne adressebog kan ikke køres, da hybridadressebogssynkronisering allerede er aktiveret for CustomerConfig. |
600013 |
Synkronisering af bruger i BroadWorks' eksterne adressebog kunne ikke tilføje brugere og maskinkonti til identitetslager. |
600014 |
Synkronisering af bruger i Broadworks' eksterne adressebog mislykkedes under forsøg på at oprette forbindelse til Broadworks-klynge. Fejl fra Broadworks – %s. |
600015 |
Synkronisering af bruger i Broadworks' eksterne adressebog fandt ingen matchende bruger i identitetslager. |
600017 |
Synkronisering af BroadWorks-telefonliste kunne ikke synkronisere alle bruger- og virksomheds-/organisationskontakter. |
600018 |
Synkronisering af BroadWorks-telefonliste mislykkedes for brugere i virksomheden/organisationen. |
600019 |
Synkronisering af BroadWorks-telefonliste kunne ikke synkronisere virksomheds-/organisationskontakter. |
600020 |
Synkronisering af BroadWorks' eksterne adressebog kan ikke deaktiveres, da synkroniseringen med CustomerConfig er i igangværende. |
600022 |
Enkeltbrugersynkronisering med ekstern BroadWorks-telefonbog er ikke mulig, da virksomheden ikke har nogen klargjort bruger. |
600023 |
Synkronisering af enkeltbruger til ekstern BroadWorks-telefonbog er ikke mulig, fordi brugeren allerede findes i denne organisation. |
600024 |
Enkeltbrugersynkronisering af ekstern BroadWorks-telefonbog er ikke mulig, fordi der ikke blev fundet nogen matchende bruger i BroadWorks. |
600 025 |
BroadWorks External Directory User Sync kunne ikke opdatere brugerkonto i CI. |
600026 |
Synkronisering af bruger i BroadWorks' eksterne adressebog kunne ikke opdatere maskinkontoen i CI. |
600027 |
Synkronisering af én bruger med ekstern BroadWorks-telefonbog er ikke mulig, fordi der blev fundet flere brugere i BroadWorks. |
600028 |
Enkeltbrugersynkronisering med ekstern BroadWorks-telefonbog er ikke mulig, fordi mindst én synkronisering af virksomhedskatalog skulle være fuldført. |
600029 |
Synkronisering af BroadWorks ekstern telefonbog mislykkedes, da virksomheden ikke har nogen klargjort bruger. |
Ændringshistorik
Følgende tabel opsummerer opdateringer af denne artikel.
Dato |
Revision |
---|---|
14. februar 2023 |
Opdateret Katalogsynkroniseringsmaksimum og kilde afsnit. |
10. december 2022 |
Opdateret udtrykket Fuldfør øjeblikkelig synkronisering til Udløs mappesynkronisering |
19. juli 2022 |
Præciseringer og rettelser af oversigtsoplysninger:
|
9. maj 2022 |
|
7. april 2022 |
|
28. marts 2022 |
|
24. marts 2022 |
Tilføjet liste over synkroniserede telefonnummer til Betingelser for synkronisering af telefonbog . Synkroniseringen omfatter nu mobiltelefon . |
16. marts 2022 |
|
17. december 2021 |
|
16. december 2021 |
|
8. december 2021 |
|