Lektion 3.3: Ein eigenes Importskript
Wenn kein Werkzeug die Quelle liest, schreibt ein Entwickler ein PHP-Skript, das den Export der Quelle liest und über die API des Kernels Objekte anlegt. Die Dokumentation enthält ein Gerüst, das nur Kernel-Funktionen verwendet, die es in 6.0.15 gibt. Diese Lektion geht es durch, und die Entwickler führen eine minimale Fassung auf ihrer Schulungsinstallation aus.
Hinweis Führen Sie Importskripte nur auf einer Schulungsinstallation oder einer Probelauf-Kopie aus. Das Gerüst ist ein Ausgangspunkt, kein fertiger Importer: Das Lesen der Quelle, die Zuordnung und die Fehlerbehandlung sind Ihre Aufgabe.
Auf einen Blick
| Kurs | Migration zu Exponential |
| Modul | Modul 3: Import- und Exportwerkzeuge |
| Dauer | 60 Minuten (20 Präsentation, 40 Übung) |
| Niveau | Experten |
| Zielgruppe | PHP-Entwickler |
| Voraussetzungen | Lektion 3.2; PHP-Kenntnisse; Shell-Zugang zu einer Schulungsinstallation und die Knoten-ID eines Kursordners |
Lernziele
Nach dieser Lektion können die Teilnehmenden:
- jeden der drei Teile des Gerüsts erklären: anlegen oder über die Remote-ID finden, Rich Text, alte Adresse;
- ein Skript mit dem Exponential-Bootstrap ausführen;
- zeigen, dass ein zweiter Lauf des Skripts aktualisiert, statt zu duplizieren;
- das
fromString()-Format von fünf gängigen Datentypen angeben; - die Reihenfolge der Abhängigkeiten eines Imports nennen und sagen, was darauf folgt (Suchindex, Caches).
Hinweise für Trainer
So präsentieren Sie es
Quelle: Die Import- und Exportwerkzeuge von Exponential, Abschnitt 4.
- Die Schleife (6 Minuten). Zeigen Sie das Gerüst am Beamer. Für jedes Element: eine aus der Quell-ID gebildete
Remote-ID,
eZContentObject::fetchByRemoteID(), danneZContentFunctions::createAndPublishObject(), falls es noch nicht existiert, mitfalsefür keine Benachrichtigungen bei importierten Inhalten. - Rich Text (4 Minuten). HTML wird auf die vereinfachte Eingabe reduziert (
p,strong,em,a href, Überschriften, Listen, Tabellen) und miteZSimplifiedXMLInputParserin XmlText umgewandelt, wie es der RSS-Import tut. - Die alte Adresse (3 Minuten).
eZURLAliasML::storePath()speichert einen weiterleitenden Alias für den Knoten. fromString()-Formate (4 Minuten). Zeigen Sie die Tabelle: Datumsangaben als Unix-Zeitstempel,ezimagealspath|alternative text,ezkeyworddurch Kommas getrennt,ezobjectrelationlistIDs durch-getrennt.- Bewährte Vorgehensweise (3 Minuten). Reihenfolge der Abhängigkeiten (Medien, Inhalte, Beziehungen in einem zweiten Durchlauf), ein eigener Import-Benutzer, den Suchindex neu aufbauen, den Inhalts-Cache leeren, in eine Datei protokollieren, jeden Lauf wiederholbar machen.
Häufige Fragen
Wie führe ich das Skript aus? Die Werkzeugseite verwendet ./console exp:ezexec path/to/your_import.php; in einer
Installation ohne den Wrapper ./console führt php bin/php/ezexec.php path/to/your_import.php denselben Bootstrap
aus.
Warum false als zweites Argument? Keine Benachrichtigungen für importierte Inhalte; sonst bekäme jeder Abonnent
pro importiertem Element eine Mail.
Kann ich das ursprüngliche Veröffentlichungsdatum setzen? Die Zuordnungsseite, Abschnitt 12: published und
modified des Objekts können vom Importskript gesetzt und gespeichert werden; prüfen Sie das Ergebnis in der
Administration.
Stolperfallen
- Keine Remote-ID. Ohne sie dupliziert der zweite Lauf alles. Die Übung beweist es von der anderen Seite her.
- Falscher Sprachcode. Das Gerüst verwendet
eng-GB; die Schulungsinstallation verwendet vielleicht einen anderen. Prüfen Sie zuerst Setup > Sprachen. - Beziehungen im ersten Durchlauf. Das Ziel existiert vielleicht noch nicht; lösen Sie sie in einem zweiten Durchlauf über die Remote-ID auf.
Praktische Übung
Für Entwickler, auf ihrer eigenen Schulungsinstallation. Das Skript legt drei Ordner unterhalb Ihres Kursordners an.
Öffnen Sie in der Administration Setup > Sprachen und notieren Sie den Sprachcode der Hauptsprache (zum Beispiel
eng-US).Notieren Sie die Knoten-ID Ihres Kursordners; im Folgenden heißt sie
<folder>.Legen Sie
var/tmp/import/import_training.phpmit dem Gerüst aus Abschnitt 4 der Werkzeugseite an.Ändern Sie
$parentNodeIdin<folder>,$classIdentifierinfolderund$languagein Ihren Sprachcode.Ersetzen Sie das leere
$itemsdurch drei fest eingetragene Elemente, jedes mit einersource_id(1,2,3), einemtitleund einemhtmlaus einem Absatz; lassen Sieold_pathleer.Das Namensattribut eines Ordners heißt
name, nichttitle: Ändern Sie das Attribut-Array inarray( 'name' => $item['title'] )und das Rich-Text-Attribut vonbodyinshort_description(prüfen Sie beide Bezeichner auf der Seite der Klasse Folder unter Setup > Klassen).Führen Sie es mit dem Exponential-Bootstrap aus:
php bin/php/ezexec.php var/tmp/import/import_training.phpÖffnen Sie Ihren Kursordner in der Administration und zählen Sie die neuen Ordner.
Führen Sie das Skript unverändert ein zweites Mal aus. Zählen Sie erneut.
Ändern Sie den Titel von Element 2 im Skript, führen Sie es ein drittes Mal aus und sehen Sie sich die Versionen dieses Ordners an.
Erwartetes Ergebnis
- Nach Schritt 7 hat das Skript
ok src-1,ok src-2,ok src-3ausgegeben, und unterhalb des Kursordners erscheinen drei Ordner. - Nach Schritt 9 sind es immer noch drei Ordner: Das Skript hat jeden über seine Remote-ID gefunden und aktualisiert.
- Nach Schritt 10 hat Ordner 2 den neuen Namen und eine neuere Version.
- Der Trainer prüft eine Installation in der Administration und bittet die Person zu erklären, warum Schritt 9 keine Duplikate erzeugt hat.
Quiz
- Welcher Kernel-Aufruf findet ein Objekt, das ein früherer Lauf bereits angelegt hat?
- In welchem Format liest
ezdatetimeeinen Wert überfromString()? A. ISO-8601-Text B. Ein Unix-Zeitstempel C. Tag/Monat/Jahr D. Ein PHP-DateTime-Objekt - Warum ist das zweite Argument von
createAndPublishObject()im Gerüst auffalsegesetzt? - Nennen Sie die Importreihenfolge, die die Werkzeugseite empfiehlt.
- Welche zwei Dinge tun Sie, nachdem der Import abgeschlossen ist?
Antworten
eZContentObject::fetchByRemoteID()(Werkzeugseite, Abschnitt 4).- B (die
fromString()-Tabelle auf der Werkzeugseite, Abschnitt 4). - Keine Benachrichtigungen für importierte Inhalte (der Kommentar im Gerüst).
- Zuerst Medien, dann Inhalte, die sich darauf beziehen, dann Inhalte, die sich auf Inhalte beziehen; Beziehungen werden in einem zweiten Durchlauf über die Remote-ID aufgelöst (Werkzeugseite, Abschnitt 4, bewährte Vorgehensweise).
- Den Suchindex neu aufbauen und den Inhalts-Cache leeren (Werkzeugseite, Abschnitt 4, bewährte Vorgehensweise).
Weiterführende Informationen
- Die Import- und Exportwerkzeuge von Exponential, Abschnitt 4:
das Gerüst und die
fromString()-Tabelle. - Inhalte auf Exponential abbilden: worauf das Skript abbildet.
- Kapitel 17.6: PHP-API: die Legacy-Klassen neben ihren Entsprechungen in der Plattform.
- Inhalte aus PHP schreiben mit expContentWriter: mit Exponential
6.0.15 derselbe Import mit Rich Text als HTML und Dateien von öffentlichen Adressen, ohne eigene HTML-Umwandlung
(
eZSimplifiedXMLInputParser) und ohne eigenen Download-Schritt.
Verwandte Seiten
- Modul 3: Import- und Exportwerkzeuge
- Migration zu Exponential: Kursüberblick
- Trainer: hier beginnen
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.