Der Import von Gruppen-, Stellen- und Nutzerdaten ist für die Verwaltung von Organisationsstrukturen von entscheidender Bedeutung. Da Massendaten regelmäßig, z. B. einmal pro Woche, aktualisiert werden müssen, wäre eine manuelle Aktualisierung für größere Organisationen nicht praktikabel.
Der Import muss in der Konfiguration erfolgen. Konfiguration Manager.
Basis-Prinzip
Gruppen enthalten Benutzer und Positionen, Positionen enthalten Benutzer. Daher sollte die gesamte Zeitplanung des Imports der Organisationsstruktur wie folgt erfolgen:
Nutzerimport (bestehend) > Stelle-Import (neu) → Gruppe-Import (neu) Diese Reihenfolge minimiert die Anzahl ungültiger Objektzuweisungen.
Dies hängt von der Job-Konfiguration ab und ist keine Aufgabe für die Implementierung.
Die XML-Struktur wird von imc als Standardstruktur definiert. Die Kunden sind für die Erstellung einer gültigen XML-Datei verantwortlich.
Der Import wird durch einen Job ausgelöst. Auf der GUI kann er zusätzlich zu diesem Job manuell ausgelöst werden. Dies kann separat für Stellen und Gruppen erfolgen.
Der Import beginnt mit dem Laden der aktuellen XML-Datei und deren Validierung. Wenn die Validierung erfolgreich ist, beginnt die Aktualisierung der Datenbank.
Gruppenimport
Der Hauptzweck des Gruppenimports besteht darin, eine Organisationsstruktur zu erstellen oder zu aktualisieren. Beim Import sollten neue Gruppen erstellt und bestehende Gruppen aktualisiert werden. Die Aktualisierung umfasst Umzüge und Löschungen innerhalb der Gruppenstruktur.
Der neue Import von Gruppen ersetzt nicht den bestehenden LDAP-Import. Er unterstützt den Import von Organisationseinheiten und Standardgruppen, bietet jedoch keine erweiterten Funktionen.
Die imc Learning Suite erwartet eine XML-Datei, um ihre Daten in die bestehende Struktur zu bearbeiten. Die Erstellung dieser XML-Datei erfolgt durch die Kunden.
Der Import erwartet immer eine XML-Datei mit der gesamten Struktur einer definierten Hauptgruppe. Gruppen, die nicht in die XML-Datei integriert sind, werden aus der Datenbank entfernt.
Alle Attribute und ihre Werte, die in der XML-Datei enthalten sind, werden importiert. Das bedeutet, dass bei einer Änderung der Werte in der imc Learning Suite diese Änderungen beim nächsten Import überschrieben werden.
Wenn Attribute in der imc Learning Suite schreibgeschützt sein sollen, müssen sie in die Konfiguration enthalten sein, damit das entsprechende Feld in der imc Learning Suite schreibgeschützt wird.
Import-Spezifikationen
-
Der Import ignoriert, wenn ein importiertes Objekt im LMS gesperrt ist, weil es von einem anderen Nutzer bearbeitet wird. Es gibt einen Mechanismus, der den Nutzer daran hindert, seine Änderungen zu speichern.
-
Der Import wird durch die Konfiguration auf eine Hauptgruppe beschränkt. Wenn ein Kunde mehrere Hauptgruppen importieren möchte, muss er dafür separate Importe konfigurieren.
-
Die Hauptgruppen-Gruppe muss manuell im LMS angelegt werden. Bei der ersten Aktualisierung durch Import erhält sie eine externe ID und kann nicht mehr wie eine nicht importierte Gruppe verwaltet werden.
-
Es kann festgelegt werden, ob beim Import eines leeren Feldes ein vorhandener Eintrag ignoriert oder gelöscht wird.
-
Wenn Gruppen erstellt werden, werden die Freigaben der direkten übergeordneten Gruppe in die neue Gruppe geschrieben. Wenn dies nicht möglich ist: Standard-ACL-Rechte schreiben.
-
Wenn eine Gruppe im Quellsystem gelöscht wird, wird die entsprechende Gruppe nach dem Import der aktualisierten XML-Datei auch in der imc Learning Suite gelöscht. Untergeordnete Gruppen der gelöschten Gruppen sollten ebenfalls in der Datenbank gelöscht werden, sofern sie nicht aufgrund der Strukturaktualisierung zu einer anderen übergeordneten Gruppe verschoben wurden. Anmerkung: Keine Auswirkungen auf die Berichterstellung, da Daten aus der Vergangenheit aus Kopien der Verlaufstabelle stammen.
-
Wenn der Ersteller einer neuen Gruppe (Ersteller gemäß Konfiguration) keine Gruppen über die GUI erstellen darf, sind keine besonderen Maßnahmen erforderlich. Die Gruppe wird mit ihm als Ersteller erstellt.
-
Gruppe-Attribut-Felder können HTML-Zeichenfolgen enthalten. Das Import-Austauschformat (xml) muss dies korrekt verarbeiten.
-
Hinweis für spätere Funktionsspezifikationen: Je nach Datenverlaufsmechanismus sollte vermieden werden, dass jede Importaktualisierung einen Eintrag in der Verlaufstabelle verursacht, auch wenn sich für die Gruppe nichts geändert hat.
Validierungsschritte
Für den Fall, dass die XML-Datei keine gültigen Daten enthält, muss vermieden werden, dass die imc Learning Suite ohne vorherige Überprüfung mit dem Import in die Datenbank beginnt. Andernfalls könnte es passieren, dass Teile der Struktur aktualisiert werden und andere nicht, weil die Aktualisierung abgebrochen wurde. Dies könnte zu massiven Dateninkonsistenzen führen.
Wenn die imc Learning Suite eine XML-Datei empfängt, sind daher die folgenden Validierungen erforderlich:
|
Schritt |
Nachricht |
Beschreibung |
|
Schritt 1:
|
|
Allgemeine Tests |
|
|
Konfiguration ungültig |
Import abbrechen; Logdatei: KONFIGURATION UNGÜLTIG. |
|
|
Für dieselbe Hauptgruppe finden sich unterschiedliche Konfigurationen. |
Import abbrechen; Logdatei: KONFIGURATION UNGÜLTIG. |
|
|
Ein weiterer Import einer Gruppe läuft für denselben Hauptordner. |
Import abbrechen; Logdatei: WEITERER GRUPPENIMPORT Wird für Hauptgruppe 12345 ausgeführt. |
|
|
XML-Datei nicht im Ordner |
Import abbrechen; Logdatei: QUELLDATEI NICHT GEFUNDEN (Pfad/Dateiname). |
|
|
Ordner nicht gefunden |
Import abbrechen; Logdatei: QUELLDATEI NICHT GEFUNDEN (Pfad/Dateiname). |
|
Schritt 2:
|
|
|
|
|
XML-Struktur ungültig |
Import abbrechen; Logdatei: UNGÜLTIGE XML-STRUKTUR |
|
|
Die XML-Struktur enthält keine Definition für das Attribut „user assignment“ (Benutzerzuweisung). |
Die XML-Datei muss den Namen des Attributs enthalten, das zur Identifizierung der zugewiesenen Nutzer verwendet wird. Z. B. <xml> <USERASSIGNMENT Attribut="USER_ID"/> (Structure) </xml>
Wenn diese Informationen fehlen, wird der Import unterbrochen und eine Fehlermeldung in die Protokolldatei geschrieben: If this information is missing, the import is interrupted and an error message is written to logfile: INVALID USER ASSIGNMENT ATTRIBUTE. Or: USER ASSIGNMENT ATTRIBUTE MISSING IN FILE.
Zulässige Nutzer-Attribute: Login PERSON_ID EXT_ID_CSV EXT_ID_LDAP EXTERNE_ID EXTERNES_SYSTEM_ID EXT_SHIB_UID EXT_SHIB_ENTITÄTS-ID |
|
|
Die Zielgruppe enthält nicht importierte Untergruppen. |
Import abbrechen; Logdatei: Ungültige Struktur der Zielgruppe |
|
|
Der Ersteller existiert nicht in der imc Learning Suite. |
Die XML-Datei muss einen Ersteller definieren. Wenn durch Import eine neue Gruppe erstellt wird, wird der Ersteller in die Datenbank geschrieben.
Import abbrechen; Logdatei: CREATOR UNKNOWN IN TARGET SYSTEM. |
|
Schritt 3:
|
|
|
|
|
Es gibt nicht genau eine Hauptgruppe. |
Import abbrechen; Logdatei: INVALID SOURCE GROUP STRUCTURE. |
|
|
Nicht alle externen IDs der verbleibenden Gruppen sind in der imc Learning Suite eindeutig. |
Import abbrechen; Logdatei: EXTERNAL IDs NOT UNIQUE IN TARGET SYSTEM. |
|
|
Nach dem Import hat jede Gruppe eine gültige übergeordnete Gruppe. |
… außer der Hauptgruppe. Diese Überprüfung muss die Neuanordnung und das Löschen von Gruppen berücksichtigen. Import abbrechen; Logdatei: INVALID SOURCE GROUP STRUCTURE. |
|
|
Stelle zugewiesen mehrfach |
Nach dem Import müssen die Stelle-Zuweisungen für die gesamte LEARNING SUITE DB eindeutig sein. Import abbrechen, Logdatei: POSITION ASSIGNMENT NOT UNIQUE (POSITION 1234). |
|
Schritt 4:
|
|
Einige obligatorische Einstellungen müssen überprüft werden, was zu Folgendem führen kann: Ungültige Struktur. Andere Einstellungen werden in diesem Fall nicht überprüft. Überprüfen Sie dies, da es für sie eine Fallback-Behandlung gibt (siehe nächstes Kapitel). |
|
|
Keine Gruppe hat eine externe ID oder einen Namen. |
Import abbrechen, Logdatei: MANDATORY FIELDS MISSING (GROUP 3254235423). |
|
|
Eine Gruppe hat denselben Nutzer. Zuweisung auf den Feldern Vorgesetzter, Stellvertreter1 oder Vertretung 2 |
Import abbrechen, Logdatei: GROUP 1234: ASSIGNMENT OF SUPERVISORS AND DEPUTIES NOT UNIQUE FOR GROUP. |
Tabelle 1: Vorabvalidierung für Gruppe-Import