- Etusivu
- /
- Artikkeli
Hakemistosynkronointi Webex Cisco Broadworksille -sovelluksessa
Tässä artikkelissa kuvataan, miten hakemistosynkronointi otetaan käyttöön Webex for Cisco BroadWorksissa. Artikkeli on tarkoitettu kumppaniorganisaatioiden palveluntarjoajien järjestelmänvalvojille.
Hakemistosynkronoinnin yleiskatsaus
Hakemistosynkronointi varmistaa, että Webex for Cisco BroadWorks -käyttäjät voivat käyttää Webex-sovelluksen Webex-hakemistoa kutsuakseen mitä tahansa kutsuvaa entiteettiä BroadWorks-palvelimelta. Tämä ominaisuus synkronoi Webex-hakemistoon BroadWorks-puhelutiedot, jotka eivät olleet osa käyttäjien valmistelua.
Webex for Cisco BroadWorks -käyttäjien valmistelu päivittää Webex-hakemistoon Webexin puhelutiedot Cisco BroadWorks -käyttäjille (ensisijainen puhelinnumero, matkapuhelinnumero, alanumero), mutta jättää ulkoiset puhelutiedot pois. Kun hakemistosynkronointi on käytössä, ominaisuus synkronoi myös seuraavat puhelutietueet Webex-hakemistoon.
Vain BroadWorks-puhelut käyttäjille (jotka eivät ole Webexin käyttäjiä)
Muut kuin käyttäjän puheluentiteetit (esim. neuvotteluhuoneen puhelin, faksi, hakuryhmän numero)
BroadWorksin puhelinluettelon merkinnät
Seuraavassa taulukossa on yhteenveto BroadWorks-puhelutietueista ja näytetään, miten ne lisätään Webex-hakemistoon.
BroadWorks-puhelutietueet | Kuvaus | Lisätty Webex-hakemistoon... |
---|---|---|
Webex Cisco BroadWorks -käyttäjille | Webex for Cisco BroadWorks -käyttäjät ovat käytössä | Käyttäjien valmistelu (esim. läpivirtausvalmistelu) |
Vain BroadWorks-puhelut käyttäjille | Soittaminen käyttäjille, joita ei ole perehdytetty Webexiin | Hakemistosynkronoinnin |
Muut kuin käyttäjän kutsuvat entiteetit | Esimerkiksi neuvotteluhuoneen puhelin, faksi, Hunt-ryhmän numero | Hakemistosynkronoinnin |
BroadWorks-puhelinluettelot | BroadWorks-puhelinluettelon merkinnät:
| Hakemistosynkronointi (puhelinluettelon synkronointi) |
Hakemistosynkronoinnin ehdot
Kumppanien järjestelmänvalvojien on otettava ominaisuus käyttöön kumppanitasolla. Kumppanien järjestelmänvalvojat voivat ottaa ominaisuuden käyttöön tai poistaa sen käytöstä useissa asiakasorganisaatioissa yhdellä kertaa.
Ensimmäinen synkronointi tapahtuu oletusarvoisesti viikon kuluttua synkronoinnin käyttöönotosta (synkronoinnin aloittamiseen valittu aika on satunnainen). Asiakasorganisaatiot voivat kuitenkin käyttää Synkronoi nyt -vaihtoehtoa ohittaakseen yhden viikon odotusajan ja käynnistääkseen välittömän synkronoinnin tietylle asiakasorganisaatiolle.
Oletusarvon mukaan hakemistosynkronointi suoritetaan viikoittain kullekin asiakkaalle. Jokainen synkronointi tapahtuu viikon kuluttua edellisestä synkronoinnista riippumatta siitä, ajoitettiinko viimeisin synkronointi vai käynnistettiinkö se manuaalisesti Synkronoi nyt-toiminnolla .
Samanaikaisten synkronointien enimmäismäärä BroadWorks-klusteria kohden on kaksi: yksi ajoitettu synkronointi ja yksi tarvittaessa tapahtuva synkronointi (ohjelmointirajapinnan tai kumppanikeskuksen graafisen käyttöliittymän kautta). Järjestelmänvalvojat eivät kuitenkaan voi suorittaa kahta on-demand-synkronointia samanaikaisesti samasta BroadWorksista. Tämä rajoitus on olemassa riippumatta siitä, aloitettiinko synkronointi ohjelmointirajapinnan vai kumppanikeskuksen Synkronoi nyt -vaihtoehdon kautta . Lisäksi Webex ei ajoita kahta ajoitettua synkronointia suoritettavaksi samanaikaisesti samasta BroadWorksista.
Jos synkronointi epäonnistuu, Webex yrittää synkronointia uudelleen automaattisesti 24 tunnin välein seuraavaan ajoitettuun synkronointiin asti.
Synkronointi ohittaa käyttäjät, joilla ei ole puhelinnumeroa.
Kumppanikeskuksessa voit tarkastella tietyn asiakkaan synkronoinnin tilatietoja. Lisäksi voit viedä viimeisimmän synkronoinnin yksityiskohtaiset tiedot CSV-tietueeseen. CSV-tietue sisältää enemmän tietoja kuin Control Hub -näyttö, ja siitä voi olla apua vianmäärityksessä, analytiikassa ja seurannassa.
Webex tallentaa käyttäjän yhteystiedot salatussa muodossa. Vain yhteystiedon omistavalla käyttäjällä on salauksenpurkuavaimen käyttöoikeus.
Vain BroadWorks-puheluita käyttäville käyttäjille ja muille kuin käyttäjille soittaville entiteeteille tämä ominaisuus synkronoi seuraavat puhelinnumerotyypit BroadWorksista:
Ensisijainen puhelinnumero
Matkapuhelinnumero
Laajennus
Synkronointi kuitenkin sulkee synkronoinnin ulkopuolelle vain BroadWorks-puhelut ja muut kuin käyttäjän puheluentiteetit, jos ensisijaista puhelinnumeroa tai alanumeroa ei ole.
BroadWorks-käyttäjätason tietosuojapalveluasetusta ei tueta hakemistosynkronoinnin osana.
BroadWorksin puhelinluettelo ja yhteystietojen enimmäismäärät
Hakemistosynkronointi synkronoi myös BroadWorks-puhelinluettelon merkinnät Webex-yhteystietoihin. Synkronoidut merkinnät lisätään johonkin seuraavista yhteystietotyypeistä:
Organisaation yhteystiedot – Webex tallentaa nämä yhteystiedot organisaatiota vastaan. Jokainen käyttäjä voi käyttää organisaationsa yhteyshenkilöitä. Enimmäismäärä on enintään 30000 yhteystietoa.
Käyttäjän yhteystiedot – Webex tallentaa nämä yhteystiedot käyttäjää vastaan. Vain yhteyshenkilön omistava käyttäjä voi käyttää yhteyshenkilömerkintää. Enimmäismäärä on enintään 2000 yhteystietoa (1500 synkronoitua yhteystietoa + 500 manuaalista syöttöyhteystietoa).
Seuraavassa taulukossa Webex-yhteystietotyypit yhdistetään yhteystietolähteeseen (synkronoitu BroadWorks-puhelinluettelosta tai lisätty manuaalisesti):
Webex-yhteystiedon tyyppi | Ota yhteyttä Lähde | Maksimi | Synkronoitu BroadWorksista... | Synkronointiin käytetty ohjelmointirajapinta |
---|---|---|---|---|
Organisaation yhteystiedot | Hakemistosynkronoinnin | 30000 kontaktia | Yrityksen yhteiset puhelinluettelot |
|
Ryhmän yhteiset puhelinluettelot (palveluntarjoajaryhmälle)** |
| |||
Käyttäjien yhteystiedot | Hakemistosynkronoinnin | 1500 kontaktia | Henkilökohtaiset puhelinluettelot | /directories/personal |
Käyttäjä lisää manuaalisesti | 500 kontaktia | N/A | N/A | |
Ryhmän yhteystiedot | Hakemistosynkronoinnin | 30000 yhteystietoa ryhmää kohden | Ryhmän yhteiset puhelinluettelot (yritysryhmälle)** | /directories/groupcommon |
**Ryhmittele yleiset puhelinluettelot -merkinnät synkronoidaan eri tavalla sen mukaan, onko BroadWorks yritystilassa vai palveluntarjoajatilassa. Arvon isBroadWorksEnterprise
Parametri (tosi tai epätosi) määrittää, miten luettelo synkronoidaan:
Tosi – synkronointi ryhmäyhteystietona
Epätosi – Synkronoi organisaation yhteyshenkilönä
Seuraavat ehdot koskevat sitä, miten Hakemistosynkronointi käsittelee kontaktien enimmäismääriä:
Jos organisaatio ylittää synkronoinnin suurimman sallitun yhteyshenkilön (30000 organisaation yhteyshenkilöä tai 30000 ryhmän yhteistä yhteyshenkilöä ryhmää kohti), hakemistosynkronointi jättää pois enimmäisrajan ylittävät merkinnät. Synkronoiduille tai poisjätetyille yhteystiedoille ei ole erityistä järjestystä.
Jos joku asiakkaistasi ylittää jommankumman luokan yhteyshenkilöiden sallitun enimmäismäärän, suosittelemme, että otat tapauksen esille Ciscon kanssa, jotta kyseinen organisaatio jätetään hakemistosynkronoinnin ulkopuolelle.
Manuaaliset yhteystiedot ovat yhteystietoja, jotka käyttäjä lisää manuaalisesti Webex-sovellukseen. Käyttäjä voi lisätä enintään 500 manuaalista yhteystietoa. Manuaaliset yhteystiedot kuuluvat Webexin suurempaan käyttäjän yhteystietoluokkaan, mutta ne eivät sisälly synkronointiin.
Organisaation yhteyshenkilöiden (30000) ja ryhmäyhteystietojen (30000 ryhmää kohti) yhdistetty raja on 200000.
Päivitykset
Webex-hakemisto käsittelee päivitykset seuraavasti:
Jos yhteystiedon nimi muuttuu BroadWorksissa, olemassa oleva yhteystieto poistetaan Webex-hakemistosta ja uusi yhteystieto luodaan.
Jos yhteyshenkilön numero muuttuu BroadWorksissa, Webex päivittää Webex-hakemistossa olevan yhteystiedon uudella numerolla.
Kun järjestelmänvalvoja on päivittänyt yhteystiedon BroadWorksissa, seuraavat ehdot määrittävät, milloin päivitys näkyy käyttäjän Webex-sovelluksessa:
Jos päivitys on tarkoitettu vain BroadWorks-kutsuvalle käyttäjälle tai muulle kuin kutsuvalle entiteetille, päivitys näkyy käyttäjän Webex-sovelluksessa heti seuraavan hakemistosynkronoinnin jälkeen.
Jos päivitys koskee BroadWorks-puhelinluettelomerkintää:
Käyttäjän yhteystiedoille: Päivitykset näkyvät käyttäjän Webex-sovelluksessa heti seuraavan hakemistosynkronoinnin jälkeen.
Ryhmän yhteystiedoille - Päivitykset näkyvät käyttäjien Webex-sovelluksessa heti seuraavan hakemistosynkronoinnin jälkeen.
Organisaation yhteyshenkilöt: Webex-hakemisto päivitetään seuraavan hakemistosynkronoinnin yhteydessä, mutta käyttäjät eivät näe muutosta Webex-sovelluksessa, ennen kuin he käynnistävät Webex-sovelluksen uudelleen tai ennen kuin paikallinen 72 tunnin välimuistiajastin vanhenee.
Hakemistosynkronoinnin edellytykset
Suosittelemme, että käytät seuraavia asetuksia:
Nopeuden rajoitusarvot – Määritä seuraavat OverloadControl-järjestelmän ominaisuudet (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit – Määritä tyhjäarvo.
globalDirectoryTransactionLimit – Määritä tyhjäarvo.
On suositeltavaa määrittää userDirectoryTransactionLimit- ja globalDirectoryTransactionLimit-arvoiksi null-arvo. Jos kuitenkin päätät määrittää arvoja, niiden arvoksi on määritettävä vähintään viisi kertaa transactionLimitPeriodSeconds-arvo (jonka pitäisi olla 1).Tapahtumarajat – Määritä seuraavat arvot (XSP_CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit – Aseta arvoksi vähintään 100.
transactionLimitPeriodSecs – Aseta arvoksi 1.
Sivutusarvot – Määritä sivutusjärjestelmän ominaisuudet (XSP_CLI/Applications/Xsi-Actions/Paging):
defaultPageSize – Määritä arvoksi 50
availableUserMaxLimit – asetettu arvoon 100
CTI-käyttöliittymä – Varmista, että lataat Webex CA -varmenteet CTI-liittymän luottamussäilöön ja otat asiakkaan todennuksen käyttöön CTI-liittymässä.
Lisäksi BroadWorks-julkaisustasi riippuen suosittelemme, että asennat seuraavat järjestelmäkorjaukset BroadWorks-käyttöönottoon, ennen kuin otat tämän ominaisuuden käyttöön:
lausekkeen R22 osalta:
AP.as.22.0.1123.ap368517
lausekkeen R23 osalta:
AP.as.23.0.1075.ap368517
lausekkeen R24 osalta: Korjaustiedostoa ei tarvita
Ota hakemistosynkronointi käyttöön (uusi malli)
Kumppanien järjestelmänvalvojat voivat ottaa hakemistosynkronoinnin käyttöön asiakasmallille uutta mallia luotaessa. Kaikissa uusissa asiakasorganisaatioissa, jotka määritetään kyseiseen malliin, hakemistosynkronointi on käytössä. Lisätietoja on Webex for Cisco BroadWorks-ratkaisuoppaan kohdassa Asiakasmallien määrittäminen.
Mitä tehdä seuraavaksi
Varmista, että käyttäjät tietävät, että heidän on napsautettava Webex-sovelluksen Yhteystiedot-välilehteä vähintään kerran, jotta ominaisuus voidaan ottaa käyttöön Webex-sovelluksessa. Tämä on suoritettava vain kerran.
Ota hakemistosynkronointi käyttöön (olemassa oleva malli)
1 | Kirjaudu Partner Hubiin ja valitse Asetukset. |
2 | Vieritä kohtaan BroadWorks Calling ja valitse Näytä mallit. |
3 | Valitse sopiva asiakasmalli ja vieritä kohtaan BroadWorks Directory Sync. |
4 | Voit ottaa hakemistosynkronoinnin oletusarvoisesti käyttöön uusissa asiakasorganisaatioissa, jotka käyttävät tätä mallia: |
5 | Voit ottaa hakemistosynkronoinnin käyttöön tätä mallia käyttävissä asiakasorganisaatioissa seuraavasti: Jos haluat poistaa hakemistosynkronoinnin käytöstä, noudata yllä olevia ohjeita ja:
|
Mitä tehdä seuraavaksi
Varmista, että käyttäjät tietävät, että heidän on napsautettava Webex-sovelluksen Yhteystiedot-välilehteä vähintään kerran, jotta ominaisuus voidaan ottaa käyttöön Webex-sovelluksessa. Tämä on suoritettava vain kerran.
Käynnistä välitön synkronointi
1 | Kirjaudu Partner Hubiin ( http://admin.webex.com) ja valitse Asetukset. |
2 | Vieritä kohtaan BroadWorks Calling ja valitse Näytä mallit. |
3 | Valitse sopiva asiakasmalli ja vieritä kohtaan BroadWorks Directory Sync. |
4 | Valitse Näytä luettelo asiakkaiden synkronoinnin tilasta. |
5 | Napsauta synkronoitavan asiakasorganisaation kolmea pistettä oikeassa reunassa ja valitse Synkronoi nyt. |
6 | Klikkaa Päivitä nähdäksesi synkronoinnin tulokset. |
Synkronointitietueiden vieminen CSV-tiedostoon
1 | Kirjaudu Partner Hubiin ( http://admin.webex.com) ja valitse Asetukset. |
2 | Vieritä kohtaan BroadWorks Calling ja valitse Näytä mallit. |
3 | Valitse sopiva asiakasmalli ja vieritä kohtaan BroadWorks Directory Sync. |
4 | Valitse Näytä luettelo asiakkaiden synkronoinnin tilasta. |
5 | Valitse viereiset valintaruudut jokaiselle organisaatiolle, jonka haluat sisällyttää vientiin. |
6 | Klikkaa Vie tulokset. |
Hakemistosynkronoinnin julkiset ohjelmointirajapinnat
Julkiset ohjelmointirajapinnat ovat käytettävissä developer.webex.com , joiden avulla kumppanien järjestelmänvalvojat voivat päivittää hallitsemiensa asiakasorganisaatioiden hakemistosynkronointiasetukset, käynnistää synkronoinnin välittömästi tai hakea synkronoinnin tilatietoja. Hakemistosynkronointimenetelmät on ryhmitelty BroadWorks Enterprises-osioon :
List BroadWorks Enterprises– Tämän ohjelmointirajapintamenetelmän avulla saat luettelon tietyn palveluntarjoajan ja kunkin yrityksen yrityksistä
id
. Sinun on annettavaspEnterpriseId
valmistelussa määritetyllä tavalla.Päivitä BroadWorks Enterprisenhakemistosynkronointi – Anna yritys
id
päivittääksesi kyseisen yrityksen hakemiston SYK-tilan ottamalla hakemistosynkronoinnin käyttöön tai poistamalla sen käytöstä.Käynnistä yrityksen hakemistosynkronointi– Käytä tätä ohjelmointirajapintamenetelmää, jos haluat käynnistää tietyn yrityksen synkronoinnin välittömästi
id
. VartensyncStatus
, kirjoitaSYNC_NOW
komento.Hae yrityksenhakemistosynkronoinnin tila – syötä yritys
id
ja suorita saadaksesi tilan jatrackingId
viimeisimmästä synkronoinnista. Voit käyttäätrackingID
suorittaa lisäanalytiikkaa Kibanan ja Grafanan kaltaisten työkalujen avulla.
Lisäksi järjestelmänvalvojat voivat käynnistää yhden käyttäjän hakemistosynkronoinnin käynnistääkseen hakemistosynkronoinnin tarvittaessa yksittäiselle käyttäjälle.
Lisätietoja ohjelmointirajapinnasta on kohdassa https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Sinun on kirjauduttava sisään, jotta voit lukea API-määrityksen osoitteessa https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Synkronoi useita yrityksiä API: n kanssa
Hakemistosynkronoinnin avulla voit synkronoida vain yhden yrityksen Broadworks-klusterista kerrallaan on-demand-synkronoinnin avulla. Jos yrität synkronoida useamman kuin yhden yrityksen, näyttöön tulee virhe 429
Yksittäisen yrityksen synkronoinnin käynnistämiseen kuluva aika vaihtelee yrityksen koon mukaan.
1 | Suorita List BroadWorks Enterprises API ja luo luettelo synkronoitavista yrityksistä. |
2 | Suorita Trigger Directory Sync for an Enterprise API luettelon ensimmäisessä yrityksessä. |
3 | Odota muutama sekunti ja suorita sitten Get Directory Sync Status API, jotta saat synkronoinnin tilan. |
4 | Kun synkronointi on valmis, suorita vaiheet 2–4 luettelon seuraavassa yrityksessä. Toista nämä vaiheet, kunnes olet synkronoinut koko luettelon. |
Hakemistosynkronoinnin virhekoodit
Seuraavat virhekoodit koskevat hakemistosynkronointia.
Virhekoodi | Virheviesti |
---|---|
600000 | Broadworks External Directory User Syncin odottamaton virhe. |
600001 | Broadworksin ulkoisen hakemiston käyttäjien synkronointi epäonnistui. |
600002 | Broadworks External Directory User Sync oli lopetettava ennen valmistumista. |
600003 | Broadworksin ulkoisen hakemiston käyttäjien synkronointi onnistui vain osittain. Joidenkin asiakasorganisaatioiden synkronointi epäonnistui. |
600004 | Broadworks External Directory User Sync ei ole käytössä ConfigSetissä. |
600005 | Broadworks External Directory User Sync on käynnissä ConfigSet-järjestelmää varten. |
600006 | Broadworksin ulkoisen hakemiston käyttäjien synkronointiketjut ovat varattuja tai sammuvat, joten ne eivät hyväksy enää synkronointipyyntöä, yritä myöhemmin uudelleen. |
600007 | CustomerConfig-tunnistetietojen organisaatiota ei löydy. |
600008 | CustomerConfigia ei löydy kumppaniorganisaatiosta. |
600009 | Broadworksin ulkoisen hakemiston käyttäjien synkronointia ei voi suorittaa, koska CustomerConfigiin liittyvä broadworks-klusteri on varattu |
600010 | Broadworks External Directory User Sync -toimintoa ei voi suorittaa, koska CustomerConfigiin ei ole liitetty broadworks-klusteria. |
600011 | Broadworks External Directory User Sync ei ole käytössä CustomerConfig-määrityksissä. |
600012 | Broadworks External Directory User Sync -toimintoa ei voi suorittaa, koska Hybrid Directory -synkronointi on jo käytössä CustomerConfig-järjestelmässä. |
600013 | Broadworks External Directory User Sync ei onnistunut lisäämään käyttäjiä ja konetilejä tunnistetietosäilöön. |
600014 | Broadworksin ulkoisen hakemiston käyttäjien synkronointi epäonnistui, kun yritettiin muodostaa yhteys Broadworks-klusteriin. Virhe Broadworksilta - %s. |
600015 | Broadworks External Directory User Sync ei löytänyt vastaavaa käyttäjää tunnistetietosäilöstä. |
600017 | BroadWorksin puhelinluettelon synkronointi epäonnistui kaikkien käyttäjien ja yrityksen/organisaation yhteystietojen synkronoinnissa. |
600018 | BroadWorks-puhelinluettelon synkronointi epäonnistui yrityksen/organisaation käyttäjille. |
600019 | BroadWorksin puhelinluettelon synkronointi epäonnistui yrityksen/organisaation yhteystietojen synkronoinnissa. |
600020 | BroadWorksin ulkoisen hakemiston käyttäjien synkronointia ei voi poistaa käytöstä, koska CustomerConfig-synkronointi on käynnissä. |
600022 | BroadWorks External Directory Single User Sync ei ole mahdollista, koska yrityksellä ei ole valmisteltua käyttäjää. |
600023 | BroadWorks External Directory Single User Sync ei ole mahdollista, koska käyttäjä on jo olemassa tässä organisaatiossa. |
600024 | BroadWorksin ulkoisen hakemiston yhden käyttäjän synkronointi ei ole mahdollista, koska vastaavaa käyttäjää ei löytynyt BroadWorksista. |
600025 | BroadWorks External Directory User Sync ei onnistunut päivittämään käyttäjätiliä CI:ssä. |
600026 | BroadWorks External Directory User Sync ei onnistunut päivittämään konetiliä CI:ssä. |
600027 | BroadWorksin ulkoinen hakemisto Yhden käyttäjän synkronointi ei ole mahdollista, koska BroadWorksista löytyi useita käyttäjiä. |
600028 | BroadWorks External Directory Single User Sync ei ole mahdollista, koska vähintään yksi yrityshakemistosynkronointi olisi pitänyt suorittaa. |
600029 | BroadWorksin ulkoisen hakemiston käyttäjien synkronointi epäonnistui, koska yrityksellä ei ole valmisteltua käyttäjää. |
Muuta historiaa
Seuraavassa taulukossa on yhteenveto tämän artikkelin päivityksistä.
Päiväys | Tarkastus |
---|---|
helmikuu 14, 2023 | Päivitetty Hakemistosynkronoinnin maksimit ja lähdeosa -osio. |
joulukuu 10, 2022 | Päivitetty termi Täydellinen välitön synkronointi hakemistosynkronoinnin käynnistämiseksi |
Heinäkuu 19, 2022 | Selvennyksiä ja korjauksia yleiskatsaustietoihin:
|
Voi 09, 2022 |
|
Huhtikuu 07, 2022 |
|
maaliskuu 28, 2022 |
|
maaliskuu 24, 2022 | Lisätty synkronoitujen puhelinnumerotyyppien luettelo hakemistosynkronoinnin ehtoihin. Synkronointi sisältää nyt matkapuhelinnumerot. |
Maaliskuussa 16, 2022 |
|
joulukuu 17, 2021 |
|
joulukuu 16, 2021 |
|
joulukuu 08, 2021 |
|