SENSUS MEDIA Logo
Synthetische Testdaten · Dokumentation

Regeln als Datei

Die Regeln als synthetic-data.yaml im Projekt ablegen – prüfbar im Merge Request und gleich in allen Umgebungen.

Regeln in der Datenbank haben Nachteile: Sie laufen zwischen Live, Stage und lokalen Umgebungen auseinander, und Änderungen sind schwer nachzuvollziehen. Deshalb können die Regeln auch als Datei im Projekt liegen.

So funktioniert es

  • Liegt im Shopware-Verzeichnis eine Datei synthetic-data.yaml (oder synthetic-data.yml), gelten ausschließlich ihre Regeln. Die Einstellungen im Admin werden dann nicht verwendet.
  • Der Admin zeigt das mit einem Hinweis an und ist schreibgeschützt.
  • Ohne Datei ändert sich nichts.
Hinweis „Regeln kommen aus einer Datei“ mit schreibgeschützten Einstellungen

Datei erstellen

Die aktuellen Regeln aus dem Admin exportieren:

bin/console sensus:synthetic-data:export-profile

Optionen: --path=<datei> für einen anderen Ort, --force zum Überschreiben, --stdout nur zur Ausgabe. Danach die Datei prüfen und in Ihr Projekt-Repository übernehmen.

Aufbau

  • version: 1
  • structureOnly: Liste der Tabellen, die nur als Struktur kopiert werden
  • anonymize: je Tabelle und Spalte die Anonymisierung, z. B. email: randomizeEmail
  • allowUnmapped: Spalten, die bewusst keine Regel haben, jeweils mit Begründung

Erlaubte Werte für die Anonymisierung: randomizeText, setNull, randomizeEmail, anonymizeDate, randomizeNumber, firstName, lastName, street, zipcode, city, phoneNumber, ip, emptyJson, secretConfigValue.

Fehler in der Datei

Unbekannte Schlüssel, unbekannte Anonymisierungen oder eine zu neue version brechen den Befehl mit einer verständlichen Meldung ab. Das Plugin verwirft nie stillschweigend Regeln.

Andere Datei verwenden

generate-dump --rules=<datei> nutzt eine bestimmte Datei. Fehlt sie, ist das ein Fehler – das Plugin weicht dann nicht auf die Datenbank aus.