- Start
- /
- Artikel
Katalogsynkronisering i Webex för Cisco BroadWorks
Den här artikeln beskriver hur du distribuerar katalogsynkronisering i Webex för Cisco BroadWorks. Artikeln riktar sig till administratörer tjänsteleverantör partnerorganisationer.
Översikt över katalogsynkronisering
Katalogsynkronisering säkerställer att Webex för Cisco BroadWorks-användare kan använda Webex-katalogen från Webex-appen för att ringa upp alla samtalsenhet från BroadWorks-servern. Den här funktionen synkroniserar BroadWorks-samtalsinformation som inte ingick i användareablering till Webex-katalogen.
Webex för Cisco BroadWorks-användares etablering uppdaterar Webex-katalogen med samtalsinformation för Webex för Cisco BroadWorks-användare (primärt telefonnummer, mobiltelefonnummer, anknytning), men utelämnar externa samtalsregister. Men när katalogsynkronisering är på synkroniseras även följande samtalsposter med Webex-katalogen.
-
BroadWorks-only calling users (who are not onboarded to Webex)
-
Enheter som inte använder uppringning (t.ex. en konferensrum telefon, fax, sökgrupp nummer)
-
BroadWorks telefonlista
Följande tabell sammanfattar BroadWorks-samtalsposter och visar hur de läggs till i Webex-katalogen.
BroadWorks samtalsregister |
Beskrivning |
Tillagd i Webex-katalogen via... |
---|---|---|
Webex för Cisco BroadWorks-användare |
Användare är aktiverade för Webex för Cisco BroadWorks |
Användareetablering (t.ex. flow provisioning) |
BroadWorks-only calling användare |
Ringa upp användare som inte är inbyggda i Webex |
Katalogsynkronisering |
Enheter som inte använder samtal |
T.ex. en telefon konferensrum, fax, huntgruppsnummer |
Katalogsynkronisering |
BroadWorks telefonlistor |
BroadWorks telefonlistposter:
|
Katalogsynkronisering (telefonlistassynkronisering) |
Villkor för katalogsynkronisering
-
Partneradministratörer måste aktivera funktionen på partnernivå. Partneradministratörer kan slå på eller av funktionen för flera kundorganisationer i en enda åtgärd.
-
Som standard sker den första synkroniseringen en vecka efter aktiveringen av synkroniseringen (den tid som väljs för att starta synkroniseringen är slumpmässig). Kundorganisationer kan dock använda alternativet Synkronisering nu för att kringgå vänteperioden på en vecka och utlösa en omedelbar synkronisering för en viss kundorganisation.
-
Som standard körs katalogsynkronisering varje vecka för varje kund. Varje synkronisering sker en vecka efter den senaste synkroniseringen, oavsett om den senaste synkroniseringen schemalades eller utlöstes manuellt med Synkronisera nu.
-
Max antal samtidiga synkroniseringar per BroadWorks-kluster är två: ett schemalagt synkroniserings- och ett on-demand-synkronisering (via API eller partnerhubb-GUI). Administratörer kan dock inte köra två synkroniserade on-demand samtidigt från samma BroadWorks. Den här begränsningen finns oavsett om synkroniseringen initierades via API:en eller via alternativet Synkronisera nu i partnerhubben. Dessutom kommer Webex inte schemalägga två schemalagda synkroniseringar som ska köras samtidigt från samma BroadWorks.
-
Om ett synkroniseringsfel uppstår försöker Webex automatiskt att synkronisera var 24:e timme till och med nästa schemalagda synkronisering.
-
Synkroniseringen ignorerar användare som inte har ett telefonnummer.
-
I partnerhubben kan du visa information om synkroniseringsstatus för en viss kund. Dessutom kan du exportera detaljerad information om den senaste synkroniseringen till en CSV-post. CSV-posten ger mer information än visningen av Control Hub och kan hjälpa dig med felsökning, analyser och granskning.
-
Webex sparar användarkontakter i ett krypterat format. Endast användaren som äger kontakten har åtkomst till dekrypteringsnyckeln.
-
För broadWorks-uppringande användare och enheter som inte använder användare synkar denna funktion följande telefonnummertyper från BroadWorks:
-
Primärt telefonnummer
-
Telefonnummer (mobil)
-
Anknytning
Men synkroniseringen exkluderar BroadWorks-endast-uppringande användare och enheter som inte använder användare från synkroniseringen om varken ett primärt telefonnummer eller tillägg finns.
Inställningen för personlig skyddstjänst på användarnivå för Broad Works stöds inte som en del av katalogsynkronisering.
-
Max för BroadWorks-telefonlista och kontakt
Katalogsynkronisering synkar även BroadWorks telefonlistposter till Webex-kontakter. Synkroniserade poster läggs till i en av följande kontakttyper:
-
Organisationskontakter – Webex sparar dessa kontakter mot en organisation. Varje användare kan få åtkomst till organisationens kontakter för sin organisation. Max. är upp till 30000 kontakter.
-
Användarkontakter—I Webex lagras dessa kontakter mot en användare. Endast användaren som äger kontakten kan komma åt kontaktposten. Max antal är upp till 2 000 kontakter (1 500 synkroniserade kontakter + 500 manuella kontaktkontakter).
Följande tabell över mappar Webex-kontakttyper mot kontaktkällan (synkroniseras från en BroadWorks-telefonlista eller läggs till manuellt):
Webex-kontakttyp |
Kontaktkälla |
Maximal |
Synkades från BroadWorks... |
API som används för synkronisering |
---|---|---|---|---|
Organisationskontakter |
Katalogsynkronisering |
30000 kontakter |
Allmänna telefonlistor för företag |
|
Grupp allmänna telefonlistor (för tjänsteleverantör grupp)** |
| |||
Användarkontakter |
Katalogsynkronisering |
1 500 kontakter |
Personliga telefonlistor | /kataloger/personal |
Lades till manuellt av användare |
500 kontakter |
Ej tillämpligt |
Ej tillämpligt | |
Gruppkontakter |
Katalogsynkronisering |
30000 kontakter per grupp |
Grupp allmänna telefonlistor (för företagsgrupp)** | /kataloger/gruppgemensamma |
**Grupp common Phone List-poster synkroniseras olika beroende på om BroadWorks är i företagsläge eller tjänsteleverantör läge. Värdet av ärBroad WorksEnterprise
parametern (sann eller falsk) avgör hur listan synkroniseras:
-
Sant – synkronisera som gruppkontakt
-
Falskt – Synkronisera som organisationskontakt
Följande villkor gäller för hur Directory Sync hanterar kontakt maximum:
-
Om en organisation överskrider de maximala tillåtna kontakterna för synkroniseringen (30000 organisationskontakter eller 30000 gruppkontakter per grupp) utesluter katalogsynkronisering poster över det maximala tröskelvärdet. Det finns ingen särskild ordning tillämpad på synkroniserade eller utelämnade kontakter.
-
Om en av dina kunder överskrider det maximalt tillåtna antalet kontakter i någon av kategorin rekommenderar vi att du tar upp ett ärende med Cisco för att utesluta denna organisation från katalogsynkronisering.
-
Manuella kontakter är kontakter som en användare lägger till manuellt i Webex-appen. En användare kan lägga till upp till 500 manuella kontakter. Manuella kontakter tillhör den större användarkontaktkategorin på Webex, men är inte inkluderade i synkroniseringen.
-
Den totala kombinerade gränsen för organisationskontakter (3 0000) och gruppkontakter (3 0000 per grupp) är 200 000.
Uppdateringar
Följande är hur Webex-katalogen hanterar uppdateringar:
-
Om kontaktnamnet ändras i BroadWorks tas den befintliga kontakten bort från Webex-katalogen och en ny kontakt skapas.
-
Om kontaktnumret ändras i BroadWorks uppdaterar Webex den befintliga kontakten i Webex-katalogen med det nya numret.
När en administratör har uppdaterat en kontakt på BroadWorks beskrivs följande villkor när uppdateringen visas i en användares Webex-app:
-
Om uppdateringen gäller en BroadWorks-uppringande användare eller en enhet som inte använder användare visas uppdateringen i en användares Webex-app omedelbart efter den efterföljande katalogsynkronisering.
-
Om uppdateringen gäller en BroadWorks-telefonlista:
-
För användarkontakter – uppdateringar visas i användarens Webex-app omedelbart efter den efterföljande katalogsynkronisering.
-
För gruppkontakter – uppdateringar visas i användarnas Webex-appen omedelbart efter efterföljande katalogsynkronisering.
-
För organisationskontakter – Webex-katalogen uppdateras vid efterföljande katalogsynkronisering, men användarna kommer inte att se ändringen i Webex-appen förrän de startar om Webex-appen eller tills den lokala cachetimeren på 72 timmar går ut.
-
Förutsättningar för katalogsynkronisering
Vi rekommenderar att du använder följande inställningar:
-
Hastighetsbegränsningsvärden – ställ in följande överbelastningskontrollsystemegenskaper (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
-
userDirectoryTransactionLimit – Ange som null-värde.
-
globalDirectoryTransactionLimit – Ange som null-värde.
Du rekommenderas att ange userDirectoryTransactionLimit och globalDirectoryTransactionLimit till ett null-värde. Om du däremot bestämmer dig för att tilldela värden måste varje anges till minst fem gånger värdet på transaktionenLimitPeriodSeconds (vilket ska vara 1). -
-
Transaktionsgränser – Ange följande värden (XSP_CLI/System/CommunicationUtility/DefaultSettings):
-
userTransactionLimit – Ställ in till minst 100.
-
transactionLimitPeriodSecs – Ställ in till 1.
-
-
Ansökningsvärden – ange egenskaper för personsökningssystemet (XSP_CLI/Applications/Xsi-Actions/Paging):
-
defaultPageSize – Ställ in till 50
-
tillgängligUserMaxLimit – ställ in på 100
-
-
CTI-gränssnitt – Se till att överföra att Webex CA-certifikat till den betrodda lagringen av CTI-gränssnittet och att aktivera klientautentisering i CTI-gränssnittet.
Beroende på din BroadWorks-version rekommenderar vi dessutom att du tillämpar följande systemfixar för BroadWorks-distribution innan du aktiverar denna funktion:
-
För R22:
AP.as.22.0.1123.ap368517
-
För R23:
AP.as.23.0.1075.ap368517
-
För R24: ingen programfix krävs
Aktivera katalogsynkronisering (ny mall)
Partneradministratörer kan aktivera Katalogsynkronisering för en kundmall medan de skapar den nya mallen. Alla nya kundorganisationer som tilldelas den mallen kommer att ha katalogsynkronisering aktiverat. Mer information finns i "Konfigurera kundmallar" i Konfigurera din partnerorganisation i partnerhubben i Lösningsguiden för Webex för Cisco BroadWorks.
Nästa steg
Se till att användarna vet att de måste klicka på fliken Kontakter på Webex-appen minst en gång för att kunna aktivera funktionen i Webex-appen. Detta behöver bara slutföras en gång.
Aktivera katalogsynkronisering (befintlig mall)
1 |
Logga in på Partner Hub och välj Inställningar. |
2 |
Bläddra till BroadWorks-samtal och klicka på Visa mallar. |
3 |
Välj lämplig kundmall och bläddra till BroadWorks Directory Sync. |
4 |
För att aktivera katalogsynkronisering som standard för nya kundorganiseringar som använder den här mallen: |
5 |
Gör så här för att aktivera katalogsynkronisering för befintliga kundorganisationer som använder den här mallen: Om du vill inaktivera katalogsynkronisering ska du följa ovanstående procedur och:
|
Nästa steg
Se till att användarna vet att de måste klicka på fliken Kontakter på Webex-appen minst en gång för att kunna aktivera funktionen i Webex-appen. Detta behöver bara slutföras en gång.
Utlöser omedelbar synkronisering
1 |
Logga in på partnerhubben ( http://admin.webex.com) och välj Inställningar. |
2 |
Bläddra till BroadWorks-samtal och klicka på Visa mallar. |
3 |
Välj lämplig kundmall och bläddra till BroadWorks Directory Sync. |
4 |
Klicka på Visa lista över kunders synkroniseringsstatus. |
5 |
För kundorganisationen som du vill synkronisera klickar du på de tre punkterna längst till höger och väljer Synkronisera nu. |
6 |
Klicka på Uppdatera för att se synkroniseringsresultaten. |
Exportera synkroniseringsregister till CSV
1 |
Logga in på partnerhubben ( http://admin.webex.com) och välj Inställningar. |
2 |
Bläddra till BroadWorks-samtal och klicka på Visa mallar. |
3 |
Välj lämplig kundmall och bläddra till BroadWorks Directory Sync. |
4 |
Klicka på Visa lista över kunders synkroniseringsstatus. |
5 |
Markera intilliggande kryssrutorna för varje organisation som du vill inkludera i exporten. |
6 |
Klicka på Exportera resultat. |
Offentliga API:er för Directory Sync
Offentliga API:er finns tillgängliga developer.webex.com gör det möjligt för partneradministratörer att uppdatera katalogsynkroniseringsinställningar för kundorganisationer som de hanterar, att utlöse en omedelbar synkronisering eller hämta synkroniseringsstatusinformation. Katalogsynkroniseringsmetoderna är grupperade under BroadWorks-företag:
-
Lista över företag – använd den här API-metoden för att erhålla en lista över företag under en viss tjänsteleverantör och varje företags
ID
. Du måste angesp
Enterprise -ID som tilldelats i etableringen. -
Uppdatera katalogsynkronisering för ett brett företag – ange företagets
ID
för att uppdatera katalogsyc-status för det företaget, aktivera eller inaktivera katalogsynkronisering. -
Utlöser katalogsynkronisering för ett företag– Använd den här API-metoden om du vill utlösa en omedelbar synkronisering för ett visst
enterprise-id
. Försynkroniseringsstatus
anger du kommandotSYNC_NOW
. -
Hämta katalogsynkroniseringsstatus för ett företag – ange företagets
ID
och kör för att få status ochspåra
den senaste synkroniseringen. Du kan användaspårnings-ID
för att köra ytterligare analyser via verktyg som Kibana och Grafana.
Dessutom kan administratörer använda Utlösa katalogsynkronisering för en enskild användares API för att utlösa en katalogsynkronisering on-demand för en enskild användare.
Detaljerad API-dokumentation finns i https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Du måste logga in för att läsa API-specifikationen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Synkronisera flera företag med API
-
Katalogsynkronisering låter dig synkronisera endast ett enda företag från ett Broadworks-kluster åt gången via en on-demand-synkronisering. Om du försöker synkronisera fler än ett företag får du ett 429-fel
-
Den tid det tar att utlösa en synkronisering för ett enda företag varierar beroende på företagets storlek.
1 |
Kör LIST BroadWorks Enterprises API för att generera en lista över företag som du vill synkronisera. |
2 |
Kör Trigger Directory Sync för ett företags-API på det första företaget i listan. |
3 |
Vänta några sekunder och kör sedan API:et Hämta katalogsynkroniseringsstatus för att få synkroniseringsstatusen. |
4 |
När synkroniseringen är slutförd slutför du steg 2 till 4 på nästa företag i listan. Upprepa dessa steg tills du har synkroniserat hela listan. |
Felkoder för katalogsynkronisering
Följande felkoder gäller för katalogsynkronisering.
Felkod |
Felmeddelande |
---|---|
600000 |
Oväntat fel vid synkronisering av Broadworks externa kataloganvändare. |
600001 |
Synkronisering av Broadworks externa kataloganvändare misslyckades. |
600002 |
Synkronisering av Broadworks externa kataloganvändare måste avslutas innan slutförande. |
600003 |
Synkronisering av Broadworks externa kataloganvändare slutfördes endast delvis. Vissa kundorganisationer kunde inte synkroniseras. |
600004 |
Synkronisering av Broadworks externa kataloganvändare är inte aktiverat för ConfigSet. |
600005 |
Synkronisering av Broadworks externa kataloganvändare pågår för ConfigSet. |
600006 |
Trådar för synkronisering av Broadworks externa kataloganvändare är upptagna eller stängs av, vilket innebär att fler synkroniseringsförfrågningar inte accepteras. Försök igen senare. |
600007 |
Hittade inte Identity Org för CustomerConfig. |
600008 |
Hittade inte CustomerConfig i partnerorganisationen. |
600009 |
Broadworks External Directory User Sync kan inte köras eftersom Broadworks-klustret som är associerat med CustomerConfig är upptaget |
600010 |
Synkronisering av Broadworks externa kataloganvändare kan inte köras eftersom det inte finns något broadworks-kluster kopplat till CustomerConfig. |
600011 |
Synkronisering av Broadworks externa kataloganvändare är inte aktiverat för CustomerConfig. |
600012 |
Synkronisering av Broadworks externa kataloganvändare kan inte köras eftersom hybridkatalogsynkronisering redan har aktiverats för CustomerConfig. |
600013 |
Synkronisering av Broadworks externa kataloganvändare kunde inte lägga till användare och maskinkonton i identitetslagret. |
600014 |
Synkronisering av Broadworks externa kataloganvändare kunde inte ansluta till Broadworks-kluster. Fel från Broadworks - %s. |
600015 |
Synkronisering av Broadworks externa kataloganvändare hittade ingen matchande användare i identitetlagret. |
600017 |
BroadWorks telefonlista kunde inte synkronisera alla användares och företags-/organisationskontakter. |
600018 |
BroadWorks telefonlista kunde inte synkroniseras för användare i företaget/organisationen. |
600019 |
BroadWorks telefonlista kunde inte synkronisera företags-/organisationskontakter. |
600020 |
BroadWorks externa katalog användarsynkronisering kan inte inaktiveras eftersom CustomerConfig-synkronisering pågår. |
600022 |
BroadWorks external directory enkel användarsynkronisering är inte möjlig eftersom företaget inte har någon användare. |
600023 |
BroadWorks extern katalog enkel användarsynkronisering är inte möjlig eftersom användaren redan finns i den här organisationen. |
600024 |
BroadWorks External Directory Enkel användarsynkronisering är inte möjlig eftersom ingen överensstämmande användare hittades i BroadWorks. |
600025 |
BroadWorks External Directory User Sync kunde inte uppdatera användarkonto CI. |
600026 |
BroadWorks External Directory User Sync kunde inte uppdatera maskinkontot i CI. |
600027 |
BroadWorks External Directory Enkel användarsynkronisering är inte möjlig eftersom flera användare hittades i BroadWorks. |
600028 |
BroadWorks External Directory Enkel användarsynkronisering är inte möjlig eftersom minst en företagskatalogsynkronisering bör ha slutförts. |
600029 |
BroadWorks External Directory User Sync misslyckades eftersom företaget inte har någon användare. |
Ändringshistorik
Följande tabell sammanfattar uppdateringar av den här artikeln.
Datum |
Revidering |
---|---|
14 februari 2023 |
Uppdaterade avsnittet Maximums och Källa för katalogsynkronisering. |
10 december 2022 |
Uppdaterade termen Slutför omedelbar synkronisering till Utlösarkatalogsynkronisering |
19 juli 2022 |
Förtydliganden och korrigeringar av översiktsinformation:
|
9 maj 2022 |
|
7 april 2022 |
|
28 mars 2022 |
|
24 mars 2022 |
Lade till en lista med synkroniserade telefonnummer i Directory Sync Conditions. Synkroniseringen inkluderar nu mobiltelefonnummer. |
16 mars 2022 |
|
17 december, 2021 |
|
16 december, 2021 |
|
8 december, 2021 |
|