Ö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.

Tabell 1. Katalogsynkroniseringsuppdateringar för 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:

  • Allmänna telefonlistor för företag

  • Grupp allmänna telefonlistor (tjänsteleverantör grupper eller företagsgrupper)

  • Personliga telefonlistor

Katalogsynkronisering (telefonlistassynkronisering)


Mer information om användareetablering finns i Webex för Cisco BroadWorks lösningsguide.

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 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.

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 500 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).


Endast telefonlistposter läggs till i Webex-kontakter. BroadWorks-uppringande användare och enheter som inte är användare ringer som ingår i katalogsynkronisering läggs inte till i kontakter om inte en Webex-användare lägger till dem i kontakter manuellt.

Följande tabell över mappar Webex-kontakttyper mot kontaktkällan (synkroniseras från en BroadWorks-telefonlista eller läggs till manuellt):

Tabell 2. Maximalt antal katalogsynkroniseringar och -källa

Webex-kontakttyp

Kontaktkälla

Maximal

Synkades från BroadWorks...

API som används för synkronisering

Organisationskontakter

Katalogsynkronisering

500 kontakter

Allmänna telefonlistor för företag

/directories/enterprisecommon

Grupp allmänna telefonlistor (för tjänsteleverantör grupp)**

/directories/groupcommon

Användarkontakter

Katalogsynkronisering

1 500 kontakter

Grupp allmänna telefonlistor (för företagsgrupp)**

/directories/groupcommon

Personliga telefonlistor

/directories/personal

Lades till manuellt av användare

500 kontakter

Ej tillämpligt

Ej tillämpligt


**Grupp common Phone List-poster 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 användarkontakt

  • Falskt – Synkronisera som organisationskontakt

Följande villkor gäller för hur Directory Sync hanterar kontakt maximum:

  • Om en organisation överskrider det maximalt tillåtna antalet tillåtna kontakter för synkroniseringen (500 organisationskontakter eller 1 500 synkroniserade användarkontakter), exkluderar 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.

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 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.


Uppdateringar av Webex för Cisco BroadWorks användarinformation kommer att hanteras som en del av etableringsprocesser.

Control Hub innehåller ett alternativ för att lägga till eller redigera kontakter på organisationsnivå i Control Hub via en CSV-fil. Partneradministratörer och kundadministratörer med åtkomst till Control Hub har åtkomst till det här alternativet. Uppdatering av kontakter via Control Hub stöds dock inte av Webex för Cisco BroadWorks. Kontaktuppdateringar som tillämpas i Control Hub synkroniseras inte med BroadWorks och är inte tillgängliga i katalogsökningar från skrivbordstelefoner.

Förutsättningar för katalogsynkronisering

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:

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)

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 och aktivera .

  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 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

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:

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

  • Uppdatera katalogsynkronisering för ett BroadWorks-företag– ange företaget 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 ett fö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.

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

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 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

  • 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 den enskilda on-demand-synkroniseringen enligt Broadworks-gränsen.
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

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

19 juli 2022

Förtydliganden och korrigeringar av översiktsinformation:

  • Uppdaterad översikt över katalogsynkronisering för att förtydliga de olika synkroniseringarna som ingår och hur Webex-katalogen uppdateras för varje.

  • Uppdaterade BroadWorks-telefonlista och kontakt maximum för att förtydliga att endast telefonlistor synkroniseras till kontakter.

  • Korrigeringar av uppdateringar för att tydliggöra hur lång tid det tar för Webex-appen att visa uppdaterade poster.

9 maj 2022

  • I Översikt över katalogsynkroniseringhar korrigerats Anteckning under tabell för högsta tillåtna katalogsynkronisering och källa. Även uppdaterad Anteckning vid flow provisioning.

  • Ändringar och korrigeringar av ämnesredigeringar

7 april 2022

  • Lade till anteckning i avsnittet Uppdateringar i Katalogsynkroniseringsöversikt runt begränsningen av tillämpning av kontaktredigering på organisationsnivå i Control Hub.

28 mars 2022

  • Infogat innehållet som saknas under Aktivera katalogsynkronisering (ny mall) .

  • Lade till information om maximalt synk. Du kan köra en schemalagd synkronisering och en API-synkronisering samtidigt från samma kluster.

  • Tillagd information om Trigger Directory Sync för en enskild användares API.

24 mars 2022

Lade till en lista med synkroniserade telefonnummer i Directory Sync Conditions. Synkroniseringen inkluderar nu mobiltelefonnummer.

16 mars 2022

  • Nya felkoder har lagts till.

  • Ett inledningsbeskrivningsmeddelande har lagts till för att ge bättre användbarhet i webbsökningar.

17 december, 2021

  • Mindre redigeringar för att åtgärda problem med saknad TOC.

16 december, 2021

  • Uppdaterad artikel med utökade maxvärden för användarkontakter.

8 december, 2021

  • Lagt till avsnitt Max för Katalogsynkronisering och kontakt för att förtydliga hur Katalogsynkronisering härrör från maximalt antal organisations- och användarkontakter.

  • Granskad tabellformatering i Felkoder för katalogsynkronisering för bättre läsbarhet.