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:
-
Telenor har tillhandahållit VpAPI:s bas-URL, klient-ID, klienthemlighet och ett klientcertifikat. Certifikatet måste vara ett
.p12eller.pfxmed en privat nyckel. A.cerutan en privat nyckel kan den inte användas. URL:en ser ut så här:https://<host>/VpAPIoch är endast tillgänglig från kundens nätverk. -
Servern som kör eAdm.Client kan nå VpAPI.
-
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:
-
eAdm.Client loggar in på VpAPI och hämtar CMG-användarna.
-
När inkommande flöden har konfigurerats kopierar eAdm tillbaka uppgifterna om ”Mobil” och ”Tillägg” från dessa användare till eAdm.
-
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 |
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.
-
Importera
.p12till Lokal dator → Personlig (Cert:\LocalMachine\My). -
Ge det konto som kör eAdm.Client behörighet att läsa certifikatets privata nyckel.
-
Kopiera certifikatets fingeravtryck. Mellanslag ignoreras. Spara endast fingeravtrycket vid CMG-synkroniseringen.
-
Ta bort
.p12frå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 |
|
Klient-ID |
Ja |
VpAPI-klient-ID. |
|
Klienthemlighet |
Ja |
VpAPI-klienthemlighet. |
|
CMG-certifikatets tumavtryck |
Ja |
Certifikatets tumavtryck i |
|
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) |
|
Alltid |
Lämnas som den är. Detta är matchningsnyckeln. |
|
Förnamn |
|
Skickat. Återgår till personens förnamn. |
Skickades när mallen kopplade det. |
|
Efternamn |
|
Skickat. Återgår till efternamnet. |
Skickades när mallen kopplade det. |
|
E-post |
|
Skickas när adressfältet inte är tomt. |
Skickas när den mappas. Ett tomt värde rensar kanalen. |
|
Titel |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
Obligatoriskt. Exakt mappnamn. |
Lämnas oförändrat. |
|
Kundgrupp-ID |
|
Obligatoriskt. Ett heltal. |
Lämnas oförändrat. |
|
Ändra av |
|
Utelämnas om fältet är tomt. |
Utelämnas om fältet är tomt. |
|
Synlig i CMGWeb |
|
|
Skickas endast när den har kartlagts. |
|
Synlig i CMG-katalogen |
|
|
Skickas endast när den har kartlagts. |
|
Huvudpost |
|
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
hiddenMobileNrochhiddenExtensionNrtilltrue. 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
VisibleInCMGWebochVisibleInCMGDirectorytilltruenär nya användare ska visas på CMG:s webbplats och i katalogen. En skapning utan tilldelning skickarfalse. -
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 |
|---|---|
|
|
Förnamn |
|
|
Efternamn |
|
|
E-post |
|
|
Titel |
|
[REFERENS;DisplayName;UserId;1;[Manager]] |
Chef |
|
[Postadress] |
Besöksadress |
|
[Postnummer] |
Postnummer |
|
Stad |
Ort |
|
[Kostnadsställe] |
Kostnadsställe |
|
|
OrgName |
|
|
Kundgrupp-ID |
|
|
Ändra av |
|
|
Synlig i CMGWeb |
|
|
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 |
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. |
|
|
Tumavtrycket saknas, är felaktigt inmatat eller delas av två certifikat. Certifikatarkivet är |
Importera om |
|
|
A |
Importera |
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
