Översikt över katalogsynkronisering

Katalogsynkronisering säkerställer att Webex för Cisco BroadWorks-användare kan använda Webex-katalogen för att ringa upp alla samtalsenhet från BroadWorks-servern. När den här funktionen är aktiverad synkroniseras den fullständiga samtalskatalogen från BroadWorks-servern med Webex-katalogen. Användare kan komma åt katalogen från Webex-appen och ringa ett samtal till alla samtalsenhet från BroadWorks-servern.

Katalogsynkronisering inkluderar synkronisering av både användarsamtalsinformation och telefonlistor. Synkroniserade telefonlistposter skrivs in för en av två kontakttyper i Webex-katalogen:

  • Organisationskontakter – Dessa kontakter lagras mot en organisation och är tillgängliga för alla användare i organisationen.

  • Användarkontakter—Dessa kontakter lagras mot en användare och är endast tillgängliga för användaren som äger kontakten.


Webex för Cisco BroadWorks-etablering inkluderar en standardsynkronisering av meddelandeanvändare och tillhörande samtalsinformation från BroadWorks-servern till Webex-katalogen. Standardsynkronisering vid tillhandahållande utelämnar dock användare som inte skickar meddelanden och enheter utan användare (till exempel en konferensrum telefon, fax eller sökgrupp nummer). Genom att aktivera katalogsynkronisering säkerställer du att alla uppringningsenheter läggs till i Webex-katalogen.

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 Synkronisera nu för att kringgå en veckas vänteperiod och slutföra ett omedelbart synkroniseringssynkronisering 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 schemalagdes eller utlöstes manuellt med Synkronisera nu.

  • Om ett synkroniseringsfel uppstår, försöker synkroniseringen automatiskt var 24:e timme tills nästa schemalagda synkronisering har inträffat.

  • 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 är mer detaljerad än visningen av Control Hub och kan hjälpa dig med felsökning, analyser och granskning.

  • Användarkontakter lagras i ett krypterat format, men endast den användare som äger kontakten har tillgång till dekrypteringsnyckeln.

  • Den här funktionen synkroniserar följande telefonlisttyper från BroadWorks-servern:

    • Allmänna telefonlistor för företag

    • Grupp allmänna telefonlistor

    • Personliga telefonlistor

Max för katalogsynkronisering och kontakt

Följande är det maximala antalet kontakter som katalogsynkronisering tillåter för varje Webex-kontakttyp:

  • 500 organisationskontakter

  • 500 användarkontakter – För en användare inkluderar max antal synkroniserade användarkontakter och manuella kontakter (kontakter som användaren lägger till manuellt via Webex-appen)

Följande villkor gäller:

  • Om en organisation har fler än 500 kontakter i någon av kategorin exkluderas poster som är över 500-gränsen. Det finns ingen särskild ordning tillämpad på synkroniserade eller utelämnade kontakter.

  • Om en användare lägger till kontakter manuellt på Webex-appen, avgörs maxvärdet för Användarkontakt genom att de manuella kontakterna subtraheras från synkroniserade användarkontakter. Om en användare till exempel lägger till 100 kontakter manuellt på Webex-appen, gör katalogsynkronisering att upp till 400 användarkontakter synkroniseras från BroadWorks för den användaren.

  • Vi rekommenderar att om en av dina kundorganisationer har fler än 500 kontakter i någon av kategorierna bör du kontakta Cisco för att utesluta denna organisation från katalogsynkronisering.

Följande tabell över mappar Webex-kontakttyperna till BroadWorks-telefonlistan från vilken posterna synkroniseras:

Tabell 1. Katalogsynkroniseringstyper och synkroniseringskälla

Webex-kontakttyp

Synkades från BroadWorks...

API som används för synkronisering

Organisationskontakter

Allmänna telefonlistor för företag

/directories/enterprisecommon

Grupp allmänna telefonlistor (i tjänsteleverantör läge)**

/directories/groupcommon

Användarkontakter

Grupp allmänna telefonlistor (i företagsläge)**

/directories/groupcommon

Personliga telefonlistor

/directories/personal


**Grupp allmänna telefonlistor synkroniseras olika beroende på om BroadWorks är i företagsläge eller tjänsteleverantör läge. Värdet på isBroadWorksEnterprise parametern (sant eller falskt) avgör hur listan synkroniseras:

  • True – Synkronisera som organisationskontakt

  • Falskt – Synkronisera som användarkontakt

Uppdateringar

När en kontakt har uppdaterats i BroadWorks beskrivs följande när uppdateringen visas i en användares Webex-app:

  • Organisationskontaktuppdateringar visas i Webex-appen när användaren har startat om appen eller efter att appens lokala 72-timmars cachetimer löper ut.

  • Uppdateringar av användarkontakt visas omedelbart i Webex-appen för den användaren.

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 uppdateras den befintliga kontakten i Webex-katalogen med det nya numret.

Förutsättningar för katalogsynkronisering

Växla krav

Följande funktionsreglage finns för den här funktionen. Se till att kontakta din Webex-representant för Cisco BroadWorks för att ställa in dessa.

Funktionsreglage

Tillämpad på ...

Beskrivning

webex-for-broadworks-phone-list-sync

Partner

Obligatorisk växling. Aktiverar telefonlistsynkronisering för alla kundorganisationer under denna partner.

Måste vara aktiverad.

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

Kundorganisation

Valfri växling. Inaktiverar telefonlistsynkronisering för en viss organisation, även om funktionen är aktiverad på partnernivå och i kundmallen.

Använd endast denna växling om du vill inaktivera telefonlistsynkronisering för en viss kundorganisation. Annars kan du lämna den inaktiverad.


 
Du bör till exempel tillämpa denna växling för alla organisationer som kräver mer än 500 kontakter.

hidden-personal-contacts-enabled-ga

Användare

Valfri växling. Döljer personliga kontakter från katalogsökning som denna användare har slutfört.

hidden-org-contacts-enabled-ga

Användare

Valfri växling. Döljer organisationskontakter från katalogsökning som denna användare har slutfört.

Förkonfigureringskrav

Vi rekommenderar att du använder följande inställningar:


Nedan följer exempel på att du använder en XSP-server. För ADP-servrar, ersätt (XSP_CLI) med (ADP_CLI).
  • 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:


En fullständig lista över programfixkrav som utgör minimikravet för Webex för Cisco BroadWorks finns i BroadWorks-programvarukrav ilösningsguiden för Webex för Cisco BroadWorks.

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örWebex 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)

Partneradministratörer kan utföra följande steg för att aktivera katalogsynkronisering i en befintlig kundmall för att aktivera funktionen för kundorganisationer som använder mallen.

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:

  1. Ställ in Aktivera BroadWorks Katalog - och Telefonlistsynkronisering för alla nya kundorganisationer till .

  2. Klicka på Spara.

5

Gör så här för att aktivera katalogsynkronisering för befintliga kundorganisationer som använder den här mallen:

  1. Klicka på Visa lista över kunders synkroniseringsstatus.

  2. Markera kryssrutorna intill för varje organisation som du vill aktivera funktionen för.

  3. Klicka på Aktivera synkronisering.


 

Om du vill inaktivera katalogsynkronisering ska du följa ovanstående procedur och:

  • I steg 4a ställer du in Aktivera telefonkatalogsynkronisering för alla nya kundorganisationer och inaktiverar katalogsynkronisering som standard för nya kundorganisationer som använder den här mallen.

  • I steg 5c klickar du på Inaktivera synkronisering för att inaktivera funktionen för befintliga organisationer.

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.

Slutför omedelbar synkronisering

Med alternativet Synkronisera nu kan partneradministratör utföra en on-demand-synkronisering för en viss kundorganisation. Det här alternativet kan endast väljas för enskilda kundorganisationer – det finns inget massalternativ för Synkronisera nu.

1

Logga in på Partner Hub (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 den kundorganisation som du vill synkronisera klickar du på de tre punkterna längst till höger och väljer Synkroniseranu.

6

Klicka på Uppdatera för att se synkroniseringsresultaten.

Exportera synkroniseringsregister till CSV

Partneradministratörer kan exportera detaljerad information om den senaste synkroniseringen till en CSV-fil. CSV-filen innehåller en mer detaljerad vy av synkroniseringsposten än GUI för kontrollhubben och kan hjälpa till med felsökning och analyser.

1

Logga in på Partner Hub (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. Det finns fyra API:er:

  • List BroadWorks-företag – Använd denna API-metod för att erhålla en lista över företagunder tjänsteleverantör och varje företags id. Du måste ange spEnterpriseId som tilldelats vid etableringen.

  • Uppdatera katalogsynkronisering för ett BroadWorks-företag– ange företag id för att uppdatera katalogsystemstatus för det företaget, aktivera eller inaktivera katalogsynkronisering.

  • Trigger Directory Sync för ett företag– Använd denna API-metod om du vill utlösa en omedelbar synkronisering för ett givet företag id. För t syncStatus, ange SYNC_NOW Kommandot.

  • Hämta katalogsynkroniseringsstatus för ettföretag – ange företag id och kör för att få en status och trackingId av den senaste synkroniseringen. Du kan använda trackingID för att göra ytterligare analyser via verktyg som Kibana och Grafana.

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

Slutför denna procedur för att använda de allmänna API:erna för att slutföra katalogsynkronisering för flera företag.

  • Katalogsynkronisering innebär att du endast kan synkronisera ett företag åt gången. Om du försöker synkronisera fler än ett företag får du ett 429-fel.

  • Tiden som det tar att genomföra 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.

  1. Ställ in start Med till startsträngen för företagets eller tjänsteleverantörens identifierare.

  2. Klicka på Kör.

2

Kör Trigger Directory Sync för ett företags-API på det första företaget i listan.

  1. Ange företags-ID.

  2. Ställ in syncStatus till SYNC_NOW

  3. Klicka på Kör.

    En omedelbar synkronisering utlöses för företaget. Denna synkronisering räknas mot gränsen för en synkronisering per instans.
3

Vänta några sekunder och kör sedan API:et Hämta katalogsynkroniseringsstatus för att få synkroniseringsstatusen.

  1. Ange företags-ID

  2. Klicka på Kör.

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

Broadworks External Directory User Sync oväntat fel.

600001

Broadworks extern katalog användarsynkronisering misslyckades.

600002

Broadworks External Directory User Sync måste avslutas innan det är klart.

600003

Broadworks External Directory User Sync har endast delvis genomförts. Vissa kundorganisationer kunde inte synkroniseras.

600004

Broadworks External Directory User Sync är inte aktiverat för configSet.

600005

Broadworks External Directory User Sync pågår för configSet.

600006

Broadworks Externa kataloganvändarsynkroniseringstrådar är upptagna eller stängs av och godkänner därför inte fler synkroniseringsförfrågningar. Försök igen senare.

600007

Det går inte att hitta identitetsorganisationen för Kundkonferenser.

600008

CustomerConfig hittades inte i partnerorganisationen.

600009

Broadworks External Directory User Sync kan inte köras eftersom Broadworks-klustret som är associerat med CustomerConfig är upptaget

600010

Broadworks External Directory User Sync kan inte köras eftersom det inte finns något Broadworks-kluster associerat med CustomerConfig.

600011

Broadworks external directory user Sync är inte aktiverat för CustomerConfig.

600012

Broadworks externa kataloganvändarsynkronisering kan inte köras eftersom Hybrid-katalogsynkronisering redan är aktiverad för CustomerConfig.

600013

Broadworks External Directory User Sync kunde inte lägga till användare och datorkonton i identitetslagret.

600014

Broadworks External Directory User Sync misslyckades med att ansluta till Broadworks-kluster. Fel från Broadworks - %s.

600015

Broadworks External Directory User Sync hittade inte någon överensstämmande användare i identitetslagret.

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.