Команды

В DataEase каждая строка в вашем файле импорта может содержать команду. Эта команда указывает приложению, что делать с этой строкой данных. Она может обновить существующий элемент, создать новый, удалить что-то или даже полностью пропустить строку.

Каждый тип данных в DataEase может поддерживать дополнительные пользовательские команды, которые документированы на их конкретных страницах сущностей.

---

⚙️ Команда по умолчанию: MERGE

• Приложение попытается найти существующий элемент и обновить его, используя данные из строки.
• Если элемент не найден, оно создаст новый.

✅ Это самая распространенная команда, которая работает как для обновления, так и для добавления новых записей.

---

✳️ Команда создания: CREATE

• Приложение попытается создать новый элемент.
• Если элемент уже существует (с тем же ID или handle), строка не выполнится.

✅ Используйте это только при импорте совершенно новых данных.
❌ Не используйте, если некоторые данные могут уже существовать.

---

🔁 Команда обновления: UPDATE

• Приложение будет искать существующий элемент и обновлять его.
• Если совпадение не найдено, строка не выполнится.

✅ Лучше всего подходит только для обновления существующих записей.
❌ Не создает новые элементы.

---

♻️ Команда замены: REPLACE

• Приложение будет искать существующий элемент.
• Если оно его найдет, то удалит его.
• Затем оно создаст новый, используя только данные из этой строки.

⚠️ Будьте осторожны: если в строке отсутствуют некоторые данные, новый элемент не будет их содержать.

✅ Полезно для полного восстановления записей с чистыми данными.

---

❌ Команда удаления: DELETE

• Приложение найдет и удалит элемент.
• Если элемент не может быть найден, строка не выполнится.

✅ Используйте это для удаления старых или неверных записей.

---

⏭️ Команда игнорирования: IGNORE

• Приложение пропустит эту строку и ничего с ней не сделает.

✅ Полезно для временного удаления строк из импорта без их удаления из файла.

---

📝 Таблица сводки команд

Команда	Что она делает	Создает новые элементы?	Обновляет существующие?	Удаляет существующие?
MERGE	Обновляет или создает, если элемент не найден	✅	✅	❌
CREATE	Создает только новые элементы	✅	❌	❌
UPDATE	Обновляет только если элемент уже существует	❌	✅	❌
REPLACE	Удаляет существующий и создает новый с текущими значениями	✅	❌	✅
DELETE	Удаляет существующие элементы	❌	❌	✅
IGNORE	Полностью пропускает строку	❌	❌	❌

---

💡 Как добавить команды в ваш файл

В вашем файле импорта включите столбец с именем command и заполните его одним из поддерживаемых значений (например, MERGE, CREATE и т.д.).

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