re:ADM maksaa itsensä takaisin vuodessa. Tilaa 18. joulukuuta mennessä ja saat 20 % alennusta www.identum.no/re-adm

Telenor CMG

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

  1. Telenor on toimittanut VpAPI-perus-URL-osoitteen, asiakastunnuksen, asiakassalaisuuden ja asiakastodistuksen. Todistuksen on oltava .p12 tai .pfx yksityisellä avaimella. A .cer ilman yksityistä avainta ei voi käyttää. URL näyttää tältä: https://<host>/VpAPI ja siihen pääsee vain asiakkaan verkosta.

  2. eAdm.Client-sovellusta suorittava palvelin pystyy muodostamaan yhteyden VpAPI:hin.

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

  1. eAdm.Client kirjautuu VpAPI:hin ja lukee CMG-käyttäjät.

  2. eAdm kopioi kyseisten käyttäjien Mobile- ja Extension-tiedot takaisin eAdm:ään, kun saapuvat virrat on määritetty.

  3. 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 Duplicate Unikt AD.

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.

  1. Tuo .p12 ...:ksi Paikallinen tietokone → Henkilökohtainen (Cert:\LocalMachine\My).

  2. Myönnä eAdm.Client-sovellusta suorittavalle tilille oikeus lukea varmenteen yksityistä avainta.

  3. Kopioi varmenteen sormenjälki. Välilyöntejä ei oteta huomioon. Tallenna CMG-synkronointivaiheessa vain sormenjälki.

  4. Poista .p12 levyltä. 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 /VpAPI.

Asiakastunnus

Kyllä

VpAPI-asiakastunnus.

Asiakassalaisuus

Kyllä

VpAPI-asiakassalaisuus.

CMG-varmenteen sormenjälki

Kyllä

Sertifikaatin sormenjälki tiedostossa LocalMachine\My.

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)

miscNo: 8

Aina

Jätetty tallennetussa muodossa. Tämä on vastaavuusavain.

FirstName

firstName

Lähetetty. Palataan henkilön etunimeen.

Lähetettiin, kun malli liitti sen.

Sukunimi

lastName

Lähetetty. Palataan sukunimeen.

Lähetettiin, kun malli liitti sen.

Sähköposti

addressItems kanava E-Mail

Lähetetään, kun osoite ei ole tyhjä.

Lähetetään, kun kohdistus on tehty. Tyhjä arvo tyhjentää kanavan.

Otsikko

miscNo: 15

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

miscNo: 13

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

miscNo: 3

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

miscNo: 5

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

miscNo: 7

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

miscNo: 2

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

orgItems[].orgName

Pakollinen. Tarkka kansion nimi.

Jätetään ennalleen.

Asiakasryhmätunnus

customerGroupId

Pakollinen. Kokonaisluku.

Jätetään ennalleen.

Muutos:

changeBy

Jätetään pois, jos kenttä on tyhjä.

Jätetään pois, jos kenttä on tyhjä.

Näkyvissä CMG-verkkosivustolla

visibleInCMGWeb

false kun se ei ole liitetty.

Lähetetään vain, kun sijainti on määritetty.

Näkyy CMG-hakemistossa

visibleInCMGDirectory

false kun se ei ole liitetty.

Lähetetään vain, kun sijainti on määritetty.

Päätietue

mainRecord

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 hiddenMobileNr ja hiddenExtensionNr osoitteeseen true. 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 VisibleInCMGWeb ja VisibleInCMGDirectory osoitteeseen true milloin 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

[GivenName]

FirstName

[Surname]

Sukunimi

[Email]

Sähköposti

[Title]

Otsikko

[REFERENCE;DisplayName;UserId;1;[Manager]]

Johtaja

[Postiosoite]

Käyntiosoite

[Postinumero]

Postinumero

Kaupunki

Paikkakunta

[Kustannuspaikka]

Kustannuskeskus

FABLETON MUNICIPALITY\Import-AD

OrgName

100

Asiakasryhmätunnus

eAdm

Muutos:

true

Näkyvissä CMG-verkkosivustolla

true

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 CMG changes are waiting for the next open run.

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.

Could not find certificate or found more than one

Sormenjälki puuttuu, se on kirjoitettu väärin tai kaksi varmennetta käyttää samaa sormenjälkeä. Varasto on LocalMachine\My.

Tuo uudelleen .p12 ja tallenna yksi sormenjälki.

CMG certificate ... has no private key

A .cer on tuotu, tai palvelutili ei voi lukea avainta.

Tuo .p12 ja myöntää eAdm.Client-tilille oikeuden lukea yksityistä avainta.

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.

OrgName is required for create tai CustomerGroupId is required for create

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

UserName is required

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.

Duplicate Unikt AD lokissa

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.

Viimeksi päivitetty: