Dette dokumentet beskriver integrasjonen mellom eAdm og Telenor CMG. Integrasjonen automatiserer administrasjonen av brukerkontoer i CMG ved å synkronisere brukerinformasjon fra eAdm.
Oversikt
CMG er Telenors telefoni- og oppslagstjeneste. Telefonistene og andre medarbeidere bruker den til å finne personer, se hvordan man kan nå dem og finne ut hvilken del av organisasjonen de tilhører. Tjenesten omfatter også telefonsvarer, en brukerportal og aktivitetsstyring.
Denne integrasjonen automatiserer brukeradministrasjonen fra HRM-systemet ditt til den katalogen.
Eksemplene nedenfor bruker Fableton kommune, organisasjons-ID NO999000001. Fableton er et fiktivt sted.
Forutsetninger
Bekreft følgende før du konfigurerer integrasjonen:
-
Telenor har oppgitt VpAPI-base-URL-en, klient-ID, klienthemmelighet og et klientsertifikat. Sertifikatet må være et
.p12eller.pfxmed en privat nøkkel. En.ceruten en privat nøkkel kan den ikke brukes. URL-adressen ser slik ut:https://<host>/VpAPIog er kun tilgjengelig fra kundens nettverk. -
Serveren som kjører eAdm.Client, har tilgang til VpAPI.
-
Et daglig synkroniseringstrinn i eAdm skjer minst én gang før kl. 08.00 eller kl. 17.00 eller senere svensk tid, eller så er helgesynkronisering aktivert. Oppretting, oppdatering og sletting i CMG utføres kun utenfor kontortiden.
Slik fungerer integrasjonen
Ved hver løpetur, inkludert løpeturer i arbeidstiden:
-
eAdm.Client logger seg på VpAPI og henter CMG-brukerne.
-
eAdm kopierer «Mobile» og «Extension» fra disse brukerne tilbake til eAdm når innkommende flyter er konfigurert.
-
eAdm registrerer alle ventende profilendringer.
Handlingene «Opprett», «Oppdater» og «Slett» utføres kun når det samme trinnet kjøres utenfor kontortiden. Flere endringer for samme bruker i løpet av dagen blir samlet til ett CMG-kall. Den siste verdien i hvert felt er den som sendes. En senere fjerning fra malen har forrang fremfor tidligere endringer.
Når eAdm har overført samtalene til klienten, fullføres disse samtalene selv om klokken da går inn i kontortiden. Klokkeslettet registreres når eAdm forbereder samtalene – det vil si når trinnet kjøres – ikke når synkroniseringen ble satt i kø.
En daglig kjøring med ventende endringer fullføres uten feil. Meldingen for synkroniseringstrinnet er CMG changes are waiting for the next open run. Klientloggen sier CMG returned no operations. Endringene ligger og venter. De blir ikke forkastet.
Søke, opprette, oppdatere og slette
eAdm lagrer CMG-bruker-ID-en for personen etter en vellykket opprettelse, og når det kobles til en eksisterende CMG-bruker. Selve brukernavnet er alltid eAdm-brukernavnet. Det er ikke et mål for eksportmaler. Det skrives til CMG som et «misc»-element { miscNo: 8, miscText: "<username>" }.
|
Når |
Hva skjer? |
|---|---|
|
Denne personen har ikke noe CMG-ID ennå, og en hovedbruker av CMG har allerede dette brukernavnet i «misc 8» |
eAdm kobler sammen denne CMG-ID-en og sender en oppdatering for de tilordnede feltene. Dette er sammenslåingen. |
|
Personen har ikke noe CMG-ID ennå, og ingen hovedbruker i CMG har dette brukernavnet |
eAdm oppretter en CMG-bruker. OrgName og et numerisk CustomerGroupId er obligatoriske opplysninger. |
|
Personen har en CMG-ID, og denne brukeren er fortsatt på listen over hentede brukere |
eAdm oppdaterer de tilordnede feltene. |
|
Personen blir fjernet fra eksportmalen, mens CMG-brukeren fortsatt står på den hentede listen |
eAdm sletter CMG-brukeren. |
|
Personen har en CMG-ID, men denne brukeren er ikke på den hentede listen |
eAdm lar CMG være i fred. Det oppretter ikke en erstatning og sender ikke en slettingsforespørsel. |
|
To av de største CMG-brukerne har samme brukernavn i «misc 8» |
eAdm beholder den første og logger |
En CMG-bruker som eAdm allerede har slettet, eller som ikke lenger tilhører en kundegruppe – slik det fremgår av dette trinnet – opprettes ikke på nytt når personen kommer tilbake til eksportmalen.
Det er kun hovedpostene som brukes til å sammenligne brukernavn. Lesingen omfatter likevel også andre poster.
En opprettelse som når CMG og deretter mister svaret, blir hentet opp ved en senere åpen kjøring dersom en ny endring fortsatt er under behandling og brukernavnet stemmer overens: eAdm kobler den eksisterende brukeren i stedet for å opprette en ny.
Importmappen
«Create» plasserer brukeren i mappen med navnet OrgName, innenfor kundegruppen med navnet Kundegruppe-ID. Bruk den egne importmappen din, f.eks.FABLETON MUNICIPALITY\Import-AD.
Så lenge brukeren befinner seg i den mappen, lagrer CMG kun brukernavnet (misc 8). eAdm sender ikke tittel, leder, besøksadresse, postnummer, lokalitet eller kostnadssted. Navn, e-postadresse, synlighet og de andre feltene som ikke er av typen «misc» sendes fortsatt.
eAdm sender aldri en ny mappe eller en ny kundegruppe etter opprettelsen. Dette forutsetter at noen i CMG flytter brukeren ut av importmappen. Ved neste synkronisering utenfor kontortiden sendes det da én oppdatering med de diverse verdiene som ble lagret. En bruker som forblir i importmappen mottar aldri disse verdiene, og senere endringer av dem sendes ikke før brukeren flyttes. Den oppdateringen bevarer mappen og kundegruppen slik CMG har dem.
Kjøringen som oppretter brukeren, sender ikke også denne oppdateringen. CMG-avlesningen i den kjøringen skjedde før opprettelsen.
Kontortider
Telenor krever at opprettelser, oppdateringer og slettinger i CMG skal skje utenfor kontortiden. eAdm utsetter disse skrivningene for å oppfylle dette kravet. Tidsvinduet er basert på svensk lokal tid (Europe/Stockholm), inkludert sommertid. Det er samme tidssone som i Norge.
|
Når |
Les CMG, skriv til mobil og utvidelse tilbake |
Opprett, oppdater, slett i CMG |
|---|---|---|
|
Hverdager kl. 08.00–16.59 |
Ja |
Avholdt |
|
På hverdager før kl. 08.00 og fra kl. 17.00 |
Ja |
Sendt |
|
Lørdag og søndag |
Ja |
Sendes når en synkronisering kjører |
eAdm starter ikke en ekstra synkronisering når klokken blir 17:00. Minst én synkronisering som inkluderer CMG-trinnet må kjøres utenfor kontortiden. Legg inn dette tidspunktet i den daglige tidsplanen for synkroniseringstrinnet.
En tidsplan som utelukkende ligger innenfor ukedagene kl. 08:00–17:00, skriver aldri til CMG. Kjøringer i helgen skriver kun til CMG når helgesynkronisering er aktivert for det aktuelle trinnet.
Når du tilbakestiller en importfil, fjernes de ikke-sendte CMG-endringene som hører til den filen.
Oppsett
Installer sertifikatet
Gjør dette på serveren der eAdm.Client kjører, i datalageret som klienttjenestekontoen har lesetilgang til.
-
Importer
.p12til Lokal datamaskin → Personlig (Cert:\LocalMachine\My). -
Gi kontoen som kjører eAdm.Client tillatelse til å lese sertifikatets private nøkkel.
-
Kopier sertifikatets tommelavtrykk. Mellomrom blir ignorert. Lagre kun tommelavtrykket i CMG-synkroniseringstrinnet.
-
Slett
.p12fra disken. Passordet lagres ikke i eAdm.
Klienten søker opp dette tommelavtrykket, krever nøyaktig én treff, og fremviser sertifikatet ved hvert VpAPI-kall, inkludert pålogging. En manglende privat nøkkel, et tomt tommelavtrykk eller mer enn én treff avbryter trinnet før et eventuelt CMG-kall.
Trinnparametere
|
Parameter |
Påkrevd |
Hva skal du skrive inn? |
|---|---|---|
|
API-URL |
Ja |
VpAPI-base-URL fra Telenor, uten etterfølgende sti utover |
|
Klient-ID |
Ja |
VpAPI-klient-ID. |
|
Kundehemmelighet |
Ja |
VpAPI-klientnøkkel. |
|
CMG-sertifikatets tommelavtrykk |
Ja |
Sertifikatets tommelavtrykk i |
|
CMG-kundegruppe-ID-er |
Nei |
Kundegruppe-ID-er, atskilt med komma eller semikolon, som skal leses inn. Et tomt felt leser inn alle gruppene som API-kontoen har tilgang til. En verdi uten heltall avbryter trinnet før et eventuelt CMG-kall. |
Eksporter mal
Tilordne eAdm-eksportmål til CMG API-felt.
|
Eksportmål |
CMG API-felt |
Ved opprettelse |
I en senere oppdatering |
|---|---|---|---|
|
Brukernavn (alltid eAdm-brukernavnet) |
|
Alltid |
Beholdes slik den er lagret. Dette er samsvaringsnøkkelen. |
|
Fornavn |
|
Sendt. Går tilbake til personens fornavn. |
Ble sendt da malen tilordnet den. |
|
Etternavn |
|
Sendt. Går tilbake til etternavnet. |
Ble sendt da malen tilordnet den. |
|
E-post |
|
Sendes når adressefeltet ikke er tomt. |
Sendes når det tilordnes. En tom verdi tømmer kanalen. |
|
Tittel |
|
Holdes tilbake. Sendes ikke mens brukeren befinner seg i importmappen. |
Sendes når elementet tilordnes. Opprettholdes så lenge brukeren fortsatt befinner seg i importmappen. En tom verdi sletter den. |
|
Leder |
|
Holdes tilbake. Sendes ikke mens brukeren befinner seg i importmappen. |
Sendes når elementet tilordnes. Opprettholdes så lenge brukeren fortsatt befinner seg i importmappen. En tom verdi sletter den. |
|
Besøksadresse |
|
Holdes tilbake. Sendes ikke mens brukeren befinner seg i importmappen. |
Sendes når elementet tilordnes. Opprettholdes så lenge brukeren fortsatt befinner seg i importmappen. En tom verdi sletter den. |
|
Postnummer |
|
Holdes tilbake. Sendes ikke mens brukeren befinner seg i importmappen. |
Sendes når elementet tilordnes. Opprettholdes så lenge brukeren fortsatt befinner seg i importmappen. En tom verdi sletter den. |
|
Sted |
|
Holdes tilbake. Sendes ikke mens brukeren befinner seg i importmappen. |
Sendes når elementet tilordnes. Opprettholdes så lenge brukeren fortsatt befinner seg i importmappen. En tom verdi sletter den. |
|
Kostnadssted |
|
Holdes tilbake. Sendes ikke mens brukeren befinner seg i importmappen. |
Sendes når elementet tilordnes. Opprettholdes så lenge brukeren fortsatt befinner seg i importmappen. En tom verdi sletter den. |
|
OrgName |
|
Påkrevd. Nøyaktig mappenavn. |
Forblir uendret. |
|
Kundegruppe-ID |
|
Påkrevd. Et heltall. |
Forblir uendret. |
|
Endring av |
|
Utelates hvis feltet er tomt. |
Utelates hvis feltet er tomt. |
|
Synlig på CMG-nettsiden |
|
|
Sendes kun når det er kartlagt. |
|
Synlig i CMG-katalogen |
|
|
Sendes kun når det er kartlagt. |
|
MainRecord |
|
Utelates når den ikke er tilordnet. CMG behandler da brukeren som en hovedpost. |
Sendes kun når det er kartlagt. |
OrgName og Kundegruppe-ID brukes kun ved opprettelse. Hvis den eneste endringen for en person gjelder ett av disse to feltene, sendes ingenting til CMG. Endringen merkes som fullført, og synkroniseringsloggen viser had no mapped fields to update. En senere endring i et tilordnet felt sendes som vanlig.
I tillegg:
-
Opprett sett
hiddenMobileNroghiddenExtensionNrtiltrue. Senere oppdateringer lar begge flaggene stå slik de er i CMG. Tallene kopieres fortsatt tilbake til eAdm når de er skjult i CMG. -
Kart
VisibleInCMGWebogVisibleInCMGDirectorytiltruenår nye brukere skal vises på CMG-nettsiden og i katalogen. En opprettelse uten tilknytning senderfalse. -
Nøkkelordene beholdes slik de er, siden CMG allerede har dem.
-
SMS og alle andre adressekanaler enn e-post beholdes slik CMG har lagret dem.
-
eAdm sender ikke mobilnummer, internnummer eller kalendersynkronisering til CMG.
Eksempel på kartlegging for Fableton
|
Verdi i malen |
Eksportmål |
|---|---|
|
|
Fornavn |
|
|
Etternavn |
|
|
E-post |
|
|
Tittel |
|
[REFERENCE;DisplayName;UserId;1;[Manager]] |
Leder |
|
[Postadresse] |
Besøksadresse |
|
[Postnummer] |
Postnummer |
|
By |
Sted |
|
[Kostnadssted] |
Kostnadssted |
|
|
OrgName |
|
|
Kundegruppe-ID |
|
|
Endring av |
|
|
Synlig på CMG-nettsiden |
|
|
Synlig i CMG-katalogen |
For OrgName, bruk det nøyaktige mappenavnet fra CMG, inkludert store og små bokstaver. Et annet regelsett, med en bokstavelig CustomerGroupId og et regelsett som ikke overlapper det første, kan plassere en annen gruppe personer i en annen kundegruppe.
Mobil og utvidelse tilbake til eAdm
I samme mal, Mobil og Utvidelse er innkommende kilder. Pek hver av dem mot eAdm-feltet som skal lagre CMG-nummeret. Uttrykket for innkommende flyt kan legge til et prefiks: eAdm erstatter CMG-nummeret med NewValue i det uttrykket.
Andre innkommende kilder i dette trinnet blir ignorert. Tittelen og resten av profilen forblir knyttet til den utgående malen.
Tilbakeskrivingen utføres ved hver synkronisering, inkludert kjøringer i kontortiden. Den gjelder kun hovedposter som eAdm allerede har koblet til en CMG-ID.
Testing
Kjør testen på kundeserveren før det foretas noen live-skrivinger. I testmodus leses CMG, operasjonene bygges opp som om skrivevinduet var åpent, og ingenting endres i CMG. Testen hopper også over tilbakeskriving til mobil og utvidelse.
eadm.client.exe exportcmg NO999000001 test
Klientloggen inneholder CMG test: N operations, none executed. og én linje per operasjon. «Bekreft» oppretter filer i importmappen, «slå sammen» bruker riktig brukernavn, og ingen som skal forbli i CMG er oppført som «slett».
Den planlagte synkroniseringen utfører «live»-kommandoen uten test:
eadm.client.exe exportcmg NO999000001
Første brukergruppe ved driftsstart
Den første CMG-eksporten bør være en fullstendig eksport. Kjør den én gang, når «Eksporter CMG» er neste trinn i synkroniseringssyklusen. Senere kjøringer skal være deltaeksport.
eadm.client.exe exportcmg NO999000001 full test
eadm.client.exe exportcmg NO999000001 full
full test gir en oversikt over hele populasjonen uten å endre noe. full tildeler eksportmalen til alle personer som oppfyller reglene, og setter en opprettelse eller sammenslåing i kø for hver enkelt. Ved en kjøring på en ukedag mellom kl. 08.00 og 17.00 svensk tid lagres radene, og trinnet avsluttes med CMG changes are waiting for the next open run. Den neste planlagte kjøringen utenfor dette tidsvinduet sender dem.
Ikke løp full en gang til mens endringene fortsatt er i kø. Den setter en ny kopi av hver av dem i kø. «Eksporter»-knappen i synkroniseringstrinnet utløser ikke CMG; den setter bare den samme gruppen i kø for neste synkronisering.
Hvis du vil prøve på nytt før sendingen, må du bare slette trinnet «Eksporter CMG». Hvis du sletter hele synkroniseringssyklusen, blir alle uutsendte CMG-endringer for den aktuelle importfilen slettet.
Feilsøking
|
Symptom |
Sannsynlig årsak |
Handling |
|---|---|---|
|
Synkroniser melding |
Løpet fant sted på en ukedag mellom kl. 08.00 og 17.00. |
Vent med synkroniseringen til utenfor dette tidsvinduet. Kontroller at synkroniseringstrinnet har et slikt tidspunkt. |
|
CMG forandrer seg aldri, og det mangler også et budskap på dagtid |
Det utføres ingen synkronisering mens vinduet er åpent, eller hvis trinn 1100 blir utført før delta-fortsettelsespunktet. |
Legg til en tidspunkt for kveld, natt eller helg i «Synkronisering». Flytt trinn 1100 nedover, slik at deltaene inkluderer det. |
|
|
Tommelavtrykket mangler, er feilskrevet, eller to sertifikater deler det. Sertifikatlageret er |
Importer på nytt |
|
|
A |
Importer |
|
Brukeranrop mislykkes med feilkode 401, men påloggingen kan likevel lykkes |
Sertifikatet ble ikke fremlagt, eller klient-ID-en eller den hemmelige nøkkelen ble avvist. |
Kontroller tommelavtrykket, klient-ID-en og klienthemmeligheten. Klienten prøver å logge seg inn på nytt én gang. |
|
For nye brukere vises kun brukernavnet i CMG |
Brukeren befinner seg fortsatt i importmappen. eAdm sender ikke de andre diverse feltene så lenge brukeren er der. |
Flytt brukeren ut av importmappen i CMG. Ved neste kjøring sendes de diverse verdiene som ble holdt tilbake. Hvis brukeren forblir der, blir disse verdiene aldri sendt. |
|
Brukeren ble flyttet i CMG, og eAdm sluttet å oppdatere opplysningene om vedkommende |
Brukeren har forlatt alle kundegruppene som nevnes i dette trinnet. |
Legg denne gruppen til i CMG-kundegruppe-ID-ene, eller flytt den tilbake. eAdm vil ikke opprette den på nytt. |
|
|
Malen angav ikke noe mappenavn eller en numerisk gruppe-ID for en ny bruker. |
Kartlegg begge målene. Mappenavnet må stemme nøyaktig overens med CMG. |
|
|
Personen har ikke noe eAdm-brukernavn. |
Gi dem et brukernavn før de går inn i CMG-malen. |
|
Det ble ryddet et område i CMG |
En oppdatering sendte en tom kartlagt verdi. En tom e-post tømmer e-postkanalen. En tom «misc»-verdi tømmer det aktuelle «misc»-feltet. |
Kartlegg målet bare når eAdm skal ha ansvaret for det. |
|
|
To hovedposter i CMG har samme brukernavn. |
Rett opp duplikatet i CMG. eAdm beholder den ene av dem. |
|
Et avvist CMG-anrop (HTTP 400–499, unntatt 401) |
CMG avviste denne brukeren. Endringen er merket som fullført og blir ikke forsøkt på nytt. |
Les feilmeldingen i objektloggen, rett opp dataene og foreta en ny endring, slik at en senere åpningskjøring sender den på nytt. |
|
HTTP 401 etter oppdatering, HTTP 5xx eller en nettverksfeil |
Anropet ble ikke gjennomført. Endringen er fortsatt under behandling. |
Ved neste åpne runde prøves det på nytt. |
