Tässä asiakirjassa kuvataan eAdm-järjestelmän ja Telenor CMG:n välinen integraatio. Integraatio automatisoi käyttäjätilien hallinnan CMG:ssä synkronoimalla käyttäjätiedot eAdm-järjestelmästä.
Yleiskatsaus
CMG on Telenorin puhelin- ja hakemistopalvelu. Puhelinkeskuksen operaattorit ja muut työntekijät käyttävät sitä henkilöiden etsimiseen, yhteystietojen tarkistamiseen sekä sen selvittämiseen, mihin organisaation osaan he kuuluvat. Palvelu kattaa myös puhepostin, loppukäyttäjäportaalin ja toiminnan hallinnan.
Tämä integrointi automatisoi käyttäjien hallinnan HRM-järjestelmästäsi kyseiseen hakemistoon.
Seuraavissa esimerkeissä käytetään Fabletonin kunta, organisaation tunnus NO999000001. Fableton on kuvitteellinen paikka.
Edellytykset
Varmista nämä ennen integraation määrittämistä:
-
Telenor on toimittanut VpAPI-perus-URL-osoitteen, asiakastunnuksen, asiakassalaisuuden ja asiakastodistuksen. Todistuksen on oltava
.p12tai.pfxyksityisellä avaimella. A.cerilman yksityistä avainta ei voi käyttää. URL näyttää tältä:https://<host>/VpAPIja siihen pääsee vain asiakkaan verkosta. -
eAdm.Client-sovellusta suorittava palvelin pystyy muodostamaan yhteyden VpAPI:hin.
-
eAdm-järjestelmän päivittäisessä synkronointivaiheessa on vähintään yksi ajankohta ennen klo 08.00 tai klo 17.00 tai sen jälkeen Ruotsin aikaa, tai viikonlopun synkronointi on otettu käyttöön. CMG:ssä tapahtuvat luomiset, päivitykset ja poistot suoritetaan ainoastaan toimistoaikojen ulkopuolella.
Miten integrointi toimii
Jokaisella ajokerralla, myös työaikana tehtävillä ajokerroilla:
-
eAdm.Client kirjautuu VpAPI:hin ja lukee CMG-käyttäjät.
-
eAdm kopioi kyseisten käyttäjien Mobile- ja Extension-tiedot takaisin eAdm:ään, kun saapuvat virrat on määritetty.
-
eAdm tallentaa kaikki vireillä olevat profiilimuutokset.
Luo-, päivitä- ja poista-toiminnot suoritetaan vain silloin, kun kyseinen vaihe toteutetaan toimistoaikojen ulkopuolella. Useat saman käyttäjän tietoihin päivän aikana tehdyt muutokset yhdistyvät yhdeksi CMG-kutsuksi. Kustakin kentästä lähetetään viimeisin arvo. Myöhemmin mallista poistettu tieto korvaa aikaisemmat muutokset.
Kun eAdm on siirtänyt puhelut asiakkaalle, ne päättyvät, vaikka kello siirtyisikin sen jälkeen toimistoaikaan. Kelloa tarkastellaan silloin, kun eAdm valmistelee puhelut – eli silloin, kun vaihe suoritetaan – eikä silloin, kun synkronointi lisättiin jonoon.
Päiväaikainen suoritus, johon liittyy vireillä olevia muutoksia, päättyy onnistuneesti. Synkronointivaiheen viesti on CMG changes are waiting for the next open run. Asiakkaan lokissa lukee CMG returned no operations. Muutokset odottavat. Niitä ei ole hylätty.
Vastaavuuksien haku, luominen, päivittäminen ja poistaminen
eAdm tallentaa CMG-käyttäjätunnuksen henkilön tietoihin, kun luominen on onnistunut tai kun se linkitetään olemassa olevaan CMG-käyttäjään. Käyttäjänimi itsessään on aina eAdm-käyttäjänimi. Se ei ole vientimallin kohde. Se tallennetaan CMG:hen ”misc”-kohteena. { miscNo: 8, miscText: "<username>" }.
|
Kun |
Mitä tapahtuu |
|---|---|
|
Henkilöllä ei ole vielä CMG-tunnusta, ja eräällä CMG:n pääkäyttäjällä on jo kyseinen käyttäjätunnus ryhmässä ”misc 8” |
eAdm linkittää kyseisen CMG-tunnuksen ja lähettää päivityksen liitetyille kentille. Tämä on yhdistämisprosessi. |
|
Henkilöllä ei ole vielä CMG-tunnusta, eikä yhdelläkään CMG:n pääkäyttäjistä ole kyseistä käyttäjänimeä |
eAdm luo CMG-käyttäjän. OrgName ja numeerinen CustomerGroupId ovat pakollisia. |
|
Henkilöllä on CMG-tunnus, ja kyseinen käyttäjä on edelleen haetussa luettelossa |
eAdm päivittää liitetyt kentät. |
|
Henkilö poistetaan vientimallista, mutta CMG-käyttäjä on edelleen haetussa luettelossa |
eAdm poistaa CMG-käyttäjän. |
|
Henkilöllä on CMG-tunnus, mutta kyseistä käyttäjää ei ole haetussa luettelossa |
eAdm jättää CMG:n ennalleen. Se ei luo korvaavaa tietuetta eikä lähetä poistopyyntöä. |
|
Kaksi CMG:n pääkäyttäjää käyttää samaa käyttäjätunnusta misc 8:ssa |
eAdm säilyttää ensimmäisen ja kirjaa tapahtumat lokiin |
CMG-käyttäjää, jonka eAdm on jo poistanut tai joka ei enää kuulu asiakasryhmään, jota tässä vaiheessa tarkastellaan, ei luoda uudelleen, kun kyseinen henkilö palaa vientimalliin.
Käyttäjänimen vertailussa käytetään ainoastaan päätietueita. Lukutulos sisältää kuitenkin myös muita tietueita.
Jos luontipyyntö saavuttaa CMG:n ja vastaus katoaa, se otetaan huomioon myöhemmässä avoimessa käsittelykierroksessa, jos uusi muutos on edelleen vireillä ja käyttäjätunnus täsmää: eAdm linkittää olemassa olevan käyttäjän sen sijaan, että luo toisen käyttäjän.
Tuontikansio
Create sijoittaa käyttäjän kansioon, jonka nimi on OrgName, asiakasryhmässä, jonka nimi on Asiakasryhmätunnus. Käytä tätä varten varattua tuontikansiota, esim.FABLETON MUNICIPALITY\Import-AD.
Niin kauan kuin käyttäjä pysyy kyseisessä kansiossa, CMG tallentaa vain käyttäjänimen (misc 8). eAdm ei lähetä titteliä, esimiehen nimeä, vierailuosoitetta, postinumeroa, paikkakuntaa tai kustannuspaikkaa. Nimi, sähköpostiosoite, näkyvyysasetukset ja muut kuin misc-kentät lähetetään edelleen.
eAdm ei koskaan lähetä uutta kansiota tai uutta asiakasryhmää luomisen jälkeen. Tämä edellyttää, että joku CMG:ssä siirtää käyttäjän pois tuontikansiosta. Seuraava synkronointi työajan ulkopuolella lähettää sitten yhden päivityksen, joka sisältää odotuksessa olleet muut arvot. Käyttäjä, joka pysyy tuontikansiossa, ei koskaan saa näitä arvoja, eikä niihin myöhemmin tehtyjä muutoksia lähetetä, ennen kuin käyttäjä siirretään. Tuo päivitys jättää kansion ja asiakasryhmän sellaisiksi kuin CMG ne on määrittänyt.
Käyttäjän luomiseen käytetty suoritus ei lähetä tätä seurantapäivitystä. Kyseisessä suorituksessa tehty CMG-lukeminen tapahtui ennen luomista.
Vastaanottoajat
Telenor edellyttää, että CMG:ssä tehtävät luonti-, päivitys- ja poistotoiminnot suoritetaan toimistoaikojen ulkopuolella. eAdm lykkää näitä kirjoitustoimintoja tämän vaatimuksen täyttämiseksi. Aikavälissä käytetään Ruotsin paikallista aikaa (Europe/Stockholm), kesäaika mukaan lukien. Se on sama aikavyöhyke kuin Norjassa.
|
Kun |
Lue CMG, kirjoita mobiiliversio ja laajennus takaisin |
Luo, päivitä, poista CMG:ssä |
|---|---|---|
|
Arkisin klo 08.00–16.59 |
Kyllä |
Pidettiin |
|
Arkisin ennen klo 08.00 ja klo 17.00 alkaen |
Kyllä |
Lähetetty |
|
lauantai ja sunnuntai |
Kyllä |
Lähetetään, kun synkronointi suoritetaan |
eAdm ei käynnistä ylimääräistä synkronointia kello 17.00:n tullessa. Ainakin yhden synkronoinnin, joka sisältää CMG-vaiheen, on suoritettava toimistoaikojen ulkopuolella. Määritä kyseinen aika synkronointivaiheen päivittäiseen aikatauluun.
Aikataulu, joka sijoittuu kokonaan arkipäivien klo 08.00–17.00 välille, ei koskaan tallenna tietoja CMG:hen. Viikonloppuajot tallentavat tietoja CMG:hen vain, jos kyseiselle vaiheelle on kytketty viikonlopun synkronointi päälle.
Tuontitiedoston nollaaminen poistaa kyseiseen tiedostoon liittyvät lähettämättömät CMG-muutokset.
Asennus
Asenna varmenne
Suorita tämä toimenpide palvelimella, jolla eAdm.Client on käynnissä, sellaisessa tietokonevarastossa, johon asiakaspalvelutilillä on lukuoikeudet.
-
Tuo
.p12...:ksi Paikallinen tietokone → Henkilökohtainen (Cert:\LocalMachine\My). -
Myönnä eAdm.Client-sovellusta suorittavalle tilille oikeus lukea varmenteen yksityistä avainta.
-
Kopioi varmenteen sormenjälki. Välilyöntejä ei oteta huomioon. Tallenna CMG-synkronointivaiheessa vain sormenjälki.
-
Poista
.p12levyltä. Salasanaa ei tallenneta eAdm-järjestelmään.
Asiakas etsii kyseisen sormenjäljen, vaatii täsmälleen yhden vastaavuuden ja esittää varmenteen jokaisessa VpAPI-kutsussa, myös kirjautumisen yhteydessä. Puuttuva salainen avain, tyhjä sormenjälki tai useampi kuin yksi vastaavuus keskeyttää vaiheen ennen CMG-kutsua.
Vaiheparametrit
|
Parametri |
Pakollinen |
Mitä syöttää |
|---|---|---|
|
API-URL |
Kyllä |
Telenorin VpAPI-perus-URL, jossa ei ole sen jälkeistä polkua |
|
Asiakastunnus |
Kyllä |
VpAPI-asiakastunnus. |
|
Asiakassalaisuus |
Kyllä |
VpAPI-asiakassalaisuus. |
|
CMG-varmenteen sormenjälki |
Kyllä |
Sertifikaatin sormenjälki tiedostossa |
|
CMG-asiakasryhmien tunnukset |
Ei |
Lukemiseen tarkoitetut asiakasryhmätunnukset, jotka on erotettu pilkulla tai puolipisteellä. Tyhjä arvo lukee kaikki ryhmät, jotka API-tili näkee. Arvo, jossa ei ole kokonaislukua, keskeyttää vaiheen ennen CMG-kutsua. |
Vie malli
Määritä eAdm-vientikohteet CMG API -kenttiin.
|
Vientikohde |
CMG API -kenttä |
Luomisen yhteydessä |
Seuraavassa päivityksessä |
|---|---|---|---|
|
Käyttäjätunnus (aina eAdm-käyttäjätunnus) |
|
Aina |
Jätetty tallennetussa muodossa. Tämä on vastaavuusavain. |
|
FirstName |
|
Lähetetty. Palataan henkilön etunimeen. |
Lähetettiin, kun malli liitti sen. |
|
Sukunimi |
|
Lähetetty. Palataan sukunimeen. |
Lähetettiin, kun malli liitti sen. |
|
Sähköposti |
|
Lähetetään, kun osoite ei ole tyhjä. |
Lähetetään, kun kohdistus on tehty. Tyhjä arvo tyhjentää kanavan. |
|
Otsikko |
|
Pidätetään. Ei lähetetä, kun käyttäjä on tuontikansiossa. |
Lähetetään, kun kohde on liitetty karttaan. Säilytetään niin kauan kuin käyttäjä on tuontikansiossa. Tyhjä arvo tyhjentää sen. |
|
Johtaja |
|
Pidätetään. Ei lähetetä, kun käyttäjä on tuontikansiossa. |
Lähetetään, kun kohde on liitetty karttaan. Säilytetään niin kauan kuin käyttäjä on tuontikansiossa. Tyhjä arvo tyhjentää sen. |
|
Käyntiosoite |
|
Pidätetään. Ei lähetetä, kun käyttäjä on tuontikansiossa. |
Lähetetään, kun kohde on liitetty karttaan. Säilytetään niin kauan kuin käyttäjä on tuontikansiossa. Tyhjä arvo tyhjentää sen. |
|
Postinumero |
|
Pidätetään. Ei lähetetä, kun käyttäjä on tuontikansiossa. |
Lähetetään, kun kohde on liitetty karttaan. Säilytetään niin kauan kuin käyttäjä on tuontikansiossa. Tyhjä arvo tyhjentää sen. |
|
Paikkakunta |
|
Pidätetään. Ei lähetetä, kun käyttäjä on tuontikansiossa. |
Lähetetään, kun kohde on liitetty karttaan. Säilytetään niin kauan kuin käyttäjä on tuontikansiossa. Tyhjä arvo tyhjentää sen. |
|
Kustannuskeskus |
|
Pidätetään. Ei lähetetä, kun käyttäjä on tuontikansiossa. |
Lähetetään, kun kohde on liitetty karttaan. Säilytetään niin kauan kuin käyttäjä on tuontikansiossa. Tyhjä arvo tyhjentää sen. |
|
OrgName |
|
Pakollinen. Tarkka kansion nimi. |
Jätetään ennalleen. |
|
Asiakasryhmätunnus |
|
Pakollinen. Kokonaisluku. |
Jätetään ennalleen. |
|
Muutos: |
|
Jätetään pois, jos kenttä on tyhjä. |
Jätetään pois, jos kenttä on tyhjä. |
|
Näkyvissä CMG-verkkosivustolla |
|
|
Lähetetään vain, kun sijainti on määritetty. |
|
Näkyy CMG-hakemistossa |
|
|
Lähetetään vain, kun sijainti on määritetty. |
|
Päätietue |
|
Jätetään pois, jos sitä ei ole liitetty karttaan. Tällöin CMG käsittelee käyttäjää pääkirjauksena. |
Lähetetään vain, kun sijainti on määritetty. |
OrgName ja Asiakasryhmätunnus käytetään vain luomisen yhteydessä. Jos henkilön ainoa muutos koskee jompaakumpaa näistä kahdesta kohteesta, CMG:lle ei lähetetä mitään. Muutos merkitään valmiiksi, ja synkronointilokissa lukee had no mapped fields to update. Myöhemmin tehty muutos kartoitettuun kenttään lähetetään normaalisti.
Lisäksi:
-
Luo sarjoja
hiddenMobileNrjahiddenExtensionNrosoitteeseentrue. Myöhemmissä päivityksissä molemmat liput säilytetään sellaisina kuin ne ovat CMG:ssä. Numerot kopioidaan edelleen takaisin eAdm:iin, vaikka ne olisi piilotettu CMG:ssä. -
Kartta
VisibleInCMGWebjaVisibleInCMGDirectoryosoitteeseentruemilloin uusien käyttäjien pitäisi näkyä CMG:n verkkosivuilla ja hakemistossa. Kartoittamaton luonti lähettääfalse. -
Avainsanat jätetään ennalleen, koska CMG:llä on ne jo.
-
Tekstiviestit ja muut osoitekanavat kuin sähköposti säilytetään sellaisina kuin CMG ne on tallentanut.
-
eAdm ei lähetä matkapuhelinnumeroa, sisäpuhelinnumeroa tai kalenterin synkronointitietoja CMG:lle.
Esimerkki Fabletonin kartoituksesta
|
Arvo mallissa |
Vientikohde |
|---|---|
|
|
FirstName |
|
|
Sukunimi |
|
|
Sähköposti |
|
|
Otsikko |
|
[REFERENCE;DisplayName;UserId;1;[Manager]] |
Johtaja |
|
[Postiosoite] |
Käyntiosoite |
|
[Postinumero] |
Postinumero |
|
Kaupunki |
Paikkakunta |
|
[Kustannuspaikka] |
Kustannuskeskus |
|
|
OrgName |
|
|
Asiakasryhmätunnus |
|
|
Muutos: |
|
|
Näkyvissä CMG-verkkosivustolla |
|
|
Näkyy CMG-hakemistossa |
Koska OrgName, käytä CMG:stä peräisin olevaa tarkkaa kansionimeä, isot kirjaimet mukaan lukien. Toinen sääntöjoukko, jossa on kirjaimellinen CustomerGroupId ja sääntökokoelma, joka ei ole päällekkäinen ensimmäisen kanssa, voi sijoittaa toisen joukon ihmisiä toiseen asiakasryhmään.
Mobiiliversio ja laajennus takaisin eAdm-järjestelmään
Samassa mallissa, Mobiili ja Laajennus ovat saapuvia lähteitä. Määritä kukin niistä kohdistumaan siihen eAdm-kenttään, johon CMG-numero tulisi tallentaa. Saapuvan virran lausekkeessa voidaan lisätä etuliite: eAdm korvaa CMG-numeron NewValue tuossa lausekkeessa.
Muut tässä vaiheessa käytettävät lähteet jätetään huomiotta. Otsikko ja muut profiilin tiedot säilyvät lähdemallin ominaisuutena.
Tiedon palautus suoritetaan jokaisen synkronoinnin yhteydessä, myös työaikana. Se koskee vain niitä päätietueita, jotka eAdm on jo linkittänyt CMG-tunnukseen.
Testaus
Suorita testi asiakaspalvelimella ennen kuin teet mitään tuotantokäyttöön tarkoitettuja kirjoituksia. Testitilassa luetaan CMG:tä, muodostetaan toimintoja ikään kuin kirjoitusikkuna olisi auki, mutta CMG:hen ei tehdä muutoksia. Lisäksi siinä ohitetaan mobiili- ja laajennusten kirjoitusten palautus.
eadm.client.exe exportcmg NO999000001 test
Asiakaskirjaus sisältää CMG test: N operations, none executed. ja yksi rivi kutakin toimintoa kohti. ”Confirm”-toiminto luo tiedoston tuontikansioon, ”merges”-toiminto yhdistää oikean käyttäjätunnuksen, eikä ketään, jonka pitäisi jäädä CMG:hen, ole merkitty poistettavaksi.
Aikataulun mukainen synkronointi suorittaa live-komennon ilman test:
eadm.client.exe exportcmg NO999000001
Ensimmäinen käyttäjäryhmä käyttöönoton yhteydessä
Ensimmäisen CMG-viennin tulisi olla täydellinen vienti. Suorita se kerran, kun ”Vie CMG” on synkronointisyklin seuraava vaihe. Myöhemmät suoritukset ovat vain päivityksiä.
eadm.client.exe exportcmg NO999000001 full test
eadm.client.exe exportcmg NO999000001 full
full test tarkastelee koko populaatiota etukäteen eikä muuta mitään. full määrittää vientimallin jokaiselle henkilölle, johon sääntökokoelma sopii, ja asettaa jokaiselle luonti- tai yhdistämistehtävän jonoon. Arkipäivisin klo 08.00–17.00 Ruotsin aikaa rivit tallennetaan, ja vaihe päättyy seuraavasti: CMG changes are waiting for the next open run. Seuraava kyseisen ajanjakson ulkopuolelle ajoitettu suoritus lähettää ne.
Älä juokse full toisen kerran, kun muutokset ovat vielä odottamassa. Se asettaa jokaisesta muutoksesta toisen kopion jonoon. Synkronointivaiheen ”Vie”-painike ei käynnistä CMG:tä, vaan se vain asettaa saman joukon jonoon seuraavaa synkronointia varten.
Jos haluat yrittää uudelleen ennen lähettämistä, poista vain ”Vie CMG” -vaihe. Koko synkronointisyklin poistaminen hylkää kyseisen tuontitiedoston lähettämättömät CMG-muutokset.
Vianmääritys
|
Oire |
Todennäköinen syy |
Toiminta |
|---|---|---|
|
Synkronointiviesti |
Juoksu järjestettiin arkipäivänä klo 08.00–17.00. |
Odota, kunnes synkronointi tapahtuu kyseisen ajanjakson ulkopuolella. Varmista, että synkronointivaiheessa on tällainen ajankohta. |
|
CMG ei muutu koskaan, eikä päiväsaikaisiakaan lähetetä |
Synkronointia ei suoriteta, kun ikkuna on auki tai kun vaihe 1100 on määrätty ennen delta-jatko-pistettä. |
Lisää synkronointiin ilta-, yö- tai viikonloppuaika. Siirrä vaihetta 1100 alaspäin, jotta muutokset sisältävät sen. |
|
|
Sormenjälki puuttuu, se on kirjoitettu väärin tai kaksi varmennetta käyttää samaa sormenjälkeä. Varasto on |
Tuo uudelleen |
|
|
A |
Tuo |
|
Käyttäjän yhteydenotot epäonnistuvat virhekoodilla 401, mutta sisäänkirjautuminen voi silti onnistua |
Varmennetta ei esitetty tai asiakastunnus tai salainen avain hylättiin. |
Tarkista sormenjälki, asiakastunnus ja asiakassalaisuus. Asiakas yrittää kirjautua sisään uudelleen kerran. |
|
Uuden käyttäjän kohdalla CMG:ssä näkyy vain käyttäjänimi |
Käyttäjä on edelleen tuontikansiossa. eAdm ei lähetä muita sekalaisia kenttiä, kun käyttäjä on siellä. |
Siirrä käyttäjä pois CMG:n tuontikansiosta. Seuraava käynnistys lähettää tallennetut muut arvot. Jos käyttäjä jää sinne, kyseisiä arvoja ei lähetetä koskaan. |
|
Käyttäjä siirrettiin CMG:ssä, ja eAdm lakkasi päivittämästä hänen tietojaan |
Käyttäjä poistui kaikista asiakasryhmistä, joita tässä vaiheessa käsitellään. |
Lisää kyseinen ryhmä CMG:n asiakasryhmätunnisteisiin tai siirrä se takaisin. eAdm ei luo niitä uudelleen. |
|
|
Mallissa ei määritetty kansion nimeä eikä numeerista ryhmätunnusta uudelle käyttäjälle. |
Määritä molemmat kohteet. Kansion nimen on vastattava täsmälleen CMG:tä. |
|
|
Henkilöllä ei ole eAdm-käyttäjätunnusta. |
Anna heille käyttäjätunnus ennen kuin he siirtyvät CMG-mallipohjaan. |
|
CMG:ssä raivattiin pelto |
Päivityksessä lähetettiin tyhjä kartoitettu arvo. Tyhjä sähköpostiviesti tyhjentää sähköpostikanavan. Tyhjä ”misc”-arvo tyhjentää kyseisen ”misc”-kentän. |
Kartoita kohde vain, jos eAdm:n tulisi olla sen omistaja. |
|
|
Kahdessa CMG:n päätietueessa on sama käyttäjätunnus. |
Korjaa päällekkäisyys CMG:ssä. eAdm säilyttää toisen niistä. |
|
Hylätty CMG-kutsu (HTTP 400–499, lukuun ottamatta 401) |
CMG hylkäsi kyseisen käyttäjän. Muutos on merkitty valmiiksi, eikä sitä yritetä uudelleen. |
Lue virhe objektin historiasta, korjaa tiedot ja tee uusi muutos, jotta se lähetetään uudelleen myöhemmässä avauskierroksessa. |
|
HTTP 401 -virhe sivun päivittämisen jälkeen, HTTP 5xx -virhe tai verkkovirhe |
Kutsu ei mennyt läpi. Muutos on edelleen vireillä. |
Seuraavalla avoimella kierroksella yritetään uudelleen. |
