Migrationshandbuch

Letzte Aktualisierung: 2. Juni 2026

Referenzhandbuch für Integrationsadministratoren zum Migrieren eines vorhandenen LMS in das Learning Manager-LMS

Anwendungsszenario usagescenario

Im Allgemeinen verfügen große Unternehmen bereits über ein internes oder extern bereitgestelltes LMS. Ein LMS umfasst die Schulungsinhalte und -daten des Unternehmens. Beim Kauf von Learning Manager sollten Unternehmen die LMS-Bestandsdaten und -Inhalte in Learning Manager verschieben, um die Vorteile eines modernen und intuitiven LMS zu nutzen, ohne diese Bestandsdaten zu verlieren.

Learning Manager bietet die erforderlichen Tools und Spezifikationen, mit denen der Integrationsadministrator des Unternehmens die Migrationsaufgaben einrichten und durchführen kann.

Von heute an können Administratoren des Unternehmens auf die Migrationsfunktion in Learning Manager zugreifen, indem sie sich an das Support-Team von Adobe wenden. Um die Migrationsfunktion in Ihrem Konto zu aktivieren, können Sie sich an das Adobe Learning Manager-Supportteam wenden.

Migrationsvorgang apidescription

In diesem Abschnitt werden die Voraussetzungen für die Migration, wichtige Schritte des Migrationsvorgangs, Sprints, Spezifikationen und Schritte zur Daten- und Inhaltsmigration wie folgt erläutert:

Wichtiger Hinweis zur Migration

Sie sollten sich bewusst sein, dass Migrationszeitpläne stark von der Qualität und Größe Ihrer Daten abhängen. Wenn Sie während des Onboarding-Prozesses eine Migration benötigen, planen Sie diese Aktivität rechtzeitig im Voraus und arbeiten Sie eng mit dem Adobe Learning Manager-Onboarding-Team zusammen, um Verzögerungen zu vermeiden.

Voraussetzungen prerequisites

Das Learning Manager-Team erwartet, dass folgende Aufgaben vor der Migration vom Integrationsadministrator des Unternehmens durchgeführt werden:

Der Integrationsadministrator extrahiert die Daten und Inhalte des vorhandenen LMS und konvertiert sie in die von Learning Manager angegebenen Dateiformate.
Der Import von Benutzern als Teil des Migrationsvorgangs wird von Learning Manager nicht unterstützt; es wird erwartet, dass diese vom Unternehmen mithilfe von Connectors importiert werden. Adobe System erwartet, dass diese Connectors vor dem Migrationsvorgang konfiguriert werden. Weitere Informationen finden Sie in der Hilfe zu Learning Manager-Connectors.

In Learning Manager wird Administratoren empfohlen, den Migrationsvorgang in einem Testkonto auszuprobieren, bevor Daten und Inhalte zur Learning Manager-Produktionsumgebung migriert werden.

Wichtige Schritte des Migrationsvorgangs keystepsofmigrationprocess

Im Folgenden finden Sie wichtige Schritte zum Migrieren von Inhalten und Daten eines vorhandenen LMS zu Learning Manager:

Der Integrationsadministrator oder Partner ermittelt die Daten und -inhalte des bestehenden LMS, die migriert werden sollen.
Der Integrationsadministrator prüft die Tools und Spezifikationen, die Learning Manager zum Erfassen von Daten und Inhalten bereitstellt.
Der Integrationsadministrator schreibt einen Code oder führt entsprechende manuelle Aufgaben durch, um die Schulungsdaten und -inhalte basierend auf den Funktionen des älteren LMS zu exportieren.
Sobald die Schulungsdaten und -inhalte verfügbar sind, werden sie vom Integrationsadministrator analysiert und den entsprechenden Migrationsspezifikationen von Learning Manager zugeordnet.
Der Integrationsadministrator migriert die Daten und Inhalte mithilfe der bereitgestellten Tools in folgender Reihenfolge zu Learning Manager:
1. Übertragen von Teilnehmenden zu Learning Manager
2. Übertragen von Schulungsinhalten in Learning Manager
3. Übertragen von Schulungsdaten in Learning Manager

Das Learning Manager-LMS kann jetzt samt der alten Inhalte vom Unternehmen genutzt werden.

Gültigkeitsbereich von Migrationsobjekten scopeofmigrationobjects

Sie können den Inhalt nur für die folgenden Lernobjekte migrieren:

Modul
Abzeichen
Kurs
Modulversion
Kursinstanz
Kursmodul
Kenntnisse
Kenntnisstand
Kenntniskurs
Zertifizierung
Zertifizierungskurs
Zertifizierung bestimmen
Lernprogramm
Lernprogrammkurs
Lernprogramminstanz
Lernprogrammkursinstanz
Arbeitshilfe
Version der Arbeitshilfe
Kurs der Arbeitshilfe
Von der Arbeitshilfe vermittelte Kenntnisse
Registrierung
Zertifizierungseinschreibung
Lernprogrammeinschreibung
Registrierung für Arbeitshilfe
Benutzerkursbewertungen

Wichtige Migrationskonzepte keyconceptsofmigration

Einige wichtige Konzepte des Learning Manager-Migrationsvorgangs werden im Folgenden kurz erläutert:

Migrationsprojekt

Ein Migrationsprojekt in Learning Manager besteht aus mindestens einem Sprint. Ein Konto kann mehrere Migrationsprojekte umfassen. Der Migrationsvorgang in Learning Manager beginnt mit der Erstellung des Migrationsprojekts.

Sprint

Im Rahmen des Learning Manager-Migrationsvorgangs ist ein Sprint definiert als eine Reihe von Migrationselementen, die zur Migration aus einem bestehenden LMS ausgewählt wurden. Bei einem Migrationselement kann es sich um ein Kursmodul, Teilnehmerdatensätze oder eine Reihe von Kursen handeln. Ein Sprint kann mehrere Schulungsdatenelemente umfassen. Migrationsaufträge können in jedem Sprint durchgeführt werden.

Sprint-Ausführungen

Sprint-Ausführung bezeichnet das Starten einer Migrationsaufgabe. Sie können die Sprint-Ausführung jederzeit während des Vorgangs unterbrechen.

Erneute Sprint-Ausführungen

Sie können einen Migrations-Sprint nach Abschluss jederzeit erneut ausführen. Diese erneute Ausführung eines Sprints erfolgt, wenn Sie die Daten an ein Sprint-Element anhängen und dieses erneut in die Anwendung migrieren oder die Fehler in CSVs beheben möchten.

CSV-Spezifikation

Learning Manager bietet Ihnen eine Reihe von CSV-Standardvorlagen. Es empfiehlt sich, diese CSV-Spezifikationen vor Beginn des Migrationsvorgangs durchzugehen. Der Integrationsadministrator des Unternehmens kann die vorhandenen Datenformate analysieren und den entsprechenden von Learning Manager bereitgestellten CSV-Vorlagenelementen zuordnen.

Migrationsprojekt-Tags

Adobe Systems empfiehlt, einige Suchbegriffe als Tags zu verwenden, um die Migrationsprojekte innerhalb von Learning Manager einfach wiederzufinden. Anhand dieser Tags können Sie Ihre Projekte in der Learning Manager-Anwendung jederzeit intern identifizieren.

Modul ohne Inhalt

Mit Learning Manager können Sie Module ohne Inhalt hochladen. Adobe Systems sieht es als Modul ohne Inhalt in Learning Manager an. In einem Szenario, bei dem Sie einige der älteren Daten von Ihrem vorhandenen LMS migrieren möchten, ohne dass Inhalte benötigt werden, können Sie die Datei module_version.csv ohne URL-Referenz hochladen.

CSV-Spezifikationen und Beispiel-CSVs csv

Im Folgenden finden Sie die CSV-Standardspezifikationen, die zur Verknüpfung mit Ihren vorhandenen LMS-Migrationsdaten verwendet werden können. Klicken Sie auf „CSV-Spezifikationen und Beispiel-CSVs“ („csv-templates“ und sample-csvs“) und laden Sie die ZIP-Dateien herunter. In der heruntergeladenen Datei „csv-specifications.zip“ sind sieben Excel-Dateien enthalten. Diese Excel-Dateien sind Spezifikationen mit Beschreibungen zum Ausfüllen von CSV-Dateien. Die entsprechenden CSV-Dateien sollten die Daten für jedes Feld im vordefinierten Format enthalten (wie in diesen XLSX-Dateien beschrieben).

Sl.no

Dateiname

Beschreibung des Inhalts

Hinweise

module.xlsx

Metadaten für module.csv

badge.xlsx

Metadaten für badge.xlsx

course.xlsx

Metadaten für course.csv

Es empfiehlt sich, für einen bestimmten Kurs den Namen nur eines Autos zu verwenden, da mehrere Namen nach der Migration in der Anwendung nicht genau angezeigt werden.

module_version.xlsx

Metadaten für module_version.csv

Achten Sie darauf, den URL-Pfad des Ordners für das Box-Konto anzugeben, in den Sie den Inhalt hochgeladen haben.

course_instance.xlsx

Metadaten für course_instance.csv

session.xlsx

Metadaten für session.csv

Stellen Sie sicher, dass jeder Eintrag in der Sitzungs-CSV mindestens einem Klassenzimmer-/virtuellen Klassenzimmermodul zugeordnet ist

course_module.xlsx

Metadaten für course_module.csv

skill.xlsx

Metadaten für skill.csv

skill_level.xlsx

Metadaten für skill_level.csv

skill_course.xlsx

Metadaten für skill_course.csv

certification.xlsx

Metadaten für Certification.csv

certification_course.xlsx

Metadaten für certification_course.csv

certification_commit.xlsx

Metadaten für certification_commit.csv

learning_program.xlsx

Metadaten für learning_program.csv

learning_program_course.xls

Metadaten für learning_program_course.csv

learning_program_instance.xlsx

Metadaten für learning_program_instance.csv

learning_program_instance_course_instance.xlsx

Metadaten für learning_program_instance_course_instance.csv

job_aid.xlsx

Metadaten für job_aid.csv

Für jede migrierte job_aid müssen eine oder mehrere job_aid-Versionen vorhanden sein.

Job_aid_version.xlsx

Metadaten für job_aid_version.csv

job_aid_course.xlsx

Metadaten für job_aid_course.csv

job_aid_skills.xlsx

Metadaten für job_aid_skills.csv

enrollments.xlsx

Metadaten für enrollments.csv

certification_enrollement.xlsx

Metadaten für certification_enrollement.csv

learning_program_enrollment.xlsx

Metadaten für learning_program_enrollment.csv

job_aid_enrollment.xlsx

Metadaten für job_aid_enrollment.csv

user_course_grade.xlsx

Metadaten für user_course_grade.csv

Ebenso empfiehlt es sich, die erforderlichen Teilnehmer-Datensatzdaten in der CSV-Datei bereitzustellen, auch wenn sie nicht erforderlich sind. Selbst wenn die CSV-Datei für die Migration verarbeitet wird, kann die Learning Manager-Anwendung ohne diese Info evtl. keine Daten darstellen. In der Datei „sample-csvs.zip“ sind sieben CSV-Dateien mit einer ähnlichen Namenskonvention wie oben enthalten.

user_skill.xlsx

Metadaten für user_skill.csv

Learning Manager unterstützt nur Datums- und Zeitwerte im UTF-8- und 32-Bit-Format. Während der Migration werden möglicherweise Fehler angezeigt, wenn Sie in CSV-Dateien ein Datum außerhalb des zulässigen Bereichs angeben (z. B. 2038-07-17T08:53:21.000Z oder 1980-04-17T08:13:25.322Z).

Sie müssen die folgenden Abhängigkeiten für CSV-Dateien während des Imports berücksichtigen:

„module_version.csv“ ist von „module.csv“ abhängig
„course_instance.csv“ ist von „course.csv“ abhängig
„course_module.csv“ ist von „course.csv“, „module.csv“ und „module_version.csv“ abhängig
„course_instance.csv“ ist von „course.csv“ abhängig
session.csv ist von „course.csv“ und „module.csv“ abhängig
„enrollment.csv“ ist von „course.csv“ abhängig
„user_course_grade.csv“ ist von „course.csv“ und „module.csv“ abhängig
„skill_course.csv“ ist von „course.csv“ abhängig
„skill_level.csv“ ist von „skill.csv“ abhängig
learning_program_instance.csv ist vom learning_program und learning_program_course.csv abhängig
learning_program_course.csv learning_program.csv abhängig ist
learning_program_enrollment.csv ist vom learning_program und learning_program_instance.csv abhängig
learning_program_instance_course_instance.csv ist von learning_program.csv, learning_program_instance.csv und course_instance.csv abhängig
certification_course.csv ist von certification.csv und von course.csv abhängig
„certification_commit.csv“ ist von „certification.csv“ und „certification_course.csv“ abhängig
„certification_enrollment.csv“ ist von „certification.csv“, „certification_course.csv“ und „certification_enrollment.csv“ abhängig

Reihenfolge von Kursen im Lernprogramm in Migrations-CSVs

In früheren Versionen der Migrationsspezifikationen enthielt die Datei learning_program_course.csv eine Bestellspalte, in der Sie darauf hinweisen, dass Sie die Reihenfolge der Kurse in einem Lernprogramm während der Migration steuern können.

Adobe Learning Manager verwendet diese Spalte nicht mehr. Die Kursreihenfolge in einem Lernprogramm kann nicht über Migrations-CSVs gesteuert werden, und das System ignoriert alle in der Spalte “Reihenfolge” angegebenen Werte, selbst wenn Sie orderEnforce auf “true” setzen.

Um Verwechslungen zu vermeiden, wurde die Bestellspalte aus den offiziellen CSV-Spezifikationen entfernt. Wenn Sie bereits Skripts oder Tools haben, die diese Spalte noch generieren, können Sie sie sicher ablegen. Es hat keine Auswirkungen darauf, wie Lernprogramme erstellt oder angezeigt werden.

Migrationsverfahren migrationprocedure

Vor dem Migrationsverfahren sind folgende Punkte zu beachten:

Innerhalb eines Kontos kann jeweils nur ein Migrationsprojekt aktiv sein. Innerhalb eines Projekts kann jeweils nur ein Sprint aktiv sein.
Wurde der Migrationsvorgang gestartet, kann die entsprechende Ausführung nicht mehr rückgängig gemacht werden. Sie können jedoch jede beliebige Daten- oder Inhaltsmigration mithilfe der Löschoption der jeweiligen Funktion in Learning Manager rückgängig machen.
Sobald das Migrationsprojekt beginnt, erhält es den Status “Unter Migration”. Während der Migration kann sich nur der Integrationsadministrator bei Learning Manager anmelden.

Erstellen von FTP- und Box-Konten creatingftpandboxaccounts

Ihr Migrationsprojekt zu planen, ist sehr wichtig. Es wird empfohlen, Ihre Projekte in mehrere Teile zu teilen und deutlich anzugeben, was Sie in den einzelnen Teilen migrieren möchten. Es kann auch ratsam sein, eine Überprüfung nach jedem Teil durchzuführen, um sicher zu gehen, dass die Daten in diesem Teil migriert wurden, anstelle einer Gesamtüberprüfungsphase am Ende des Projekts. Bevor Sie die Teile als Teil Ihres Migrationsprojekts starten, müssen Sie Daten und Inhalts-CSV-Dateien auf FTP- und Box-Server hochladen. Wenn Sie keine Konten für benutzerdefiniertes FTP und Box haben, können Sie sie erstellen.

Box-Konto erstellen

Erstellen Sie den Upload-Ordner für Inhalte in einem ähnlichen Vorgang wie beim Erstellen des FTP-Ordners. Klicken Sie im linken Bereich auf „Migration“ und dann unten auf der daraufhin angezeigten Seite auf „Anfordern“ für einen Upload-Ordner für Inhalte.

Sie erhalten eine E-Mail von Box mit einem Link zum freigegebenen Ordner. Wenn Sie über kein Box-Konto verfügen, klicken Sie auf „Registrieren“ und erstellen Sie ein Konto. Anweisungen zur Anmeldung werden an die E-Mail-ID des Integrations-Admins gesendet.

Hochladen von Daten (CSV-Dateien) auf FTP- oder Box-Ordner

Bevor Sie ein Migrationsprojekt erstellen, müssen Sie als Voraussetzung ein FTP- oder Box-Konto erstellen. In dieser Phase können Sie also ein Migrationsprojekt und einen Sprint in der Learning Manager-Anwendung erstellen. Informationen zum Erstellen von Migrationsprojekten finden Sie im Abschnitt Migrationsverfahren für Daten und Inhalte auf dieser Seite.

Klicken Sie im FTP- bzw. Box-Konto auf den Namen Ihres Projektordners und anschließend auf den Sprint-Namen. Innerhalb des Sprint-Ordners können Sie die CSV-Datendateien hochladen, die migriert werden sollen. Klicken Sie zum Hochladen oben auf dem FTP- oder Box-Server auf die Schaltfläche Dateien hochladen und legen Sie die CSV-Dateien ab. In der Abbildung unten sehen Sie ein Referenzbeispiel nach dem Hochladen auf FTP.

Sie können zum Learning Manager-Migrationsprojekt zurückkehren, auf Aktualisieren klicken und alle in Ihrem Migrations-Sprint aufgelisteten CSV-Datentypen anzeigen.

Schulungsinhalte in Inhaltsordner hochladen

Laden Sie die Schulungsinhalte von Ihrem vorhandenen LMS auf Ihr Box-Konto hoch. Wenn Sie bereits das Migrationsprojekt und den Sprint erstellt haben, füllt das Box-Konto das Migrationsprojekt und den Sprint-Namen aus. Sie können die Inhalte im selben Pfad hochladen. Informationen zum Erstellen von Migrationsprojekten finden Sie im Abschnitt Migrationsverfahren für Daten und Inhalte auf dieser Seite.

Sie können die Inhaltsdateien per Drag & Drop verschieben oder auf Hochladen klicken und die Dateien auf dem Desktop auswählen. Bei Inhalten mit sehr großen Dateigrößen kann es zu Verzögerungen beim Hochladen der Dateien kommen. Abhängig von der Größe der Datei ist die erforderliche Zeit zum Hochladen der Dateien auf Ihr Box-Konto unterschiedlich.

In der Abbildung unten sehen Sie ein Referenzbeispiel mit einem Box-Konto nach dem Hochladen von Inhalt:

Dateien in Box-Konto

Nachdem die Dateien auf Ihr Box-Konto hochgeladen wurden, stellen Sie sicher, dass Sie den relativen Pfad dieser Box-Inhaltsdatei in der Datei „module_version.csv“ angeben. Dies ist ein obligatorischer Schritt für Sie, um den Pfad des Modulinhalts anzugeben.

Wenn Sie sich bei den FTP- und Box-Servern angemeldet und den Inhalt hochgeladen haben, werden die CSV-Speicherorte wie in der Abbildung unten dargestellt in Learning Manager angezeigt.

CSV-Speicherorte im Box-Konto

Migration für Alternativen und Entsprechungen

Übersicht

In diesem Thema werden das CSV-basierte Datenmodell und das Migrationsverhalten zur Einführung der Lernobjektäquivalenz (LO) im System beschrieben.

Vorhandene CSV-Dateien (Kontext)

Diese CSVs sind bereits in der Plattform vorhanden und stellen das primäre Lernobjekt, das Modul und den Abschlusskontext bereit (nicht erschöpfende Liste):

user_course_grade.csv
Modulumkehrung
module.csv
course.csv
course_module.csv

Diese Dateien werden weiterhin unverändert verwendet und werden nicht durch die neue Äquivalenzfunktion geändert. Sie bilden jedoch die zugrunde liegenden Daten, auf denen die Äquivalenz angewendet wird.

Neue CSV-Dateien für Alternativen

Zwei neue CSVs werden eingeführt, um LO-alternative Beziehungen und entsprechende Benutzerabschlüsse zu unterstützen.

1. equivalence_relations.csv

Definiert Äquivalenzzuordnungen zwischen Quell- und Ziel-Lernobjekten (LOs), die entweder Kurse oder Lernpfade (LPs) sein können.

Schema:

sourceId
sourceloType (Kurs/LP)
targetId
targetLotype (Kurs / LP)
dateCreated
relatedStatus (AKTIV / DELETE)
dateModified

Zweck:

Stellt eine Äquivalenzbeziehung zwischen zwei LOs dar.
relationStatus steuert, ob die Beziehung derzeit aktiv oder gelöscht ist.
dateCreated und dateModified unterstützen Auditing.

equivalence_user_completion.csv

Erfasst Abschlussinformationen auf Benutzerebene für entsprechende LOs, die den in der Datei “equivalence_relations.csv” definierten Beziehungen entsprechen.

Schema:

userId
sourceId
sourceloType (Kurs/LP)
targetId
targetLotype (Kurs / LP)
dateCompleted

Zweck:

Explizit wird aufgezeichnet, welche LO-Zielabschlüsse für einen Benutzer auf der Grundlage der Äquivalenzbeziehung und der vorhandenen LO-Quellabschlüsse abgeleitet werden sollen.
Dient als autoritative Quelle für Benutzerabschlüsse, die mit Daten migrierter Entsprechungen verknüpft sind.

Migrationsregeln und Verhaltenssemantik

1. Keine Nachrüstungsunterstützung für neue Entsprechungen von CSVs

Alle äquivalenzbezogenen Daten müssen über die Migration eingegeben werden.
Das System unterstützt keine Szenarien, in denen:
- LO-Daten (Kurse/LPs) wurden über die Benutzeroberfläche erstellt und
- Äquivalenzbeziehungen werden später nur über CSV importiert.

Dies bedeutet:

Das unterstützte Muster ist: LO-Definitionen und ihre Äquivalenzbeziehungen werden als Teil eines kohärenten Migrationsflusses verwaltet.
Hybride Flows, bei denen über die Benutzeroberfläche erstellte LOs mit einer reinen CSV-Äquivalenz nachgerüstet werden, werden nicht unterstützt.

2. Keine retroaktiven Abschlüsse/Unvollständigkeiten aus migrierten Beziehungen

Wenn eine Äquivalenzbeziehung über Migration eingeführt wird (d. h. über equivalence_relations.csv):

Das System führt keine retroaktive Fertigstellungs- oder Unvollständigkeitsberechnungen durch, die ausschließlich auf dieser Beziehung basieren.
Stattdessen müssen alle erforderlichen Benutzervervollständigungsdaten explizit über equivalence_user_completion.csv bereitgestellt werden.

Implikation:

equivalence_user_completion.csv ist die einzige Quelle der Wahrheit für alle Abschlüsse, die bei der Migration als Ergebnis der Äquivalenz erkannt werden sollten.
Die Plattform versucht nicht, diese Abschlüsse vom vorhandenen Kursfortschritt abzuleiten oder zu vervollständigen.

3. Verhalten für neue Abschlüsse nach der Migration

Wenn:

Eine Äquivalenzbeziehung wurde durch Migration erstellt und
Ein Teilnehmer schließt später das Quell-LO ab (nach der Migration).

dann:

Das System löst alternative Abschlüsse für das Ziel-LO aus, d. h., die Äquivalenz verhält sich in der Regel bei neuen Quellenabschlüssen.

Hauptunterscheidung:

Zum Migrationszeitpunkt: Abschlüsse müssen über equivalence_user_completion.csv erfolgen.
Nach der Migration: Die native Laufzeitlogik verarbeitet alternative Abschlüsse, wenn ein Quell-LO neu abgeschlossen wird.

4. Auswirkungen auf Lernobjekte höherer Ordnung

Alternative Abschlüsse, die über CSV eingehen (d. h. über equivalence_user_completion.csv), lösen eine Neuberechnung von LOs höherer Ordnung aus.

LOs höherer Ordnung können Folgendes umfassen:

Lernpfade

Technische Auswirkungen:

Die Aufnahme von equivalence_user_completion.csv ist kein “unbeaufsichtigter” Vorgang: Sie initiiert die gleiche Neuberechnungs-/Roll-up-Logik, die durch normale Laufzeitabschlüsse ausgelöst wird.
Systeme, die diese Migration integrieren oder planen, müssen die Last und den Zeitpunkt der Neuberechnung planen.

Webhooks für Alternativen

Wenn ein Teilnehmer einen Kurs über eine alternative Registrierung oder über eine Beziehung abschließt, generiert Adobe Learning Manager ein dediziertes Webhook-Ereignis, das sich vom Standard-Webhook für den Kursabschluss unterscheidet, sodass Integrationen verschiedene Handhabungslogik für alternative Abschlüsse anwenden können. Webhook-Ereignisse werden auch für den rückwirkenden Abschluss und die rückwirkende Nicht-Abschluss generiert und decken historische Änderungen des Kursstatus ab, einschließlich solcher, die durch Aktualisierungen von Beziehungen gesteuert werden, sodass externe Systeme mit dem aktuellen Abschlussstatus des Teilnehmers synchronisiert bleiben.

Informationen zu webhooks for Alternates finden Sie unter webhooks for Alternates.

Migrationsverfahren für Daten und Inhalte dataandcontentmigrationprocedure

Das Verfahren zur Migration der LMS-Daten und -Inhalte Ihres Unternehmens zu Learning Manager wird im Folgenden erläutert:

Prüfen Sie die Voraussetzungen für den Migrationsprozess, bevor Sie mit der Migration beginnen. Bereiten Sie die CSV-Dateien für die Daten- und Inhaltsmigration wie auf dieser Seite im Abschnitt CSV-Spezifikationen und Beispiel-CSVs beschrieben vor.

Melden Sie sich bei der Learning Manager-Anwendung als Integrationsadministrator an und klicken Sie im linken Teilfenster auf Migration.

Daraufhin wird die Startseite für Migrationsprojekte angezeigt. Wenn Ihr Unternehmen bereits Migrationsprojekte erstellt hat, können Sie auf dieser Seite eine Liste mit allen Migrationsprojekten anzeigen.
Klicken Sie in der rechten oberen Ecke der Seite auf Neu, um ein Migrationsprojekt zu erstellen. Alternativ können Sie auf der Seite auf den Link Migrationsprojekt erstellen klicken, um ein Migrationsprojekt zu erstellen. Daraufhin wird die Seite zum Erstellen eines Migrationsprojekts angezeigt.

Wenn Sie noch keinen FTP-Ordner erstellt haben, werden Sie aufgefordert, einen FTP-Ordner im Konto zu erstellen. Dies ist ein obligatorischer Schritt, bevor Sie mit dem Erstellen eines Migrationsprojekts beginnen.

FTP-Ordner erstellen

Geben Sie den Projektnamen, das Projekt-Tag, den Kurskatalog und eine Beschreibung für Ihr Migrationsprojekt an. Klicken Sie auf Erstellen.

Ihre Migrationsdatenelemente werden mithilfe dieses Migrationsprojekt-Tags identifiziert. Wenn Sie über keinen bestimmten Kurskatalog verfügen, wählen Sie den Standardkatalog in der Dropdown-Liste aus. Alle Kurse, die mithilfe eines Migrationsprojekts migriert werden, sind im Katalog enthalten, den Sie in dieser Phase ausgewählt haben. Wenn Sie keinen Katalog auswählen, sind alle migrierten Kurse Teil des Standardkatalogs.
Die Seite der Sprint-Konfiguration wird angezeigt (siehe nachfolgende Abbildung). Sie müssen einen Sprint als Teil Ihres Migrationsprojekts erstellen. Wählen Sie einen Sprint-Namen aus und geben Sie eine kurze Beschreibung des Sprints an. Sie können „Ja“ auswählen, wenn Sie Inhalte als Teil dieses Sprints migrieren möchten. Klicken Sie auf Weiter.

Sprint-Migration

Aktivieren Sie das Kontrollkästchen Benutzer wurden seit der letzten Ausführung hinzugefügt oder geändert, um die Liste der Benutzer mit der Learning Manager-Anwendung zu synchronisieren. Wenn Sie den Inhalt und die Daten in die Learning Manager-Anwendung migrieren, ist dies unter Umständen nicht erforderlich. Wenn zwischen Ihrer früheren Sprint-Migration und der neuesten Sprint-Migration jedoch eine Zeitspanne liegt, wird empfohlen, die Liste der Benutzer zu synchronisieren. Bei diesem Schritt kann die Learning Manager-Datenbank mit Ihren LMS-Benutzern synchronisiert werden.

Dieser Synchronisierungsschritt wird empfohlen, wenn die Dateien „enrollment.csv“ und „user_course_grade.csv“ migriert werden. Bei diesem Schritt kann die Learning Manager-Datenbank mit Ihrer Migrationsdatenbank synchronisiert werden und es wird sichergestellt, dass alle Benutzer, deren Datensätze im Sprint migriert werden sollen, in der Migrationsdatenbank zur Verfügung stehen.
Sie können die Sprint-Migration mit Ihren hochgeladenen Daten und Inhalten beginnen. Klicken Sie vor dem Start des Sprint-Laufs auf den Link Aktualisieren, um die FTP- und Inhaltsordner mit der Learning Manager-Anwendung zu synchronisieren.

Sprint-Migration starten

Klicken Sie in der rechten oberen Ecke der Seite auf Start. Sie können während des Sprint-Migrationsvorgangs jederzeit auf Stopp klicken, um die Sprint-Migration abzubrechen.

Der Migrationsstatus wird für die jeweiligen Sprint-Datenelemente und -Inhalte angezeigt. Überprüfen Sie die Anzahl der erfolgreichen und fehlgeschlagenen Elemente als Teil des Sprint-Laufs der Migration.

Stellen Sie beim Hochladen von Modulinhalten sicher, dass der Pfad des Inhaltsordners in der Datei „module_version.csv“ angegeben wird. Wenn Sie diesen Schritt versäumen, stellen Sie möglicherweise Fehler während der Migration fest. Wenn Sie beispielsweise Inhalte von Modulen zum Selbststudium (z. B. Videos) hochladen, müssen Sie den relativen Box-URL-Pfad in der Datei „module_version.csv“ angeben. Für Inhalte des Aktivitätsmoduls können Sie den URL-Namen festlegen.

In der Abbildung unten sehen Sie ein Referenzbeispiel für den Fortschrittsdialog. Sie können die Anzahl der für jedes Migrationsdatenelement verarbeiteten Datensätze zusammen mit dem Status der erfolgreichen und fehlgeschlagenen Elemente sehen. Klicken Sie auf „Fehlerdatensätze für die fehlgeschlagenen Elemente herunterladen“, um die Fehlerprotokolle herunterzuladen und anzuzeigen. Sie können die Probleme in der CSV-Datei beheben und diese erneut auf FTP hochladen.

Anzeigen des Sprint-Fortschritts

Klicken Sie im linken Bereich auf die Sprint-Liste, wenn Sie die Liste aller Sprints eines Migrationsprojekts anzeigen möchten. Sie können eine Liste aller Sprints, die Anzahl der für jeden Sprint ausgeführten Läufe, das Startdatum, die Dauer und den Abschlussstatus anzeigen, wie in der Abbildung unten dargestellt.

Liste der Sprints anzeigen
Nachdem Sie die neuesten aktualisierten CSV-Dateien hochgeladen haben, können Sie in der oberen rechten Ecke der Seite auf „Wiederholen“ klicken. Bei der Wiederholung werden alle Datenelemente noch einmal verarbeitet und Elemente ignoriert, für die es keine Änderungen gibt. Sobald Sie mit der Migration von Datenelementen in einem Sprint zufrieden sind, können Sie die Sprint-Migration als abgeschlossen markieren, indem Sie auf die Schaltfläche oben auf der Seite klicken. Sie können einen neuen Sprint mit mehr Datenelementen zu einem späteren Zeitpunkt starten. Sobald ein Sprint als abgeschlossen markiert wurde, können Sie ihn nicht erneut wiederholen. Dementsprechend kann ein Migrationsprojekt eine beliebige Anzahl von Sprints umfassen. Sobald Sie mit dem Migrationsstatus aller Sprints zufrieden sind, können Sie das Migrationsprojekt als abgeschlossen markieren, indem Sie auf der Seite der Sprint-Liste auf den Link Projekt als abgeschlossen markieren klicken.

Bevor Sie das Migrationsprojekt als abgeschlossen markieren, müssen Sie sicherstellen, dass alle Sprints des Projekts abgeschlossen sind. Nachdem Sie das Migrationsprojekt als abgeschlossen markiert haben, können Sie nicht zurückgehen und Sprints in diesem Projekt erstellen oder Änderungen an diesem Projekt vornehmen. Sie müssen ein weiteres Migrationsprojekt erstellen und ihm Sprints hinzufügen.

Migrationsverifizierung registration

Nachdem Sie die Lerndaten und -inhalte aus dem älteren LMS Ihres Unternehmens migriert haben, können Sie die importierten Daten und Inhalte mit verschiedenen Lernobjektfunktionen überprüfen. Sie können sich beispielsweise bei der Learning Manager-Anwendung als Administrator anmelden und die Verfügbarkeit der Daten und Inhalte von importierten Modulen und Kursen überprüfen.

Migration mithilfe von APIs

Adobe Learning Manager (ALM) bietet eine Migrationsfunktion zum Importieren von Daten oder Inhalten aus externen Systemen, die hauptsächlich für die Migration von älteren LMS-Plattformen verwendet wird.

Einige Organisationen können jedoch verlangen, dass dieser Prozess in einem regulären Zeitplan (z. B. nachts oder wöchentlich) ausgeführt wird, anstatt als einmaliger Import.

Als Beispiel sehen Sie, wie ein fiktiver Kunde (NovaFX) mit einem fiktiven externen Anbieter (SquareCorp) integriert und geplante Migrationen automatisiert. Die Integration bietet folgende Möglichkeiten:

SquareCorp-Kurse werden für NovaFX-Teilnehmer als Lernobjekte in ALM angezeigt.
NovaFX verfolgt den Fortschritt der Teilnehmer bei von SquareCorp gehosteten Kursen direkt in ALM.

Integrationsanforderungen

SquareCorp muss Folgendes bereitstellen:

Informationen zu den Kurs-Metadaten: Eine API zum Freigeben von Kurs-Metadaten, auf die NovaFX Zugriff hat.
Fortschrittsdateninformationen: Eine API zum regelmäßigen Teilen von Informationen zum Fortschritt und Abschluss von Teilnehmern.

Schlüsseldefinitionen

Aktives Projekt: Ein Projekt ist aktiv, wenn es “In Bearbeitung” oder “Initialisiert” ist.
Aktiver Sprint: Ein Sprint ist aktiv, wenn er “In Bearbeitung” oder “Initialisiert” ist.

Automatisieren der Sprint-Ausführung

Erstellen Sie eine App oder ein Skript, die bzw. das Folgendes nach einem Zeitplan ausführt:

Rufen Sie Kurs-Metadaten, Benutzerregistrierungen und Teilnehmerbewertungen von SquareCorp ab.
Generieren Sie die CSV-Dateien.
Laden Sie die Dateien auf Box oder FTP hoch.
Lösen Sie den Sprint über die Migrations-APIs aus.

API-Details

Migrationslauf starten

Endpunkt: POST /primeapi/v2/bulkimport/startrun

Parameter:

lockaccount (Boolean): Der Parameter bestimmt, ob das Konto zu Beginn der Ausführung gesperrt werden soll. Standardmäßig ist sie auf “false” festgelegt. Es wird empfohlen, dass Benutzer diesen Parameter nur verwenden, wenn ein gültiger Grund für das Sperren des Kontos vorliegt.
catalogId (Integer): Mit diesem Parameter können Sie den Zielkatalog während der Migration auswählen. Er wird in der Regel beim Erstellen des Migrationsprojekts festgelegt, kann jedoch für einzelne Ausführungen angepasst werden. Wenn der Katalog geändert wird, werden in zukünftigen Ausführungen hinzugefügte Lernobjekte im zuletzt ausgewählten Katalog platziert. Wenn Sie zum Katalog zurückkehren müssen, der während der Erstellung des Migrationsprojekts ausgewählt wurde, müssen Sie dies auch explizit angeben.
migrationProjectId (Integer): Der Parameter ist erforderlich, um ein bestimmtes Migrationsprojekt auszulösen, wenn mehrere API-fähige Ausführungen im Konto aktiviert sind.

Überprüfen Sie, ob die Synchronisierung beginnen kann

Stellen Sie sicher, dass Inhalte mit dem Sprint-Ordner synchronisiert werden können. Kopieren Sie keine Inhalts- oder Metadatendateien in den FTP-Ordner, es sei denn, diese API gibt ein erfolgreiches Antwortobjekt zurück.

Endpunkt: GET /primeapi/v2/bulkimport/cansync

Parameter:

migrationProjectId (Integer) Der Parameter ist erforderlich, um ein bestimmtes Migrationsprojekt auszulösen, wenn mehrere API-fähige Ausführungen im Konto aktiviert sind.

Antworterfolg

{
    "status": "OK",
    "title": "BULKIMPORT_CAN_SYNC_NOW",
    "source": {
        "info": "Yes"
    }
}

Antworterfolg

{
    "status": "BAD_REQUEST",
    "title": "BULKIMPORT_ERROR_CANNOT_SYNC",
    "source": {
        "info": "Error, No active projects"
    }
}

Mögliche API-Antworten

Aktion

Typ

Nachricht

BULKIMPORT_RUN_INITIATED_SUCCESSFULLY

Erfolgreich

Ausführung erfolgreich initiiert