Anleitung Migrationstool für OSG Seminar Manager Joomla 4

Bei der Umstellung bzw. dem Upgrade auf Joomla 4 werden Ihre alten Daten aus dem Seminar Manager nicht automatisch übertragen. Damit Sie den neuen SMAN 4 wie zuvor nutzen können, können Sie mithilfe des Importers Ihre Daten migrieren.

Aktuell setzt die Bedienung des Importers technisches Know How in der Arbeit mit MySQL voraus. Weiter unten finden Sie eine Bedienungsanleitung. Wir sind stetig dabei, diese zu aktualisieren und noch detaillierter zu gestalten. Sehen Sie sich den Changelog zum Importer an (am Seitenende) und erfahren Sie mehr über weitere Updates.

Aufgrund der Komplexität der Bedienung des Importers bieten wir den kostenpflichtigen Service, Ihre alten Daten für Sie in den SMAN 4 zu importieren. Kontaktieren Sie uns: .

Kurzes FAQ Seminar Manager (SMAN)-Importer

1. Was kann der Importer?

Der Importer ist ein Migrations-Tool, um Datenbanktabellen mit ihren Feldern aus dem Seminar Manager 3 in die aktuellere Version Seminar Manager 4 zu importieren.

2. Welche Daten kann der Importer importieren?

Mit dem Importer können Sie folgende Daten Ihrer Kurse in SMAN 4 importieren:

• alle Daten ausser Fotos, Bildern und Kurs-Dokumente

Die Kurs-Dokumente werden bald zur Migration in SMAN J4 verfügbar sein, Joomla com_media wird dort eingesetzt.

3. Welche Daten können nicht importiert werden?

• Fotos & Bilder: Benutzen Sie dafür den Medienmanager.
• Joomla-Benutzer können bei der Neuinstallation von J4 nicht via SMAN Importer importiert werden. Nutzen Sie dafür einen der im Joomla Extension Manager zahlreich angebotenen User Importer. (Bei einem Upgrade von J3 zu J4 werden die User automatisch importiert.)

Kontaktieren Sie uns, falls es auf Ihrer Website eine grosse Anzahl von Fotos, Bildern sowie Kurs-Dokumenten gibt. Wir bieten Ihnen eine individuelle Übertragung von Fotos, Bildern und Kurs-Dokumenten an, wie z.B.: die Übertragung in den Joomla Media Manager, neue Ordnerstruktur im Media Manager, erneute Dateizuordnung für Kurse / Tutoren, etc.

4. Wie funktioniert der Export bzw. Import bei einem Upgrade von J3 auf J4?

In der nachfolgenden Kurzübersicht können Sie sich einen Überblick über die Reihenfolge der Migration mit dem Importer verschaffen. Eine detaillierte Anleitung finden Sie weiter unten.

1. SMAN J3 komplett sichern: Invoice, Bilder sowie andere Datei-Ordner und SQL Tabellen (dump alle __seminarman_xxx Tabelle, z.B. über phpMyAdmin)
2. SMAN J3 in Joomla 3 System deinstallieren
3. Upgrade von J3 auf J4
4. SMAN J4 in Joomla 4 System installieren
5. J3 / J4 Importer (Migrationstool / Expert Mode) in SMAN J4 aktivieren
6. Vorheriges SQL Dump File über z.B. Notepad++ bearbeiten, um einen "J3 Identifier" hinzufügen (siehe Beschreibung)
7. Obige verarbeitete SQL Dump in J4 Datenbank (z.B. über phpMyAdmin) importieren
8. 12 Wizard Steps des Importers durchführen

Anleitung SMAN-Importer

Die aktuelle Version des Seminar Managers mit dem Importer können Sie im Downloadbereich und mit einer aktiven Mitgliedschaft herunterladen. Melden Sie sich dazu an auf: https://seminar-manager.ch/de-de/benutzerkonto/login.

Öffnen Sie im Joomla-4-Backend Ihrer Seminar-Manager-Komponente das Menü Optionen. Aktivieren Sie im Reiter Misc. unter Expertenmodus das “Migrationstool für Seminarman J3” (Auswahl “Ja”).

Scrollen Sie bis zum Seitenende dort finden Sie den Expertenmodus.

Die Auswahl “Reiter für J3-Referenz” ist optional.
Mit der Auswahl “Ja” erscheint bei denen aus J3 importierten Objekten wie Kurs / Tutor / Buchung ein Reiter. Unter diesem sieht man die originalen Dateninformationen aus J3 für dieses Objekt.

Es kann z.B. passieren, dass ein fehlerhaftes Custom Field mit nicht identischen Options in J4 erstellt wurde und es bei der J3-J4 Feld-Abbildung an einem J3 Feld zugewiesen wurde. Darüber hinaus wird das Option-Value bei diesem Feld fehlerhaft importiert.

Durch den Reiter für J3-Referenz haben Sie die Möglichkeit, noch auf die originalen Infos von J3 zuzugreifen und etwaige Fehler nachträglich manuell zu beheben.

Nun können Sie mit der Migration beginnen.

Wichtig: Führen Sie Schritt 1 manuell korrekt durch.

Schritt 1: Exportieren Sie alle SMAN J3 Datenbanktabellen in ein SQL-File. Die Tabellen beinhalten alle den Prefix: seminarman (danach kann selektiert werden). Das SQL-File beinhaltet alle Tabellen.

Schritt 2: Öffnen Sie die in Schritt 1 exportierte Dump-Datei mit einem Plain-Text-Editor und suchen Sie nach "`YourJ3Prefix_seminarman_".
Ersetzen Sie alle diese Ausdrücke durch "`YourJ4Prefix_seminarman_zzzj3_".

Schritt 3: Importieren Sie die obige SQL-Dump-Datei in Ihre Joomla 4-Datenbank. Die Dump-Datei soll eine Reihe der folgenden Ausdrücke enthalten:

- CREATE TABLE `YourJ4Prefix_seminarman_zzzj3_...`
- INSERT INTO `YourJ4Prefix_seminarman_zzzj3_...`

Schritt 4: Öffnen Sie nun Systemwerkzeuge im Joomla-4-Backend Ihrer Seminar-Manager-Komponente. Unter Import / Export finden Sie dann den Importer: Migrationstool für OSG Seminar Manager Joomla 3. Klicken Sie auf diesen, um ihn zu starten.

Schritt 5: Führen Sie die 12 Steps des Import-Wizards durch.

Wichtig: Zwischen den Steps 2-7 ist die Reihenfolge, in der Sie die Importe durchführen, nicht wichtig. Nach Step 7 müssen die Steps in der richtigen Reihenfolge bearbeitet werden.

Step 1: Prüfen Sie im Migrationstool, ob das J3 SQL-File korrekt importiert ist.

In den Steps 2-5 importieren und prüfen Sie die einzelnen Tabellen.

Prüfen Sie die Tabelleninhalte und sehen Sie die alten und neuen IDs, die vergeben werden.

In Step 2 importieren Sie die Kategorien.

Klicken Sie auf den Button im Anschluss der Tabelle.

In Step 3 sehen Sie die zu importierenden Tags/Stichwörter.

Klicken Sie auf den Button, um den Import abzuschliessen.

Wichtige Info zu Email / PDF Vorlagen (Steps 4 und 5): 

UPDATE: Ab Version 4.1.2beta2 werden die Template-Parameter während des Migrationsprozesses automatisch korrigiert.

Nur wenn Sie Ihre Website mit einer früheren Version als 4.1.2beta2 migriert haben, müssen Sie die Vorlagenparameter manuell aktualisieren:

{PRICE_PER_ATTENDEE}: Preis pro Teilnehmer
{PRICE_PER_ATTENDEE_VAT}: Preis pro Teilnehmer inkl. Steuern
{PRICE_TOTAL}: Gesamtpreis
{PRICE_TOTAL_VAT}: Gesamtpreis inkl. Steuern
{PRICE_REAL_BOOKING_SINGLE}: Buchungspreis pro Teilnehmer
{PRICE_REAL_BOOKING_TOTAL}: Gesamtpreis ohne Steuern (mit Berechnung von Rabatten)

{PRICE_TOTAL_ORIG_VAT}: Gesamtpreis inkl. Steuern (ohne Berechnung von Rabatten) *

Sie werden durch die nachfolgenden Parameter ersetzt. Leider können Sie nicht während des Imports automatisch korrigiert werden. Bitte korrigieren Sie die Parameter manuell, nachdem die Email / PDF-Templates (Step 4 & 5) importiert wurden.

{PRICE_STANDARD}: Preis pro Teilnehmer
{PRICE_STANDARD_W_VAT}: Preis pro Teilnehmer inkl. Steuern
{PRICE_STANDARD_TOTAL}: Gesamtpreis
{PRICE_STANDARD_TOTAL_W_VAT}: Gesamtpreis inkl. Steuern
{PRICE_BOOKING}: Buchungspreis pro Teilnehmer
{PRICE_BOOKING_TOTAL}: Gesamtbuchungspreis ohne Steuern (mit Berechnung von Rabatten)

{PRICE_BOOKING_TOTAL_W_VAT}: Gesamtbuchungspreis inkl. Steuern (mit Berechnung von Rabatten) *

* kein 1:1 Ersatz für {PRICE_TOTAL_ORIG_VAT}, es war ein falscher Parameter in Joomla 3 Version, stattdessen gibt es einen neuen Parameter {PRICE_BOOKING_TOTAL_W_VAT} in der Joomla 4 Version

In Step 4 sehen Sie die E-Mail Vorlagen. Klicken Sie auf den Button, um den Import abzuschliessen. 

In Step 5 importieren Sie die PDF Vorlagen mit einem Klick auf den Button.


In Step 6 sehen Sie alle verfügbare benutzerdefinierten Felder in Joomla 3 im Überblick.

Dies gibt Ihnen eine Übersicht der benutzerdefinierten Felder.

Erstellen Sie im Seminar Manager 4 zuerst die Custom Fields manuell und weisen Sie in Schritt 7 die Custom Fields aus Seminar Manager 3 den neuen zu. Folgen Sie der Anleitung weiter unten.

Nach Step 6 (benutzerdef. Felder in SMAN J4), sollten Sie ein Buchungsformular in Joomla 4 manuell einrichten und setzen Sie es als default, nach dieser Anleitung: https://seminar-manager.ch/de-de/sman4/category/buchungsfomulare-erstellen-und-zuweisen

Wichtig: Wenn Sie kein Buchungsformular manuell einrichten, kann es sein, dass die importierten Daten nicht im Backend erscheinen.

In Step 7 mappen/weisen Sie die benutzerdefinierten Felder aus der Joomla 3 Installation denen in J4 zu. Erstellen Sie zuvor die benutzerdefinierten Felder manuell.

In der linken Spalte können Sie die benutzerdefinierten Felder aus dem Seminar Manager 3 auswählen und in der rechten Spalte den neuen benutzerdefinierten Felder in Joomla 4 zuweisen.

Klicken Sie auf den + Button, um weitere Felder zuzuweisen. Speichern Sie Ihren Fortschritt mit dem “Save”-Button.

Bereiten Sie die benutzerdefinierten Felder, die Sie importieren möchten, in SMAN Joomla 4 manuell exakt so vor und dann können Sie diese mappen (zuweisen).

Öffnen Sie unter Systemwerkzeuge den Reiter Allgemein und klicken Sie auf “Benutzerdefinierte Felder”.



Unter “Neu” können Sie nun die benutzerdefinierten Felder hinzufügen.

In Step 8 werden die Kursvorlagen importiert.

In den folgenden Schritten sehen Sie die Möglichkeiten zur Abbildung von benutzerdefinierten Feldern zwischen J3 / J4.

In Step 9 importieren Sie die benutzerdefinierten Kursfelder.

In J3 wurden diese in den Optionen unter “benutzerdefinierte Kursfelder” global angelegt.

Mit Step 10 importieren Sie die Buchungen. Auch hier haben Sie die Möglichkeit, mit dem “Custom Field” Mapping die benutzerdefinierten Felder zuzuweisen. 

Ausserdem können Sie wahlweise J3 User IDs importieren.

Mit Step 11 importieren Sie die Interessenten.

Mit Step 12 wird der Import abgeschlossen.

Abschliessend kopieren Sie alle Invoice Files, Certificate Files, Email Attachment Files vom J3 Invoice-Ordner (default heisst dieser "invoices") in den in J4 eingestellten Invoice-Ordner (default heisst dieser "invoices").

Wir führen den Import für Sie durch

Brauchen Sie Unterstützung beim Import Ihrer Daten in SMAN 4? Gerne bieten wir Ihnen unsere Dienste an. Kontaktieren Sie uns: