- Etusivu
- /
- Artikkeli
Tässä artikkelissa kuvataan Directory Sync -sovelluksen käyttöönotto Webex for Cisco BroadWorksissa. Artikkeli on tarkoitettu kumppaniorganisaatioiden palveluntarjoajille.
Hakemiston synkronoinnin yleiskatsaus
Hakemiston synkronointi varmistaa, että Webex for Cisco BroadWorks -käyttäjät voivat käyttää Webex-sovelluksen Webex-hakemistoa soittaakseen mille tahansa kutsuvalle taholle BroadWorks-palvelimesta. Tämä ominaisuus synkronoi Webex-hakemistoon BroadWorks-kutsutiedot, jotka eivät olleet osa käyttäjän kokoonpanoa.
Webex for Cisco BroadWorks -käyttäjien hallinta päivittää Webex-hakemiston Webex for Cisco BroadWorks -käyttäjien soittotiedoilla (ensisijainen puhelinnumero, matkapuhelinnumero, alaliittymä), mutta jättää pois ulkoiset puhelutietueet. Kuitenkin, kun hakemistosynkronointi on käytössä, ominaisuus synkronoi myös seuraavat soittotietueet Webex-hakemistoon.
BroadWorks-vain soittavat käyttäjät (jotka eivät ole liittyneet Webexiin)
Muut kuin käyttäjät soittavat tahot (esim. kokoushuoneen puhelin, faksi, metsästysryhmän numero)
BroadWorks-puhelinluettelon merkinnät
Seuraavassa taulukossa on yhteenveto BroadWorks-soittotietueista ja näytetään, kuinka ne lisätään Webex-hakemistoon.
BroadWorks Calling Records | Kuvaus | Lisätty Webex-hakemistoon kautta... |
---|---|---|
Webex Cisco BroadWorks -käyttäjille | Käyttäjille on otettu käyttöön Webex for Cisco BroadWorks | Käyttäjien hallinta (esim. läpivienti) |
BroadWorks-vain soittavat käyttäjät | Soittaminen käyttäjille, jotka ovat ei liittyi Webexiin | Hakemiston synkronointi |
Muut kuin käyttäjät soittavat entiteetit | Esim. kokoushuoneen puhelin, faksi, metsästysryhmän numero | Hakemiston synkronointi |
BroadWorks-puhelinluettelot | BroadWorks-puhelinluettelon merkinnät:
| Hakemiston synkronointi (puhelinluettelon synkronointi) |
Lisätietoja käyttäjien luomisesta on kohdassa Webex for Cisco BroadWorks -ratkaisuopas. |
Hakemiston synkronointiehdot
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ä toiminnolla.
Oletusarvon mukaan ensimmäinen synkronointi tapahtuu viikon kuluttua synkronoinnin käyttöönotosta (synkronoinnin aloitusaika on satunnainen). Asiakasorganisaatiot voivat kuitenkin käyttää Synkronoi nyt mahdollisuus ohittaa viikon odotusaika ja käynnistää välitön synkronointi tietylle asiakasorganisaatiolle.
Oletuksena hakemistosynkronointi suoritetaan viikoittain jokaiselle asiakkaalle. Jokainen synkronointi tapahtuu viikon kuluttua viimeisestä synkronoinnista riippumatta siitä, ajoitettiinko viimeisin synkronointi vai käynnistettiinkö se manuaalisesti Synkronoi nyt.
Samanaikaisten synkronointien enimmäismäärä BroadWorks-klusteria kohden on kaksi: yksi ajoitettu synkronointi ja yksi on-demand synkronointi (sovellusliittymän tai Partner Hub GUI:n kautta). Järjestelmänvalvojat eivät kuitenkaan voi suorittaa kahta on-demand-synkronointia samanaikaisesti samasta BroadWorksistä. Tämä rajoitus on olemassa riippumatta siitä, aloitettiinko synkronointi API:n vai Synkronoi nyt vaihtoehto Partner Hubissa. Webex ei myöskään ajoita kahta ajoitettua synkronointia suoritettavaksi samaan aikaan samasta BroadWorksistä.
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.
Partner Hubissa voit tarkastella tietyn asiakkaan synkronoinnin tilatietoja. Lisäksi voit viedä yksityiskohtaiset tiedot viimeisestä synkronoinnista CSV-tietueeseen. CSV-tietue tarjoaa enemmän yksityiskohtia kuin Control Hub -näyttö ja voi auttaa vianmäärityksessä, analytiikassa ja tarkastuksessa.
Webex tallentaa käyttäjien yhteystiedot salatussa muodossa. Vain yhteyshenkilön omistavalla käyttäjällä on pääsy salauksen purkuavaimeen.
Vain BroadWorksin soittaville käyttäjille ja muille kuin käyttäjille soittaville yhteisöille tämä ominaisuus synkronoi seuraavat puhelinnumerotyypit BroadWorksista:
ensisijainen puhelinnumero
Matkapuhelimen numero
Laajennus
Synkronointi kuitenkin sulkee pois vain BroadWorksille soittavat käyttäjät ja muut kuin käyttäjät soittavat entiteetit synkronoinnista, jos ensisijaista puhelinnumeroa tai alaliittymää ei ole.
BroadWorks-käyttäjätason tietosuojapalveluasetusta ei tueta osana hakemistosynkronointia.
BroadWorks-puhelinluettelo ja kontaktien enimmäismäärät
Hakemiston synkronointi synkronoi myös BroadWorks-puhelinluettelomerkinnät Webex-yhteystietoihin. Synkronoidut merkinnät lisätään johonkin seuraavista yhteystyypeistä:
Organisaation yhteystiedot – Webex tallentaa nämä yhteystiedot organisaatiota vastaan. Jokainen käyttäjä voi käyttää organisaationsa yhteystietoja. Yhteystietojen enimmäismäärä on 30 000.
Käyttäjän yhteystiedot – Webex tallentaa nämä yhteystiedot käyttäjää vastaan. Vain yhteystiedon omistava käyttäjä voi käyttää yhteystietomerkintää. Enimmäismäärä on 2 000 yhteystietoa (1 500 synkronoitua yhteystietoa + 500 manuaalista syöttöä).
Vain puhelinluettelon merkinnät lisätään Webex-yhteystietoihin. Hakemistosynkronointiin sisältyvät vain BroadWorks-puhelut soittavat käyttäjät ja muut kuin käyttäjät soittavat entiteetit eivät lisäänny Yhteystietoihin, ellei Webex-käyttäjä lisää niitä Yhteystietoihin manuaalisesti. |
Seuraavassa taulukossa on yhdistetty Webex-yhteystietotyypit yhteystietolähteeseen (synkronoitu BroadWorks-puhelinluettelosta tai lisätty manuaalisesti):
Webex-kontaktityyppi | Yhteydenottolähde | Enimmäismäärä | Synkronoitu BroadWorksistä... | Synkronointiin käytetty API |
---|---|---|---|---|
Organisaation yhteystiedot | Hakemiston synkronointi | 30 000 kontaktia | Yritysten yhteiset puhelinluettelot |
|
Ryhmän yhteiset puhelinluettelot (palveluntarjoajaryhmälle)** |
| |||
Käyttäjien yhteystiedot | Hakemiston synkronointi | 1500 kontaktia | Henkilökohtaiset puhelinluettelot | /directories/personal |
Käyttäjä lisäsi manuaalisesti | 500 kontaktia | Ei käytössä | Ei käytössä | |
Ryhmän yhteystiedot | Hakemiston synkronointi | 30 000 kontaktia ryhmää kohden | Ryhmän yhteiset puhelinluettelot (yritysryhmälle)** | /directories/groupcommon |
**Ryhmän yleisten puhelinluetteloiden merkinnät synkronoidaan eri tavalla sen mukaan, onko BroadWorks yritystilassa vai palveluntarjoajatilassa. Arvo
|
Seuraavat ehdot koskevat sitä, kuinka Directory Sync käsittelee kontaktien enimmäismääriä:
Jos organisaatio ylittää synkronoinnissa sallitun yhteystietojen enimmäismäärän (30 000 organisaation yhteystietoa tai 30 000 ryhmän yhteistä yhteystietoa ryhmää kohti), hakemistosynkronointi sulkee pois enimmäisrajan ylittävät merkinnät. Synkronoiduille tai pois jätetyille yhteystiedoille ei ole asetettu erityistä järjestystä.
Jos yksi asiakkaistasi ylittää suurimman sallitun yhteyshenkilömäärän jommassakummassa luokassa, suosittelemme, että otat yhteyttä Ciscoon, jotta kyseinen organisaatio suljetaan pois hakemistosynkronointista.
Manuaaliset yhteystiedot ovat yhteystietoja, jotka käyttäjä lisää manuaalisesti Webex-sovellukseen. Käyttäjä voi lisätä jopa 500 manuaalista yhteystietoa. Manuaaliset yhteystiedot kuuluvat Webexin laajempaan Käyttäjäkontaktien kategoriaan, mutta ne eivät sisälly synkronointiin.
Yleinen yhdistetty raja organisaatiokontakteille (30 000) ja ryhmäkontakteille (30 000 ryhmää kohden) on 200 000.
Päivitykset
Webex-hakemisto käsittelee päivityksiä seuraavasti:
Jos yhteyshenkilön nimi muuttuu BroadWorksissä, olemassa oleva yhteystieto poistetaan Webex-hakemistosta ja uusi yhteystieto luodaan.
Jos yhteyshenkilön numero muuttuu BroadWorksissä, Webex päivittää Webex-hakemistossa olevan yhteyshenkilön uudella numerolla.
Kun järjestelmänvalvoja on päivittänyt yhteyshenkilön BroadWorksissä, seuraavat ehdot määritellään, kun päivitys näkyy käyttäjän Webex-sovelluksessa:
Jos päivitys koskee vain BroadWorks-soittoa soittavalle käyttäjälle tai ei-käyttäjälle, päivitys näkyy käyttäjän Webex-sovelluksessa välittömästi seuraavan hakemistosynkronoinnin jälkeen.
Jos päivitys koskee BroadWorks-puhelinluettelomerkintää:
Käyttäjien yhteystiedot – päivitykset näkyvät käyttäjän Webex-sovelluksessa välittömästi seuraavan hakemistosynkronoinnin jälkeen.
Ryhmäyhteyshenkilöille - Päivitykset näkyvät käyttäjien Webex-sovelluksessa välittömästi seuraavan hakemistosynkronoinnin jälkeen.
Organisaation yhteystiedot: Webex-hakemisto päivitetään myöhemmän 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älimuistin ajastin vanhenee.
Webex for Cisco BroadWorks -käyttäjätietojen päivitykset käsitellään osana prosesseja. |
Control Hub sisältää mahdollisuuden lisätä tai muokata organisaatiotason yhteystietoja Control Hubissa CSV-tiedoston kautta. Kumppanien järjestelmänvalvojat ja asiakasjärjestelmänvalvojat, joilla on Control Hub -käyttöoikeudet, voivat käyttää tätä vaihtoehtoa. Webex for Cisco BroadWorks ei kuitenkaan tue yhteystietojen päivittämistä Control Hubin kautta. Control Hubissa käytetyt yhteystietopäivitykset eivät synkronoidu takaisin BroadWorksiin, eivätkä ne ole käytettävissä pöytäpuhelimien hakemistohakuihin. |
Hakemiston synkronoinnin edellytykset
Suosittelemme, että käytät seuraavia asetuksia:
Alla olevissa esimerkeissä oletetaan, että käytät XSP-palvelinta. Vaihda ADP-palvelimille (XSP_CLI) ja (ADP_CLI). |
Nopeuden rajoitusarvot – Aseta seuraavat OverloadControl-järjestelmän ominaisuudet (XSP_CLI/Sovellukset/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit – Aseta tyhjä arvo.
globalDirectoryTransactionLimit – Aseta nolla-arvo.
On suositeltavaa asettaa userDirectoryTransactionLimit ja globalDirectoryTransactionLimit nolla-arvoon. Jos kuitenkin päätät määrittää arvot, jokaisen on asetettava vähintään viisi kertaa transaktionLimitPeriodSeconds-arvo (jonka pitäisi olla 1).Tapahtumarajat – Aseta seuraavat arvot (XSP_CLI/Järjestelmä/CommunicationUtility/DefaultSettings):
userTransactionLimit – Aseta vähintään 100.
TransactionLimitPeriodSecs—Aseta arvoon 1.
Hakuarvot – Aseta hakujärjestelmän ominaisuudet (XSP_CLI/Sovellukset/Xsi-Actions/Paging):
oletusPageSize – Aseta arvoon 50
availableUserMaxLimit – Aseta arvoon 100
CTI-liitäntä – Varmista, että lataat Webexin CA-varmenteet CTI-liitännän luottamussäilöön ja otat asiakkaan todennus käyttöön CTI-liitännässä.
Lisäksi BroadWorks-julkaisustasi riippuen suosittelemme, että asennat seuraavat järjestelmäkorjaukset BroadWorks-asennukseen ennen tämän ominaisuuden käyttöönottoa:
R22:lle:
AP.as.22.0.1123.ap368517
R23:lle:
AP.as.23.0.1075.ap368517
R24:lle: laastaria ei tarvita
Täydellinen luettelo korjauspäivitysvaatimuksista, jotka muodostavat Webex for Cisco BroadWorksin vähimmäisvaatimuksen, on kohdassa BroadWorks-ohjelmistovaatimukset in Ratkaisuopas Webexille Cisco BroadWorksille. |
Ota hakemistosynkronointi käyttöön (uusi malli)
Kumppanien järjestelmänvalvojat voivat ottaa Directory Sync -toiminnon käyttöön asiakasmallissa uutta mallia luodessaan. Hakemistojen synkronointi on käytössä kaikissa uusissa asiakasorganisaatioissa, jotka määritetään kyseiseen malliin. Lisätietoja on kohdassa "Asiakasmallien määrittäminen". Määritä kumppaniorganisaatiosi Partner Hubissa sisällä Ratkaisuopas Webexille Cisco BroadWorksille.
Mitä tehdä seuraavaksi
Varmista, että käyttäjäsi tietävät, että heidän on napsautettava Yhteystiedot -välilehteä Webex-sovelluksessa vähintään kerran, jotta ominaisuus otetaan käyttöön Webex-sovelluksessa. Tämä on suoritettava vain kerran.
Ota hakemistosynkronointi käyttöön (nykyinen malli)
1 | Kirjaudu sisään Partner Hubiin ja valitse asetukset. | ||
2 | Vieritä kohtaan BroadWorks kutsuu ja napsauta Näytä mallit. | ||
3 | Valitse sopiva asiakasmalli ja vieritä kohtaan BroadWorks Directory Sync. | ||
4 | Ota hakemistosynkronointi käyttöön oletusarvoisesti uusille asiakasorganisaatioille, jotka käyttävät tätä mallia: | ||
5 | Ota käyttöön hakemistosynkronointi olemassa oleville asiakasorganisaatioille, jotka käyttävät tätä mallia:
|
Mitä tehdä seuraavaksi
Varmista, että käyttäjäsi tietävät, että heidän on napsautettava Yhteystiedot -välilehteä Webex-sovelluksessa vähintään kerran, jotta ominaisuus otetaan käyttöön Webex-sovelluksessa. Tämä on suoritettava vain kerran.
Käynnistä välitön synkronointi
1 | Kirjaudu sisään Partner Hubiin ( http://admin.webex.com) ja valitse asetukset. |
2 | Vieritä kohtaan BroadWorks kutsuu ja napsauta Näytä mallit. |
3 | Valitse sopiva asiakasmalli ja vieritä kohtaan BroadWorks Directory Sync. |
4 | Klikkaus Näytä luettelo asiakkaiden synkronoinnin tilasta. |
5 | Napsauta sen asiakasorganisaation kohdalla, jonka haluat synkronoida, kolmea pistettä oikeassa reunassa ja valitse Synkronoi nyt. |
6 | Klikkaus virkistää nähdäksesi synkronointitulokset. |
Vie synkronointitietueet CSV-muotoon
1 | Kirjaudu sisään Partner Hubiin ( http://admin.webex.com) ja valitse asetukset. |
2 | Vieritä kohtaan BroadWorks kutsuu ja napsauta Näytä mallit. |
3 | Valitse sopiva asiakasmalli ja vieritä kohtaan BroadWorks Directory Sync. |
4 | Klikkaus Näytä luettelo asiakkaiden synkronoinnin tilasta. |
5 | Valitse viereiset valintaruudut jokaisen organisaation kohdalla, jonka haluat sisällyttää vientiin. |
6 | Klikkaus Vie tulokset. |
Julkiset sovellusliittymät Directory Syncille
Julkiset API:t ovat saatavilla osoitteessa developer.webex.com joiden avulla kumppanien järjestelmänvalvojat voivat päivittää hallinnoimiensa asiakasorganisaatioiden Directory Sync -asetuksia, käynnistää välittömän synkronoinnin tai hankkia synkronoinnin tilatietoja. Hakemiston synkronointimenetelmät on ryhmitelty alle BroadWorks Enterprises:
Listaa BroadWorks-yritykset— Käytä tätä API-menetelmää saadaksesi luettelon tietyn palveluntarjoajan ja kunkin yrityksen alaisista yrityksistä
id
. Sinun on syötettäväspEnterpriseId
provisioinnin mukaisesti.Päivitä hakemiston synkronointi BroadWorks Enterpriselle– Syötä yritys
id
päivittääksesi kyseisen yrityksen hakemistosynkronoinnin tilan ottamalla käyttöön tai poistamalla käytöstä hakemistosynkronoinnin.Käynnistä hakemistosynkronointi yritykselle— Käytä tätä API-menetelmää, jos haluat käynnistää välittömän synkronoinnin tietylle yritykselle
id
. VartensyncStatus
, syötäSYNC_NOW
komento.Hanki hakemiston synkronoinnin tila yritykselle– Syötä yritys
id
ja juokse saadakseen aseman jatrackingId
uusimmasta synkronoinnista. Voit käyttäätrackingID
suorittaa lisäanalytiikkaa työkaluilla, kuten Kibana ja Grafana.
Lisäksi järjestelmänvalvojat voivat käyttää Käynnistä hakemistosynkronointi yhdelle käyttäjälle API käynnistää pyynnöstä hakemistosynkronoinnin yhdelle käyttäjälle.
Katso yksityiskohtaiset API-dokumentaatiot https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Sinun on kirjauduttava sisään lukeaksesi API-määritykset osoitteessa https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Synkronoi useita yrityksiä API:n kanssa
|
1 | Suorita Listaa BroadWorks-yritykset API luodaksesi luettelon yrityksistä, jotka haluat synkronoida. |
2 | Suorita Käynnistä hakemistosynkronointi yritykselle API luettelon ensimmäisenä yrityksenä. |
3 | Odota muutama sekunti ja käynnistä sitten Hanki hakemiston synkronoinnin tila API saadaksesi synkronoinnin tilan. |
4 | Kun synkronointi on valmis, suorita vaiheet 2–4 luettelon seuraavan yrityksen kohdalla. Toista näitä vaiheita, kunnes olet synkronoinut koko luettelon. |
Hakemiston synkronoinnin virhekoodit
Seuraavat virhekoodit koskevat Directory Synciä.
Virhekoodi | Virheviesti |
---|---|
600 000 | Broadworks External Directory User Sync odottamaton virhe. |
600 001 | Broadworksin ulkoisen hakemiston käyttäjän synkronointi epäonnistui. |
600 002 | Broadworks External Directory User Sync oli lopetettava ennen valmistumista. |
600003 | Broadworks External Directory User Sync 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ä ConfigSetille. |
600006 | Broadworks External Directory User Sync -säikeet ovat varattuina tai sulkeutuvat, joten ne eivät hyväksy enempää synkronointipyyntöjä. Yritä myöhemmin uudelleen. |
600007 | CustomerConfigin identiteettiorganisaatiota ei löydy. |
600008 | CustomerConfig ei löydy kumppaniorganisaatiosta. |
600009 | Broadworks External Directory User Sync -toimintoa 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ä CustomerConfigissa. |
600012 | Broadworksin ulkoisen hakemiston käyttäjäsynkronointia ei voi suorittaa, koska hybridihakemiston synkronointi on jo otettu käyttöön CustomerConfigissa. |
600013 | Broadworks External Directory User Sync ei onnistunut lisäämään käyttäjiä ja konetilejä henkilöllisyyssäilöön. |
600014 | Broadworks External Directory User Sync epäonnistui yritettäessä muodostaa yhteys Broadworks-klusteriin. Virhe Broadworksilta - %s. |
600015 | Broadworks External Directory User Sync ei löytänyt vastaavaa käyttäjää identiteettikaupassa. |
600017 | BroadWorks Phone List Sync ei onnistunut synkronoimaan kaikkia käyttäjien ja yrityksen/organisaation yhteystietoja. |
600018 | BroadWorks-puhelinluettelon synkronointi epäonnistui yrityksen/organisaation käyttäjien osalta. |
600019 | BroadWorks Phone List Sync ei onnistunut synkronoimaan yrityksen/organisaation yhteystietoja. |
600020 | BroadWorks External Directory User Sync -toimintoa 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 käytössä olevaa käyttäjää. |
600023 | BroadWorks External Directory yhden käyttäjän synkronointi ei ole mahdollista, koska käyttäjä on jo tässä organisaatiossa. |
600024 | BroadWorksin ulkoisen hakemiston yhden käyttäjän synkronointi ei ole mahdollista, koska BroadWorksistä ei löytynyt vastaavaa käyttäjää. |
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 ulkoisen hakemiston yhden käyttäjän synkronointi ei ole mahdollista, koska BroadWorksistä löytyi useita käyttäjiä. |
600028 | BroadWorks External Directory Single User Sync ei ole mahdollista, koska vähintään yhden yrityshakemiston synkronoinnin olisi pitänyt olla valmis. |
600029 | BroadWorks External Directory -käyttäjien synkronointi epäonnistui, koska yrityksellä ei ole käytössä olevaa käyttäjää. |
Muutoshistoria
Seuraavassa taulukossa on yhteenveto tämän artikkelin päivityksistä.
Päiväys | Tarkistus |
---|---|
14. helmikuuta 2023 | Päivitetty Hakemiston synkronoinnin maksimiarvot ja lähde osio. |
10. joulukuuta 2022 | Päivitetty termi Täydellinen välitön synkronointi to Käynnistä hakemiston synkronointi |
19. heinäkuuta 2022 | Selvennyksiä ja korjauksia yleiskuvaan:
|
9. toukokuuta 2022 |
|
07. huhtikuuta 2022 |
|
28. maaliskuuta 2022 |
|
24. maaliskuuta 2022 | Lisätty luettelo synkronoiduista puhelinnumerotyypeistä Hakemiston synkronointiehdot. Synkronointi sisältää nyt matkapuhelinnumerot. |
16. maaliskuuta 2022 |
|
17. joulukuuta 2021 |
|
16. joulukuuta 2021 |
|
8. joulukuuta 2021 |
|