re:ADM kan tjene sig selv hjem på et år. Bestil inden den 18. december og få 20 % rabat www.identum.no/re-adm

Telenor CMG

Dette dokument beskriver integrationen mellem eAdm og Telenor CMG. Integrationen automatiserer administrationen af brugerkonti i CMG ved at synkronisere brugeroplysninger fra eAdm.

Oversigt

CMG er Telenors telefoni- og oplysningstjeneste. Telefonister og kolleger bruger den til at finde personer, se, hvordan man kan kontakte dem, og se, hvilken del af organisationen de tilhører. Den omfatter også telefonsvarer, en brugerportal og aktivitetsstyring.

Denne integration automatiserer brugeradministrationen fra dit HRM-system til det pågældende brugerregister.

I nedenstående eksempler anvendes Fableton Kommune, organisations-id NO999000001. Fableton er et fiktivt sted.


Forudsætninger

Bekræft følgende, inden du konfigurerer integrationen:

  1. Telenor har leveret VpAPI-basis-URL’en, klient-id’et, klienthemmeligheden og et klientcertifikat. Certifikatet skal være et .p12 eller .pfx med en privat nøgle. A .cer uden en privat nøgle kan den ikke bruges. URL’en ser således ud: https://<host>/VpAPI og kan kun tilgås fra kundens netværk.

  2. Den server, der kører eAdm.Client, har adgang til VpAPI.

  3. Et dagligt synkroniseringsskridt i eAdm skal mindst én gang finde sted før kl. 08.00 eller kl. 17.00 eller senere svensk tid, eller også skal weekendsynkronisering være aktiveret. Oprettelse, opdatering og sletning i CMG foregår udelukkende uden for kontortiden.


Sådan fungerer integrationen

Ved hver løbetur, herunder løbeture i arbejdstiden:

  1. eAdm.Client logger ind på VpAPI og henter CMG-brugerne.

  2. eAdm kopierer oplysningerne om »Mobile« og »Extension« fra disse brugere tilbage til eAdm, når indgående dataflows er konfigureret.

  3. eAdm registrerer alle udestående profilændringer.

Funktionerne »Opret«, »Opdater« og »Slet« udføres kun, når det pågældende trin udføres uden for kontortiden. Flere redigeringer af den samme bruger i løbet af dagen samles til ét CMG-kald. Det er den seneste værdi for hvert felt, der sendes. En senere sletning fra skabelonen har forrang for tidligere redigeringer.

Når eAdm har videresendt opkaldene til klienten, afsluttes disse opkald, selvom klokken derefter går ind i kontortiden. Klokkeslættet aflæses, når eAdm forbereder opkaldene – det vil sige, når trinnet udføres – og ikke når synkroniseringen blev sat i kø.

En daglig kørsel med ventende ændringer afsluttes uden problemer. Meddelelsen om synkroniseringstrinnet lyder: CMG changes are waiting for the next open run. I klientloggen står der CMG returned no operations. Ændringerne ligger og venter. De er ikke blevet kasseret.

Søgning, oprettelse, opdatering og sletning

eAdm gemmer CMG-bruger-id’et for personen efter en vellykket oprettelse og når der oprettes en forbindelse til en eksisterende CMG-bruger. Selve brugernavnet er altid eAdm-brugernavnet. Det er ikke et mål for eksportskabelonen. Det skrives til CMG som et »misc«-element. { miscNo: 8, miscText: "<username>" }.

Når

Hvad sker der?

Personen har endnu ikke et CMG-id, og en hovedbruger af CMG har allerede det pågældende brugernavn i misc 8

eAdm knytter det pågældende CMG-id og sender en opdatering for de tilknyttede felter. Dette er sammenfletningen.

Personen har endnu ikke et CMG-id, og ingen af de primære CMG-brugere har det pågældende brugernavn

eAdm opretter en CMG-bruger. OrgName og et numerisk CustomerGroupId er obligatoriske felter.

Personen har et CMG-id, og denne bruger er stadig på den hentede liste

eAdm opdaterer de tilknyttede felter.

Personen fjernes fra eksportskabelonen, mens CMG-brugeren stadig er på listen over hentede poster

eAdm sletter CMG-brugeren.

Personen har et CMG-id, men denne bruger er ikke på den hentede liste

eAdm lader CMG være i fred. Det opretter ikke en erstatning og sender ikke en sletningsanmodning.

To af de største CMG-brugere har det samme brugernavn i misc 8

eAdm gemmer den første og logger Duplicate Unikt AD.

En CMG-bruger, som eAdm allerede har slettet, eller som ikke længere er medlem af en kundegruppe – som det fremgår af dette trin – oprettes ikke igen, når personen vender tilbage til eksportskabelonen.

Kun hovedposterne anvendes til sammenligning af brugernavne. Udtrækket indeholder dog stadig andre poster.

En oprettelse, der når frem til CMG og derefter mister svaret, bliver hentet ved et senere åbent forløb, hvis der stadig er en ny ændring i kø, og brugernavnet stemmer overens: eAdm knytter den eksisterende bruger til i stedet for at oprette en ny.

Importmappen

»Create« placerer brugeren i den mappe, der har navnet OrgName, inden for den kundegruppe, der er navngivet som Kundegruppe-ID. Brug din særlige importmappe, f.eks.FABLETON MUNICIPALITY\Import-AD.

Så længe brugeren befinder sig i den pågældende mappe, gemmer CMG kun brugernavnet (misc 8). eAdm sender ikke titel, leder, besøgsadresse, postnummer, lokalitet eller omkostningscenter. Navn, e-mail, synlighed og de øvrige felter, der ikke hører under »misc«, sendes stadig.

eAdm sender aldrig en ny mappe eller en ny kundegruppe efter oprettelsen. Dette forudsætter, at en medarbejder i CMG flytter brugeren ud af importmappen. Ved den næste synkronisering uden for kontortiden sendes der så en opdatering med de diverse værdier, der blev gemt. En bruger, der forbliver i importmappen, modtager aldrig disse værdier, og senere ændringer af dem sendes først, når brugeren flyttes. Denne opdatering bevarer mappen og kundegruppen, som de er i CMG.

Den kørsel, der opretter brugeren, sender ikke også denne efterfølgende opdatering. CMG-læsningen i den pågældende kørsel fandt sted før oprettelsen.

Kontortider

Telenor kræver, at oprettelser, opdateringer og sletninger i CMG foretages uden for kontortiden. eAdm udsætter disse skrivninger for at opfylde dette krav. Tidsvinduet er baseret på svensk lokal tid (Europe/Stockholm), inklusive sommertid. Det er samme tidszone som i Norge.

Når

Læs CMG, skriv til mobilen og send udvidelsen tilbage

Opret, opdater, slet i CMG

Hverdage kl. 08.00–16.59

Ja

Afholdt

På hverdage før kl. 08.00 og fra kl. 17.00

Ja

Sendt

Lørdag og søndag

Ja

Sendes, når en synkronisering kører

eAdm starter ikke en ekstra synkronisering, når klokken bliver 17:00. Der skal køre mindst én synkronisering, der omfatter CMG-trinnet, uden for kontortiden. Indtast dette tidspunkt i den daglige tidsplan for synkroniseringstrinnet.

En tidsplan, der udelukkende ligger inden for hverdage kl. 08:00–17:00, skriver aldrig til CMG. Kørsler i weekenden skriver kun til CMG, hvis weekendsynkronisering er aktiveret for det pågældende trin.

Når man nulstiller en importfil, fjernes de ikke-afsendte CMG-ændringer, der hører til den pågældende fil.


Opsætning

Installer certifikatet

Dette skal udføres på den server, hvor eAdm.Client kører, i den computergruppe, som klienttjenestekontoen har læseadgang til.

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

  2. Giv den konto, der kører eAdm.Client, tilladelse til at læse certifikatets private nøgle.

  3. Kopier certifikatets fingeraftryk. Mellemrum ignoreres. Gem kun fingeraftrykket i CMG-synkroniseringstrinnet.

  4. Slet .p12 fra disken. Adgangskoden gemmes ikke i eAdm.

Klienten slår dette fingeraftryk op, kræver præcis ét match og fremviser certifikatet ved hvert VpAPI-kald, herunder ved login. Manglende privatnøgle, et tomt fingeraftryk eller mere end ét match afbryder trinnet, inden der foretages et CMG-kald.

Trinparametre

Parameter

Påkrævet

Hvad skal der indtastes?

API-URL

Ja

VpAPI-basis-URL fra Telenor, uden efterfølgende sti /VpAPI.

Kunde-ID

Ja

VpAPI-klient-id.

Klienthemmelighed

Ja

VpAPI-klientnøgle.

CMG-certifikatets fingeraftryk

Ja

Certifikatets fingeraftryk i LocalMachine\My.

CMG-kundegruppe-id’er

Nej

Kundegruppe-id’er adskilt med komma eller semikolon, der skal læses. Hvis feltet er tomt, læses alle grupper, som API-kontoen har adgang til. En værdi uden heltal afbryder trinnet, før der foretages et CMG-kald.

Eksporter skabelon

Kortlæg eksportmålene fra eAdm til felterne i CMG API.

Eksportmål

CMG API-felt

Ved oprettelse

I en senere opdatering

Brugernavn (altid eAdm-brugernavnet)

miscNo: 8

Altid

Lades stå som den er. Dette er nøglen til kampen.

Fornavn

firstName

Sendt. Falder tilbage til personens fornavn.

Sendt, da skabelonen tilknyttede det.

Efternavn

lastName

Sendt. Falder tilbage til efternavnet.

Sendt, da skabelonen tilknyttede det.

E-mail

addressItems kanal E-Mail

Sendes, når adressen ikke er tom.

Sendes, når der kortlægges. En tom værdi rydder kanalen.

Titel

miscNo: 15

Udsat. Sendes ikke, mens brugeren befinder sig i importmappen.

Sendes, når der oprettes en kort. Bevares, så længe brugeren stadig befinder sig i importmappen. En tom værdi nulstiller den.

Leder

miscNo: 13

Udsat. Sendes ikke, mens brugeren befinder sig i importmappen.

Sendes, når der oprettes en kort. Bevares, så længe brugeren stadig befinder sig i importmappen. En tom værdi nulstiller den.

Besøgsadresse

miscNo: 3

Udsat. Sendes ikke, mens brugeren befinder sig i importmappen.

Sendes, når der oprettes en kort. Bevares, så længe brugeren stadig befinder sig i importmappen. En tom værdi nulstiller den.

Postnummer

miscNo: 5

Udsat. Sendes ikke, mens brugeren befinder sig i importmappen.

Sendes, når der oprettes en kort. Bevares, så længe brugeren stadig befinder sig i importmappen. En tom værdi nulstiller den.

Lokalitet

miscNo: 7

Udsat. Sendes ikke, mens brugeren befinder sig i importmappen.

Sendes, når der oprettes en kort. Bevares, så længe brugeren stadig befinder sig i importmappen. En tom værdi nulstiller den.

Omkostningscenter

miscNo: 2

Udsat. Sendes ikke, mens brugeren befinder sig i importmappen.

Sendes, når der oprettes en kort. Bevares, så længe brugeren stadig befinder sig i importmappen. En tom værdi nulstiller den.

OrgName

orgItems[].orgName

Påkrævet. Det nøjagtige mappenavn.

Forbliver uændret.

Kundegruppe-ID

customerGroupId

Obligatorisk. Et heltal.

Forbliver uændret.

Ændring af

changeBy

Udelades, hvis feltet er tomt.

Udelades, hvis feltet er tomt.

Synlig på CMGWeb

visibleInCMGWeb

false når den ikke er kortlagt.

Sendes kun, når der er oprettet en kort.

Synlig i CMG-mappen

visibleInCMGDirectory

false når den ikke er kortlagt.

Sendes kun, når der er oprettet en kort.

Hovedpost

mainRecord

Udelades, når der ikke er tilknyttet et kort. CMG behandler derefter brugeren som en hovedpost.

Sendes kun, når der er oprettet en kort.

OrgName og Kundegruppe-ID bruges kun ved oprettelse. Hvis den eneste ændring for en person vedrører et af disse to felter, sendes der intet til CMG. Ændringen markeres som gennemført, og synkroniseringsloggen angiver had no mapped fields to update. En senere ændring af et kortlagt felt sendes som normalt.

Desuden:

  • Opret sæt hiddenMobileNr og hiddenExtensionNr til true. I senere opdateringer forbliver begge markeringer, som de er i CMG. Tallene kopieres stadig tilbage til eAdm, selvom de er skjult i CMG.

  • Kort VisibleInCMGWeb og VisibleInCMGDirectory til true hvornår nye brugere skal vises på CMG-websiden og i brugeroversigten. En oprettelse uden tilknytning sender false.

  • Nøgleordene bibeholdes, da CMG allerede har dem.

  • SMS og alle andre adressekanaler end e-mail bevares i den form, som CMG har gemt dem.

  • eAdm sender hverken mobilnummer, lokalnummer eller kalendersynkronisering til CMG.

Eksempel på kortlægning af Fableton

Værdi i skabelonen

Eksportmål

[GivenName]

Fornavn

[Surname]

Efternavn

[Email]

E-mail

[Title]

Titel

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

Leder

[Postadresse]

Besøgsadresse

[Postnummer]

Postnummer

By

Lokalitet

[Omkostningscenter]

Omkostningscenter

FABLETON MUNICIPALITY\Import-AD

OrgName

100

Kundegruppe-ID

eAdm

Ændring af

true

Synlig på CMGWeb

true

Synlig i CMG-mappen

For OrgName, skal du bruge det nøjagtige mappenavn fra CMG, inklusive store og små bogstaver. Et andet regelsæt med en bogstavelig CustomerGroupId og et regelsæt, der ikke overlapper det første, kan placere en anden gruppe af personer i en anden kundegruppe.

Mobil og udvidelse tilbage til eAdm

I samme skabelon, Mobil og Udvidelse er indgående kilder. Indstil hver enkelt til det eAdm-felt, der skal gemme CMG-nummeret. Udtrykket for den indgående strøm kan tilføje et præfiks: eAdm erstatter CMG-nummeret med NewValue i det udtryk.

Andre indgående kilder i dette trin ignoreres. Titlen og resten af profilen forbliver tilknyttet den udgående skabelon.

Writeback udføres ved hver synkronisering, herunder også i kontortiden. Det gælder kun for hovedposter, som eAdm allerede har knyttet til et CMG-id.


Testning

Kør testen på kundens server, inden der foretages nogen live-skrivninger. I testtilstand læses CMG, operationerne opbygges, som om skrivevinduet var åbent, og der foretages ingen ændringer i CMG. Desuden springes tilbageskrivningen til mobilen og udvidelsen over.

eadm.client.exe exportcmg NO999000001 test

Klientloggen indeholder CMG test: N operations, none executed. og én linje pr. handling. Ved »Bekræft« oprettes der filer i importmappen, ved »Flet« angives det korrekte brugernavn, og ingen, der skal forblive i CMG, er angivet som »Slet«.

Den planlagte synkronisering udfører kommandoen »live« uden test:

eadm.client.exe exportcmg NO999000001

Første brugergruppe ved idriftsættelsen

Den første CMG-eksport bør være en fuld eksport. Kør den én gang, når »Eksporter CMG« er det næste trin i synkroniseringscyklussen. Efterfølgende kørsler skal være delta-eksport.

eadm.client.exe exportcmg NO999000001 full test
eadm.client.exe exportcmg NO999000001 full

full test giver et overblik over hele populationen og ændrer intet. full tildeler eksportskabelonen til alle personer, som regelsættet matcher, og sætter en oprettelse eller sammenlægning i kø for hver enkelt. Ved en kørsel på hverdage mellem kl. 08.00 og 17.00 svensk tid gemmes rækkerne, og trinnet afsluttes med CMG changes are waiting for the next open run. Den næste planlagte kørsel uden for dette tidsvindue sender dem af sted.

Løb ikke full en anden gang, mens der stadig er ændringer, der skal behandles. Den sætter en ekstra kopi af hver af dem i kø. Knappen »Eksporter« i synkroniseringstrinnet kalder ikke CMG; den sætter blot den samme gruppe i kø til den næste synkronisering.

Hvis du vil prøve igen inden afsendelsen, skal du kun slette trinnet »Eksporter CMG«. Hvis du sletter hele synkroniseringscyklussen, slettes de ikke-afsendte CMG-ændringer for den pågældende importfil.


Fejlfinding

Symptom

Sandsynlig årsag

Handling

Synkroniseringsmeddelelse CMG changes are waiting for the next open run.

Løbet fandt sted på en hverdag mellem kl. 08.00 og 17.00.

Vent med synkroniseringen, indtil det ligger uden for dette tidsvindue. Kontroller, at der er afsat tid til synkroniseringstrinnet.

CMG ændrer sig aldrig, og der er heller ingen daglige meddelelser

Der udføres ingen synkronisering, mens vinduet er åbent, eller hvis trin 1100 udføres før delta-fortsættelsespunktet.

Tilføj et tidspunkt om aftenen, om natten eller i weekenden i »Synkronisering«. Flyt trin 1100 nedad, så deltaerne omfatter det.

Could not find certificate or found more than one

Tommelfingeraftryk mangler, er indtastet forkert, eller to certifikater deler det. Certifikatarkivet er LocalMachine\My.

Importer på ny .p12 og indstille et enkelt fingeraftryk.

CMG certificate ... has no private key

A .cer er blevet importeret, eller servicekontoen kan ikke læse nøglen.

Importer .p12 og tildel eAdm.Client-kontoen læseadgang til den private nøgle.

Brugeropkald mislykkes med fejlkode 401, men det kan stadig lykkes at logge ind

Certifikatet blev ikke fremlagt, eller klient-id’et eller den hemmelige nøgle blev afvist.

Kontroller tommelfingeraftrykket, klient-id’et og klienthemmeligheden. Klienten forsøger at logge ind én gang til.

For nye brugere vises kun brugernavnet i CMG

Brugeren befinder sig stadig i importmappen. eAdm sender ikke de øvrige felter, så længe brugeren befinder sig der.

Flyt brugeren ud af importmappen i CMG. Ved den næste åbne kørsel sendes de diverse værdier, der blev gemt. Hvis brugeren forbliver der, sendes disse værdier aldrig.

Brugeren blev flyttet i CMG, og eAdm er holdt op med at opdatere oplysningerne om vedkommende

Brugeren har forladt alle de kundegrupper, der nævnes i dette trin.

Føj den pågældende gruppe til CMG-kundegruppe-id’erne, eller flyt dem tilbage. eAdm vil ikke oprette dem på ny.

OrgName is required for create eller CustomerGroupId is required for create

Skabelonen angav hverken et mappenavn eller et numerisk gruppe-id for en ny bruger.

Kortlæg begge mål. Mappenavnet skal stemme nøjagtigt overens med CMG.

UserName is required

Personen har ikke noget eAdm-brugernavn.

Giv dem et brugernavn, inden de går ind i CMG-skabelonen.

Der blev ryddet et område i CMG

En opdatering sendte en tom kortlagt værdi. En tom e-mail rydder e-mail-kanalen. En tom værdi i feltet »Diverse« rydder dette felt.

Kortlæg kun målet, når eAdm skal være ansvarlig for det.

Duplicate Unikt AD i loggen

To af CMG’s hovedposter har det samme brugernavn.

Ret duplikatet i CMG. eAdm beholder den ene af dem.

Et afvist CMG-opkald (HTTP 400–499, bortset fra 401)

CMG afviste den pågældende bruger. Ændringen er markeret som udført og forsøges ikke igen.

Læs fejlmeddelelsen i objektets historik, ret dataene, og foretag en ny ændring, så en senere åbningskørsel sender den igen.

HTTP 401 efter opdatering, HTTP 5xx eller en netværksfejl

Opkaldet blev ikke gennemført. Ændringen er stadig under behandling.

Det næste åbne løb forsøger igen.

Senest opdateret: