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:
-
Telenor har leveret VpAPI-basis-URL’en, klient-id’et, klienthemmeligheden og et klientcertifikat. Certifikatet skal være et
.p12eller.pfxmed en privat nøgle. A.ceruden en privat nøgle kan den ikke bruges. URL’en ser således ud:https://<host>/VpAPIog kan kun tilgås fra kundens netværk. -
Den server, der kører eAdm.Client, har adgang til VpAPI.
-
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:
-
eAdm.Client logger ind på VpAPI og henter CMG-brugerne.
-
eAdm kopierer oplysningerne om »Mobile« og »Extension« fra disse brugere tilbage til eAdm, når indgående dataflows er konfigureret.
-
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 |
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.
-
Importer
.p12til Lokal computer → Personlig (Cert:\LocalMachine\My). -
Giv den konto, der kører eAdm.Client, tilladelse til at læse certifikatets private nøgle.
-
Kopier certifikatets fingeraftryk. Mellemrum ignoreres. Gem kun fingeraftrykket i CMG-synkroniseringstrinnet.
-
Slet
.p12fra 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 |
|
Kunde-ID |
Ja |
VpAPI-klient-id. |
|
Klienthemmelighed |
Ja |
VpAPI-klientnøgle. |
|
CMG-certifikatets fingeraftryk |
Ja |
Certifikatets fingeraftryk i |
|
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) |
|
Altid |
Lades stå som den er. Dette er nøglen til kampen. |
|
Fornavn |
|
Sendt. Falder tilbage til personens fornavn. |
Sendt, da skabelonen tilknyttede det. |
|
Efternavn |
|
Sendt. Falder tilbage til efternavnet. |
Sendt, da skabelonen tilknyttede det. |
|
|
|
Sendes, når adressen ikke er tom. |
Sendes, når der kortlægges. En tom værdi rydder kanalen. |
|
Titel |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
Påkrævet. Det nøjagtige mappenavn. |
Forbliver uændret. |
|
Kundegruppe-ID |
|
Obligatorisk. Et heltal. |
Forbliver uændret. |
|
Ændring af |
|
Udelades, hvis feltet er tomt. |
Udelades, hvis feltet er tomt. |
|
Synlig på CMGWeb |
|
|
Sendes kun, når der er oprettet en kort. |
|
Synlig i CMG-mappen |
|
|
Sendes kun, når der er oprettet en kort. |
|
Hovedpost |
|
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
hiddenMobileNroghiddenExtensionNrtiltrue. I senere opdateringer forbliver begge markeringer, som de er i CMG. Tallene kopieres stadig tilbage til eAdm, selvom de er skjult i CMG. -
Kort
VisibleInCMGWebogVisibleInCMGDirectorytiltruehvornår nye brugere skal vises på CMG-websiden og i brugeroversigten. En oprettelse uden tilknytning senderfalse. -
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 |
|---|---|
|
|
Fornavn |
|
|
Efternavn |
|
|
|
|
|
Titel |
|
[REFERENCE;DisplayName;UserId;1;[Manager]] |
Leder |
|
[Postadresse] |
Besøgsadresse |
|
[Postnummer] |
Postnummer |
|
By |
Lokalitet |
|
[Omkostningscenter] |
Omkostningscenter |
|
|
OrgName |
|
|
Kundegruppe-ID |
|
|
Ændring af |
|
|
Synlig på CMGWeb |
|
|
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 |
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. |
|
|
Tommelfingeraftryk mangler, er indtastet forkert, eller to certifikater deler det. Certifikatarkivet er |
Importer på ny |
|
|
A |
Importer |
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
