re:ADM kan betala sig själv på ett år. Beställ senast den 18 december och få 20 % rabatt www.identum.no/re-adm

Telenor CMG

I detta dokument beskrivs integrationen mellan eAdm och Telenor CMG. Integrationen automatiserar hanteringen av användarkonton i CMG genom att synkronisera användarinformation från eAdm.

Översikt

CMG är Telenors telefoni- och nummertjänst. Telefonväxlarpersonal och övriga medarbetare använder den för att hitta personer, se hur man når dem och ta reda på vilken del av organisationen de tillhör. Tjänsten omfattar även röstbrevlåda, en användarportal och aktivitetshantering.

Denna integration automatiserar användarhanteringen från ditt HRM-system till den katalogen.

I exemplen nedan används Fableton kommun, organisations-id NO999000001. Fableton är en fiktiv ort.


Förkunskapskrav

Kontrollera följande innan du konfigurerar integrationen:

  1. Telenor har tillhandahållit VpAPI:s bas-URL, klient-ID, klienthemlighet och ett klientcertifikat. Certifikatet måste vara ett .p12 eller .pfx med en privat nyckel. A .cer utan en privat nyckel kan den inte användas. URL:en ser ut så här: https://<host>/VpAPI och är endast tillgänglig från kundens nätverk.

  2. Servern som kör eAdm.Client kan nå VpAPI.

  3. Ett dagligt synkroniseringssteg i eAdm sker minst en gång före kl. 08.00 eller kl. 17.00 eller senare svensk tid, eller så är helgsynkronisering aktiverad. Funktionerna för att skapa, uppdatera och ta bort i CMG körs endast utanför kontorstid.


Så här fungerar integrationen

Vid varje löprunda, även under kontorstid:

  1. eAdm.Client loggar in på VpAPI och hämtar CMG-användarna.

  2. När inkommande flöden har konfigurerats kopierar eAdm tillbaka uppgifterna om ”Mobil” och ”Tillägg” från dessa användare till eAdm.

  3. eAdm registrerar alla väntande profiländringar.

Åtgärderna ”Skapa”, ”Uppdatera” och ”Ta bort” utförs endast när samma steg körs utanför kontorstid. Flera ändringar av samma användare under dagen sammanförs till ett enda CMG-anrop. Det senaste värdet för varje fält är det som skickas. En senare borttagning från mallen har företräde framför tidigare ändringar.

När eAdm har vidarebefordrat samtalen till klienten avslutas dessa samtal även om klockan därefter går in i kontorstid. Klocktiden avläses när eAdm förbereder samtalen, vilket är när steget körs, inte när synkroniseringen lades i kö.

En dagtidskörning med väntande ändringar avslutas framgångsrikt. Meddelandet för synkroniseringssteget lyder CMG changes are waiting for the next open run. I klientloggen står det CMG returned no operations. Förändringarna väntar. De har inte förkastats.

Matchning, skapande, uppdatering och radering

eAdm lagrar CMG-användar-ID:t för personen efter en lyckad skapning och när en befintlig CMG-användare kopplas till personen. Användarnamnet i sig är alltid eAdm-användarnamnet. Det ingår inte i exportmallen. Det skrivs in i CMG som ett övrigt objekt. { miscNo: 8, miscText: "<username>" }.

När

Vad händer?

Den här personen har ännu inget CMG-ID, och en huvudanvändare av CMG har redan det användarnamnet i ”misc 8”

eAdm kopplar samman det CMG-id:t och skickar en uppdatering för de mappade fälten. Detta är sammanfogningen.

Personen har ännu inget CMG-ID, och ingen huvudanvändare på CMG har det användarnamnet

eAdm skapar en CMG-användare. OrgName och ett numeriskt CustomerGroupId är obligatoriska uppgifter.

Personen har ett CMG-ID, och den användaren finns fortfarande med i den hämtade listan

eAdm uppdaterar de mappade fälten.

Personen tas bort från exportmallen, medan CMG-användaren fortfarande finns kvar i den hämtade listan

eAdm raderar CMG-användaren.

Personen har ett CMG-ID, men den användaren finns inte med i den hämtade listan

eAdm lämnar CMG ifred. Det skapar ingen ersättning och skickar inte någon raderingsbegäran.

Två av CMG:s huvudanvändare har samma användarnamn i misc 8

eAdm behåller den första och loggar Duplicate Unikt AD.

En CMG-användare som eAdm redan har raderat, eller som inte längre ingår i den kundgrupp som anges i detta steg, skapas inte på nytt när personen återgår till exportmallen.

Endast huvudposter används för att jämföra användarnamn. Läsningen omfattar fortfarande andra poster.

En skapelse som når CMG och sedan förlorar svaret hämtas vid en senare öppen körning om en ny ändring fortfarande väntar på behandling och användarnamnet stämmer överens: eAdm kopplar den befintliga användaren istället för att skapa en ny.

Importmappen

Med funktionen ”Skapa” placeras användaren i den mapp som anges med namnet OrgName, inom den kundgrupp som benämns Kundgrupp-ID. Använd din särskilda importmapp, t.ex.FABLETON MUNICIPALITY\Import-AD.

Så länge användaren befinner sig i den mappen lagrar CMG endast användarnamnet (misc 8). eAdm skickar inte titel, chef, besöksadress, postnummer, ort eller kostnadsställe. Namn, e-postadress, synlighet och övriga fält som inte tillhör kategorin ”misc” skickas fortfarande.

eAdm skickar aldrig en ny mapp eller en ny kundgrupp efter att de har skapats. Detta förutsätter att någon i CMG flyttar användaren ut ur importmappen. Vid nästa synkronisering utanför kontorstid skickas då en uppdatering med de övriga värdena som har sparats. En användare som stannar kvar i importmappen får aldrig dessa värden, och senare ändringar av dem skickas inte förrän användaren har flyttats. Den uppdateringen lämnar mappen och kundgruppen i det skick som CMG har dem.

Den körning som skapar användaren skickar inte heller denna uppföljande uppdatering. CMG-läsningen under den körningen ägde rum innan skapandet.

Kontorstider

Telenor kräver att skapande, uppdatering och radering i CMG sker utanför kontorstid. eAdm skjuter upp dessa skrivåtgärder för att uppfylla detta krav. Tidsfönstret baseras på svensk lokal tid (Europe/Stockholm), inklusive sommartid. Det är samma tidszon som i Norge.

När

Läs CMG, skriv till mobilen och skicka tillbaka till tillägget

Skapa, uppdatera, ta bort i CMG

Vardagar kl. 08.00–16.59

Ja

Hölls

Vardagar före kl. 08.00 och från kl. 17.00

Ja

Skickat

Lördag och söndag

Ja

Skickas när en synkronisering körs

eAdm startar inte någon extra synkronisering när klockan blir 17:00. Minst en synkronisering som inkluderar CMG-steget måste köras utanför kontorstiden. Ange den tiden i det dagliga schemat för synkroniseringssteget.

Ett schema som helt och hållet ligger inom vardagar kl. 08:00–17:00 skriver aldrig till CMG. Helgkörningar skriver till CMG endast om helgsynkronisering är aktiverad för det steget.

Om du återställer en importfil tas de icke-skickade CMG-ändringarna som hör till den filen bort.


Inställningar

Installera certifikatet

Gör detta på den server där eAdm.Client körs, i den datormapp som klienttjänstens konto har läsbehörighet till.

  1. Importera .p12 till Lokal dator → Personlig (Cert:\LocalMachine\My).

  2. Ge det konto som kör eAdm.Client behörighet att läsa certifikatets privata nyckel.

  3. Kopiera certifikatets fingeravtryck. Mellanslag ignoreras. Spara endast fingeravtrycket vid CMG-synkroniseringen.

  4. Ta bort .p12 från hårddisken. Lösenordet sparas inte i eAdm.

Klienten söker upp det digitala avtrycket, kräver exakt en träff och visar upp certifikatet vid varje VpAPI-anrop, inklusive inloggning. Om den privata nyckeln saknas, om det digitala avtrycket är tomt eller om det finns fler än en träff avbryts steget innan något CMG-anrop görs.

Stegparametrar

Parameter

Obligatoriskt

Vad ska man ange

API-URL

Ja

VpAPI-bas-URL från Telenor, utan någon efterföljande sökväg /VpAPI.

Klient-ID

Ja

VpAPI-klient-ID.

Klienthemlighet

Ja

VpAPI-klienthemlighet.

CMG-certifikatets tumavtryck

Ja

Certifikatets tumavtryck i LocalMachine\My.

CMG-kundgrupps-ID:n

Nej

Kundgrupps-ID:n som ska läsas in, åtskilda med kommatecken eller semikolon. Om fältet lämnas tomt läses alla grupper in som API-kontot har åtkomst till. Ett värde som inte innehåller något heltal avbryter steget innan något CMG-anrop utförs.

Exportera mall

Mappa eAdm-exportmål till CMG API-fält.

Exportmål

CMG API-fält

Vid skapande

I en senare uppdatering

Användarnamn (alltid eAdm-användarnamnet)

miscNo: 8

Alltid

Lämnas som den är. Detta är matchningsnyckeln.

Förnamn

firstName

Skickat. Återgår till personens förnamn.

Skickades när mallen kopplade det.

Efternamn

lastName

Skickat. Återgår till efternamnet.

Skickades när mallen kopplade det.

E-post

addressItems kanal E-Mail

Skickas när adressfältet inte är tomt.

Skickas när den mappas. Ett tomt värde rensar kanalen.

Titel

miscNo: 15

Hålls tillbaka. Skickas inte medan användaren befinner sig i importmappen.

Skickas när mappningen är klar. Behålls så länge användaren befinner sig i importmappen. Ett tomt värde rensar det.

Chef

miscNo: 13

Hålls tillbaka. Skickas inte medan användaren befinner sig i importmappen.

Skickas när mappningen är klar. Behålls så länge användaren befinner sig i importmappen. Ett tomt värde rensar det.

Besöksadress

miscNo: 3

Hålls tillbaka. Skickas inte medan användaren befinner sig i importmappen.

Skickas när mappningen är klar. Behålls så länge användaren befinner sig i importmappen. Ett tomt värde rensar det.

Postnummer

miscNo: 5

Hålls tillbaka. Skickas inte medan användaren befinner sig i importmappen.

Skickas när mappningen är klar. Behålls så länge användaren befinner sig i importmappen. Ett tomt värde rensar det.

Ort

miscNo: 7

Hålls tillbaka. Skickas inte medan användaren befinner sig i importmappen.

Skickas när mappningen är klar. Behålls så länge användaren befinner sig i importmappen. Ett tomt värde rensar det.

Kostnadsställe

miscNo: 2

Hålls tillbaka. Skickas inte medan användaren befinner sig i importmappen.

Skickas när mappningen är klar. Behålls så länge användaren befinner sig i importmappen. Ett tomt värde rensar det.

OrgName

orgItems[].orgName

Obligatoriskt. Exakt mappnamn.

Lämnas oförändrat.

Kundgrupp-ID

customerGroupId

Obligatoriskt. Ett heltal.

Lämnas oförändrat.

Ändra av

changeBy

Utelämnas om fältet är tomt.

Utelämnas om fältet är tomt.

Synlig i CMGWeb

visibleInCMGWeb

false när den inte är mappad.

Skickas endast när den har kartlagts.

Synlig i CMG-katalogen

visibleInCMGDirectory

false när den inte är mappad.

Skickas endast när den har kartlagts.

Huvudpost

mainRecord

Utelämnas när den inte är mappad. CMG behandlar då användaren som en huvudpost.

Skickas endast när den har kartlagts.

OrgName och Kundgrupp-ID används endast vid skapande. Om den enda ändringen för en person gäller något av dessa två mål skickas inget till CMG. Ändringen markeras som genomförd, och i synkroniseringsloggen står det had no mapped fields to update. En senare ändring av ett mappat fält skickas som vanligt.

Dessutom:

  • Skapa uppsättningar hiddenMobileNr och hiddenExtensionNr till true. I senare uppdateringar behålls båda flaggorna så som de är i CMG. Siffrorna kopieras fortfarande tillbaka till eAdm även när de är dolda i CMG.

  • Karta VisibleInCMGWeb och VisibleInCMGDirectory till true när nya användare ska visas på CMG:s webbplats och i katalogen. En skapning utan tilldelning skickar false.

  • Nyckelorden behålls som de är, eftersom CMG redan har dem.

  • SMS och alla andra adresskanaler än e-post behålls i det skick som CMG lagrade dem.

  • eAdm skickar inte mobilnummer, anknytning eller kalendersynkronisering till CMG.

Exempel på kartläggning för Fableton

Värde i mallen

Exportmål

[GivenName]

Förnamn

[Surname]

Efternamn

[Email]

E-post

[Title]

Titel

[REFERENS;DisplayName;UserId;1;[Manager]]

Chef

[Postadress]

Besöksadress

[Postnummer]

Postnummer

Stad

Ort

[Kostnadsställe]

Kostnadsställe

FABLETON MUNICIPALITY\Import-AD

OrgName

100

Kundgrupp-ID

eAdm

Ändra av

true

Synlig i CMGWeb

true

Synlig i CMG-katalogen

För OrgName, använd det exakta mappnamnet från CMG, inklusive stora och små bokstäver. En andra regeluppsättning, med en bokstavlig CustomerGroupId och en uppsättning regler som inte överlappar den första kan placera en annan grupp av personer i en annan kundgrupp.

Mobil och återanslutning till eAdm

I samma mall, Mobil och Förlängning är inkommande källor. Rikta in var och en mot det eAdm-fält som ska lagra CMG-numret. Uttrycket för det inkommande flödet kan lägga till ett prefix: eAdm ersätter CMG-numret med NewValue i det uttrycket.

Övriga inkommande källor i detta steg ignoreras. Titeln och resten av profilen tillhör fortfarande den utgående mallen.

Återställningen utförs vid varje synkronisering, även under kontorstid. Den gäller endast huvudposter som eAdm redan har kopplat till ett CMG-ID.


Testning

Kör testet på kundservern innan någon skrivning sker i produktion. I testläget läses CMG, transaktionerna byggs upp som om skrivfönstret vore öppet, och inga ändringar görs i CMG. Dessutom hoppas skrivningarna till mobila enheter och tillägg över.

eadm.client.exe exportcmg NO999000001 test

Klientloggen innehåller CMG test: N operations, none executed. och en rad per åtgärd. När man bekräftar skapas en fil i importmappen, sammanfogningar görs med rätt användarnamn, och ingen som ska finnas kvar i CMG anges som att raderas.

Den schemalagda synkroniseringen anropar kommandot ”live” utan test:

eadm.client.exe exportcmg NO999000001

Första populationen vid driftsättningen

Den första CMG-exporten bör vara en fullständig export. Kör den en gång, när ”Exportera CMG” är nästa steg i synkroniseringscykeln. Senare körningar ska vara deltakörningar.

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

full test ger en översikt över hela populationen utan att ändra någonting. full tilldelar exportmallen till alla personer som uppfyller reglerna och lägger till en skapande- eller sammanfogningsuppgift i kön för var och en. Vid en körning på vardagar mellan kl. 08.00 och 17.00 svensk tid sparas raderna och steget avslutas med CMG changes are waiting for the next open run. Nästa schemalagda körning utanför det tidsfönstret skickar dem.

Spring inte full en andra gång medan ändringarna fortfarande väntar på att genomföras. Den lägger till en andra kopia av var och en av dem i kön. Knappen ”Exportera” i synkroniseringssteget anropar inte CMG; den lägger endast till samma datauppsättning i kön inför nästa synkronisering.

Om du vill göra ett nytt försök innan du skickar ska du endast ta bort steget ”Exportera CMG”. Om du tar bort hela synkroniseringscykeln raderas de CMG-ändringar som inte har skickats för den aktuella importfilen.


Felsökning

Symptom

Trolig orsak

Åtgärd

Synkronisera meddelande CMG changes are waiting for the next open run.

Loppet ägde rum en vardag mellan kl. 08.00 och 17.00.

Vänta med synkroniseringen tills det inte längre ligger inom det tidsfönstret. Kontrollera att synkroniseringssteget har en sådan tidpunkt.

CMG förändras aldrig, och det finns inte heller något budskap under dagtid

Ingen synkronisering utförs medan fönstret är öppet, eller om steg 1100 utförs före delta-fortsättningspunkten.

Lägg till en tidpunkt på kvällen, natten eller helgen i synkroniseringen. Flytta steg 1100 nedåt så att delta-värdena inkluderar den.

Could not find certificate or found more than one

Tumavtrycket saknas, är felaktigt inmatat eller delas av två certifikat. Certifikatarkivet är LocalMachine\My.

Importera om .p12 och registrera ett enda tumavtryck.

CMG certificate ... has no private key

A .cer har importerats, eller så kan tjänstekontot inte läsa nyckeln.

Importera .p12 och bevilja kontot eAdm.Client läsbehörighet för den privata nyckeln.

Användaransökningar misslyckas med felkod 401, men inloggningen kan ändå lyckas

Certifikatet visades inte upp, eller så avvisades klient-ID:t eller den hemliga nyckeln.

Kontrollera tumavtrycket, klient-ID:t och klienthemligheten. Klienten gör ett nytt inloggningsförsök en gång.

För nya användare visas endast användarnamnet i CMG

Användaren befinner sig fortfarande i importmappen. eAdm skickar inte de övriga övriga fälten så länge användaren befinner sig där.

Flytta användaren från importmappen i CMG. Vid nästa körning skickas de övriga värdena som sparats. Om användaren förblir där skickas dessa värden aldrig.

Användaren har flyttats i CMG och eAdm har slutat uppdatera uppgifterna för denne

Användaren har lämnat alla kundgrupper som nämns i detta steg.

Lägg till den gruppen i CMG:s kundgrupps-ID:n, eller flytta tillbaka dem. eAdm kommer inte att skapa dem på nytt.

OrgName is required for create eller CustomerGroupId is required for create

Mallen angav varken ett mappnamn eller ett numeriskt grupp-ID för en ny användare.

Kartlägg båda målen. Mappnamnet måste stämma exakt med CMG.

UserName is required

Personen har inget eAdm-användarnamn.

Ge dem ett användarnamn innan de går in i CMG-mallen.

En yta röjdes i CMG

En uppdatering skickade ett tomt mappat värde. Ett tomt e-postmeddelande rensar e-postkanalen. Ett tomt ”misc”-värde rensar det aktuella ”misc”-fältet.

Kartlägg målet endast när eAdm ska ansvara för det.

Duplicate Unikt AD i loggen

Två huvudposter i CMG har samma användarnamn.

Rätta till dubbletten i CMG. eAdm behåller den ena av dem.

Ett avvisat CMG-anrop (HTTP 400–499, utom 401)

CMG avvisade den användaren. Ändringen markeras som genomförd och försöks inte igen.

Läs felmeddelandet i objektets historik, korrigera uppgifterna och gör en ny ändring så att den skickas igen vid nästa öppningskörning.

HTTP 401 efter uppdatering, HTTP 5xx eller ett nätverksfel

Anropet gick inte igenom. Ändringen är fortfarande under behandling.

Nästa öppna körning görs på nytt.

Senast uppdaterad: