In dit artikel wordt beschreven hoe u Directory Sync implementeert in Webex voor Cisco BroadWorks. Het artikel is bedoeld voor serviceproviderbeheerders bij partnerorganisaties.
Overzicht van Directorysynchronisatie
Adreslijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex -telefoonlijst van de Webex -app kunnen gebruiken om een bellende entiteit te bellen vanaf de BroadWorks-server. Deze functie synchroniseert BroadWorks-gespreksinformatie die geen deel uitmaakte van de gebruikersinrichting naar de Webex directory.
Met Webex voor Cisco BroadWorks-gebruikersinrichting wordt de Webex -telefoonlijst bijgewerkt met gespreksdetails voor Webex voor Cisco BroadWorks-gebruikers (primaire telefoon , mobiel telefoonnummer, toestel), maar worden externe gespreksrecords weggelaten. Wanneer Adreslijstsynchronisatie echter is ingeschakeld, synchroniseert de functie ook de volgende gespreksrecords met de Webex telefoonlijst.
Gebruikers die alleen bellen via BroadWorks (die niet zijn opgenomen in Webex)
Bellende entiteiten die geen gebruiker zijn (bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, zoekgroep )
Vermeldingen in de BroadWorks-telefoonlijst
De volgende tabel geeft een overzicht van BroadWorks-gespreksrecords en hoe ze worden toegevoegd aan de Webex directory.
BroadWorks-gespreksrecords |
Beschrijving |
Toegevoegd aan Webex Directory via... |
---|---|---|
Webex voor Cisco BroadWorks-gebruikers |
Gebruikers zijn ingeschakeld voor Webex voor Cisco BroadWorks |
Gebruikersinrichting (bijvoorbeeld doorstroominrichting) |
Gebruikers die alleen bellen via BroadWorks |
Gebruikers bellen die: niet onboard naar Webex |
Adreslijstsynchronisatie |
Aanroepende entiteiten die geen gebruiker zijn |
Bijvoorbeeld een telefoon in een vergaderruimte, faxapparaat, Hunt-groepnummer |
Adreslijstsynchronisatie |
BroadWorks-telefoonlijsten |
Vermeldingen in de BroadWorks-telefoonlijst:
|
Telefoonlijstsynchronisatie (synchronisatie van telefoonlijst) |
Voor meer informatie over het inrichten van gebruikers raadpleegt u de: Webex voor Cisco BroadWorks-oplossingshandleiding .
|
Voorwaarden voor directorysynchronisatie
Partnerbeheerders moeten de functie inschakelen op partnerniveau. Partnerbeheerders kunnen de functie in één bewerking in- of uitschakelen voor meerdere klantorganisaties.
Standaard vindt de eerste synchronisatie plaats één week na het inschakelen van de synchronisatie (de gekozen tijd om de synchronisatie te starten is willekeurig). Klantorganisaties kunnen echter de Nu synchroniseren optie om de wachttijd van één week te omzeilen en een onmiddellijke synchronisatie te activeren voor een bepaalde klantorganisatie.
Directorysynchronisatie wordt standaard wekelijks uitgevoerd voor elke klant. Elke synchronisatie vindt plaats één week na de laatste synchronisatie, ongeacht of de laatste synchronisatie is gepland of handmatig is geactiveerd met Nu synchroniseren .
Het maximumaantal gelijktijdige synchronisaties per BroadWorks-cluster is twee: één geplande synchronisatie en één synchronisatie op aanvraag (via API of Partner Hub GUI). Beheerders kunnen echter niet twee on-demand synchronisaties tegelijkertijd uitvoeren vanuit dezelfde BroadWorks. Deze beperking bestaat ongeacht of de synchronisatie is gestart via de API of via de Nu synchroniseren optie in Partnerhub. Bovendien Webex niet dat twee geplande synchronisaties tegelijkertijd worden uitgevoerd vanuit dezelfde BroadWorks.
Als er een synchronisatiefout optreedt, probeert Webex de synchronisatie elke 24 uur automatisch opnieuw tot de volgende geplande synchronisatie.
De synchronisatie negeert gebruikers die geen telefoonnummer hebben.
In Partner Hub kunt u informatie over de synchronisatiestatus voor een bepaalde klant bekijken. Daarnaast kunt u gedetailleerde informatie over de laatste synchronisatie exporteren naar een CSV -record. De CSV -record biedt meer details dan de Control Hub-weergave en kan helpen bij het oplossen van problemen, analyses en controles.
Webex slaat gebruikerscontacten op in een gecodeerde indeling. Alleen de gebruiker die eigenaar is van de contactpersoon heeft toegang tot de decoderingssleutel.
Voor gebruikers die alleen BroadWorks bellen en entiteiten die geen gebruikers bellen, synchroniseert deze functie de volgende typen telefoonnummer uit BroadWorks:
Primair telefoonnummer
Mobiel telefoonnummer
Extensie
Synchronisatie sluit echter alleen BroadWorks-bellende gebruikers en niet-gebruikers bellende entiteiten uit van de synchronisatie als er geen primaire telefoon of toestel aanwezig is.
BroadWorks-telefoonlijst en maxima voor contactpersonen
Directorysynchronisatie synchroniseert ook de vermeldingen in de BroadWorks-telefoonlijst met Webex -contactpersonen. Gesynchroniseerde vermeldingen worden toegevoegd aan een van de volgende typen contactpersonen:
Contactpersonen organisatie: Webex slaat deze contactpersonen op voor een organisatie. Elke gebruiker heeft toegang tot de contactpersonen van de organisatie voor hun organisatie. Het maximum is maximaal 30000 contacten.
Gebruikerscontactpersonen: Webex slaat deze contactpersonen op voor een gebruiker. Alleen de gebruiker die eigenaar is van de contactpersoon heeft toegang tot de contactpersoon. Het maximum is maximaal 2000 contacten (1500 gesynchroniseerde contacten + 500 contacten voor handmatige invoer).
Alleen vermeldingen in de telefoonlijst worden toegevoegd aan Webex -contactpersonen. Gebruikers die alleen BroadWorks bellen en niet-gebruikers bellende entiteiten die zijn opgenomen in de adreslijstsynchronisatie, worden niet toegevoegd aan Contactpersonen, tenzij een Webex -gebruiker ze handmatig aan Contactpersonen toevoegt.
|
In de volgende tabel worden Webex -contacttypen toegewezen aan de contactbron (gesynchroniseerd vanuit een BroadWorks-telefoonlijst of handmatig toegevoegd):
Type Webex contactpersoon |
Contactbron |
Maximum |
Gesynchroniseerd vanuit BroadWorks... |
API gebruikt voor synchronisatie |
---|---|---|---|---|
Contactpersonen organisatie |
Adreslijstsynchronisatie |
30000 contacten |
Algemene telefoonlijsten voor Enterprise |
|
Algemene telefoonlijsten voor groepen (voor een serviceprovidergroep)** |
|
|||
Gebruikerscontacten |
Adreslijstsynchronisatie |
1500 contacten |
Persoonlijke telefoonlijsten |
/directories/personal |
Handmatig toegevoegd door gebruiker |
500 contacten |
N.v.t. |
N.v.t. |
|
Contactpersonen groep |
Adreslijstsynchronisatie |
30000 contacten per groep |
Algemene telefoonlijsten voor groepen (voor een Enterprise-groep)** |
/directories/groupcommon |
**Gemeenschappelijke groepstelefoonlijsten worden op verschillende manieren gesynchroniseerd, afhankelijk van of BroadWorks zich in de bedrijfsmodus of de serviceprovidermodus bevindt. De waarde van de
|
De volgende voorwaarden zijn van toepassing op de manier waarop Directory Sync de maximale contactpersonen afhandelt:
Als een organisatie het maximaal toegestane aantal contactpersonen voor de synchronisatie overschrijdt (30000 organisatiecontactpersonen of 30000 algemene groepscontactpersonen per groep), worden vermeldingen boven de maximale drempelwaarde uitgesloten. Er is geen specifieke volgorde toegepast op gesynchroniseerde of weggelaten contactpersonen.
Als een van uw klanten het maximaal toegestane aantal contactpersonen in een van beide categorieën overschrijdt, raden we u aan een aanvraag bij Cisco in te dienen om die organisatie uit te sluiten van adreslijstsynchronisatie.
Handmatige contactpersonen zijn contactpersonen die een gebruiker handmatig toevoegt aan de Webex app. Een gebruiker kan maximaal 500 handmatige contactpersonen toevoegen. Handmatige contactpersonen vallen binnen de grotere categorie Gebruikerscontactpersonen op Webex, maar worden niet opgenomen in de synchronisatie.
De totale gecombineerde limiet voor organisatiecontactpersonen (30000) en groepscontactpersonen (30000 per groep) is 200000.
Updates
Hieronder ziet u hoe de Webex directory updates verwerkt:
Als de naam van de naam contactpersoon in BroadWorks verandert, wordt de bestaande contactpersoon verwijderd uit de Webex telefoonlijst en wordt er een nieuwe contactpersoon gemaakt.
Als het contactnummer op BroadWorks verandert, werkt Webex de bestaande contactpersoon in de Webex telefoonlijst bij met het nieuwe nummer.
Nadat een beheerder een contactpersoon op BroadWorks heeft bijgewerkt, geven de volgende voorwaarden weer wanneer de update wordt weergegeven in de Webex -app van een gebruiker:
Als de update betrekking heeft op een gebruiker die alleen BroadWorks belt of een entiteit die geen gebruiker is, wordt de update onmiddellijk na de daaropvolgende synchronisatie van de adreslijst in de Webex -app van een gebruiker weergegeven.
Als de update betrekking heeft op een vermelding in de BroadWorks-telefoonlijst:
Voor contactpersonen van gebruikers: updates worden onmiddellijk na de daaropvolgende synchronisatie van de adreslijst in de Webex -app van de gebruiker weergegeven.
Voor groepscontactpersonen: updates worden onmiddellijk na de daaropvolgende synchronisatie van de adreslijst in de Webex -app van de gebruiker weergegeven.
Voor contactpersonen van de organisatie: de Webex -directory wordt bijgewerkt bij de volgende synchronisatie van de directory, maar gebruikers zien de wijziging pas in de Webex -app als ze de Webex -app opnieuw starten of totdat de lokale cachetimer van 72 uur is verstreken.
Updates voor Webex voor Cisco BroadWorks- gebruikersgegevens worden verwerkt als onderdeel van inrichtingsprocessen.
|
Control Hub bevat een optie om contactpersonen op organisatieniveau in Control Hub toe te voegen of te bewerken via een CSV-bestand. Partnerbeheerders en klantbeheerders met Control Hub-toegang hebben toegang tot deze optie. Het bijwerken van contactpersonen via Control Hub wordt echter niet ondersteund door Webex voor Cisco BroadWorks. Updates voor contactpersonen die zijn toegepast in Control Hub, worden niet opnieuw gesynchroniseerd met BroadWorks en zijn niet beschikbaar voor zoekopdrachten in de directory vanaf bureautelefoons.
|
Vereisten voor Directorysynchronisatie
We raden u aan de volgende instellingen te gebruiken:
In de onderstaande voorbeelden wordt ervan uitgegaan dat u een XSP-server gebruikt. Voor ADP-servers vervangt u (XSP_ CLI) met (ADP_ CLI).
|
Snelheidsbeperkende waarden: stel de volgende systeemeigenschappen van OverloadControl in (XSP_ CLI/Toepassingen/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit: stel in op een null-waarde.
globalDirectoryTransactionLimit: stel in op een null-waarde.
U wordt aangeraden userDirectoryTransactionLimit en globalDirectoryTransactionLimit in te stellen op een null-waarde. Als u echter besluit waarden toe te wijzen, moet elke waarde worden ingesteld op ten minste vijf keer de waarde van transactionLimitPeriodSeconds (dit moet 1) zijn.Transactielimieten: stel de volgende waarden in (XSP_ CLI/Systeem/CommunicationUtility/Standaardinstellingen):
userTransactionLimit: stel in op minimaal 100.
transactionLimitPeriodSecs: ingesteld op 1.
Paging-waarden: hiermee stelt u de eigenschappen van het pagingsysteem in (XSP_ CLI/Toepassingen/Xsi-Actions/Paginering):
defaultPageSize: instellen op 50
beschikbareUserMaxLimit: instellen op 100
CTI -interface: zorg ervoor dat u die Webex -CA-certificaten uploadt naar de CTI -interface-truststore en dat u clientverificatie op de CTI -interface inschakelt.
Daarnaast raden we u aan, afhankelijk van uw BroadWorks-release, de volgende systeempatches toe te passen op de BroadWorks-implementatie voordat u deze functie inschakelt:
Voor R22:
AP.as.22.0.1123.ap368517
Voor R23:
AP.as.23.0.1075.ap368517
Voor R24: geen patch vereist
Directorysynchronisatie inschakelen (nieuwe sjabloon)
Partnerbeheerders kunnen Directory-synchronisatie inschakelen voor een klantsjabloon terwijl ze de nieuwe sjabloon maken. Voor nieuwe klantorganisaties die aan die sjabloon worden toegewezen, is adreslijstsynchronisatie ingeschakeld. Zie 'Uw klantsjablonen configureren' in . voor meer informatie Uw partnerorganisatie configureren in Partner Hub binnen de Oplossingshandleiding voor Webex voor Cisco BroadWorks .
De volgende stappen
Zorg ervoor dat uw gebruikers weten dat ze moeten klikken op de Contacten op de Webex -app om de functie in de Webex -app in te schakelen. Dit hoeft slechts één keer te worden ingevuld.
Directorysynchronisatie inschakelen (bestaande sjabloon)
1 | Meld u aan bij Partner Hub en kies Instellingen . |
||
2 | Scroll naar BroadWorks Calling en klik op Sjablonen weergeven . |
||
3 | Selecteer de juiste klantsjabloon en blader naar BroadWorks-directorysynchronisatie . |
||
4 | Adreslijstsynchronisatie standaard inschakelen voor nieuwe klantorganisaties die deze sjabloon gebruiken:
|
||
5 | Adreslijstsynchronisatie inschakelen voor bestaande klantorganisaties die deze sjabloon gebruiken:
|
De volgende stappen
Zorg ervoor dat uw gebruikers weten dat ze moeten klikken op de Contacten op de Webex -app om de functie in de Webex -app in te schakelen. Dit hoeft slechts één keer te worden ingevuld.
Directe synchronisatie activeren
1 | Meld u aan bij Partner Hub (http://admin.webex.com ) en kies Instellingen . |
2 | Scroll naar BroadWorks Calling en klik op Sjablonen weergeven . |
3 | Selecteer de juiste klantsjabloon en blader naar BroadWorks-directorysynchronisatie . |
4 | Klik op Lijst met synchronisatiestatus van klanten weergeven . |
5 | Klik voor de klantorganisatie die u wilt synchroniseren op de drie stippen uiterst rechts en selecteer Nu synchroniseren . |
6 | Klik op Vernieuwen om de synchronisatieresultaten te bekijken. |
Synchronisatierecords exporteren naar CSV
1 | Meld u aan bij Partner Hub (http://admin.webex.com ) en kies Instellingen . |
2 | Scroll naar BroadWorks Calling en klik op Sjablonen weergeven . |
3 | Selecteer de juiste klantsjabloon en blader naar BroadWorks-directorysynchronisatie . |
4 | Klik op Lijst met synchronisatiestatus van klanten weergeven . |
5 | Schakel de selectievakjes ernaast in voor elke organisatie die u wilt opnemen in de export. |
6 | Klik op Resultaten exporteren . |
Openbare API's voor Directory Sync
Openbare API's zijn beschikbaar op ontwikkelaar.webex.com waarmee partnerbeheerders de instellingen voor Directorysynchronisatie kunnen bijwerken voor de klantorganisaties die ze beheren, een directe synchronisatie kunnen starten of informatie over de synchronisatiestatus kunnen verkrijgen. De directorysynchronisatiemethoden zijn gegroepeerd onder: BroadWorks Enterprises :
BroadWorks-ondernemingen weergeven —Gebruik deze API -methode om een lijst op te halen van ondernemingen onder een bepaalde serviceprovider en die van elke onderneming
id
. U moet de . invoerenspEnterpriseId
zoals toegewezen in inrichting.Directorysynchronisatie bijwerken voor een BroadWorks-onderneming —Voer de onderneming in
id
om de syc-status van de adreslijst voor die onderneming bij te werken en adreslijstsynchronisatie in of uit te schakelen.Directorysynchronisatie activeren voor een onderneming —Gebruik deze API -methode als u een onmiddellijke synchronisatie wilt activeren voor een bepaalde onderneming
id
. Voor desyncStatus
, voer de . inSYNC_NOW
opdracht.De adreslijstsynchronisatiestatus voor een onderneming ophalen —Voer de onderneming in
id
en uitvoeren om een status te krijgen entrackingId
van de laatste synchronisatie. U kunt detrackingID
om aanvullende analyses uit te voeren via tools zoals Kibana en Grafana.
Daarnaast kunnen beheerders de Directorysynchronisatie activeren voor één gebruiker API om een directorysynchronisatie op aanvraag te activeren voor één gebruiker.
Zie voor gedetailleerde API documentatiehttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
U moet zich aanmelden om de API specificatie te lezen ophttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Meerdere ondernemingen synchroniseren met API
|
1 | Voer de . uit BroadWorks-ondernemingen weergeven API om een lijst met ondernemingen te genereren die u wilt synchroniseren.
|
2 | Voer de . uit Directorysynchronisatie activeren voor een onderneming API op de eerste onderneming in de lijst. |
3 | Wacht een paar seconden en voer vervolgens de Status van adreslijstsynchronisatie ophalen API om de synchronisatiestatus op te halen.
|
4 | Nadat de synchronisatie is voltooid, voert u stap 2 tot en met 4 uit voor de volgende onderneming in de lijst. Herhaal deze stappen totdat u de volledige lijst hebt gesynchroniseerd. |
Foutcodes voor adreslijstsynchronisatie
De volgende foutcodes zijn van toepassing op adreslijstsynchronisatie.
Foutcode |
Foutbericht |
---|---|
600000 |
Onverwachte fout in BroadWorks-gebruikerssynchronisatie van externe adressenlijst. |
600001 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is mislukt. |
600002 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst moest vóór voltooiing worden beëindigd. |
600003 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is slechts gedeeltelijk voltooid. Het synchroniseren van enkele klantorganisaties is mislukt. |
600004 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is niet ingeschakeld voor de ConfigSet. |
600005 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst wordt uitgevoerd voor de ConfigSet. |
600006 |
Threads van BroadWorks-gebruikerssynchronisatie van externe adressenlijst zijn bezet of worden gesloten en accepteren daarom geen nieuwe synchronisatieverzoeken. Probeer het later opnieuw. |
600007 |
De identiteitsorganisatie van de CustomerConfig is niet gevonden. |
600008 |
De CustomerConfig is niet gevonden in de partnerorganisatie. |
600009 |
Broadworks External Directory User Sync kan niet worden uitgevoerd omdat het broadworks-cluster dat is gekoppeld aan CustomerConfig, bezet is |
600010 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst kan niet worden uitgevoerd omdat er geen BroadWorks-cluster is gekoppeld aan de CustomerConfig. |
600011 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is niet ingeschakeld voor de CustomerConfig. |
600012 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst kan niet worden uitgevoerd omdat synchronisatie van hybride adressenlijst al is ingeschakeld voor de CustomerConfig. |
600013 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst kan geen gebruikers- en machineaccounts toevoegen aan de identiteitsopslag. |
600014 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is mislukt tijdens het maken van verbinding met het BroadWorks-cluster. Fout van Broadworks - %s. |
600015 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst heeft geen overeenkomende gebruiker gevonden in de identiteitsopslag. |
600017 |
BroadWorks Phone List Sync kan niet alle contactpersonen van gebruikers en ondernemingen/organisatie synchroniseren. |
600018 |
De synchronisatie van de BroadWorks-telefoonlijst is mislukt voor gebruikers in de onderneming/organisatie. |
600019 |
BroadWorks Phone List Sync kan zakelijke/organisatiecontacten niet synchroniseren. |
600020 |
BroadWorks External Directory User Sync kan niet worden uitgeschakeld omdat de CustomerConfig-synchronisatie wordt bezig. |
600022 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat de onderneming geen ingerichte gebruiker heeft. |
600023 |
BroadWorks External Directory Single User-synchronisatie is niet mogelijk omdat de gebruiker al bestaat in deze organisatie. |
600024 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat er geen overeenkomende gebruiker is gevonden in BroadWorks. |
600025 |
BroadWorks External Directory User Sync kan het gebruikersaccount in CI niet bijwerken. |
600026 |
BroadWorks External Directory User Sync kan het computeraccount in CI niet bijwerken. |
600027 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat er meerdere gebruikers zijn gevonden in BroadWorks. |
600028 |
BroadWorks External Directory Single User-synchronisatie is niet mogelijk omdat er ten minste één ondernemingstelefoonlijst -synchronisatie moet zijn voltooid. |
600029 |
De gebruikerssynchronisatie van BroadWorks External Directory is mislukt omdat de onderneming geen ingerichte gebruiker heeft. |
Geschiedenis wijzigen
De volgende tabel bevat een overzicht van de updates van dit artikel.
Datum |
Revisie |
---|---|
14 februari 2023 |
Bijgewerkt Maximumwaarden en bron voor Directorysynchronisatie sectie. |
10 december 2022 |
De term is bijgewerkt Onmiddellijke synchronisatie voltooien naar Directorysynchronisatie activeren |
19 juli 2022 |
Verduidelijkingen en correcties voor overzichtsinformatie:
|
09 mei 2022 |
|
7 april 2022 |
|
28 maart 2022 |
|
24 maart 2022 |
Lijst met gesynchroniseerde telefoonnummer toegevoegd aan: Voorwaarden voor directorysynchronisatie . De synchronisatie bevat nu mobiele telefoon . |
16 maart 2022 |
|
17 december 2021 |
|
16 december 2021 |
|
08 december 2021 |
|