In dit document wordt de integratie tussen eAdm en Telenor CMG beschreven. Deze integratie automatiseert het beheer van gebruikersaccounts in CMG door gebruikersgegevens uit eAdm te synchroniseren.
Overzicht
CMG is de telefonie- en telefoongidsdienst van Telenor. Telefonisten en collega’s gebruiken het om mensen op te zoeken, te zien hoe ze te bereiken zijn en te zien tot welk onderdeel van de organisatie ze behoren. Het omvat ook voicemail, een portaal voor eindgebruikers en activiteitenbeheer.
Deze integratie automatiseert het gebruikersbeheer vanuit uw HRM-systeem naar die directory.
In de onderstaande voorbeelden wordt gebruikgemaakt van Gemeente Fableton, organisatie-ID NO999000001. Fableton is een fictieve plaats.
Vereisten
Controleer deze voordat je de integratie instelt:
-
Telenor heeft de VpAPI-basis-URL, de client-id, het client-geheim en een clientcertificaat verstrekt. Het certificaat moet een
.p12of.pfxmet een privésleutel. A.cerzonder privésleutel kan niet worden gebruikt. De URL ziet er als volgt uit:https://<host>/VpAPIen is alleen bereikbaar vanuit het netwerk van de klant. -
De server waarop eAdm.Client draait, heeft toegang tot VpAPI.
-
Een dagelijkse synchronisatiestap in eAdm vindt ten minste één keer plaats vóór 08:00 uur of om 17:00 uur of later (Zweedse tijd), of er is synchronisatie in het weekend ingeschakeld. Het aanmaken, bijwerken en verwijderen in CMG vindt uitsluitend buiten kantooruren plaats.
Hoe de integratie werkt
Bij elke rit, ook tijdens kantooruren:
-
eAdm.Client meldt zich aan bij VpAPI en leest de CMG-gebruikers op.
-
eAdm kopieert de gegevens ‘Mobile’ en ‘Extension’ van die gebruikers terug naar eAdm wanneer inkomende stromen zijn geconfigureerd.
-
eAdm registreert alle nog niet doorgevoerde profielwijzigingen.
De acties ‘Aanmaken’, ‘Bijwerken’ en ‘Verwijderen’ worden alleen uitgevoerd wanneer diezelfde stap buiten kantooruren plaatsvindt. Meerdere wijzigingen aan dezelfde gebruiker gedurende de dag worden samengevoegd tot één CMG-aanroep. De meest recente waarde van elk veld wordt verzonden. Een latere verwijdering uit het sjabloon heeft voorrang op eerdere wijzigingen.
Zodra eAdm de oproepen aan de klant heeft doorgegeven, worden die oproepen afgerond, zelfs als de klok daarna in de kantooruren terechtkomt. De klok wordt afgelezen op het moment dat eAdm de oproepen voorbereidt – dat is het moment waarop de stap wordt uitgevoerd – en niet op het moment dat de synchronisatie in de wachtrij werd geplaatst.
Een dagelijkse run met nog door te voeren wijzigingen is succesvol afgerond. Het bericht van de synchronisatiestap luidt: CMG changes are waiting for the next open run. In het klantlogboek staat CMG returned no operations. De veranderingen liggen op de loer. Ze worden niet terzijde geschoven.
Koppelen, aanmaken, bijwerken en verwijderen
eAdm slaat de CMG-gebruikers-ID op bij de persoon na een succesvolle aanmaak en wanneer er een koppeling wordt gemaakt met een bestaande CMG-gebruiker. De gebruikersnaam zelf is altijd de eAdm-gebruikersnaam. Dit is geen doel van een exportsjabloon. Het wordt in CMG opgeslagen als een ‘misc’-item. { miscNo: 8, miscText: "<username>" }.
|
Wanneer |
Wat gebeurt er? |
|---|---|
|
Deze persoon heeft nog geen CMG-ID, en een hoofdgebruiker van CMG heeft die gebruikersnaam al in 'misc 8' |
eAdm koppelt die CMG-ID en verstuurt een update voor de gekoppelde velden. Dit is de samenvoeging. |
|
Deze persoon heeft nog geen CMG-ID, en geen enkele hoofdgebruiker van CMG heeft die gebruikersnaam |
eAdm maakt een CMG-gebruiker aan. OrgName en een numerieke CustomerGroupId zijn verplicht. |
|
De persoon heeft een CMG-ID en die gebruiker staat nog steeds in de opgehaalde lijst |
eAdm werkt de gekoppelde velden bij. |
|
De persoon wordt uit het exportsjabloon verwijderd, terwijl de CMG-gebruiker nog steeds in de opgehaalde lijst staat |
eAdm verwijdert de CMG-gebruiker. |
|
De persoon heeft een CMG-ID, maar die gebruiker staat niet in de opgehaalde lijst |
eAdm laat CMG met rust. Het maakt geen vervangend item aan en verstuurt geen verwijderingsverzoek. |
|
Twee belangrijke CMG-gebruikers hebben dezelfde gebruikersnaam in misc 8 |
eAdm behoudt de eerste en registreert deze |
Een CMG-gebruiker die eAdm al heeft verwijderd, of die niet langer deel uitmaakt van een klantgroep zoals in deze stap wordt aangegeven, wordt niet opnieuw aangemaakt wanneer de persoon terugkeert naar het exportsjabloon.
Alleen de hoofdrecords worden gebruikt voor de vergelijking van de gebruikersnaam. De uitlezing bevat nog steeds andere records.
Een aanmaakverzoek dat CMG bereikt en vervolgens het antwoord kwijtraakt, wordt bij een latere open run opgepakt als er nog een nieuwe wijziging in behandeling is en de gebruikersnaam overeenkomt: eAdm koppelt de bestaande gebruiker in plaats van een tweede aan te maken.
De importmap
Met ‘Create’ wordt de gebruiker in de map geplaatst met de naam OrgName, binnen de klantengroep met de naam Klantgroep-ID. Gebruik je speciale importmap, bijvoorbeeldFABLETON MUNICIPALITY\Import-AD.
Zolang de gebruiker in die map blijft, bewaart CMG alleen de gebruikersnaam (misc 8). eAdm verstuurt geen functie, leidinggevende, bezoekadres, postcode, plaats of kostenplaats. Naam, e-mailadres, zichtbaarheid en de andere velden die niet onder ‘misc’ vallen, worden nog steeds verstuurd.
eAdm verstuurt na het aanmaken nooit een nieuwe map of een nieuwe klantengroep. Hierbij wordt ervan uitgegaan dat iemand in CMG de gebruiker uit de importmap verplaatst. Bij de volgende synchronisatie buiten kantooruren wordt dan één update verzonden met de ‘misc’-waarden die waren opgeslagen. Een gebruiker die in de importmap blijft, ontvangt die waarden nooit, en latere wijzigingen daarin worden pas verzonden zodra de gebruiker wordt verplaatst. Die update laat de map en de klantengroep ongewijzigd, zoals CMG ze heeft vastgelegd.
De run waarmee de gebruiker wordt aangemaakt, verstuurt deze vervolgupdate niet. Het CMG-leesproces tijdens die run vond plaats vóór het aanmaken.
Kantooruren
Telenor eist dat het aanmaken, bijwerken en verwijderen in CMG buiten kantooruren plaatsvindt. eAdm stelt deze schrijfbewerkingen uit om aan die eis te voldoen. Het tijdvenster is gebaseerd op de lokale tijd in Zweden (Europe/Stockholm), inclusief de zomertijd. Dat is dezelfde tijd als in Noorwegen.
|
Wanneer |
CMG lezen, mobiel schrijven en extensie terugsturen |
Aanmaken, bijwerken, verwijderen in CMG |
|---|---|---|
|
Op werkdagen van 08:00 tot 16:59 uur |
Ja |
Gehouden |
|
Op werkdagen vóór 08:00 uur en vanaf 17:00 uur |
Ja |
Verzonden |
|
Zaterdag en zondag |
Ja |
Verzonden wanneer er een synchronisatie plaatsvindt |
eAdm start geen extra synchronisatie wanneer het 17.00 uur wordt. Er moet ten minste één synchronisatie, waarin de CMG-stap is opgenomen, buiten kantooruren worden uitgevoerd. Voeg dat tijdstip toe aan het dagelijkse schema van de synchronisatiestap.
Een schema dat volledig binnen de weekdagen van 08:00–17:00 valt, schrijft nooit naar CMG. Weekendruns schrijven alleen naar CMG als de weekendsynchronisatie voor die stap is ingeschakeld.
Als je een importbestand reset, worden de nog niet verzonden CMG-wijzigingen die bij dat bestand horen, verwijderd.
Installatie
Installeer het certificaat
Voer dit uit op de server waarop eAdm.Client draait, in de computeropslag waar het client-serviceaccount toegang toe heeft.
-
Importeer de
.p12in Lokale computer → Persoonlijk (Cert:\LocalMachine\My). -
Geef het account waarop eAdm.Client draait toestemming om de privésleutel van het certificaat te lezen.
-
Kopieer de vingerafdruk van het certificaat. Spaties worden genegeerd. Sla alleen de vingerafdruk op tijdens de CMG-synchronisatiestap.
-
Verwijder de
.p12vanaf de schijf. Het wachtwoord wordt niet opgeslagen in eAdm.
De client zoekt die vingerafdruk op, vereist precies één overeenkomst en legt het certificaat bij elke VpAPI-aanroep voor, ook bij het inloggen. Een ontbrekende privésleutel, een lege vingerafdruk of meer dan één overeenkomst zorgt ervoor dat de stap wordt afgebroken voordat er een CMG-aanroep plaatsvindt.
Stapparameters
|
Parameter |
Verplicht |
Wat moet je invullen? |
|---|---|---|
|
API-URL |
Ja |
VpAPI-basis-URL van Telenor, zonder een pad achter de URL |
|
Klant-ID |
Ja |
VpAPI-client-ID. |
|
Geheim van de klant |
Ja |
VpAPI-clientsleutel. |
|
CMG-certificaat-thumbprint |
Ja |
Vingerafdruk van het certificaat in |
|
CMG-klantgroep-ID's |
Geen |
Door komma’s of puntkomma’s gescheiden klantgroep-ID’s die moeten worden ingelezen. Als dit veld leeg is, worden alle groepen ingelezen die het API-account kan zien. Een waarde zonder geheel getal stopt de stap vóór elke CMG-aanroep. |
Sjabloon exporteren
Koppel de exportdoelen van eAdm aan de velden van de CMG API.
|
Exportbestemming |
CMG API-veld |
Bij het aanmaken |
In een latere update |
|---|---|---|---|
|
Gebruikersnaam (altijd de eAdm-gebruikersnaam) |
|
Altijd |
Ongewijzigd gelaten. Dit is de match-sleutel. |
|
Voornaam |
|
Verzonden. Er wordt dan teruggevallen op de voornaam van de persoon. |
Verzonden toen het sjabloon het koppelde. |
|
Achternaam |
|
Verzonden. Valt terug op de achternaam. |
Verzonden toen het sjabloon het koppelde. |
|
|
|
Wordt verzonden als het adres niet leeg is. |
Wordt verzonden wanneer er een toewijzing plaatsvindt. Een lege waarde wist het kanaal. |
|
Titel |
|
Uitgesteld. Wordt niet verzonden zolang de gebruiker zich in de importmap bevindt. |
Wordt verzonden zodra de toewijzing is voltooid. Blijft actief zolang de gebruiker zich nog in de importmap bevindt. Een lege waarde wist deze instelling. |
|
Manager |
|
Uitgesteld. Wordt niet verzonden zolang de gebruiker zich in de importmap bevindt. |
Wordt verzonden zodra de toewijzing is voltooid. Blijft actief zolang de gebruiker zich nog in de importmap bevindt. Een lege waarde wist deze instelling. |
|
Bezoekadres |
|
Uitgesteld. Wordt niet verzonden zolang de gebruiker zich in de importmap bevindt. |
Wordt verzonden zodra de toewijzing is voltooid. Blijft actief zolang de gebruiker zich nog in de importmap bevindt. Een lege waarde wist deze instelling. |
|
Postcode |
|
Uitgesteld. Wordt niet verzonden zolang de gebruiker zich in de importmap bevindt. |
Wordt verzonden zodra de toewijzing is voltooid. Blijft actief zolang de gebruiker zich nog in de importmap bevindt. Een lege waarde wist deze instelling. |
|
Plaats |
|
Uitgesteld. Wordt niet verzonden zolang de gebruiker zich in de importmap bevindt. |
Wordt verzonden zodra de toewijzing is voltooid. Blijft actief zolang de gebruiker zich nog in de importmap bevindt. Een lege waarde wist deze instelling. |
|
Kostenplaats |
|
Uitgesteld. Wordt niet verzonden zolang de gebruiker zich in de importmap bevindt. |
Wordt verzonden zodra de toewijzing is voltooid. Blijft actief zolang de gebruiker zich nog in de importmap bevindt. Een lege waarde wist deze instelling. |
|
OrgName |
|
Verplicht. Exacte mapnaam. |
Ongewijzigd gelaten. |
|
Klantgroep-ID |
|
Verplicht. Een geheel getal. |
Ongewijzigd gelaten. |
|
Wijzigen door |
|
Wordt weggelaten als het veld leeg is. |
Wordt weggelaten als het veld leeg is. |
|
Zichtbaar in CMGWeb |
|
|
Wordt alleen verzonden als het is toegewezen. |
|
Zichtbaar in CMG-directory |
|
|
Wordt alleen verzonden als het is toegewezen. |
|
Hoofdrecord |
|
Wordt weggelaten wanneer er geen koppeling is. CMG beschouwt de gebruiker dan als een hoofdrecord. |
Wordt alleen verzonden als het is toegewezen. |
OrgName en Klantgroep-ID worden alleen bij het aanmaken gebruikt. Als de enige wijziging voor een persoon betrekking heeft op een van deze twee doelen, wordt er niets naar CMG verzonden. De wijziging wordt als voltooid gemarkeerd en in het synchronisatielogboek staat had no mapped fields to update. Een latere wijziging in een toegewezen veld wordt op de gebruikelijke manier verzonden.
Ook:
-
Sets aanmaken
hiddenMobileNrenhiddenExtensionNrnaartrue. Bij latere updates blijven beide vlaggen ongewijzigd, zoals ze in CMG staan. De getallen worden nog steeds teruggekopieerd naar eAdm wanneer ze in CMG verborgen zijn. -
Kaart
VisibleInCMGWebenVisibleInCMGDirectorynaartruewanneer nieuwe gebruikers in de CMG-website en -lijst moeten verschijnen. Bij het aanmaken van een niet-toegewezen item wordt het volgende verzonden:false. -
De trefwoorden blijven ongewijzigd, aangezien CMG deze al heeft opgenomen.
-
SMS-berichten en alle andere adreskanalen dan e-mail worden behouden zoals CMG ze heeft opgeslagen.
-
eAdm stuurt het mobiele nummer, het doorkiesnummer of de agendasynchronisatie niet naar CMG.
Voorbeeld van een kaart voor Fableton
|
Waarde in het sjabloon |
Exportbestemming |
|---|---|
|
|
Voornaam |
|
|
Achternaam |
|
|
|
|
|
Titel |
|
[REFERENCE;DisplayName;UserId;1;[Manager]]. |
Manager |
|
[Postadres] |
Bezoekadres |
|
[Postcode] |
Postcode |
|
Stad |
Plaats |
|
[Kostenplaats] |
Kostenplaats |
|
|
OrgName |
|
|
Klantgroep-ID |
|
|
Wijzigen door |
|
|
Zichtbaar in CMGWeb |
|
|
Zichtbaar in CMG-directory |
Voor OrgName, gebruik de exacte mapnaam uit CMG, inclusief hoofdletters. Een tweede regelset, met een letterlijke CustomerGroupId en een regelset die geen overlap vertoont met de eerste, kan een andere groep mensen in een andere klantgroep indelen.
Mobiel en uitbreiding terug naar eAdm
In hetzelfde sjabloon, Mobiel en Uitbreiding zijn inkomende bronnen. Wijs elk van deze bronnen toe aan het eAdm-veld waarin het CMG-nummer moet worden opgeslagen. De uitdrukking voor de inkomende stroom kan een voorvoegsel toevoegen: eAdm vervangt het CMG-nummer door NewValue in die uitdrukking.
Andere inkomende bronnen in deze stap worden genegeerd. De titel en de rest van het profiel blijven eigendom van het uitgaande sjabloon.
De terugboeking wordt bij elke synchronisatie uitgevoerd, ook tijdens kantooruren. Dit geldt alleen voor hoofdrecords die eAdm al aan een CMG-id heeft gekoppeld.
Testen
Voer de test uit op de klantenserver, voordat er daadwerkelijk gegevens worden geschreven. In de testmodus wordt de CMG gelezen, worden de bewerkingen opgebouwd alsof het schrijfvenster open is, en wordt er niets in de CMG gewijzigd. Ook wordt het terugschrijven naar mobiele apparaten en extensies overgeslagen.
eadm.client.exe exportcmg NO999000001 test
Het klantlogboek bevat CMG test: N operations, none executed. en één regel per bewerking. Met ‘Bevestigen’ wordt een bestand aangemaakt in de importmap, bij ‘Samenvoegen’ wordt de juiste gebruikersnaam gebruikt, en niemand die in CMG moet blijven, wordt als te verwijderen vermeld.
De geplande synchronisatie roept het `live`-commando aan zonder test:
eadm.client.exe exportcmg NO999000001
Eerste populatie bij de livegang
De eerste CMG-export moet een volledige export zijn. Voer deze één keer uit, wanneer ‘CMG exporteren’ de volgende stap in de synchronisatiecyclus is. Latere uitvoeringen blijven delta-exports.
eadm.client.exe exportcmg NO999000001 full test
eadm.client.exe exportcmg NO999000001 full
full test geeft een overzicht van de gehele populatie en verandert niets. full wijst het exportsjabloon toe aan elke persoon aan wie de regelset voldoet, en plaatst voor elk van hen een aanmaak- of samenvoegopdracht in de wachtrij. Tijdens een werkdagrun tussen 08:00 en 17:00 Zweedse tijd worden de rijen opgeslagen en eindigt de stap met CMG changes are waiting for the next open run. De eerstvolgende geplande uitvoering buiten dat tijdsbestek zorgt ervoor dat ze worden verzonden.
Niet rennen full een tweede keer terwijl er nog wijzigingen in behandeling zijn. Er wordt een tweede kopie van elk daarvan in de wachtrij geplaatst. De knop ‘Exporteren’ in de synchronisatiestap roept CMG niet aan; deze plaatst alleen dezelfde gegevensset in de wachtrij voor de volgende synchronisatie.
Als je het nog eens wilt proberen vóór het verzenden, verwijder dan alleen de stap ‘CMG exporteren’. Als je de hele synchronisatiecyclus verwijdert, gaan de nog niet verzonden CMG-wijzigingen voor dat importbestand verloren.
Problemen oplossen
|
Symptoom |
Waarschijnlijke oorzaak |
Actie |
|---|---|---|
|
Bericht synchroniseren |
De rit vond plaats op een doordeweekse dag tussen 08.00 en 17.00 uur. |
Wacht met synchroniseren tot buiten dat tijdsbestek. Controleer of de synchronisatiestap een dergelijk tijdstip heeft. |
|
CMG verandert nooit, en er is ook geen boodschap overdag |
Er wordt geen synchronisatie uitgevoerd zolang het venster open is, of als stap 1100 wordt uitgevoerd vóór het delta-vervolgpunt. |
Voeg een tijdstip in de avond, 's nachts of in het weekend toe aan ‘Synchronisatie’. Verplaats stap 1100 naar beneden, zodat de delta's dit tijdstip meenemen. |
|
|
Er ontbreekt een vingerafdruk, deze is verkeerd ingevoerd of twee certificaten delen dezelfde vingerafdruk. De opslagplaats is |
Importeer de |
|
|
A |
Importeer de |
|
Gebruikersaanroepen mislukken met foutcode 401, maar het inloggen kan nog steeds lukken |
Het certificaat werd niet getoond, of de client-id of het geheim werd afgewezen. |
Controleer de thumbprint, client-id en client-secret. De client probeert nog één keer in te loggen. |
|
Bij nieuwe gebruikers wordt in CMG alleen de gebruikersnaam weergegeven |
De gebruiker bevindt zich nog steeds in de importmap. eAdm verstuurt de overige diverse velden niet zolang de gebruiker zich daar bevindt. |
Verplaats de gebruiker uit de importmap in CMG. Bij de volgende open run worden de opgeslagen overige waarden verzonden. Als de gebruiker daar blijft staan, worden die waarden nooit verzonden. |
|
De gebruiker is verplaatst in CMG en eAdm is gestopt met het bijwerken van deze gegevens |
De gebruiker heeft zich uit alle klantgroepen verwijderd die in deze stap worden genoemd. |
Voeg die groep toe aan de CMG-klantgroep-ID’s, of verplaats ze terug. eAdm zal ze niet opnieuw aanmaken. |
|
|
Het sjabloon heeft geen mapnaam of numerieke groeps-ID voor een nieuwe gebruiker opgegeven. |
Breng beide doelen in kaart. De mapnaam moet exact overeenkomen met CMG. |
|
|
De persoon heeft geen eAdm-gebruikersnaam. |
Geef ze een gebruikersnaam voordat ze de CMG-sjabloon openen. |
|
Er is een veld vrijgemaakt in CMG |
Bij een update werd een lege toegewezen waarde verzonden. Een lege e-mail wist het e-mailkanaal. Een lege waarde in het veld ‘misc’ wist dat veld. |
Breng het doel alleen in kaart als eAdm er eigenaar van moet zijn. |
|
|
Twee hoofdrecords in CMG hebben dezelfde gebruikersnaam. |
Corrigeer het dubbele item in CMG. eAdm behoudt één van beide. |
|
Een afgewezen CMG-verzoek (HTTP 400–499, met uitzondering van 401) |
CMG heeft die gebruiker geweigerd. De wijziging is gemarkeerd als voltooid en wordt niet opnieuw geprobeerd. |
Bekijk de foutmelding in de objectgeschiedenis, corrigeer de gegevens en breng een nieuwe wijziging aan, zodat deze bij een volgende open-run opnieuw wordt verzonden. |
|
HTTP 401 na het vernieuwen, HTTP 5xx of een netwerkfout |
De oproep is niet doorgegaan. De wijziging is nog steeds in behandeling. |
Bij de volgende open run wordt het opnieuw geprobeerd. |
