- Hjem
- /
- Artikel
Katalogsynkronisering i Webex til Cisco BroadWorks
Denne artikel beskriver, hvordan du installerer adressebogssynkronisering i Webex til Cisco BroadWorks. Artiklen er beregnet til administratorer af tjenesteudbydere i partnerorganisationer.
Oversigt over katalogsynkronisering
Katalogsynkronisering sikrer, at brugere af Webex til Cisco Broad Works kan bruge Webex-telefonbogen fra Webex-appen til at ringe til enhver opkaldsenhed fra Broad Works-serveren. Denne funktion synkroniserer opkaldsoplysninger om Broad Works, der ikke var en del af brugerklargøringen til Webex-telefonbogen.
Klargøring af brugere af Webex til CiscoBroad Works opdaterer Webex-telefonbogen med opkaldsoplysninger for brugere af Webex til Cisco Broad Works (primært telefonnummer, mobiltelefonnummer, lokalnummer), men udelader eksterne opkaldsregistre. Men når adressebogssynkronisering er aktiveret, synkroniserer funktionen også følgende opkaldsposter til Webex-telefonbogen.
Brugereder kun opkalder bredt på Works (som ikke er onboardet til Webex)
Ikke-brugeropkaldsenheder (f.eks. en konferencelokale, faxmaskine, viderestillingsgruppenummer)
Telefonlisteposter medbredt anvendte værker
Følgende tabel opsummerer Broad Works-opkaldsposter og viser, hvordan de føjes til Webex-telefonbogen.
Opkaldsoptegnelser over brede værker | Beskrivelse | Føjet til Webex Directory via ... |
---|---|---|
Webex til Cisco Broad Works-brugere | Brugere er aktiveret for Webex til Cisco BroadWorks | Brugerklargøring (f.eks. flowthrough-klargøring) |
Opkaldsbrugere, der kun er bredt tilgængelige værker | Brugere, der ringer op, som ikke er onboardet til Webex | Adressebogssynkronisering |
Ikke-brugeropkaldsenheder | F.eks. telefon til konferencelokaler, faxmaskine, viderestillingsgruppenummer | Adressebogssynkronisering |
Telefonlisterover store værker | Telefonlisteposter medBroad Works:
| Katalogsynkronisering (synkronisering af telefonliste) |
Betingelser for katalogsynkronisering
Partneradministratorer skal aktivere funktionen på partnerniveau. Partneradministratorer kan slå funktionen til eller fra for flere kundeorganisationer i en enkelt handling.
Som standard sker den første synkronisering en uge efter aktivering af synkroniseringen (det valgte tidspunkt for at starte synkroniseringen er tilfældigt). Kundeorganisationer kan dog bruge valgmuligheden Synk nu til at omgå ventetiden på en uge og udløse en øjeblikkelig synkronisering for en given kundeorganisation.
Som standard kører katalogsynkronisering ugentligt for hver kunde. Hver synkronisering sker en uge efter den sidste synkronisering, uanset om den sidste synkronisering blev planlagt eller udløst manuelt med Synkroniser nu.
Det maksimale antal samtidige synkroniseringer pr. Broad Works-klynge erto: en planlagt synkronisering og en on-demand synkronisering (via API eller Partner Hub-GUI). Administratorer kan dog ikke køre to on-demand-syncs samtidigt fra det samme Broad Works. Denne begrænsning eksisterer, uanset om synkroniseringen blev startet via API'et eller via indstillingen Sync Now i Partner Hub. Derudover vil Webex ikke planlægge to planlagte synkroniseringer, der skal køres samtidigt fra det samme Broad WorksWorks.
Hvis der opstår en synkroniseringsfejl, forsøger Webex automatisk synkroniseringen hver 24. time, indtil den næste planlagte synkronisering.
Synkroniseringen ignorerer brugere, der ikke har et telefonnummer.
I Partner Hub kan du se synkroniseringsstatusoplysninger for en given kunde. Derudover kan du eksportere detaljerede oplysninger om den sidste synkronisering til en CSV-post. CSV-posten giver flere detaljer end Control Hub-skærmen og kan hjælpe med fejlfinding, analyse og revision.
Webex gemmer brugerkontakter i et krypteret format. Kun den bruger, der ejer kontakten, har adgang til dekrypteringsnøglen.
For brugereder kun ringer op til Broad Works og andre opkaldsenheder, der ikke er brugere, synkroniserer denne funktion følgende telefonnummertyper fra BroadWorks:
Primært telefonnummer
Mobiltelefonnummer
Lokalnummer
Synkronisering udelukker dog brugere, der kun ringer op til Broad Works, og enheder, der ikke er brugere, fra synkroniseringen, hvis der ikke findes et primært telefonnummer eller et lokalnummer.
Indstillingen fordatabeskyttelsestjeneste på brugerniveau understøttes ikke som en del af adressebogssynkronisering.
Bredarbejdstelefonliste og kontaktmaksimer
Adressebogssynkronisering synkroniserer også telefonlisteposter i Broad Works til Webex Contacts. Synkroniserede poster føjes til en af følgende kontakttyper:
Organisationskontakter – Webex gemmer disse kontakter mod en organisation. Hver bruger kan få adgang til organisationskontakter for sin organisation. Maksimalt er op til 30000 kontakter.
Brugerkontakter – Webex gemmer disse kontakter mod en bruger. Det er kun brugeren, der ejer kontakten, der kan få adgang til kontaktposten. Maksimalt er op til 2000 kontakter (1500 synkroniserede kontakter + 500 kontakter til manuel indtastning).
Følgende tabel kortlægger Webex-kontakttyper i forhold til kontaktkilden (synkroniseret fra en Broad Works-telefonliste eller tilføjet manuelt):
Webex-kontakttype | kontaktkilde | Maksimal | Synkroniseret fra Broad Works... | API bruges til synkronisering |
---|---|---|---|---|
Organisationskontakter | Adressebogssynkronisering | 30000 kontakter | Almindelige virksomhedstelefoner |
|
Gruppefælles telefonlister (for en tjenesteudbydergruppe)** |
| |||
Brugerkontakter | Adressebogssynkronisering | 1500 kontakter | Personlige telefonlister | /directories/personal |
Tilføjet manuelt af bruger | 500 kontakter | Ikke anvendelig | Ikke anvendelig | |
Gruppekontakter | Adressebogssynkronisering | 30000 kontakter pr. gruppe | Gruppefælles telefonlister (for en virksomhedsgruppe)** | /directories/groupcommon |
**Gruppefællesingposter synkroniseres forskelligt, afhængigt afom Broad Works er i Virksomhedstilstand eller Tjenesteudbydertilstand. Værdien af isBroadWorksEnterprise
parameter (sand eller falsk) bestemmer, hvordan listen synkroniserer:
Sandt – synkroniser som gruppekontakt
Falsk – synkroniser som organisationskontakt
Følgende betingelser gælder for, hvordan Directory Sync håndterer kontaktmaksimalgrænseværdier:
Hvis en organisation overskrider det maksimale antal tilladte kontakter for synkroniseringen (30000 organisationskontakter eller 30000 fælles kontakter pr. gruppe), udelukker adressebogssynkronisering poster over den maksimale tærskel. Der anvendes ingen særlig ordre på synkroniserede eller udeladte kontakter.
Hvis en af dine kunder overstiger det maksimale tilladte antal kontakter i hver kategori, anbefaler vi, at du retter en sag med Cisco for at få den pågældende organisation udelukket fra adressebogssynkronisering.
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 brugerkontaktkategori på Webex, men er ikke inkluderet i synkroniseringen.
Den samlede samlede grænse for organisationskontakter (30000) og gruppekontakter (30000 pr. gruppe) er 200000.
Opdateringer
Følgende er, hvordan Webex-telefonbogen håndterer opdateringer:
Hvis kontaktnavnet ændres på Broad WorksWorks, slettes den eksisterende kontakt fra Webex-telefonbogen, og der oprettes en ny kontakt.
Hvis kontaktnummeret ændres i Broad WorksWorks, opdaterer Webex den eksisterende kontakt i Webex-telefonbogen med det nye nummer.
Når en administrator opdaterer en kontakt på Broad Works, skitserer følgende betingelser, når opdateringen vises i en brugers Webex-app:
Hvis opdateringen er til en opkaldsbruger, der kun bruger Broad Works, eller en enhed, der ikke er bruger, vises opdateringen i en brugers Webex-app umiddelbart efter den efterfølgende adressebogssynkronisering.
Hvis opdateringen er til en telefonliste medBroad Works:
For brugerkontakter – opdateringer vises i brugerens Webex-app umiddelbart efter den efterfølgende adressebogssynkronisering.
For gruppekontakter – opdateringer vises i brugernes Webex-app umiddelbart efter den efterfølgende adressebogssynkronisering.
For organisationskontakter – Webex-telefonbogen opdateres ved den efterfølgende adressebogssynkronisering, men brugere vil ikke se ændringen i Webex-appen, før de genstarter Webex-appen, eller før den lokale 72-timers cache-timeren udløber.
Forudsætninger for katalogsynkronisering
Vi anbefaler, at du bruger følgende indstillinger:
Hastighedsbegrænsende værdier – indstil følgende egenskaber i systemet til_overbelastningskontrol (XSP/Applications/Xsi-Actions/Overbelastningskontrol):
Grænse fortransaktion i brugertelefonbog – indstil til en nulværdi.
GlobalDirectoryTransaction Limit – indstillet til en nulværdi.
Det anbefales, at du indstiller grænse for transaktioni brugeradressebog og grænse for transaktion iglobal adressebog til en nulværdi. Men hvis du beslutter dig for at tildele værdier, skal hver indstilles til mindst fem gange værdien af transaktionsgrænsetidspunktetSekunder (som skal være 1).Transaktionsgrænser – indstil følgende værdier (XSP_CLI/System/Communication Utility/Standard-indstillinger):
Grænsefor brugertransaktion – indstil til mindst 100.
transaktionsbegrænsningsperiodeSek. – indstillet til 1.
Paging-værdier – indstil paging-systemets egenskaber (XSP_CLI/Applications/Xsi-Actions/Paging):
standardsidestørrelse – indstil til 50
tilgængeligMaksimalbrugergrænse – indstil til 100
CTI-grænseflade – sørg for at overføre, at Webex CA-certifikater til tillidsbutikken for CTI-grænsefladen, og aktivere klientgodkendelse på CTI-grænsefladen.
Afhængigt af udgivelsen af Broad Works anbefaler vi, at du anvender følgende systemprogramrettelser på Broad Works-installation, før du aktiverer denne funktion:
For R22:
AP.as.22.0.1123.ap368517
For R23:
AP.as.23.0.1075.ap368517
For R24: ingen plaster påkrævet
Aktivér katalogsynkronisering (ny skabelon)
Partneradministratorer kan aktivere adressebogssynkronisering for en kundeskabelon, mens de opretter den nye skabelon. Alle nye kundeorganisationer, der tildeles denne skabelon, vil have adressebogssynkronisering aktiveret. Se "Konfigurer dine kundeskabeloner" i Konfigurer din partnerorganisation i Partner Hub i løsningsvejledningen til Webex til Cisco.
Hvad der skal gøres Næste
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 fuldføres én gang.
Aktivér adressebogssynkronisering (eksisterende skabelon)
1 | Log ind på Partner Hub, og vælg Indstillinger. |
2 | Rul til Brede værker, og klik på Vis skabeloner. |
3 | Vælg den relevante kundeskabelon, og rul til Broad Works Directory Sync. |
4 | Sådan aktiveres adressebogssynkronisering som standard for nye kundeorganisationer, der bruger denne skabelon: |
5 | Sådan aktiveres adressebogssynkronisering for eksisterende kundeorganisationer, der bruger denne skabelon: Hvis du vil deaktivere adressebogssynkronisering, skal du følge ovenstående procedure og:
|
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 fuldføres én gang.
Udløser øjeblikkelig synkronisering
1 | Log ind på Partner Hub ( http://admin.webex.com), og vælg Indstillinger. |
2 | Rul til Brede værker, og klik på Vis skabeloner. |
3 | Vælg den relevante kundeskabelon, og rul til Broad Works Directory Sync. |
4 | Klik på Vis liste over kunders synkroniseringsstatus. |
5 | For den kundeorganisation, du vil synkronisere, skal du klikke på de tre prikker til højre og vælge Synkroniser nu. |
6 | Klik på Opdater for at se synkroniseringsresultaterne. |
Eksportér synkroniseringsposter til CSV
1 | Log ind på Partner Hub ( http://admin.webex.com), og vælg Indstillinger. |
2 | Rul til Brede værker, og klik på Vis skabeloner. |
3 | Vælg den relevante kundeskabelon, og rul til Broad Works Directory Sync. |
4 | Klik på Vis liste over kunders synkroniseringsstatus. |
5 | Marker de tilstødende afkrydsningsfelter for hver organisation, som du vil inkludere i eksporten. |
6 | Klik på Eksportér resultater. |
Offentlige API'er til katalogsynkronisering
Offentlige API'er er tilgængelige på developer.webex.com , der giver partneradministratorer mulighed for at opdatere indstillinger for adressebogssynkronisering for de kundeorganisationer, de administrerer, for at udløse en øjeblikkelig synkronisering eller få oplysninger om synkroniseringsstatus. Katalogsynkroniseringsmetoderne grupperes under Broad Works:
Liste over store virksomheder – Brug denne API-metode til at få en liste over virksomheder under en bestemt tjenesteudbyder og hver virksomheds
id
. Du skal indtastespEnterpriseId
som tildelt ved klargøring.Opdater adressebogssynkronisering for en virksomhed med brede værker – indtast virksomheden
id
for at opdatere adressebogssyc-statussen for den pågældende virksomhed ved at aktivere eller deaktivere adressebogssynkronisering.Udløseradressebogssynkronisering for en virksomhed – brug denne API-metode, hvis du vil udløse en øjeblikkelig synkronisering for en given virksomhed
id
. ForsyncStatus
, indtastSYNC_NOW
Kommandør.Få status for adressebogssynkronisering for en virksomhed – indtast virksomheden
id
og køre for at få status ogtrackingId
af den seneste synkronisering. Du kan brugetrackingID
at udføre yderligere analyser via værktøjer som Kibana og Grafana.
Derudover kan administratorer bruge Trigger Directory Sync for en enkelt bruger API til at udløse en on-demand adressebogssynkronisering for en enkelt bruger.
Se detaljeret API-dokumentation 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
Katalogsynkronisering tillader dig kun at synkronisere en enkelt virksomhed fra en Broadworks-klynge ad gangen via en on-demand-synkronisering. Hvis du forsøger at synkronisere mere end én virksomhed, modtager du en 429-fejl
Den tid, det tager at udløse en synkronisering for en enkelt virksomhed, varierer afhængigt af virksomhedens størrelse.
1 | Kør API List Broad Works Enterprises for at generere en liste over virksomheder, som du vil synkronisere. |
2 | Kør Trigger Directory Sync for en virksomhed API på den første virksomhed på listen. |
3 | Vent et par sekunder, og kør derefter API til Hent adressebogssynkroniseringsstatus for at få synkroniseringsstatus. |
4 | Når synkroniseringen er afsluttet, skal du fuldføre trin 2 til 4 på den næste virksomhed på listen. Gentag disse trin, indtil du har synkroniseret hele listen. |
Fejlkoder for adressebogssynkronisering
Følgende fejlkoder gælder for adressebogssynkronisering.
Fejlkode | Fejlmeddelelse |
---|---|
600000 | 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 kundekonfigurationen, 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 Broad Works-telefonliste kunne ikke synkronisere alle bruger- og virksomheds-/organisationskontakter. |
600018 | Synkronisering af Broad Works-telefonliste mislykkedes for brugere i virksomheden/organisationen. |
600019 | Synkronisering af telefonliste med brede værker kunne ikke synkronisere virksomheds-/organisationskontakter. |
600020 | Synkronisering af brugere af den eksterne adressebog for Broad Works kan ikke deaktiveres, da synkroniseringen af kundekonfiguration er i gang. |
600022 | Synkronisering af enkelt bruger i Broad Works External Directory er ikke mulig, da virksomheden ikke har en klargjort bruger. |
600023 | Synkronisering af enkelt bruger i Broad Works External Directory er ikke mulig, fordi brugeren allerede findes i denne organisation. |
600024 | Synkronisering af enkelt bruger i Broad Works External Directory er ikke mulig, fordi der ikke blev fundet nogen matchende bruger i BroadWorks. |
600025 | Synkronisering afbruger i Broad Works' eksterne adressebog kunne ikke opdatere brugerkontoen i CI. |
600026 | Synkronisering afBroad Works External Directory-bruger kunne ikke opdatere maskinkontoen i CI. |
600027 | Synkronisering af enkelt bruger i Broad Works External Directory er ikke mulig, fordi flere brugere blev fundet i BroadWorks. |
600028 | Synkronisering af BroadWorks External Directory Single User Sync er ikke mulig, fordi mindst én synkronisering af firmatelefonbogen skulle være fuldført. |
600029 | Synkronisering af bruger i BroadWorks' eksterne adressebog mislykkedes, da virksomheden ikke har en klargjort bruger. |
Skift historik
Følgende tabel opsummerer opdateringer til denne artikel.
Dato | Revision |
---|---|
14. februar 2023 | Opdateret sektionen Maks. og kilde til adressebogssynkronisering . |
10. december 2022 | Opdaterede termen Fuldfør øjeblikkelig synkronisering til Trigger Directory Sync |
19. juli 2022 | Præciseringer og rettelser for at få oversigt over oplysninger:
|
09. maj 2022 |
|
Den 07. april 2022 |
|
28. marts 2022 |
|
24. marts 2022 | Tilføjet liste over synkroniserede telefonnummertyper til betingelser for adressebogssynkronisering. Synkroniseringen omfatter nu mobiltelefonnumre. |
16. marts 2022 |
|
17. december 2021 |
|
16. december 2021 |
|
08. december 2021 |
|