Inhalte aus einem anderen CMS migrieren #

Diese Seite ist für Integratoren, die eine Website aus einem anderen Content-Management-System nach Exponential übertragen. Eine Migration ist eine Integration, die ein paar Mal statt jede Nacht läuft, aber sie braucht dieselbe Disziplin: einen Schlüssel pro Datensatz, einen Probelauf, einen wiederholbaren Import und eine Prüfung. Migrationen von früheren Versionen dieser Codebasis (4.x, 5.x Legacy) sind eine andere Aufgabe, die das Installationsbuch behandelt (Von 4.x migrieren).

Inhalt #

1. Die Phasen
2. Bestandsaufnahme und Abbildung
3. Der Importansatz
4. Interne Links, Medien und Benutzer
5. Alte Adressen
6. Proben und Umstellung
7. Abnahme

Die Phasen #

Bestandsaufnahme und Abbildung #

Zählen Sie, bevor Sie schätzen: Inhalte pro Typ und Sprache, die Tiefe des Baums, Anzahl und Größe der Mediendateien, den Anteil an Rich Text mit eingebetteten Elementen (Tabellen, Einbettungen, Shortcodes), Benutzer und ihre Gruppen sowie die URL-Muster. Jedes Muster eingebetteten Markups, das das alte System erfunden hat (Shortcodes, Makros), ist eine Umwandlungsregel, die gebaut und getestet werden muss.

Vereinbaren Sie mit dem Kunden, was nicht migriert wird: veraltete Neuigkeiten, Entwürfe, Revisionen, Kommentare, Statistiken. Jedes ausgelassene Element spart Zeit in jeder Probe.

Der Importansatz #

Importieren Sie in der Reihenfolge der Abhängigkeiten: Ordner und Kategorien, dann Medien, dann Inhalte, die auf sie verweisen, dann Beziehungen in einem zweiten Durchlauf. Veröffentlichen Sie ohne Benachrichtigung. Setzen Sie beim Anlegen section_id, wo Sektionen den Zugriff steuern.

Interne Links, Medien und Benutzer #

• Interne Links im Rich Text verweisen auf alte Adressen. Ersetzen Sie bei der Umwandlung jeden Link auf ein migriertes Element durch einen Link auf das neue Objekt (Rich Text in ezxmltext kann auf Objekte und Knoten verlinken); sammeln Sie die Links, die sich nicht auflösen lassen, in einem Bericht für Redakteure.
• Medien: Importieren Sie Dateien zuerst, mit Remote-ID als Schlüssel, damit Inhalte auf sie verweisen können. Behalten Sie den Alternativtext; der Bild-Datentyp nimmt path|alternative text.
• Benutzer: Importieren Sie Benutzer als Benutzerobjekte mit ihren Gruppen. Man kann nicht davon ausgehen, dass Passwort-Hashes eines anderen Systems in Exponential funktionieren; planen Sie für jedes migrierte Konto ein Zurücksetzen des Passworts ein (die Funktion für vergessene Passwörter oder php bin/php/resetuserpassword.php für einzelne Konten), und informieren Sie die Benutzer vor der Umstellung. Migrieren Sie nur die Benutzer, die noch gebraucht werden.

Alte Adressen #

Jede alte Adresse, die Suchmaschinen oder andere Websites kennen, sollte mit einer dauerhaften Weiterleitung antworten:

Erzeugen Sie die Weiterleitungsliste aus dem Import selbst: Jeder Datensatz kennt seine alte Adresse und, nach dem Veröffentlichen, den URL-Alias seines Knotens.

Proben und Umstellung #

• Führen Sie den vollständigen Import mindestens zweimal auf einer Kopie der Produktion aus; messen Sie die Zeit; beheben und wiederholen Sie.
• Vor dem letzten Lauf: Frieren Sie die Inhalte im alten System ein, halten Sie die Cronjob-Teile Ihrer anderen Integrationen an, und schalten Sie den Wartungsmodus ein, wenn die neue Website schon öffentlich ist (php bin/php/maintenance.php on --message="..." --until=2h).
• Nach dem Lauf: Bauen Sie den Suchindex neu auf, wenn die Indizierung verzögert war (php bin/php/updatesearchindex.php), leeren Sie die Caches (Caching nach Importen), schalten Sie die Weiterleitungen ein und den Wartungsmodus aus, setzen Sie die Cronjob-Teile fort.

Abnahme #

• To do: Die Anzahl pro Klasse stimmt mit der Bestandsaufnahme überein (abzüglich dessen, was vereinbart weggelassen wurde).
• To do: Eine Stichprobe von Seiten pro Klasse wurde nebeneinander mit der alten Website verglichen.
• To do: Keine unaufgelösten internen Links über dem vereinbarten Schwellenwert; der Bericht ist an die Redakteure übergeben.
• To do: Jedes Bild hat seinen Alternativtext.
• To do: Eine Stichprobe alter Adressen antwortet mit einer dauerhaften Weiterleitung auf die richtige Seite.
• To do: Benutzer können ihr Passwort zurücksetzen und sich anmelden.
• To do: Der Import lässt sich ohne Duplikate erneut ausführen (der zweite Lauf meldet nur Unverändertes).

Verwandte Seiten #

• Playbook für Implementierungsprojekte
• Playbook für Integrationsprojekte
• Migrationsreferenz
• Wartungsmodus
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.