Befehle

In DataEase kann jede Zeile in Ihrer Importdatei einen Befehl enthalten. Dieser Befehl teilt der App mit, was mit dieser Datenzeile zu tun ist. Er kann ein bestehendes Element aktualisieren, ein neues erstellen, etwas löschen oder sogar die Zeile vollständig überspringen.

Jeder Datentyp in DataEase kann zusätzliche benutzerdefinierte Befehle unterstützen, die auf ihren spezifischen Entitätsseiten dokumentiert sind.

---

⚙️ Standardbefehl: MERGE

• Die App wird versuchen, ein bestehendes Element zu finden und es mit den Daten in der Zeile zu aktualisieren.
• Wenn kein Element gefunden wird, wird ein neues erstellt.

✅ Dies ist der häufigste Befehl und funktioniert sowohl für das Aktualisieren als auch für das Hinzufügen neuer Datensätze.

---

✳️ Erstellbefehl: CREATE

• Die App wird versuchen, ein neues Element zu erstellen.
• Wenn ein Element bereits existiert (mit derselben ID oder demselben handle), wird die Zeile fehlschlagen.

✅ Verwenden Sie dies nur beim Importieren brandneuer Daten.
❌ Nicht verwenden, wenn einige der Daten möglicherweise bereits existieren.

---

🔁 Aktualisierungsbefehl: UPDATE

• Die App wird nach einem bestehenden Element suchen und es aktualisieren.
• Wenn sie keine Übereinstimmung findet, wird die Zeile fehlschlagen.

✅ Am besten nur zum Aktualisieren bestehender Datensätze.
❌ Erstellt keine neuen Elemente.

---

♻️ Ersetzungsbefehl: REPLACE

• Die App wird nach einem bestehenden Element suchen.
• Wenn sie eines findet, wird es gelöscht.
• Dann wird ein neues erstellt, das nur die Daten in dieser Zeile verwendet.

⚠️ Vorsicht: Wenn einige Daten in der Zeile fehlen, wird das neue Element sie nicht enthalten.

✅ Nützlich für das vollständige Wiederaufbauen von Datensätzen mit sauberen Daten.

---

❌ Löschbefehl: DELETE

• Die App wird das Element finden und löschen.
• Wenn das Element nicht gefunden werden kann, wird die Zeile fehlschlagen.

✅ Verwenden Sie dies, um alte oder falsche Datensätze zu entfernen.

---

⏭️ Ignorierbefehl: IGNORE

• Die App wird diese Zeile überspringen und nichts damit tun.

✅ Hilfreich, um Zeilen vorübergehend aus dem Import zu entfernen, ohne sie aus der Datei zu löschen.

---

📝 Befehlszusammenfassungstabelle

Befehl	Was er tut	Erstellt neue Elemente?	Aktualisiert bestehende?	Löscht bestehende?
MERGE	Aktualisiert oder erstellt, wenn Element nicht gefunden	✅	✅	❌
CREATE	Erstellt nur neue Elemente	✅	❌	❌
UPDATE	Aktualisiert nur, wenn Element bereits existiert	❌	✅	❌
REPLACE	Löscht bestehende und erstellt neue mit aktuellen Werten	✅	❌	✅
DELETE	Löscht bestehende Elemente	❌	❌	✅
IGNORE	Überspringt die Zeile vollständig	❌	❌	❌

---

💡 Wie man Befehle in Ihrer Datei hinzufügt

Fügen Sie in Ihrer Importdatei eine Spalte mit dem Namen command ein und füllen Sie sie mit einem der unterstützten Werte (wie MERGE, CREATE, etc.).

title,handle,price,command
"Red T-shirt","red-tee",19.99,MERGE
"Blue T-shirt","blue-tee",21.99,CREATE
"Old Product","old-handle",,DELETE