Dieses Dokument beschreibt die Integration zwischen eAdm und Telenor CMG. Die Integration automatisiert die Verwaltung von Benutzerkonten in CMG durch die Synchronisierung von Benutzerdaten aus eAdm.
Übersicht
CMG ist der Telefonie- und Verzeichnisdienst von Telenor. Telefonisten und Mitarbeiter nutzen ihn, um Personen zu finden, zu erfahren, wie sie zu erreichen sind, und zu sehen, zu welchem Bereich des Unternehmens sie gehören. Der Dienst umfasst außerdem Voicemail, ein Endnutzerportal und das Aktivitätsmanagement.
Diese Integration automatisiert die Benutzerverwaltung aus Ihrem HRM-System in dieses Verzeichnis.
In den folgenden Beispielen wird Gemeinde Fableton, Organisations-ID NO999000001. Fableton ist ein fiktiver Ort.
Voraussetzungen
Überprüfen Sie diese Punkte, bevor Sie die Integration einrichten:
-
Telenor hat die VpAPI-Basis-URL, die Client-ID, das Client-Geheimnis und ein Client-Zertifikat bereitgestellt. Das Zertifikat muss ein
.p12oder.pfxmit einem privaten Schlüssel. Ein.cerohne privaten Schlüssel kann nicht verwendet werden. Die URL sieht wie folgt aus:https://<host>/VpAPIund ist nur vom Kundennetzwerk aus erreichbar. -
Der Server, auf dem eAdm.Client ausgeführt wird, kann auf VpAPI zugreifen.
-
Ein täglicher Synchronisierungsschritt in eAdm findet mindestens einmal vor 08:00 Uhr oder um 17:00 Uhr bzw. später (schwedische Zeit) statt, oder die Wochenendsynchronisierung ist aktiviert. Die Funktionen „Erstellen“, „Aktualisieren“ und „Löschen“ in CMG werden ausschließlich außerhalb der Bürozeiten ausgeführt.
So funktioniert die Integration
Bei jedem Lauf, auch bei Läufen während der Bürozeiten:
-
eAdm.Client meldet sich bei VpAPI an und liest die CMG-Benutzer aus.
-
eAdm kopiert die Daten zu „Mobile“ und „Extension“ dieser Benutzer zurück in eAdm, wenn eingehende Datenflüsse konfiguriert sind.
-
eAdm protokolliert alle anstehenden Profiländerungen.
Die Schritte „Erstellen“, „Aktualisieren“ und „Löschen“ werden nur ausgeführt, wenn derselbe Schritt außerhalb der Bürozeiten stattfindet. Mehrere Änderungen an demselben Benutzer im Laufe des Tages werden zu einem einzigen CMG-Aufruf zusammengefasst. Es wird jeweils der aktuellste Wert jedes Feldes übermittelt. Eine spätere Entfernung aus der Vorlage hat Vorrang vor früheren Änderungen.
Sobald eAdm die Anrufe an den Client weitergeleitet hat, werden diese Anrufe auch dann abgeschlossen, wenn die Uhrzeit danach in die Bürozeiten fällt. Die Uhrzeit wird zum Zeitpunkt der Vorbereitung der Anrufe durch eAdm erfasst – also dann, wenn der Schritt ausgeführt wird –, und nicht zum Zeitpunkt der Einreihung der Synchronisierung in die Warteschlange.
Ein Tageslauf mit anstehenden Änderungen wird erfolgreich abgeschlossen. Die Meldung zum Synchronisierungsschritt lautet CMG changes are waiting for the next open run. Im Client-Protokoll steht CMG returned no operations. Die Änderungen werden zurückgestellt. Sie werden nicht verworfen.
Abgleichen, Anlegen, Aktualisieren und Löschen
eAdm speichert die CMG-Benutzer-ID für die Person nach einer erfolgreichen Erstellung sowie bei der Verknüpfung mit einem bestehenden CMG-Benutzer. Der Benutzername selbst ist immer der eAdm-Benutzername. Er ist kein Ziel einer Exportvorlage. Er wird als „Misc“-Element in CMG geschrieben. { miscNo: 8, miscText: "<username>" }.
|
Wenn |
Was passiert? |
|---|---|
|
Die Person hat noch keine CMG-ID, und ein Haupt nutzer von CMG hat diesen Benutzernamen bereits in „Misc 8“ |
eAdm verknüpft diese CMG-ID und sendet eine Aktualisierung für die zugeordneten Felder. Das ist die Zusammenführung. |
|
Die Person hat noch keine CMG-ID, und kein Hauptnutzer bei CMG hat diesen Benutzernamen. |
eAdm legt einen CMG-Benutzer an. „OrgName“ und eine numerische „CustomerGroupId“ sind Pflichtangaben. |
|
Die Person hat eine CMG-ID, und dieser Benutzer befindet sich noch in der abgerufenen Liste. |
eAdm aktualisiert die zugeordneten Felder. |
|
Die Person wird aus der Exportvorlage entfernt, der CMG-Benutzer befindet sich jedoch weiterhin in der abgerufenen Liste. |
eAdm löscht den CMG-Benutzer. |
|
Die Person hat eine CMG-ID, aber dieser Benutzer ist nicht in der abgerufenen Liste enthalten. |
eAdm lässt CMG unverändert. Es erstellt keinen Ersatz und sendet keine Löschanweisung. |
|
Zwei wichtige CMG-Nutzer haben denselben Benutzernamen in „misc 8“ |
eAdm behält den ersten Wert bei und protokolliert die übrigen |
Ein CMG-Benutzer, den eAdm bereits gelöscht hat oder der sich nicht mehr in einer Kundengruppe befindet, wie in diesem Schritt beschrieben, wird nicht erneut angelegt, wenn die Person in die Exportvorlage zurückkehrt.
Für den Abgleich des Benutzernamens werden nur die Hauptdatensätze herangezogen. Die Abfrage umfasst jedoch weiterhin auch andere Datensätze.
Ein Erstellungsvorgang, der CMG erreicht und anschließend die Antwort verliert, wird bei einem späteren offenen Durchlauf wieder aufgegriffen, sofern noch eine neue Änderung aussteht und der Benutzername übereinstimmt: eAdm verknüpft den bestehenden Benutzer, anstatt einen zweiten anzulegen.
Der Importordner
Mit „Create“ wird der Benutzer in den Ordner verschoben, dessen Name durch OrgName, innerhalb der Kundengruppe mit dem Namen Kundengruppen-ID. Verwenden Sie Ihren eigenen Importordner, z. B.FABLETON MUNICIPALITY\Import-AD.
Solange sich der Benutzer in diesem Ordner befindet, speichert CMG lediglich den Benutzernamen (misc 8). eAdm übermittelt weder Titel, Vorgesetzten, Besuchsadresse, Postleitzahl, Ort noch Kostenstelle. Name, E-Mail-Adresse, Sichtbarkeit und die anderen Felder, die nicht unter „misc“ fallen, werden weiterhin übermittelt.
eAdm sendet nach der Erstellung niemals einen neuen Ordner oder eine neue Kundengruppe. Dabei wird davon ausgegangen, dass jemand in CMG den Benutzer aus dem Importordner verschiebt. Bei der nächsten Synchronisierung außerhalb der Bürozeiten wird dann eine Aktualisierung mit den zurückgestellten Werten unter „Sonstiges“ gesendet. Ein Benutzer, der im Importordner verbleibt, erhält diese Werte niemals, und spätere Änderungen daran werden erst gesendet, wenn der Benutzer verschoben wird. Diese Aktualisierung belässt den Ordner und die Kundengruppe so, wie sie in CMG vorliegen.
Der Durchlauf, der den Benutzer anlegt, sendet diese nachfolgende Aktualisierung nicht mit. Das CMG-Lesen in diesem Durchlauf erfolgte vor der Anlage.
Sprechzeiten
Telenor schreibt vor, dass das Anlegen, Aktualisieren und Löschen von Datensätzen in CMG außerhalb der Bürozeiten erfolgen muss. eAdm hält diese Schreibvorgänge zurück, um diese Vorgabe zu erfüllen. Das Zeitfenster basiert auf der schwedischen Ortszeit (Europe/Stockholm), einschließlich Sommerzeit. Das entspricht der Zeit in Norwegen.
|
Wenn |
CMG lesen, auf Mobilgerät schreiben und Erweiterung zurücksenden |
Erstellen, Aktualisieren, Löschen in CMG |
|---|---|---|
|
Werktags 08:00–16:59 Uhr |
Ja |
Abgehalten |
|
An Werktagen vor 08:00 Uhr und ab 17:00 Uhr |
Ja |
Gesendet |
|
Samstag und Sonntag |
Ja |
Wird gesendet, wenn eine Synchronisierung läuft |
eAdm startet keine zusätzliche Synchronisierung, sobald es 17:00 Uhr ist. Mindestens eine Synchronisierung, die den CMG-Schritt umfasst, muss außerhalb der Bürozeiten stattfinden. Tragen Sie diesen Zeitpunkt in den Tagesplan des Synchronisierungsschritts ein.
Ein Zeitplan, der vollständig in die Werktagszeiten von 08:00 bis 17:00 Uhr fällt, schreibt niemals in die CMG. Wochenendläufe schreiben nur dann in die CMG, wenn die Wochenendsynchronisation für diesen Schritt aktiviert ist.
Durch das Zurücksetzen einer Importdatei werden die noch nicht gesendeten CMG-Änderungen, die zu dieser Datei gehören, entfernt.
Einrichtung
Installieren Sie das Zertifikat
Führen Sie diesen Vorgang auf dem Server aus, auf dem eAdm.Client läuft, und zwar in dem Computerspeicher, auf den das Client-Dienstkonto Lesezugriff hat.
-
Importieren Sie die
.p12in Lokaler Computer → Persönlich (Cert:\LocalMachine\My). -
Erteilen Sie dem Konto, unter dem eAdm.Client ausgeführt wird, die Berechtigung zum Lesen des privaten Schlüssels des Zertifikats.
-
Kopieren Sie den Zertifikats-Fingerabdruck. Leerzeichen werden ignoriert. Speichern Sie beim CMG-Synchronisierungsschritt nur den Fingerabdruck.
-
Lösche das
.p12von der Festplatte. Das Passwort wird in eAdm nicht gespeichert.
Der Client sucht diesen Fingerabdruck, verlangt genau eine Übereinstimmung und legt das Zertifikat bei jedem VpAPI-Aufruf vor, einschließlich der Anmeldung. Ein fehlender privater Schlüssel, ein leerer Fingerabdruck oder mehr als eine Übereinstimmung führen dazu, dass der Schritt vor jedem CMG-Aufruf abgebrochen wird.
Schrittparameter
|
Parameter |
Erforderlich |
Was muss eingegeben werden? |
|---|---|---|
|
API-URL |
Ja |
VpAPI-Basis-URL von Telenor, ohne nachfolgenden Pfad |
|
Kunden-ID |
Ja |
VpAPI-Client-ID. |
|
Client-Geheimnis |
Ja |
VpAPI-Client-Secret. |
|
CMG-Zertifikat-Fingerabdruck |
Ja |
Fingerabdruck des Zertifikats in |
|
CMG-Kundengruppen-IDs |
Nein |
Durch Kommas oder Semikolons getrennte Kundengruppen-IDs, die gelesen werden sollen. Bei einem leeren Wert werden alle Gruppen gelesen, die für das API-Konto sichtbar sind. Ein Wert ohne Ganzzahl bricht den Schritt vor jedem CMG-Aufruf ab. |
Vorlage exportieren
Ordnen Sie die eAdm-Exportziele den CMG-API-Feldern zu.
|
Exportziel |
CMG-API-Feld |
Beim Anlegen |
In einem späteren Update |
|---|---|---|---|
|
Benutzername (immer der eAdm-Benutzername) |
|
Immer |
Unverändert belassen. Dies ist der Übereinstimmungsschlüssel. |
|
Vorname |
|
Gesendet. Es wird wieder auf den Vornamen der Person zurückgegriffen. |
Wurde gesendet, als die Vorlage dies zugeordnet hat. |
|
Nachname |
|
Gesendet. Weicht auf den Nachnamen aus. |
Wurde gesendet, als die Vorlage dies zugeordnet hat. |
|
|
|
Wird gesendet, wenn das Adressfeld nicht leer ist. |
Wird bei Zuordnung gesendet. Ein leerer Wert löscht den Kanal. |
|
Titel |
|
Zurückgestellt. Wird nicht gesendet, solange sich der Benutzer im Importordner befindet. |
Wird bei der Zuordnung gesendet. Wird beibehalten, solange sich der Benutzer noch im Importordner befindet. Ein leerer Wert löscht ihn. |
|
Manager |
|
Zurückgestellt. Wird nicht gesendet, solange sich der Benutzer im Importordner befindet. |
Wird bei der Zuordnung gesendet. Wird beibehalten, solange sich der Benutzer noch im Importordner befindet. Ein leerer Wert löscht ihn. |
|
Besuchsadresse |
|
Zurückgestellt. Wird nicht gesendet, solange sich der Benutzer im Importordner befindet. |
Wird bei der Zuordnung gesendet. Wird beibehalten, solange sich der Benutzer noch im Importordner befindet. Ein leerer Wert löscht ihn. |
|
Postleitzahl |
|
Zurückgestellt. Wird nicht gesendet, solange sich der Benutzer im Importordner befindet. |
Wird bei der Zuordnung gesendet. Wird beibehalten, solange sich der Benutzer noch im Importordner befindet. Ein leerer Wert löscht ihn. |
|
Ort |
|
Zurückgestellt. Wird nicht gesendet, solange sich der Benutzer im Importordner befindet. |
Wird bei der Zuordnung gesendet. Wird beibehalten, solange sich der Benutzer noch im Importordner befindet. Ein leerer Wert löscht ihn. |
|
Kostenstelle |
|
Zurückgestellt. Wird nicht gesendet, solange sich der Benutzer im Importordner befindet. |
Wird bei der Zuordnung gesendet. Wird beibehalten, solange sich der Benutzer noch im Importordner befindet. Ein leerer Wert löscht ihn. |
|
OrgName |
|
Erforderlich. Genaue Angabe des Ordnernamens. |
Unverändert belassen. |
|
Kundengruppen-ID |
|
Erforderlich. Eine ganze Zahl. |
Unverändert belassen. |
|
Ändern durch |
|
Wird weggelassen, wenn das Feld leer ist. |
Wird weggelassen, wenn das Feld leer ist. |
|
In CMGWeb sichtbar |
|
|
Wird nur gesendet, wenn eine Zuordnung vorliegt. |
|
Im CMG-Verzeichnis sichtbar |
|
|
Wird nur gesendet, wenn eine Zuordnung vorliegt. |
|
Hauptdatensatz |
|
Wird weggelassen, wenn keine Zuordnung vorliegt. CMG behandelt den Benutzer dann als Hauptdatensatz. |
Wird nur gesendet, wenn eine Zuordnung vorliegt. |
OrgName und Kundengruppen-ID werden nur beim Anlegen verwendet. Wenn die einzige Änderung bei einer Person eines dieser beiden Ziele betrifft, wird nichts an CMG gesendet. Die Änderung wird als erledigt markiert, und im Synchronisierungsprotokoll steht had no mapped fields to update. Eine spätere Änderung an einem zugeordneten Feld wird wie gewohnt gesendet.
Außerdem:
-
Sets erstellen
hiddenMobileNrundhiddenExtensionNrzutrue. Bei späteren Aktualisierungen bleiben beide Kennzeichen so, wie sie in CMG gesetzt sind. Die Zahlen werden weiterhin in eAdm zurückkopiert, auch wenn sie in CMG ausgeblendet sind. -
Karte
VisibleInCMGWebundVisibleInCMGDirectoryzutruewann neue Benutzer im CMG-Web und im Verzeichnis angezeigt werden sollen. Bei einer nicht zugeordneten Erstellung wird Folgendes gesendet:false. -
Die Schlüsselwörter bleiben unverändert, da CMG sie bereits enthält.
-
SMS und alle anderen Adresskanäle außer E-Mail werden so belassen, wie CMG sie gespeichert hat.
-
eAdm übermittelt weder die Handynummer noch die Durchwahl noch die Kalendersynchronisierung an CMG.
Beispiel für eine Zuordnung für Fableton
|
Wert in der Vorlage |
Exportziel |
|---|---|
|
|
Vorname |
|
|
Nachname |
|
|
|
|
|
Titel |
|
[REFERENCE;Anzeigename;Benutzer-ID;1;[Manager]] |
Manager |
|
[Postanschrift] |
Besuchsadresse |
|
[Postleitzahl] |
Postleitzahl |
|
Stadt |
Ort |
|
[Kostenstelle] |
Kostenstelle |
|
|
OrgName |
|
|
Kundengruppen-ID |
|
|
Ändern durch |
|
|
In CMGWeb sichtbar |
|
|
Im CMG-Verzeichnis sichtbar |
Für OrgName, verwenden Sie den genauen Ordnernamen aus CMG, einschließlich der Groß- und Kleinschreibung. Ein zweiter Regelsatz mit einem wörtlichen CustomerGroupId und ein Regelsatz, der sich nicht mit dem ersten überschneidet, kann eine andere Gruppe von Personen einer anderen Kundengruppe zuordnen.
Mobil und Erweiterung zurück in eAdm
Auf derselben Vorlage, Mobil und Erweiterung sind Eingangsquellen. Verweisen Sie jede davon auf das eAdm-Feld, in dem die CMG-Nummer gespeichert werden soll. Der Ausdruck für den Eingangsfluss kann ein Präfix hinzufügen: eAdm ersetzt die CMG-Nummer durch NewValue in diesem Ausdruck.
Andere eingehende Quellen in diesem Schritt werden ignoriert. Der Titel und der Rest des Profils bleiben Eigentum der ausgehenden Vorlage.
Die Rückbuchung erfolgt bei jeder Synchronisierung, auch während der Bürozeiten. Sie gilt nur für Hauptdatensätze, die eAdm bereits mit einer CMG-ID verknüpft hat.
Testen
Führen Sie den Test auf dem Kundenserver durch, bevor Sie Daten in die Produktion schreiben. Im Testmodus wird die CMG gelesen, die Vorgänge werden so aufgebaut, als wäre das Schreibfenster geöffnet, und es werden keine Änderungen an der CMG vorgenommen. Außerdem werden das Writeback auf Mobilgeräte und Erweiterungen übersprungen.
eadm.client.exe exportcmg NO999000001 test
Das Client-Protokoll enthält CMG test: N operations, none executed. und eine Zeile pro Vorgang. Bei „Bestätigen“ wird ein Eintrag im Importordner erstellt, bei „Zusammenführen“ wird der richtige Benutzername übernommen, und niemand, der in CMG verbleiben soll, wird als zu löschender Eintrag aufgeführt.
Die geplante Synchronisierung ruft den Befehl „live“ auf, ohne test:
eadm.client.exe exportcmg NO999000001
Erste Datenübernahme bei der Inbetriebnahme
Der erste CMG-Export sollte ein vollständiger Export sein. Führen Sie ihn einmal aus, wenn „CMG exportieren“ der nächste Schritt im Synchronisierungszyklus ist. Spätere Durchläufe erfolgen als Deltas.
eadm.client.exe exportcmg NO999000001 full test
eadm.client.exe exportcmg NO999000001 full
full test Zeigt eine Vorschau der gesamten Population an und nimmt keine Änderungen vor. full Weist jeder Person, auf die der Regelsatz zutrifft, die Exportvorlage zu und stellt für jede einzelne einen Erstellungs- oder Zusammenführungsauftrag in die Warteschlange. Bei einem Lauf an Werktagen zwischen 08:00 und 17:00 Uhr schwedischer Zeit werden die Zeilen gespeichert, und der Schritt endet mit CMG changes are waiting for the next open run. Der nächste geplante Durchlauf außerhalb dieses Zeitfensters sendet sie.
Nicht laufen full ein zweites Mal, solange noch Änderungen ausstehen. Dabei wird jeweils eine zweite Kopie aller Daten in die Warteschlange gestellt. Die Schaltfläche „Exportieren“ im Synchronisierungsschritt ruft CMG nicht auf, sondern stellt lediglich denselben Datenbestand für die nächste Synchronisierung in die Warteschlange.
Um es vor dem Senden erneut zu versuchen, löschen Sie bitte nur den Schritt „CMG exportieren“. Durch das Löschen des gesamten Synchronisierungszyklus werden die noch nicht gesendeten CMG-Änderungen für diese Importdatei verworfen.
Fehlerbehebung
|
Symptom |
Mögliche Ursache |
Aktion |
|---|---|---|
|
Synchronisierungsmeldung |
Der Lauf fand an einem Wochentag zwischen 08:00 und 17:00 Uhr statt. |
Warten Sie, bis außerhalb dieses Zeitfensters eine Synchronisierung stattfindet. Vergewissern Sie sich, dass der Synchronisierungsschritt einen solchen Zeitpunkt vorsieht. |
|
CMG ändert sich nie, und auch die Botschaft für den Tag fehlt |
Es wird kein Synchronisierungslauf durchgeführt, solange das Fenster geöffnet ist oder Schritt 1100 vor dem Delta-Fortsetzungspunkt angeordnet wird. |
Fügen Sie bei „Synchronisation“ eine Zeitangabe für den Abend, die Nacht oder das Wochenende hinzu. Verschieben Sie Schritt 1100 nach unten, damit die Deltas diese Zeitangabe berücksichtigen. |
|
|
Der Fingerabdruck fehlt, wurde falsch eingegeben oder wird von zwei Zertifikaten gemeinsam genutzt. Der Speicher ist |
Importiere die Datei erneut |
|
|
A |
Importieren Sie die |
|
Benutzeraufrufe schlagen mit dem Fehler 401 fehl, die Anmeldung kann dennoch erfolgreich sein |
Das Zertifikat wurde nicht vorgelegt, oder die Client-ID oder der geheime Schlüssel wurden abgelehnt. |
Überprüfen Sie den Fingerabdruck, die Client-ID und das Client-Geheimnis. Der Client unternimmt einen weiteren Anmeldeversuch. |
|
Bei neuen Benutzern wird in CMG nur der Benutzername angezeigt |
Der Benutzer befindet sich noch im Importordner. eAdm übermittelt die anderen sonstigen Felder nicht, solange sich der Benutzer dort befindet. |
Verschieben Sie den Benutzer aus dem Importordner in CMG. Beim nächsten offenen Durchlauf werden die zurückgehaltenen „misc“-Werte gesendet. Bleibt der Benutzer dort, werden diese Werte niemals gesendet. |
|
Der Benutzer wurde in CMG verschoben, und eAdm hat die Aktualisierung seiner Daten eingestellt |
Der Benutzer hat alle Kundengruppen verlassen, die in diesem Schritt aufgeführt sind. |
Fügen Sie diese Gruppe zu den CMG-Kundengruppen-IDs hinzu oder verschieben Sie sie zurück. eAdm wird sie nicht neu anlegen. |
|
|
Die Vorlage hat weder einen Ordnernamen noch eine numerische Gruppen-ID für einen neuen Benutzer bereitgestellt. |
Ordnen Sie beide Ziele zu. Der Ordnername muss genau mit „CMG“ übereinstimmen. |
|
|
Die Person hat keinen eAdm-Benutzernamen. |
Weisen Sie ihnen einen Benutzernamen zu, bevor sie die CMG-Vorlage aufrufen. |
|
In CMG wurde ein Feld geräumt |
Bei einer Aktualisierung wurde ein leerer zugeordneter Wert gesendet. Eine leere E-Mail löscht den E-Mail-Kanal. Ein leerer Wert im Feld „Sonstiges“ löscht dieses Feld. |
Ordnen Sie das Ziel nur dann zu, wenn es zu eAdm gehören soll. |
|
|
Zwei CMG-Hauptdatensätze haben denselben Benutzernamen. |
Korrigieren Sie den Duplikat-Eintrag in CMG. eAdm behält einen der beiden Einträge bei. |
|
Ein abgelehnter CMG-Aufruf (HTTP 400–499, außer 401) |
CMG hat diesen Benutzer abgelehnt. Die Änderung wird als erledigt markiert und nicht erneut versucht. |
Lesen Sie den Fehler im Objektverlauf, korrigieren Sie die Daten und nehmen Sie eine neue Änderung vor, damit diese bei einem späteren Open-Lauf erneut gesendet wird. |
|
HTTP 401 nach dem Aktualisieren, HTTP 5xx oder ein Netzwerkfehler |
Der Aufruf blieb ohne Erfolg. Die Änderung ist weiterhin ausstehend. |
Beim nächsten offenen Lauf wird es erneut versucht. |
