file
Hängt eine Datei aus dem Migrationsordner an ein Dateiattribut (ezbinaryfile, ezmedia) eines Objekts.
Ein Schritt einer YAML-Migration mit type: file. Die Klasse expMigrationStepFile (kernel/classes/migration/steps/expmigrationstepfile.php) ist in settings/migration.ini [StepSettings] StepTypeList[file] registriert.
Schlüssel
| Schlüssel | Typ | Standard | Was er ist |
|---|---|---|---|
object | identifier (object) | das Objekt (oder node:) | |
node | identifier (node) | ein Knoten des Objekts (oder object:) | |
field | string | erforderlich | der Bezeichner des Attributs (ezbinaryfile, ezmedia) |
file | string | erforderlich | die Datei: ein Pfad unterhalb des Ordners der Migrationsdatei (files/report.pdf) |
name | string | der Dateiname, den Besucher bekommen (Standard: der Name der Datei) | |
language | string | die Übersetzung, die die Datei bekommt (Standard: die Standardsprache der Inhalte) | |
in_place | bool | false | true: die veröffentlichte Version wird an Ort und Stelle geändert, ohne neue Version |
missing | string: fail, skip | "fail" | was geschieht, wenn das Objekt nicht da ist: fail (Standard, scheitern) oder skip (überspringen) |
workflows | bool | false | true: die Workflows der Auslöser der Operation laufen, wie in der Administration (Standard: sie laufen nicht) |
notify | bool | false | true: das Veröffentlichen erzeugt ein Benachrichtigungsereignis (Standard: ohne Benachrichtigung veröffentlicht) |
Daneben nimmt jeder Schritt die Schlüssel der Engine: type, mode, if, references, environments, engines und comment (das Dateiformat). Ein Schlüssel vom Typ identifier nennt einen Knoten, ein Objekt oder einen anderen Teil der Installation über ID, Remote-ID, Pfad oder Namen (Bezeichner).
Werte für Referenzen
references: { <name>: <wert> } behält einen Wert des Ergebnisses des Schritts als ${ref.<name>} für die Schritte und Migrationen nach ihm:
| Wert | Was er ist |
|---|---|
object_id | die ID des Objekts |
node_id | die ID seines Hauptknotens |
remote_id | seine Remote-ID |
version | seine aktuelle Version |
name | sein Name |
path | der URL-Pfad seines Hauptknotens |
changed | true, wenn der Schritt das Objekt geändert hat |
Zurücknehmen
Ein Schritt dieses Typs nimmt sich nicht selbst zurück: Eine Migration mit ihm braucht down: oder eine Rücknahme auf ihren Sicherungspunkt.
Caches, die er berührt (nach dem Lauf geleert): content.
Beispiel
- type: file
object: remote:annual-report
field: file
file: files/annual-report-2026.pdf
name: Annual report 2026.pdfSiehe auch
Erzeugt von ./console exp:help:examples --language=ger-de aus settings/migration.ini, kernel/classes/migration/steps/expmigrationstepfile.php. Bearbeiten Sie diese Seite nicht: Ändern Sie die Quelle oder die deutsche Übersetzung und erzeugen Sie sie neu (wie). Freie Dokumentation: GFDL 1.3 oder später.