re: ADM kan tjene seg inn på ett år. Bestill innen 18. desember og få 20 % rabatt www.identum.no/re-adm

Telenor CMG

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:

  1. Telenor har oppgitt VpAPI-base-URL-en, klient-ID, klienthemmelighet og et klientsertifikat. Sertifikatet må være et .p12 eller .pfx med en privat nøkkel. En .cer uten en privat nøkkel kan den ikke brukes. URL-adressen ser slik ut: https://<host>/VpAPI og er kun tilgjengelig fra kundens nettverk.

  2. Serveren som kjører eAdm.Client, har tilgang til VpAPI.

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

  1. eAdm.Client logger seg på VpAPI og henter CMG-brukerne.

  2. eAdm kopierer «Mobile» og «Extension» fra disse brukerne tilbake til eAdm når innkommende flyter er konfigurert.

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

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.

  1. Importer .p12 til Lokal datamaskin → Personlig (Cert:\LocalMachine\My).

  2. Gi kontoen som kjører eAdm.Client tillatelse til å lese sertifikatets private nøkkel.

  3. Kopier sertifikatets tommelavtrykk. Mellomrom blir ignorert. Lagre kun tommelavtrykket i CMG-synkroniseringstrinnet.

  4. Slett .p12 fra 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 /VpAPI.

Klient-ID

Ja

VpAPI-klient-ID.

Kundehemmelighet

Ja

VpAPI-klientnøkkel.

CMG-sertifikatets tommelavtrykk

Ja

Sertifikatets tommelavtrykk i LocalMachine\My.

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)

miscNo: 8

Alltid

Beholdes slik den er lagret. Dette er samsvaringsnøkkelen.

Fornavn

firstName

Sendt. Går tilbake til personens fornavn.

Ble sendt da malen tilordnet den.

Etternavn

lastName

Sendt. Går tilbake til etternavnet.

Ble sendt da malen tilordnet den.

E-post

addressItems kanal E-Mail

Sendes når adressefeltet ikke er tomt.

Sendes når det tilordnes. En tom verdi tømmer kanalen.

Tittel

miscNo: 15

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

miscNo: 13

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

miscNo: 3

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

miscNo: 5

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

miscNo: 7

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

miscNo: 2

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

orgItems[].orgName

Påkrevd. Nøyaktig mappenavn.

Forblir uendret.

Kundegruppe-ID

customerGroupId

Påkrevd. Et heltall.

Forblir uendret.

Endring av

changeBy

Utelates hvis feltet er tomt.

Utelates hvis feltet er tomt.

Synlig på CMG-nettsiden

visibleInCMGWeb

false når den ikke er tilordnet.

Sendes kun når det er kartlagt.

Synlig i CMG-katalogen

visibleInCMGDirectory

false når den ikke er tilordnet.

Sendes kun når det er kartlagt.

MainRecord

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 hiddenMobileNr og hiddenExtensionNr til true. 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 VisibleInCMGWeb og VisibleInCMGDirectory til true når nye brukere skal vises på CMG-nettsiden og i katalogen. En opprettelse uten tilknytning sender false.

  • 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

[GivenName]

Fornavn

[Surname]

Etternavn

[Email]

E-post

[Title]

Tittel

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

Leder

[Postadresse]

Besøksadresse

[Postnummer]

Postnummer

By

Sted

[Kostnadssted]

Kostnadssted

FABLETON MUNICIPALITY\Import-AD

OrgName

100

Kundegruppe-ID

eAdm

Endring av

true

Synlig på CMG-nettsiden

true

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

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.

Could not find certificate or found more than one

Tommelavtrykket mangler, er feilskrevet, eller to sertifikater deler det. Sertifikatlageret er LocalMachine\My.

Importer på nytt .p12 og registrere ett fingeravtrykk.

CMG certificate ... has no private key

A .cer ble importert, eller så har ikke tjenestekontoen tilgang til nøkkelen.

Importer .p12 og gi eAdm.Client-kontoen lesetilgang til den private nøkkelen.

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.

OrgName is required for create eller CustomerGroupId is required for create

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.

UserName is required

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.

Duplicate Unikt AD i loggen

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.

Sist oppdatert: