Polecenia

W DataEase każdy wiersz w pliku importu może zawierać polecenie. To polecenie informuje aplikację, co zrobić z tym wierszem danych. Może zaktualizować istniejący element, utworzyć nowy, usunąć coś lub nawet całkowicie pominąć wiersz.

Każdy typ danych w DataEase może obsługiwać dodatkowe niestandardowe polecenia, które są udokumentowane na ich stronach dotyczących konkretnych jednostek.

---

⚙️ Domyślne polecenie: MERGE

• Aplikacja spróbuje znaleźć istniejący element i zaktualizować go za pomocą danych z wiersza.
• Jeśli nie znajdzie elementu, utworzy nowy.

✅ To najczęściej używane polecenie, które działa zarówno do aktualizacji, jak i dodawania nowych rekordów.

---

✳️ Polecenie tworzenia: CREATE

• Aplikacja spróbuje utworzyć nowy element.
• Jeśli element już istnieje (z tym samym ID lub handle), wiersz zakończy się niepowodzeniem.

✅ Używaj tego tylko przy imporcie zupełnie nowych danych.
❌ Nie używaj, jeśli niektóre dane mogą już istnieć.

---

🔁 Polecenie aktualizacji: UPDATE

• Aplikacja poszuka istniejącego elementu i zaktualizuje go.
• Jeśli nie znajdzie dopasowania, wiersz zakończy się niepowodzeniem.

✅ Najlepsze do aktualizacji tylko istniejących rekordów.
❌ Nie tworzy nowych elementów.

---

♻️ Polecenie zastąpienia: REPLACE

• Aplikacja poszuka istniejącego elementu.
• Jeśli go znajdzie, usunie go.
• Następnie utworzy nowy używając tylko danych z tego wiersza.

⚠️ Uważaj: Jeśli w wierszu brakuje danych, nowy element nie będzie ich zawierał.

✅ Przydatne do całkowitego odbudowywania rekordów z czystymi danymi.

---

❌ Polecenie usunięcia: DELETE

• Aplikacja znajdzie i usunie element.
• Jeśli element nie zostanie znaleziony, wiersz zakończy się niepowodzeniem.

✅ Używaj tego do usuwania starych lub niepoprawnych rekordów.

---

⏭️ Polecenie pominięcia: IGNORE

• Aplikacja pominie ten wiersz i nic z nim nie zrobi.

✅ Pomocne do tymczasowego usuwania wierszy z importu bez usuwania ich z pliku.

---

📝 Tabela podsumowująca polecenia

Polecenie	Co robi	Tworzy nowe elementy?	Aktualizuje istniejące?	Usuwa istniejące?
MERGE	Aktualizuje lub tworzy, jeśli element nie został znaleziony	✅	✅	❌
CREATE	Tworzy tylko nowe elementy	✅	❌	❌
UPDATE	Aktualizuje tylko, jeśli element już istnieje	❌	✅	❌
REPLACE	Usuwa istniejące i tworzy nowe z bieżącymi wartościami	✅	❌	✅
DELETE	Usuwa istniejące elementy	❌	❌	✅
IGNORE	Całkowicie pomija wiersz	❌	❌	❌

---

💡 Jak dodać polecenia do swojego pliku

W swoim pliku importu, dodaj kolumnę o nazwie command i wypełnij ją jedną z obsługiwanych wartości (takich jak MERGE, CREATE, itp.).

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