Import aus JoomLeague 3

Der Import aus der alten JoomLeague für Joomla 3 muss historische Daten erhalten und in ein für Joomla 6 nutzbares Schema überführen.

Es gibt zwei unterstützte Wege, eine alte Datenbank nach JoomLeague 6 zu übernehmen:

1. Online-Migrationswerkzeug — wandelt einen rohen JoomLeague-3-SQL-Dump in eine mit JoomLeague 6 kompatible SQL-Datei um.
2. SQL-Import in der Komponente — lädt diese umgewandelte SQL-Datei tabellenweise in Ihre Website.

Der übliche Ablauf ist: zuerst das Online-Werkzeug ausführen, dessen Ergebnis dann mit dem Werkzeug in der Komponente importieren.

1. Online-Migrationswerkzeug

Adresse: migrate.klucon.cz

Das Werkzeug nimmt einen exportierten SQL-Dump einer alten JoomLeague-3-Datenbank entgegen und gibt einen umgewandelten Dump zurück, der dem aktuellen JoomLeague-6-Schema entspricht.

Schritte

1. Exportieren Sie die alte Datenbank (oder nur die #__joomleague_*-Tabellen) als SQL-Datei.
2. Öffnen Sie migrate.klucon.cz und laden Sie die SQL-Datei hoch.
3. Warten Sie, bis die Phasen abgeschlossen sind (provision, sanitize, import, migrate, validate, export).
4. Laden Sie das resultierende ZIP mit der umgewandelten migrated.sql herunter.

Was das Werkzeug tut

• läuft je Auftrag in einer isolierten, temporären Staging-Datenbank;
• vereinheitlicht das Tabellenpräfix auf den neutralen Platzhalter #__;
• wandelt MyISAM in InnoDB und alte Zeichensätze in utf8mb4 um;
• korrigiert Null-/Leer-Daten zu NULL;
• ordnet alte Länderwerte dem neuen Länder-Code-Verzeichnis zu;
• ergänzt Tabellen und Spalten, die nur in JoomLeague 6 existieren;
• setzt die Ziel-JoomLeague-Version in den migrierten Daten.

Datenschutz

Jeder Auftrag verwendet eine eigene temporäre Datenbank, die nach dem Export verworfen und gelöscht wird. Hochgeladene Daten werden nicht aufbewahrt.

2. SQL-Import in der Komponente

Ort: JoomLeague → Dashboard → Werkzeuge → SQL-Import

Dieses Werkzeug importiert einen JoomLeague-SQL-Dump (zum Beispiel die migrated.sql aus dem Online-Werkzeug) tabellenweise in die aktuelle Website, mit Fortschritt je Tabelle.

Schritte

1. Öffnen Sie JoomLeague → Dashboard → Werkzeuge → SQL-Import.
2. Wählen Sie die SQL-Datei und klicken Sie auf Datei analysieren.
3. Prüfen Sie die erkannten Tabellen und ihre Datensatzanzahl.
4. Klicken Sie auf Import starten — jede Tabelle wird nacheinander importiert und mit einem grünen Haken oder einem roten Kreuz markiert.
5. Klicken Sie nach dem Abschluss auf Fertig, um zum Dashboard zurückzukehren.

Hinweise

• Der Import erkennt das Präfix des Dumps automatisch und schreibt es auf das Präfix Ihrer Website um.
• Tabellen werden in einer festen Reihenfolge importiert, damit die Relationen korrekt aufgelöst werden.
• Die Tabelle version wird bewusst übersprungen, damit der importierte Dump den Versionsmarker der installierten Komponente niemals überschreiben kann.

Import überschreibt Daten

Der Import überschreibt die vorhandenen JoomLeague-Daten in den betroffenen Tabellen. Sichern Sie vor einem Import immer Ihre Datenbank.

Typische Probleme alter Daten

• MyISAM-Tabellen;
• älterer Zeichensatz utf8mb3;
• fehlende Spalten wie published;
• Null- oder Leer-Daten;
• Texte als Sprachkonstanten gespeichert;
• fehlende Relationen und Indizes.

Das Online-Migrationswerkzeug behandelt alle diese Fälle automatisch.

Legacy-Sprachkonstanten

Wenn ein importierter Wert wie eine Sprachkonstante aussieht, darf er nicht durch hart codierten übersetzten Text ersetzt werden.

Die Ausgabeschicht soll ihn über Text::_() anzeigen.

Neuer Code darf keine neuen Legacy-Konstanten erzeugen. Neue Konstanten verwenden das aktuelle Namensschema COM_JOOMLEAGUE_*.